WhatChimp Docs
Help articles and guides for WhatChimp, the WhatsApp Business API platform.
Overview
- WhatChimp Pricing Benefits: WhatChimp Pricing Benefits (No Markup on WhatsApp API)
- WhatChimp Overview: Everything you need to know about WhatChimp
- What Are WhatsApp Conversations and How Are They Charged: Guide: What Are WhatsApp Conversations and How Are They Charged
- WhatsApp vs WhatsApp Business vs WhatsApp Business API: Guide: WhatsApp vs WhatsApp Business vs WhatsApp Business API: Which One Does Your Business Actually Need?
- Pricing Explained: How WhatsApp Business API pricing works: what Meta charges you for, when messages are free, and how to find rates for your country.
- What is changing with WhatsApp pricing on 1 October 2026: A plain-language guide to the WhatsApp Business Platform pricing change taking effect 1 October 2026, and what actually changes for you.
- How to keep your WhatsApp costs low under the new pricing: Practical steps you can take today to keep your WhatsApp monthly cost low after the 1 October 2026 pricing change, including the 1,000 free service messages allowance.
Setup & Configuration
- How to Connect Your Phone Number with WhatChimp (Embedded Signup): Step-by-step guide to connect your WhatsApp Business phone number to WhatChimp using the embedded signup flow
- How to Create a Facebook Business Manager Account for WhatChimp: Step-by-step guide to creating a Facebook Business Manager account so you can unlock full WhatsApp Business API access in WhatChimp.
- How to Verify Your Meta Business Manager: Step-by-step guide to verify your Meta Business Manager for WhatsApp API access
- How to Add Payment Method for WhatsApp API Billing: Set up your payment method on Meta Business portal to pay for WhatsApp API usage
- How to Update Your WhatsApp Business Profile: Update your WhatsApp Business profile picture, description, website, and business details
- How to Migrate from WhatsApp App to WhatChimp Business Account: Migrate your existing WhatsApp number from the app to the WhatsApp Business API
- How to Migrate to WhatChimp from Another BSP: Step-by-step guide to migrate your WhatsApp Business account to WhatChimp without losing your phone number, messaging quota, or quality rating
- WhatsApp Co-Existence: Use Your Business App and WhatChimp Together: Use the same number on WhatsApp Business App and WhatChimp API at the same time
- Connect with an Existing Business Portfolio: How to connect your WhatsApp number when you already have a Meta Business Portfolio
- Reconnect an Existing WhatsApp Business Account to WhatChimp: How to reconnect a previously used WABA and phone number to WhatChimp
- Reconnect Your Disconnected WhatChimp Account: How to reconnect your WhatsApp number to WhatChimp after your account was disconnected due to trial expiry or missed billing
- How to Delete Your Phone Number on Meta: Remove your phone number from WhatsApp Business API
WhatsApp Business API
- What is WhatsApp Business API?: Introduction to WhatsApp Business API and how it differs from the regular app
- Business Manager, WhatsApp Accounts, and Phone Numbers Explained: Understanding the relationship between Meta Business Manager and WhatsApp accounts
- WhatsApp Messaging Limits: Understanding WhatsApp API messaging tiers and daily limits
- Handy Links for WhatsApp Business API Settings: Quick access links to Meta Business Manager and WhatsApp settings
- How to Apply for the WhatsApp Green Tick: Get your Official Business Account verification badge
- My WhatsApp Business Verification Request Was Rejected: What to do if your Meta Business verification is rejected
- WhatsApp API: Maximum Media Size & Supported Formats: Guide: WhatsApp API: Maximum Media Size & Supported Formats
Omnichannel Inbox
- Introduction to Omnichannel Inbox: Manage all your WhatsApp, Instagram, Facebook, and website conversations from one unified inbox.
- Filter Conversations by Channel & Account: Learn how to filter your inbox by specific channels and connected accounts.
- Organize Conversations with Labels, Views & Search: Keep your inbox organized using labels, conversation views, and search filters.
- AI Translation & Message Rewrite: Translate incoming messages and improve your replies using AI-powered features.
- Team Collaboration & Agent Assignment: Assign conversations to team members, manage permissions, and collaborate effectively.
- Messaging Tools: Canned Responses, Templates & Attachments: Speed up your responses with canned replies, send templates, and share files.
- Follow-up Reminders & Message Sequences: Never miss a follow-up with reminders and automated message sequences.
- Managing Customer Data with Custom Fields: Store and manage customer information using custom fields in conversations.
Chat Routing
- Round Robin Chat Assignment: Auto-Assign Chats to Your Team: Automatically share incoming WhatsApp chats across your team so every customer reaches an available agent. Set up your team once, then pick how chats get handed over.
- Create a Team and Add Your Agents: Set up a team in WhatChimp as a User Permission role, then add agents to it. This is the foundation for round-robin chat assignment.
- How Agents Set Their Availability: Each agent can turn their support availability on or off from their profile. Round robin only assigns chats to available agents.
- Control Which Chats Each Agent Can See: Decide whether an agent sees only the chats assigned to them, or can switch between their chats and all chats. Set per agent with the Allow Only Assigned Chat toggle.
- Round Robin on Any Message (No Match Reply): Assign every incoming WhatsApp message to a team and round-robin it to an available agent, using the No Match Reply.
- Round Robin on a Keyword: Route customers to the right team based on the keyword they send, then round-robin the chat to an available agent.
- Round Robin on a Button Click: Let customers pick their department from a menu of buttons, then round-robin their chat to an available agent in the team they chose.
Message Template
- Why Templates Get Rejected and How to Fix Them: Common reasons WhatsApp message templates get rejected and how to fix each issue
- Character Limits for Media Message Templates: Character Limits for Media Message Templates
- Understanding Conversations and Their Types: How WhatsApp conversation categories work, what they cost, and how they relate to message templates
- Guidelines for Utility and Marketing Templates: How to choose the right category for your WhatsApp message templates
- How to Create and Use Carousel Media Templates: Step-by-step guide to creating carousel templates with multiple cards in WhatChimp
- Creating a WhatsApp Message Template: Step-by-step guide to creating WhatsApp message templates in WhatChimp
- Create Templates in WhatsApp Manager and Sync to WhatChimp: How to create message templates in Meta's WhatsApp Manager and sync them to WhatChimp
- Templates to Restart Conversations After Non-Working Hours: Ready-to-use templates for re-engaging customers after the 24-hour service window expires
- Template Variables vs Custom Variables — What's the Difference?
- Understanding WhatsApp Quality Rating: How your WhatsApp quality rating works, what affects it, and how to maintain a high rating
Broadcasting
- Broadcasting with Personalized Variable Data: How to send personalized WhatsApp broadcasts using custom fields and subscriber data
- How to Send Broadcast Messages in WhatChimp: Step-by-step guide to importing contacts, creating templates, and sending broadcast campaigns
Subscriber Manager
- How to Manage Custom Fields and Labels: Guide: Manage Custom Fields and Labels
- How to Import Subscribers Using CSV: Guide: Import Subscribers Using CSV
- How to Import Subscribers Manually: How to manually add individual subscribers in WhatChimp
- How to Import Contacts from Google Sheets: Connect Google Sheets to WhatChimp and import contacts directly
Bot Manager
- WhatsApp Flow Forms: How to create and use WhatsApp Flow Forms for data collection in WhatChimp
- HTTP API Node Returns a Connection Timeout (http_code 0): If the HTTP API node fails with a connection timeout and http_code 0, the external provider is most likely blocking WhatChimp's IP. Whitelist WhatChimp's IPs to fix it.
- How to Build Automatic Follow-Up Chatbots on WhatsApp: Guide: Build Automatic Follow-Up Chatbots on WhatsApp
- How to Collect User Details Without Forms on WhatsApp: Guide: Collect User Details Without Forms on WhatsApp
- How to Add Clickable CTA Buttons: How to add interactive call-to-action buttons to your chatbot flows
- External HTTP API Integration in Bot Flow: External HTTP API Integration in Bot Flow
- How to Set Up Sales Sequence Chatbots: How to create automated messaging sequences for lead nurturing and sales
- How to Add WhatChimp Chat Widget to WordPress: Step-by-step guide to integrating WhatChimp's webchat widget on your WordPress site
- How to Create a Keyword-Based WhatsApp Chatbot: Build a chatbot that replies on its own when a customer sends a word you choose, in five steps.
- How to Automate Complex Conversations with User Input Flow in Webchat: Guide: How to Automate Complex Conversations with User Input Flow in Webchat
- No Match Reply & Frequency Setup: Configure automatic replies for unmatched messages and control reply frequency
- Why Your Chatbot Gets Stuck on an Old Conversation (and How to Fix It): If your WhatsApp chatbot stays stuck on an old, unfinished Input Flow, set an Input Flow Session Expiry Time so abandoned sessions clear automatically.
- Auto-Tag Failed WhatsApp Deliveries So You Can Find and Recover Them: WhatChimp can automatically label any contact whose message failed to deliver, so you can find and follow up with everyone a broadcast missed.
- How to Make a Chatbot Reply to Any Keyword (Not Just the Ones You Set): Want one chatbot to answer any message, not just exact keywords? Set up a catch-all reply so every message a customer sends gets a response.
- Flow Builder Blocks Explained: What every block in the WhatChimp Flow Builder does, how to add and join blocks, and which blocks need something in front of them.
- How to Build a Complete WhatsApp Chatbot, Step by Step: Build your own menu chatbot one click at a time and learn every main Flow Builder block, with a picture for every step.
Appointment Booking
- Introduction to Appointment Booking: Let customers book appointments right inside WhatsApp, free or paid, synced to Google Calendar with a Meet link. See how the whole booking flow works.
- How to Connect Your Google Calendar to WhatChimp: Connect your Google account so appointment bookings sync to Google Calendar with a Meet link. The first step for appointment booking in WhatChimp.
- How to Create an Appointment: Set up a bookable appointment in WhatChimp: pick a calendar, set your availability, duration, pricing, data actions, and the questions customers answer.
- How to Customize Appointment Booking Messages: Rewrite the WhatsApp messages WhatChimp sends for a booking: the confirmation, booking confirmed, reschedule, reminders, and more, using your own copy and variables.
- How to Set a Booking Reminder: Send an automatic WhatsApp reminder before each appointment to cut no-shows. Set the lead time, an optional country code, and the approved message template.
- How to Trigger Appointment Booking from a Chatbot: Connect an appointment to a chatbot keyword so booking starts inside the chat. Add the Appointment node in the Flow Builder and pick your appointment.
- How to View Appointment Requests: See every booking across your appointments in one table. Filter by appointment and status, change a booking's status, and open its invoice.
- How to Add a Webhook for Appointments: Send appointment booking events to an external URL with a webhook. Fire Order Submitted, Order Checkout, or Order Updated events to n8n, Zapier, or your own server.
Catalog
- Introduction to eCommerce Catalog: Sell products directly inside WhatsApp — learn how the catalog works end-to-end
- Create a Product Catalog in Meta: Step-by-step guide to creating a product catalog in Meta Commerce Manager
- Connect Your Catalog with WhatsApp: Link your Meta product catalog to your WhatsApp number through WhatChimp
- Showcase Products in a Chatbot: Build a WhatsApp chatbot that displays your product catalog to customers
- Manage Orders & Payment Settings: Handle catalog orders, configure payment gateways, and export to Google Sheets
- Catalog Settings & Sync: Manage catalog sync, visibility, messaging, and webhook settings in WhatChimp
E-Commerce
- Recover Shopify Abandoned Carts with WhatsApp: Guide: Recover Shopify Abandoned Carts with WhatsApp
- WooCommerce Abandoned Cart Recovery via WhatsApp: Guide: WooCommerce Abandoned Cart Recovery via WhatsApp
- How to Confirm Cash-on-Delivery Orders via WhatsApp: Guide: How to Confirm Cash-on-Delivery Orders via WhatsApp Using WhatChimp
- Send Shopify Order Notifications to WhatsApp via Webhook Workflow: Guide: Send Shopify Order Notifications to WhatsApp via Webhook Workflow
Account Safety
- How to Appeal a WhatsApp Business API Ban and Get Your Number Back: How to appeal a WhatsApp Business API ban in Meta Business Support Home, what to write in the review, and when to escalate through WhatChimp.
- WhatsApp Account Bans: What They Are, Why They Happen, and How to Stay Protected: Understand the two types of WhatsApp bans, what to do if your account is already banned, and the step-by-step warmup and scaling rules to keep your number safe long-term.
- WhatsApp Account Safety & Compliance Guide: Understand why WhatChimp protects you from technical bans, what policy bans are, and the complete 4-phase guide to warming up and scaling your WhatsApp number safely.
Google Spreadsheet
- Connect Google Spreadsheet: Connect your Google account to WhatChimp and manage your Google Sheets: create new sheets, add existing ones, and organize your spreadsheet connections.
- Import Contacts from Google Spreadsheet: Bulk-import contacts from a Google Sheet into WhatChimp's Subscriber Manager — map spreadsheet columns to subscriber fields and organize with labels.
- Send New Subscriber Data to Google Spreadsheet: Automatically save new subscriber information to a Google Spreadsheet whenever someone messages your WhatsApp number using a bot flow.
- Collect WhatsApp Lead Details via Chatbot: Build an interactive WhatsApp chatbot that asks questions, validates answers, and saves lead data to a Google Spreadsheet automatically.
- Fetch Details from Google Spreadsheet: Let customers fetch order details, booking info, or any data from a Google Spreadsheet by sending a WhatsApp message.
- Send WhatsApp Messages from Google Spreadsheet: Send automated WhatsApp messages like payment reminders or order confirmations whenever you add or update data in a Google Spreadsheet.
AI Integration
- How to Train Your AI Chatbot: Train AI Assistant for Chatbot With FAQ, URL & File
- Enable AI Agent for Your WhatsApp Number: Enable and configure the AI Agent to auto-respond on WhatsApp
- Disable AI Agent During Business Hours: Configure business hours so AI only responds outside working hours
- Restrict AI on Specific Keywords: Block AI from responding to specific topics like pricing or discounts
- Auto-Assign Conversations to a Department: Route AI conversations to specific teams or departments automatically
- Intent Detection Actions: Trigger bots, assign teams, or switch AI agents based on detected intent
- Getting Started with AI Agents: Overview of WhatChimp's AI Agent — what it can do, how to set it up, and links to detailed guides for each step.
- Add Your OpenAI API Key: Get your OpenAI API key from platform.openai.com and configure it in WhatChimp to power the AI Agent.
- Connect WhatChimp with N8N AI Agent: Build advanced AI agents with N8N and connect them to WhatChimp for complex WhatsApp automation workflows.
- Set Up Intent Detection: Route conversations based on customer intent. Note: Intent Detection has been superseded by the Multi-Agent AI Workforce.
- Build a Multi-Agent AI Workforce with WhatChimp: Set up a team of specialised AI agents in WhatChimp, each with its own training and role, and route customer conversations to the right one automatically.
Integrations
- How to Integrate Shopify for WhatsApp Automation: Guide: How to Integrate Shopify for WhatsApp Automation
- How to Use Google Sheet Data in Chatbot Replies: Fetch data from Google Sheets and use it in chatbot replies on WhatsApp
- How to Send Automated WhatsApp Messages on WP Form Submission: Guide: How to Send Automated WhatsApp Messages on WP Form Submission
- How to Set Up SMS Marketing: A Complete Beginner's Guide: Step-by-step guide to setting up SMS marketing in WhatChimp, from connecting an SMS provider to sending and tracking your first campaign.
- WhatChimp's IP Addresses to Whitelist: The outbound IP addresses WhatChimp sends requests from. Add all of them to any external service that only allows whitelisted IPs.
WhatChimp APIs
- Getting Started with WhatChimp Developer API
- Sending WhatsApp Messages via WhatChimp API — Text vs Template Messages: The most common API mistake explained: when to use text messages vs template messages, how the 24-hour window works, and how to send template messages with variables.
- WhatChimp Messaging API — Quick Reference: Overview of all messaging endpoints — send messages, get conversations, track delivery, and list bot postbacks.
- Send Template Messages via WhatChimp API: How to create templates, use the API Console generator, send template messages with variables, and troubleshoot errors.
- Send Template Messages with Variables via WhatChimp API: How to personalize template messages with dynamic data like customer names, order numbers, and dates using template variables.
- Send Template Messages with Custom Variables via WhatChimp API: Send template messages with dynamic subscriber data via the API
- Send Template Messages with Quick Reply Buttons via WhatChimp API: Send templates with quick reply buttons that trigger bot flows
- Send 24-Hour Text Messages via WhatChimp API: How to send text messages within the WhatsApp 24-hour session window using the WhatChimp API.
- Get Conversation History via WhatChimp API: Retrieve the full message history with any subscriber — messages sent, received, timestamps, and delivery status.
- Get Bot Postback List via WhatChimp API: Retrieve all bot flow postback IDs — needed for binding Quick Reply buttons to bot flows.
- Get Message Delivery Status via WhatChimp API: Track whether your messages were sent, delivered, read, or failed.
- WhatChimp Subscriber Management API: Create, update, delete subscribers and manage labels programmatically
- Get Template List via WhatChimp API: Retrieve all WhatsApp templates with approval status and button types
- Trigger Bot Flow via WhatChimp API: Trigger bot flows for subscribers from external systems via API
- Manage Labels via WhatChimp API: List and create subscriber labels programmatically
- Catalog & Orders via WhatChimp API: Manage WhatsApp product catalogs and process orders via API
- WhatChimp Bot, Catalog & Utility APIs: Manage bot flows, templates, catalogs, and labels via API
Webhooks
- Webhook for Incoming and Outgoing Messages: Fire webhooks to your server in real time for every incoming and outgoing WhatsApp message
- Webhook on Keyword Trigger: Fire a webhook every time a customer triggers a specific keyword in your chatbot
- Webhook on Button Click: Fire a webhook when a customer clicks a specific button in your chatbot flow
- Webhook for Input Flow: Send collected chat responses from Input Flow to your webhook URL automatically
- Webhook for WhatsApp Flows: Fire a webhook every time a customer submits a WhatsApp Flow form
- Webhook for WhatsApp Catalog: Get notified via webhook when customers submit orders, checkout, or update orders in your WhatsApp catalog
Incoming Webhook Workflow
- What is Incoming Webhook Workflow: Connect third-party apps to WhatChimp and send WhatsApp messages automatically when events happen — no Zapier or Pabbly needed
- Create a Webhook Workflow: Step-by-step guide to creating a webhook workflow — set up callback URL, capture responses, and map JSON data to template variables
- Webhook Automation Settings: Add delays, conditional rules, and post-webhook actions like assigning conversations and labels
- Webhook Workflow Reporting: Monitor delivery stats, track errors, and troubleshoot webhook workflow performance
Team Management
- Introduction to Team Management: Learn how to manage team members and control access in your WhatChimp account
- How to Add and Manage Team Members: Add users, assign roles, control bot access, and export team data
- How to Set Up User Roles and Permissions: Create roles, configure platform access, and set module-level permissions
Account Settings
- How to Cancel Your WhatChimp Free Trial Subscription: Guide: How to Cancel Your WhatChimp Free Trial Subscription
- How to Delete Your Account (and Cancel Your Subscription Separately): Permanently delete your WhatChimp account. Important: this does not cancel your paid subscription, you must cancel that separately through Stripe.
- How to Restrict Login to Specific IP Addresses (IP Whitelisting): Lock your WhatChimp account so it can only be accessed from trusted IP addresses. Use IP Manager to whitelist IPs for login, direct login, and API.
FAQs and Troubleshooting
- Blocking Spam Messages in Whatchimp: Blocking Spam Messages in Whatchimp
- Common Error Codes and solutions: Common Error Codes and solutions
- Why Your Messages Aren’t Sending & How to Fix It: Why Your Messages Aren’t Sending & Guide: Fix It
- What if the Facebook “Start Verification” Button is Greyed Out or Not Visible?: Guide: What if the Facebook “Start Verification” Button is Greyed Out or Not Visible?
- Understanding Meta’s Frequency Capping for WhatsApp Marketing: Guide: Understanding Meta’s Frequency Capping for WhatsApp Marketing
- How to Migrate Your WhatsApp Business API from Your Current BSP to Whatchimp: Guide: How to Migrate Your WhatsApp Business API from Your Current BSP to Whatchimp
- How to Contact Meta Support for WhatsApp Business API Issues: Guide: How to Contact Meta Support for WhatsApp Business API Issues
- How to Create WordPress Users via HTTP API in Whatchimp: Guide: Create WordPress Users via HTTP API in Whatchimp
- Important Update on WhatsApp Business API Disruptions: A temporary issue on Meta's platform is intermittently affecting some WhatsApp Business API operations. Your data and templates are fully safe, Meta has acknowledged the issue in writing, and we are escalating it at the highest level for a fast, permanent fix.