Skip to content

suminhthanh/pancake-skills

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
references
references
 
 
scripts
scripts
 
 
README.md
README.md
 
 
SKILL.md
SKILL.md
 
 

Repository files navigation

pancake-skills

Claude Code skill for interacting with the Pancake Platform API - a multi-channel sales management platform.

Installation

Copy the skill directory to your Claude skills folder:

cp -r pancake-skills ~/.claude/skills/

Environment Variables

Required

Variable Description How to obtain
USER_ACCESS_TOKEN Personal access token (90-day validity) Account → Personal Settings
PAGE_ACCESS_TOKEN Page access token (no expiration) Page Settings → Tools

Optional

Variable Default Description
PANCAKE_BASE_URL https://pages.fm Override API base URL
CONFIRM_WRITE - Set to YES to allow write operations

Quick Start

List your pages

export USER_ACCESS_TOKEN="your_token"
bash scripts/pancake.sh pages-list

List conversations

export PAGE_ACCESS_TOKEN="your_page_token"
bash scripts/pancake.sh conversations-list 123456789

Send a message

export PAGE_ACCESS_TOKEN="your_page_token"
export CONFIRM_WRITE=YES

echo '{"action":"reply_inbox","message":"Hello!"}' | \
  bash scripts/pancake.sh messages-send 123456789 conversation_id

Available Commands

Pages

Command Description
pages-list List all pages
pages-generate-token PAGE_ID Generate page access token

Conversations

Command Description
conversations-list PAGE_ID [QUERY] List conversations
conversations-tag PAGE_ID CONV_ID Add/remove tag (stdin: JSON)
conversations-assign PAGE_ID CONV_ID Assign staff (stdin: JSON)
conversations-read PAGE_ID CONV_ID Mark as read
conversations-unread PAGE_ID CONV_ID Mark as unread

Messages

Command Description
messages-list PAGE_ID CONV_ID [COUNT] Get messages
messages-send PAGE_ID CONV_ID Send message (stdin: JSON)

Customers

Command Description
customers-list PAGE_ID SINCE UNTIL PAGE [SIZE] [ORDER] List customers
customers-update PAGE_ID CUST_ID Update customer (stdin: JSON)
customers-add-note PAGE_ID CUST_ID Add note (stdin: JSON)
customers-update-note PAGE_ID CUST_ID Update note (stdin: JSON)
customers-delete-note PAGE_ID CUST_ID Delete note (stdin: JSON)

Statistics

Command Description
stats-campaigns PAGE_ID SINCE UNTIL Ads campaign stats
stats-ads PAGE_ID SINCE UNTIL TYPE Ads stats (by_id/by_time)
stats-engagement PAGE_ID DATE_RANGE [BY_HOUR] Engagement stats
stats-page PAGE_ID SINCE UNTIL Page stats
stats-tags PAGE_ID SINCE UNTIL Tag stats
stats-users PAGE_ID DATE_RANGE User stats
stats-new-customers PAGE_ID DATE_RANGE [GROUP] New customer stats

Tags, Posts, Users

Command Description
tags-list PAGE_ID List all tags
posts-list PAGE_ID SINCE UNTIL PAGE SIZE [TYPE] List posts
users-list PAGE_ID List staff
users-round-robin PAGE_ID Update round robin (stdin: JSON)

Other

Command Description
call-logs PAGE_ID SIP_ID PAGE SIZE [SINCE] [UNTIL] Get call logs
export-ads-conversations PAGE_ID SINCE UNTIL [OFFSET] Export ads conversations
upload PAGE_ID FILE_PATH Upload media
chat-plugin-send PAGE_ID Send chat plugin message (stdin: JSON)
chat-plugin-messages PAGE_ID CONV_ID [OFFSET] Get chat plugin messages

Message Types

Inbox Message

{
  "action": "reply_inbox",
  "message": "Your text message"
}

Inbox with Attachment

{
  "action": "reply_inbox",
  "content_ids": ["content_id_from_upload"]
}

Important: message and content_ids are mutually exclusive. Do not send both.

Reply to Comment

{
  "action": "reply_comment",
  "message_id": "comment_id",
  "message": "Your reply"
}

Private Reply

{
  "action": "private_replies",
  "post_id": "post_id",
  "message_id": "comment_id",
  "message": "Your private message"
}

Safety Features

  • Write Protection: All write operations require CONFIRM_WRITE=YES
  • Token Security: Tokens are URL-encoded automatically
  • Validation: Clear error messages for missing required parameters

API Reference

Full OpenAPI specification is available at references/openapi-pancake.yaml.

License

MIT

Tiếng Việt

Giới thiệu

Claude Code skill để tương tác với Pancake Platform API - nền tảng quản lý bán hàng đa kênh.

Cài đặt

Copy thư mục skill vào folder skills của Claude:

cp -r pancake-skills ~/.claude/skills/

Biến môi trường

Bắt buộc

Biến Mô tả Cách lấy
USER_ACCESS_TOKEN Token cá nhân (hiệu lực 90 ngày) Account → Personal Settings
PAGE_ACCESS_TOKEN Token của page (không hết hạn) Page Settings → Tools

