WhatsApp Business Integration
Introduction
Connect your ChatCrafterAI agent to WhatsApp Business to communicate with customers through their preferred messaging platform. This guide walks you through the complete setup process.Prerequisites
Before connecting WhatsApp to ChatCrafterAI, ensure you have:Meta Business Account
A Meta (Facebook) Business Account provides access to WhatsApp Business APIs and management tools. If you already manage Facebook Pages or Instagram Business accounts, you likely have this set up.WhatsApp Business Account Approval
WhatsApp requires businesses to verify their identity before accessing the Business API. This approval process typically takes 1-3 business days but can occasionally take longer for certain business types or countries.Dedicated Phone Number
You need a phone number exclusively for WhatsApp Business that isn’t currently used with regular WhatsApp. This number becomes your business identity on WhatsApp. It can be a mobile or landline number, but it must be able to receive SMS or voice calls for verification.API Credentials
Access tokens and phone number IDs from Meta’s developer platform enable ChatCrafterAI to send and receive messages on your behalf.Detailed Setup Process
Step 1: Create Meta Business Account
If you don’t already have a Meta Business Account:- Navigate to Meta Business Suite: Visit business.facebook.com in your web browser
- Sign Up or Log In: Use your personal Facebook account to create or access a business account
-
Create Business: Click “Create Account” and follow the prompts:
- Enter your business name
- Provide your business email
- Add business details (address, website)
- Verify business information
- Verify Your Business: Meta may require additional verification through documents (business license, tax ID, utility bill). Prepare these in advance to expedite approval.
Step 2: Create WhatsApp Business Account
With your Meta Business Account ready:- Access WhatsApp in Business Manager: Navigate to Business Settings > Accounts > WhatsApp Accounts
-
Add Phone Number:
- Click “Add” to create a new WhatsApp Business Account
- Select “Add phone number”
- Choose your country code
- Enter your dedicated business phone number
- Select verification method (SMS or voice call)
-
Verify Phone Number:
- Receive verification code via your selected method
- Enter the 6-digit code
- Confirm verification successful
-
Configure Business Profile:
- Upload your business logo or profile image
- Add business description (what your company does)
- Enter business category (e.g., E-commerce, Healthcare, Education)
- Add website URL
- Include business address (if applicable)
- Set business hours
-
Accept WhatsApp Terms:
- Review WhatsApp Business Terms of Service
- Accept Commerce Policy
- Confirm you understand messaging pricing structure
Step 3: Generate API Credentials
API credentials allow ChatCrafterAI to connect to your WhatsApp account:-
Access App Dashboard:
- In Meta Business Manager, go to Business Settings
- Navigate to “WhatsApp Accounts”
- Select your WhatsApp Business Account
- Click on “API Setup”
-
Get Phone Number ID:
- In the API Setup screen, you’ll see “Phone number ID”
- This is a long numeric ID (different from your phone number)
- Copy this ID and save it securely
-
Generate Access Token:
- In the same API Setup screen, find “Temporary access token”
- Click “Generate token”
- Copy the token immediately (it’s shown only once)
- For production use, you’ll eventually create a permanent token
-
Configure Webhooks:
- ChatCrafterAI needs to receive incoming messages
- In API Setup, locate “Webhook” section
- You’ll configure the webhook URL in ChatCrafterAI (next step)
- Keep this page open for reference
Step 4: Connect in ChatCrafterAI
Now connect your WhatsApp account to your ChatCrafterAI agent:-
Navigate to Integrations:
- Log into ChatCrafterAI dashboard
- Select your agent
- Click “Channels” in sidebar
- Choose “WhatsApp”
-
Enter Credentials:
- Paste your Phone Number ID in the designated field
- Paste your Access Token
- Verify both are copied exactly (no extra spaces)
-
Configure Webhook:
- ChatCrafterAI displays a unique webhook URL
- Copy this webhook URL
- Return to Meta’s API Setup page
- Paste the webhook URL in the “Callback URL” field
- Enter the verify token provided by ChatCrafterAI
- Click “Verify and Save”
-
Complete Connection:
- Return to ChatCrafterAI
- Click “Connect WhatsApp”
- Wait for verification (usually 5-10 seconds)
- Confirmation message appears when successful
-
Activate Channel:
- Toggle “WhatsApp Channel” to “Active”
- Your agent is now live on WhatsApp
Step 5: Test the Connection
Before announcing to customers, thoroughly test:-
Send Test Message:
- Open WhatsApp on your phone
- Message your business number
- Send a simple greeting: “Hello”
-
Verify Agent Response:
- Agent should respond within 1-2 seconds
- Response should match your agent’s training
- Check that conversation flows naturally
-
Test Quick Replies:
- If your agent uses button options, verify they appear correctly
- Tap buttons and confirm selections register properly
- Check that subsequent responses match button selections
-
Test Rich Media:
- Request information that triggers image responses
- Verify images load correctly
- Test document sending if configured
-
Verify in ChatCrafterAI Dashboard:
- Return to ChatCrafterAI
- Open “Conversations” view
- Confirm test conversation appears
- Review conversation history for accuracy
Step 6: Deploy to Production
Once testing confirms everything works:-
Upgrade to Permanent Token:
- Temporary tokens expire after 24 hours
- Create a permanent token in Meta Business Manager
- Update token in ChatCrafterAI settings
-
Set Business Hours:
- Configure when agent is active vs. when to send offline messages
- Set up away messages for outside business hours
-
Announce Availability:
- Add WhatsApp contact button to your website
- Include WhatsApp number in email signatures
- Promote on social media
- Add to customer communication templates
-
Monitor Initial Volume:
- Watch conversation volume closely in first days
- Identify common questions requiring better training
- Adjust agent responses based on real interactions
Available Features
WhatsApp’s rich feature set enhances your agent’s capabilities:Text Messages
Send messages of virtually unlimited length (though shorter is better for readability). WhatsApp automatically handles line breaks, formatting, and emoji.Quick Reply Buttons
Present up to 10 buttons for user selection. Each button can trigger different conversation flows. Example use cases:- “I want to: [Track Order] [Return Item] [Contact Support]”
- “Choose department: [Sales] [Technical] [Billing]“
List Messages
For longer option lists (up to 10 items), use list messages. Users tap a “Select” button to see options in a clean menu format. This works well for product categories, service types, or location selection.Images and Media
Send product images, infographics, diagrams, or visual instructions directly in conversation. Supports JPG, PNG, and GIF formats up to 5MB.Documents and PDFs
Share instruction manuals, invoices, shipping labels, or terms of service. WhatsApp supports PDF, DOC, DOCX, XLS, XLSX, and other common formats up to 100MB.Audio Messages
Send voice instructions or audio confirmations. Useful for pronunciation guides, personalized messages, or situations where audio is clearer than text.Location Sharing
Send store locations, delivery addresses, or service area maps. Customers can tap to open in their map app for navigation.Contact Cards
Share contact information in vCard format. Customers can save directly to their phone’s contacts. Useful for providing sales rep or support team details.Template Messages
Pre-approved messages for promotional content or important notifications. WhatsApp requires template approval before use, but ChatCrafterAI manages this process automatically.Message Templates
WhatsApp distinguishes between session messages and template messages:Session Messages
Free messages sent within 24 hours of a customer-initiated conversation. These can be dynamic and personalized based on conversation context. Most customer support conversations fall into this category.Template Messages
Required for initiating conversations or messaging after the 24-hour window. Templates must be pre-approved by WhatsApp and include:- Transactional Templates: Order confirmations, shipping updates, appointment reminders
- Marketing Templates: Promotional offers, product announcements (requires opt-in)
- Authentication Templates: One-time passwords, verification codes
Common Setup Mistakes and Solutions
Issue: “Invalid Credentials”
Symptoms: Error message when attempting to connect in ChatCrafterAI Solutions:- Copy access token again, ensuring no leading or trailing spaces
- Verify you’re using the correct Phone Number ID (not your actual phone number)
- Check token hasn’t expired (temporary tokens last 24 hours)
- Confirm you have admin access to the WhatsApp Business Account
- Try generating a new access token and reconnecting
Issue: “Webhook Not Verifying”
Symptoms: Meta’s webhook verification fails when you try to save Solutions:- Double-check ChatCrafterAI’s webhook URL is copied exactly
- Verify the verify token matches what ChatCrafterAI provided
- Ensure your ChatCrafterAI account is active and in good standing
- Try removing and re-adding the webhook
- Contact ChatCrafterAI support if issue persists
Issue: “Agent Not Responding”
Symptoms: Messages to WhatsApp number receive no response Solutions:- Confirm WhatsApp channel is activated in agent settings (toggle is “On”)
- Verify your agent has knowledge base content to respond with
- Check ChatCrafterAI conversation logs to see if messages are being received
- Test with simple messages like “Hello” to rule out complex query issues
- Ensure access token hasn’t expired and update if necessary
- Verify phone number in WhatsApp settings matches Phone Number ID used in ChatCrafterAI
Issue: “Messages Delayed”
Symptoms: Agent responses take 10+ seconds to arrive Solutions:- Check ChatCrafterAI system status (delays may be platform-wide)
- Verify your knowledge base isn’t excessively large (>10,000 documents can slow responses)
- Review agent complexity (highly complex flows may need optimization)
- Test during off-peak hours to rule out high-traffic slowdowns
Best Practices
Use Quick Reply Buttons Generously
WhatsApp users expect quick, tap-based interactions. Offer buttons for common paths rather than asking users to type. This speeds resolution and reduces errors from typos or unclear phrasing.Keep Messages Concise
While WhatsApp supports long messages, mobile users prefer brevity. Break long responses into multiple shorter messages. Use bullets for lists. Get to the point quickly.Leverage Templates for Consistency
Create templates for frequently sent information (business hours, return policies, popular products). This ensures consistent messaging and reduces agent training complexity.Respect the 24-Hour Window
Design conversation flows to resolve issues quickly. If a conversation requires follow-up beyond 24 hours, set clear expectations and ensure the value justifies any messaging costs.Test Across Devices
WhatsApp behaves slightly differently on iOS vs. Android. Test your agent on both platforms, paying special attention to button rendering, image display, and list message formatting.Monitor Analytics Regularly
Review conversation metrics weekly:- Response time (aim for under 5 seconds)
- Resolution rate (percentage of conversations resolved without escalation)
- Customer satisfaction (if using feedback prompts)
- Common questions (identify training opportunities)
Provide Clear Escalation Path
Always offer a way to reach human support. Include phrases like “If you need human assistance, reply ‘agent’” in appropriate contexts.Monitoring and Analytics
Message Delivery Tracking
ChatCrafterAI shows delivery status for each message:- Sent: Message left ChatCrafterAI
- Delivered: WhatsApp delivered to customer’s phone
- Read: Customer opened the message
- Failed: Delivery failed (invalid number, blocked, etc.)
Response Time Metrics
Track average time from customer message to agent response. WhatsApp users expect near-instant replies. Aim for under 5 seconds for optimal experience.Failed Message Analysis
Review failed messages to identify issues:- Invalid phone numbers requiring cleanup
- Blocked users who may need different outreach
- Format errors in rich media messages
- Template rejection reasons
Conversation Analytics
Monitor conversation patterns:- Peak usage hours (inform staffing for human escalation)
- Most common intents (prioritize knowledge base improvements)
- Drop-off points (where conversations end without resolution)
- Channel preferences (how WhatsApp performs vs. other channels)
Next Steps
Your WhatsApp integration is now live and serving customers. To maximize effectiveness:- Explore Cross-Channel Features: Learn how WhatsApp conversations integrate with other channels in Cross-Channel Conversation Management
- Optimize Response Quality: Regularly review conversations and enhance your knowledge base
- Scale Smartly: Monitor costs and optimize for the 24-hour free window
- Gather Feedback: Ask customers about their WhatsApp experience and iterate