WhatsApp Business

Before you can build a WhatsApp widget, you need a Meta-approved WhatsApp Business number and a permanent access token. There are two paths — both end at the same four credentials Insighto needs.

Insighto uses Meta Cloud API only. Twilio-WhatsApp is not supported in this codebase.

The two paths

Path A — Direct via Meta

Best if you want full control and have engineering bandwidth.

1. Create a Meta Business Manager account at business.facebook.com.
2. Add a WhatsApp Business Account (WABA) to it.
3. In Meta for Developers, create an App and add the WhatsApp product.
4. Add a phone number — Meta sends a verification code via voice or SMS to confirm you control it.
5. Generate a System User with whatsapp_business_messaging and whatsapp_business_management permissions.
6. Generate a permanent access token for the system user (default tokens expire in 24 hours — use a permanent one).
7. Copy the app secret from your App's Basic Settings.

Path B — Via a BSP (Gupshup / 360dialog / similar)

Best if you want the BSP to handle Meta approvals, templates, and number provisioning for you.

1. Sign up with the BSP.
2. They handle Meta verification and assign you a number.
3. They give you credentials that map to the same four fields below.

The four credentials Insighto needs

Regardless of path:

Credential	Where it comes from
Phone number	The number you got approved — in E.164 form (e.g. +15551234567).
Phone number ID	The numeric ID Meta assigns the phone in the WhatsApp Manager.
WhatsApp Business Account ID	Top of the WhatsApp Manager.
Access token + app secret	System user permanent token, app secret from App settings.

Wire up the Meta webhook (manual)

You only need to do this once per Meta App.

In the Meta App dashboard, go to WhatsApp → Configuration → Webhook → Edit:

• Callback URL: https://api.insighto.ai/api/v1/webhook/whatsapp_webhook
• Verify token: insighto!2#$
• Subscribed fields: tick messages

Click Verify and save. Meta will hit Insighto's verify endpoint and confirm.

Paste into Insighto

You'll do this when you build the WhatsApp widget — that page walks you through it.

Where to next

• WhatsApp widget — build the widget that uses these credentials.
• Contacts — see WhatsApp users in your contact list.
• Conversations — view every WhatsApp chat.