Tuỳ chọn

Biến Mặc định Mô tả
PANCAKE_BASE_URL https://pages.fm Ghi đè URL API
CONFIRM_WRITE - Đặt YES để cho phép thao tác ghi

Bắt đầu nhanh

Liệt kê pages

export USER_ACCESS_TOKEN="token_của_bạn"
bash scripts/pancake.sh pages-list

Liệt kê conversations

export PAGE_ACCESS_TOKEN="token_page_của_bạn"
bash scripts/pancake.sh conversations-list 123456789

Gửi tin nhắn

export PAGE_ACCESS_TOKEN="token_page_của_bạn"
export CONFIRM_WRITE=YES

echo '{"action":"reply_inbox","message":"Xin chào!"}' | \
  bash scripts/pancake.sh messages-send 123456789 conversation_id

Các lệnh có sẵn

Pages

Lệnh Mô tả
pages-list Liệt kê tất cả pages
pages-generate-token PAGE_ID Tạo page access token

Conversations

Lệnh Mô tả
conversations-list PAGE_ID [QUERY] Liệt kê conversations
conversations-tag PAGE_ID CONV_ID Thêm/xóa tag (stdin: JSON)
conversations-assign PAGE_ID CONV_ID Gán nhân viên (stdin: JSON)
conversations-read PAGE_ID CONV_ID Đánh dấu đã đọc
conversations-unread PAGE_ID CONV_ID Đánh dấu chưa đọc

Messages

Lệnh Mô tả
messages-list PAGE_ID CONV_ID [COUNT] Lấy tin nhắn
messages-send PAGE_ID CONV_ID Gửi tin nhắn (stdin: JSON)

Customers

Lệnh Mô tả
customers-list PAGE_ID SINCE UNTIL PAGE [SIZE] [ORDER] Liệt kê khách hàng
customers-update PAGE_ID CUST_ID Cập nhật khách hàng (stdin: JSON)
customers-add-note PAGE_ID CUST_ID Thêm ghi chú (stdin: JSON)
customers-update-note PAGE_ID CUST_ID Sửa ghi chú (stdin: JSON)
customers-delete-note PAGE_ID CUST_ID Xóa ghi chú (stdin: JSON)

Statistics

Lệnh Mô tả
stats-campaigns PAGE_ID SINCE UNTIL Thống kê chiến dịch quảng cáo
stats-ads PAGE_ID SINCE UNTIL TYPE Thống kê quảng cáo (by_id/by_time)
stats-engagement PAGE_ID DATE_RANGE [BY_HOUR] Thống kê tương tác
stats-page PAGE_ID SINCE UNTIL Thống kê page
stats-tags PAGE_ID SINCE UNTIL Thống kê tags
stats-users PAGE_ID DATE_RANGE Thống kê users
stats-new-customers PAGE_ID DATE_RANGE [GROUP] Thống kê khách hàng mới

Tags, Posts, Users

Lệnh Mô tả
tags-list PAGE_ID Liệt kê tất cả tags
posts-list PAGE_ID SINCE UNTIL PAGE SIZE [TYPE] Liệt kê bài viết
users-list PAGE_ID Liệt kê nhân viên
users-round-robin PAGE_ID Cập nhật round robin (stdin: JSON)

Khác

Lệnh Mô tả
call-logs PAGE_ID SIP_ID PAGE SIZE [SINCE] [UNTIL] Lấy lịch sử cuộc gọi
export-ads-conversations PAGE_ID SINCE UNTIL [OFFSET] Export conversations từ ads
upload PAGE_ID FILE_PATH Upload media
chat-plugin-send PAGE_ID Gửi tin nhắn chat plugin (stdin: JSON)
chat-plugin-messages PAGE_ID CONV_ID [OFFSET] Lấy tin nhắn chat plugin

Các loại tin nhắn

Tin nhắn Inbox

{
  "action": "reply_inbox",
  "message": "Nội dung tin nhắn"
}

Inbox với Attachment

{
  "action": "reply_inbox",
  "content_ids": ["content_id_từ_upload"]
}

Quan trọng: message và content_ids là MUTUALLY EXCLUSIVE - không được gửi cả hai cùng lúc.

Trả lời Comment

{
  "action": "reply_comment",
  "message_id": "comment_id",
  "message": "Nội dung trả lời"
}

Private Reply

{
  "action": "private_replies",
  "post_id": "post_id",
  "message_id": "comment_id",
  "message": "Tin nhắn riêng tư"
}

Tính năng an toàn

  • Bảo vệ ghi: Tất cả thao tác ghi yêu cầu CONFIRM_WRITE=YES
  • Bảo mật token: Token được URL-encode tự động
  • Xác thực: Thông báo lỗi rõ ràng khi thiếu tham số bắt buộc

Tham chiếu API

Xem đầy đủ OpenAPI specification tại references/openapi-pancake.yaml.

About

No description, website, or topics provided.

Resources

Readme
Activity

Stars

5 stars

Watchers

0 watching

Forks

2 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages