WhatsApp Integration

Deploy your Chipp AI app to WhatsApp and let users interact with your AI directly through WhatsApp messaging.

Prerequisites

Before you begin, you'll need:

A Chipp application ready to deploy
A Meta Developer Account
A phone number to associate with your WhatsApp Business account

Setup Instructions

Create a Meta App

Click Create App
Select Business as the app type
Fill in your app details
Navigate to WhatsApp in the sidebar and click Quick Start
Select Get Started with the API and click Start using the API

Open WhatsApp Configuration in Chipp

Go to your Chipp application and click Share in the navigation. Find the Deploy to WhatsApp card and click Add Deployment.

Enter Your Meta Credentials

From the Meta Developer Platform, copy these values into the Chipp dialog:

Access Token: Your WhatsApp API access token (at least 32 characters)
Phone Number ID: A 15-digit ID found in WhatsApp API Setup
Business Account ID: A 15-16 digit ID found in your app settings

Configure the Webhook in Meta

Copy the Callback URL from the Chipp dialog
In the Meta Developer Platform, go to WhatsApp > Configuration
Paste the Callback URL into Meta's Callback URL field
Copy the Verify Token from Chipp and paste it into Meta's Verify Token field
Click Verify and Save

Subscribe to Messages

In the Meta Developer Platform webhook configuration:

Scroll down to find the Webhook fields section
Find messages and click Subscribe
This allows your app to receive incoming WhatsApp messages

Save Configuration

Back in Chipp, click Save Configuration to complete the setup.

Test Your Connection

Use the test WhatsApp number provided by Meta
Send a test message like "Hello"
Verify that your Chipp AI responds automatically

Going Live

When you're ready for production:

In the Meta Developer Platform, switch your app from Development to Live Mode
Complete the required business verification
Request the whatsapp_business_messaging permission
Add a production phone number

⚠️

Development mode limits you to messaging with registered test numbers only. You must go live to message any WhatsApp user.

Managing Your Connection

Disconnect WhatsApp

To disconnect your WhatsApp integration:

Go to Share > Deploy to WhatsApp
Click Add Deployment to open the dialog
Click Disconnect at the bottom

Update Credentials

If you need to update your Access Token or other credentials:

Open the WhatsApp configuration dialog
Enter the new values
Click Save Configuration

Best Practices

Response Time

WhatsApp expects responses within 24 hours of the user's last message. After that, you'll need to use approved message templates for proactive outreach.

Message Templates

For proactive messaging (reaching out first), create message templates in the Meta Business Suite and get them approved before use.

Rate Limits

Be aware of WhatsApp's rate limits:

Tier 1: 1,000 unique users per 24 hours
Tier 2: 10,000 unique users per 24 hours
Tier 3: 100,000 unique users per 24 hours

You can increase your tier by maintaining good quality ratings.

Troubleshooting

Messages Not Being Received

Verify the Callback URL is correct in Meta
Check that the messages webhook is subscribed
Ensure your app is in Live mode (or using test numbers in Development)
Verify all three credentials are valid (Access Token, Phone Number ID, Business Account ID)

Webhook Verification Failed

Double-check the Verify Token matches exactly
Ensure your Chipp app is published and running
Try re-copying the Callback URL from Chipp

AI Not Responding

Check your Chipp app is active
Verify your AI model is configured correctly
Check the chat history in Chipp's Chats page for any errors

Invalid Credentials Error

Access Token: Must be at least 32 characters
Phone Number ID: Must be exactly 15 digits
Business Account ID: Must be 15-16 digits

Pricing

WhatsApp Business API pricing is based on conversation types:

User-initiated conversations: Lower cost per conversation
Business-initiated conversations: Higher cost per conversation

Prices vary by country. Check Meta's pricing page for current rates.