​

WhatsApp Agents Quickstart

• Set up your WhatsApp Business credentials
• Connect your WhatsApp number to Kupe AI
• Configure your webhook
• Attach an agent to handle messages

​

Prerequisites

• A Meta developer account
• Access to Meta for Developers
• A WhatsApp Business number (test number is fine)

Tip: If you’re new to the WhatsApp Cloud API, keep the Meta WhatsApp docs open for reference.

​

1. Get your WhatsApp credentials

• Phone Number ID
• Access Token
• WhatsApp Business Account ID

​

2. Connect your WhatsApp number to Kupe AI

1. Log in to Kupe AI
   Go to https://app.kupe.in and sign in.
2. Open WhatsApp
   Click WhatsApp in the sidebar.
3. Start the integration
   Click Integrate WhatsApp Number.
4. Fill in the form
   • Phone Number — Your WhatsApp Business number (with country code)
   • Phone Number ID — From Meta
   • Business Account ID — From Meta
   • Auth Token — Access token from Meta Apps
   • Label — Friendly name (e.g. “Customer Support Bot”)
   • Business Name — Your business name
   • Verify Token — Any string you choose; you’ll use the same value in the webhook step
5. Create
   Click Create to save the integration.

Security: Store your access token securely, rotate it when needed, and avoid sharing it in screenshots.

​

3. Configure the WhatsApp webhook

1. Go to Meta for Developers and select your app.
2. Open Use cases → Customize for the WhatsApp use case.
3. Under Configuration, open Webhook Configuration.
4. Set:
   • Callback URL — Use the webhook URL shown in the Kupe WhatsApp integration screen (e.g. https://api.kupe.in/... — check the dashboard for the exact URL).
   • Verify Token — The same value you entered in Kupe.
5. Click Verify and Save.
6. Enable the messages webhook field so your agent receives incoming messages.
7. Confirm in the Kupe WhatsApp page that the webhook status is active.

​

You’re all set

Tip: If messages don’t arrive, double-check the Verify Token, ensure the messages field is enabled in the webhook, and that your access token hasn’t expired.