How to Connect WhatsApp

Connect your ChatFlow chatbot to WhatsApp Business to automatically respond to customer messages on WhatsApp.

Prerequisites

• ChatFlow Account (Growth or Enterprise plan)
• Trained Chatbot - A chatbot with FAQs or documents
• Meta Business Account - A verified Facebook/Meta business account
• WhatsApp Business API Access - Through Meta Developer portal
• Business Phone Number - A number for WhatsApp Business

Required Plan: Growth or Enterprise

Quick Overview

The WhatsApp integration connects your ChatFlow chatbot to the WhatsApp Business API, enabling:

• Automatic AI responses to customer messages
• 24/7 availability on WhatsApp
• Seamless handoff to human agents (if enabled)
• Conversation tracking in your dashboard

Steps

Step 1: Open Integrations Tab

1. Go to Chatbots in the sidebar
2. Click on your chatbot
3. Click the Integrations tab
4. Find WhatsApp and click Add to WhatsApp

Step 2: Set Up Meta Business Account

If you don't have one already:

1. Go to business.facebook.com
2. Create a new business account
3. Verify your business information

Step 3: Create Meta Developer App

1. Go to developers.facebook.com
2. Click My Apps > Create App
3. Choose Other > Business
4. Enter app name and email
5. Create the app

Step 4: Add WhatsApp Product

1. In your Meta app dashboard
2. Find Add products to your app
3. Select WhatsApp > Set Up
4. Choose your Meta Business Account

Step 5: Generate Access Token

1. Go to Meta Business Suite > Business Settings
2. Navigate to Users > System Users
3. Create an Admin system user
4. Click Add Assets > Select your app
5. Click Generate New Token
6. Select permissions:
   • whatsapp_business_messaging
   • whatsapp_business_management
7. Set expiration to Never
8. Copy and save the token securely

Step 6: Configure Webhook

1. In WhatsApp Developer Dashboard, go to Configuration
2. Click Edit under Webhook
3. Copy Callback URL and Verification Token from ChatFlow
4. Paste into Meta dashboard
5. Click Verify and Save
6. Under Webhook Fields, subscribe to messages

Step 7: Complete ChatFlow Setup

Enter these details in the ChatFlow integration modal:

Field	Where to Find
Facebook App Secret	Meta App > Settings > Basic
WhatsApp Access Token	Generated in Step 5
Phone Number	WhatsApp API Setup
Phone Number ID	WhatsApp API Setup
WhatsApp Business Account ID	WhatsApp API Setup

Click Save to complete the integration.

Verify It's Working

1. Open WhatsApp on a different phone
2. Send a message to your connected WhatsApp Business number
3. Your chatbot should respond automatically
4. Check Conversations in ChatFlow to see the message

Troubleshooting

Messages Not Received

• Verify integration shows Active status
• Check webhook subscription for messages is enabled
• Ensure chatbot has training data (FAQs/documents)

Webhook Verification Failed

• Double-check Callback URL matches exactly
• Verify token matches (case-sensitive)
• Ensure Meta app is set to Live mode

Token Errors

• Generate a new permanent access token
• Update token in ChatFlow integration settings
• Ensure proper permissions are selected

Payment Issues

• WhatsApp requires a valid payment method
• First 1,000 conversations/month are free
• Add payment method in Meta Business Suite

Detailed Guide

For complete step-by-step instructions with screenshots, see the full WhatsApp Integration Guide.

Next Steps

• Connect Instagram - Add Instagram messaging
• Connect Messenger - Add Facebook Messenger
• Enable Human Support - Add live agent handoff