WhatChimp
Connect WhatChimp to send WhatsApp messages and templates, manage subscribers and labels, and run chatbot flows.
Two values go into PopMCP: the key shown under Your API key in WhatChimp's API Developer Console, and the phone_number_id of your connected WhatsApp number.
- Setup time
- 5 min
- Auth
- API credentials
- API base URL
- https://app.whatchimp.com/api/v1
Before you begin
- A WhatChimp account at app.whatchimp.com
- A WhatsApp Business number already connected through Connect Account, because the Phone Number ID does not exist until a number is linked
- Owner or admin access, since only those roles can open Settings, API Developer Console
Get your credentials
Open the API Developer Console
Sign in at app.whatchimp.com, click Settings in the left sidebar, and choose API Developer Console.
API Developer Console
Your API key, endpoint reference and endpoint generators.
| Endpoint | Method | Purpose |
|---|---|---|
| /api/v1/whatsapp/sendSend Message | GET, POST | Send a text message or an approved template |
| /api/v1/whatsapp/send/templateSend Template with Buttons | POST | Send a template whose quick reply buttons run a bot flow |
| /api/v1/whatsapp/get/conversationConversation | GET, POST | Read a subscriber thread |
| /api/v1/whatsapp/get/message-statusMessage Status | GET, POST | Check delivery status |
Every endpoint on this page takes apiToken and phone_number_id as query parameters.
Copy your API key
Find Your API key at the top of the console and click Copy. Click Generate API key only if no key exists yet or the current one has leaked.
API Developer Console
Your API key, endpoint reference and endpoint generators.
- Workspace
- Acme Support
- Connected numbers
- 1
- Key status
- Active
Read the Phone Number ID from the endpoint generator
Scroll to Send Message and open Generate API End-point: Send Template Message. Pick your number in the WhatsApp Account dropdown, then copy the digits after phone_number_id= in the generated URL.
Send Message
Pick an account and a template to build a ready-to-call URL.
- Acme Support
- +1 555 0100
- Phone Number ID
- 1098****4321
The digits after phone_number_id= are the value PopMCP asks for.
Paste both values into PopMCP
Open the WhatChimp connector in PopMCP, paste the key into API token and the digits into Phone Number ID, then save.
Connect in PopMCP
Open your workspace, choose WhatChimp in the marketplace, and fill in the connect dialog:
| Field | What to enter |
|---|---|
| API tokensecret | In WhatChimp open Dashboard → Settings → Developer / API (or the API section of your account) and copy your API token. It's sent as the apiToken query parameter and stored encrypted; used server-side only.Encrypted with AES-256-GCM on save and never shown again. |
| Phone Number IDtext | WhatChimp's internal ID for your connected WhatsApp number. Find it in your WhatChimp account settings next to the connected number. It's required by almost every endpoint and added to your calls automatically. (If you connect more than one number, pick the one you'll use most; the AI can target another by passing phone_number_id explicitly.) |
PopMCP verifies the credential against WhatChimp immediately. On success the connection flips to Verified and its MCP tools are provisioned.
Verify it worked
PopMCP marks WhatChimp as Connected and a read call such as fetching message status returns a JSON body with status 1 rather than an error object.
Troubleshooting
Every call comes back with status 0 and an authentication message
Why: The apiToken value is wrong, or the key was regenerated in the console after you saved it in PopMCP.
Fix: Reopen Settings, API Developer Console, copy the key under Your API key, and re-save it in PopMCP.
Subscriber limit has been exceeded
Why: Your WhatChimp plan's subscriber cap is full. This is a plan limit rather than an auth failure.
Fix: Upgrade the WhatChimp plan or delete inactive subscribers in Subscriber Manager.
Plain text messages are rejected
Why: WhatsApp only allows free-form text inside the 24-hour customer service window.
Fix: Send a Meta-approved template instead and check its approval state under Bot Manager, Message Template.
Calls fail with an unknown phone number
Why: The Phone Number ID belongs to a different WhatChimp account, or the number was disconnected.
Fix: Re-select the number in the console's Send Message generator and copy phone_number_id from the freshly built URL.
The WhatsApp Account dropdown is empty
Why: No WhatsApp Business number is linked to the account yet.
Fix: Open Connect Account and finish the Embedded Signup flow, then return to the console.