Pancake API & đồng bộ dữ liệu
Webhook, API hội thoại, khách hàng, thống kê — đưa dữ liệu Pancake về hệ thống của bạn.
8 bài
Pancake Webhook Idempotency — Chống xử lý trùng sự kiện khi retry
Khi tích hợp webhook Pancake vào chatbot hoặc CRM, cùng 1 tin nhắn có thể được đẩy về nhiều lần do retry của Pancake hoặc do server bạn timeout. Bài này giải đáp 4 câu hỏi kinh điển: field nào là ID duy nhất và ổn định của event, retry có giữ nguyên ID không, 2 tin cùng nội dung có ID khác nhau không, ID unique toàn hệ thống hay chỉ trong 1 page — kèm 3 pattern chống trùng ở tầng ứng dụng (Redis SETNX, PostgreSQL UNIQUE, in-memory LRU) với code Node.js chạy được ngay.
Xác định nguồn khách vào Facebook Page qua Webhook Pancake — referral, ad_id
Khách nhắn vào Facebook Page qua Messenger nhưng đội marketing không biết khách đến từ quảng cáo nào, từ đường link nào — mất khả năng đo hiệu quả chiến dịch. Bài này chỉ ra 3 cách khách vào Messenger của Fanpage (quảng cáo Click-to-Messenger, đường link m.me có tham số ref, và tin nhắn tự nhiên), map với từng trường dữ liệu trong webhook Pancake, cùng 2 phương án đo nguồn: tin cậy trực tiếp webhook và chủ động cài ref vào mọi đường link m.me. Nêu rõ vì sao không nên dựa vào Get Conversations API để suy ra nguồn cho hội thoại inbox.
Pancake Statistics API — 7 endpoint thống kê (page, user, tag, engagement, ads, new customer)
Hướng dẫn chi tiết 7 endpoint Statistics trên Pancake API — page, user (KPI nhân viên), tag, engagement, ads + ads campaign, new customer. Kèm cảnh báo về 3 FORMAT DATE PARAMS khác nhau giữa các endpoint (since/until Unix sec, date_range string DD/MM/YYYY HH:MM:SS, date_range string DD/MM/YYYY) — đây là pitfall thường gặp khi build BI dashboard hoặc cron sync.
Quản lý hội thoại Pancake API — Tag, Assign nhân viên, Mark Read/Unread
Hướng dẫn chi tiết 4 nhóm endpoint quản lý vòng đời hội thoại Pancake — gắn/gỡ tag, assign nhân viên xử lý, mark read/unread. Kèm 2 endpoint lookup (tags + users), pattern auto-tag theo keyword, round-robin assign, và lưu ý về tính năng round_robin_users built-in của Pancake.
3 phương án truy xuất data Pancake để đẩy vào CRM — Cẩm nang cho kĩ thuật viên
So sánh 3 phương án thực dụng để truy xuất data khách hàng và hội thoại từ Pancake API rồi đẩy vào CRM của bạn — Postman (manual), Make.com / n8n (no-code automation), và self-hosted Node.js cron (full code). Mỗi phương án có bước setup cụ thể, chi phí, latency, và pitfall đi kèm để kĩ thuật viên chọn đúng theo nhu cầu.
Page Customers API Pancake — Đồng bộ khách hàng vào CRM kèm ghi chú & avatar
Hướng dẫn đầy đủ Page Customers API của Pancake — list khách hàng với offset pagination, update thông tin, CRUD ghi chú nội bộ, và endpoint avatar public không cần token. Kèm pattern sync vào CRM (HubSpot/Salesforce/Postgres) với delta sync, schema gợi ý và cảnh báo các pitfall về đơn vị thời gian.
Lấy danh sách hội thoại Pancake API — Pagination, filter & sync vào hệ thống
Hướng dẫn chi tiết cách gọi API GET /pages/{page_id}/conversations để lấy danh sách hội thoại Pancake — từ endpoint cơ bản, pagination bằng last_conversation_id, filter theo type/tags/post/thời gian, đến best practice sync số lượng lớn vào CRM.
Hướng dẫn kết nối Webhook & API gửi tin nhắn trên Pancake
Hướng dẫn từng bước cấu hình Webhook để nhận tin nhắn realtime từ Pancake và gọi API gửi reply tự động cho khách hàng, kèm Page Access Token, endpoint chuẩn và ví dụ code Node.js + Python.