n8n-nodes-pancake-official

👨‍💻 Author & Maintainer

Developed and maintained with ❤️ by Jay Nguyen (Nguyễn Thiệu Toàn).

🛡️ Verified n8n Creator | 💼 CEO/Founder of GenStaff

Connect with me:

🚀 Why is this package a game-changer for n8n?

Pancake is one of the most widely adopted customer communication, social commerce, and omnichannel inbox platforms in Southeast Asia (connecting Facebook Messenger, Instagram, WhatsApp, personal Zalo, Telegram, Webcake, and more).

Previously, connecting Pancake to n8n required fragile custom HTTP requests, complex token management, and manual webhook parsing. n8n-nodes-pancake-official bridges this gap by turning Pancake into a unified omnichannel gateway:

1. Instant AI Omnichannel Agent: Connect incoming customer messages directly to LangChain, OpenAI, Claude, or DeepSeek agents in n8n, and reply back via Pancake across any social channel.
2. True Omnichannel Write API: Send Inbox messages, reply directly to public comments on social posts, or trigger Private Replies (send a direct message to a customer who commented on your Facebook/Instagram post).
3. Smooth Human Handoff: Automatically assign human staff members to conversations when AI confidence drops, or update round-robin distribution dynamically.
4. Real-time Event-Driven Architecture: Catch incoming messages, comment events, conversation state changes, and channel connection warnings in real time using the dedicated Pancake Trigger node.
5. Customer CRM & Order Insights: Extract purchase history (order_count, purchased_amount, recent_orders), update contact profiles, and manage CRM notes.
6. Business Analytics & Reporting: Track team performance, conversation volume, customer satisfaction, and ad campaign attribution.
7. SIP Call Logs: Access complete call recordings, durations, and caller/callee histories.

📦 Included Nodes

| Node | Type | Description | |---|---|---| | Pancake | Standard Action Node | Comprehensive operations for Conversations, Messages, Customers, Analytics, Staff, Call Logs, Ads Export, Tags, Posts, and Media Uploads. | | Pancake Trigger | Webhook Trigger Node | Real-time trigger for customer messaging, comments, conversation updates, post events, subscription events, and connection status. |

🛠️ Key Capabilities & Resources (10 Core Resources)

1. Conversation Management

• Get Many: Fetch conversations with granular filters (INBOX, COMMENT, COMMENT_LIVESTREAM, POST, tags, post IDs, time ranges, and unread priority).
• Mark as Read / Unread: Mark conversations as read, or flag as unread (needs_attention = true) for staff review.
• Tagging: Add or remove categorization tags dynamically.
• Assign Staff (Human Handoff): Assign staff user UUIDs to conversations for human takeover.

2. Multi-channel Messaging

• Inbox Message: Send direct replies to customer chats (supports text and uploaded media attachment IDs).
• Reply Comment: Post public replies under customer comments on social media posts.
• Private Reply: Send private inbox messages to users who commented on your posts (within Meta 7-day window).
• WhatsApp Template: Send pre-approved WhatsApp Business template messages with dynamic parameters.
• Message History: Fetch previous messages with cursor pagination (current_count).

3. Customer CRM & Order Insights

• Customer Lookup: Query customer profiles including phone numbers, emails, order counts, and recent purchase history.
• Update Profile: Update customer names, phone numbers, gender, and birthdays directly from AI extraction.
• CRM Notes (Full CRUD): Create, update, and delete customer interaction notes.
• Avatar Lookup: Fetch direct CDN avatar URLs via customer PSID.
• Order Insights: While Pancake's public API does not provide a dedicated /orders endpoint, customer order metrics are accessible via customer profiles (order_count, succeed_order_count, purchased_amount, recent_orders, last_order_at).

4. Staff & Round Robin Distribution

• Staff / Users: List all active team members, roles, and current round-robin participants.
• Update Round Robin: Configure automated lead and conversation distribution for inbox and comments among staff members.

5. Statistics & Analytics

• Customer Engagements: Retrieve conversation volume, hourly trends, and order counts per staff member.
• Page Summary: Overall page performance metrics across channels.
• Tag Statistics: Metrics grouped by conversation tags.
• Staff Performance: Response times, resolution rates, and message volume per user.
• New Customers: Acquisition numbers grouped by day, month, or year.
• Ads Campaigns: Conversation attribution and return on ad spend (ROAS).
• Customer Feedback: Customer satisfaction ratings and ratings trends.

6. Call Logs & Ads Export

• SIP Call Logs: Retrieve call history with duration, status, started/ended timestamps, and recording URLs.
• Ads Export: Export ad-originated conversations with offset pagination for external BI and data warehouses.

7. Tags, Posts & Media Upload

• Tags: Retrieve all available tags to map and categorize chats.
• Posts: Retrieve recent social posts to route comment automation.
• Media Upload: Upload photos, videos, and documents directly from n8n binary data to obtain content_id for messaging.

⚡ Real-Time Webhook Trigger (Pancake Trigger)

The Pancake Trigger node receives instant HTTP POST notifications from Pancake. It supports 5 official event types:

| Event Type | Description | |---|---| | messaging | Instant notification whenever a customer sends an inbox message or posts a comment. | | conversation | Triggered when a conversation is updated, assigned, marked read/unread, or tagged. | | post | Triggered on social post creation or updates. | | subscription | User or page subscription events. | | connect_status | Alerts when a channel connection (Facebook, Instagram, Zalo, WhatsApp) is connected or disconnected. |

Webhook Setup in Pancake

1. Copy the Webhook URL from your Pancake Trigger node in n8n.
2. In Pancake, navigate to Page Settings > Tools > Webhook.
3. Register your webhook URL and ensure your subscription has an available connection slot.
4. Pancake will send a verification handshake and begin forwarding real-time events.

📥 Installation

In n8n Community Nodes Settings (Recommended)

1. Go to Settings > Community Nodes in your n8n instance.
2. Click Install a community node.
3. Enter n8n-nodes-pancake-official in the npm Package Name field.
4. Agree to risks and click Install.

🔑 Credentials Configuration

1. In n8n, create a new credential for Pancake API.
2. Provide:
   • Page ID: The numeric ID of your Pancake page (found in your Pancake dashboard URL).
   • Page Access Token: The permanent token obtained from Pancake -> Page Settings -> Tools -> Page Access Token.
3. Click Test Connection to immediately verify access against the live Pancake API!

📄 License

MIT © Jay Nguyen (Nguyễn Thiệu Toàn)