WhatsApp Business Integration

WhatsApp Business integration allows you to send and receive messages, media, and interactive content through WhatsApp’s official Business API. This integration is perfect for customer support, sales, and marketing automation.

Getting Started

Prerequisites

  • WhatsApp Business Account
  • Facebook Business Manager account
  • Verified phone number
  • Business verification (for some features)

Setup Process

1

Create WhatsApp Business Account

  1. Go to business.whatsapp.com
  2. Sign up with your business information
  3. Verify your business details
  4. Complete the onboarding process
2

Connect to Kaie

  1. Navigate to Integrations in your Kaie dashboard
  2. Select “WhatsApp Business” from the available integrations
  3. Click “Connect Account”
  4. Authorize Kaie to access your WhatsApp Business account
3

Configure Settings

  1. Set your business display name
  2. Upload your business logo
  3. Configure message templates
  4. Set up webhook endpoints

Message Types

Text Messages

Send simple text messages to customers.

Media Messages

Send images, videos, documents, and audio files.

Interactive Messages

Send buttons, lists, and quick replies for better user engagement.

Template Messages

Send pre-approved message templates for marketing and notifications.

Webhook Configuration

Setting Up Webhooks

Configure webhooks to receive incoming messages and status updates.

Webhook Payload Structure

Understand the structure of incoming webhook data.
{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "PHONE_NUMBER",
              "phone_number_id": "PHONE_NUMBER_ID"
            },
            "messages": [
              {
                "id": "MESSAGE_ID",
                "from": "CUSTOMER_PHONE_NUMBER",
                "timestamp": "TIMESTAMP",
                "text": {
                  "body": "MESSAGE_TEXT"
                },
                "type": "text"
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}

Workflow Integration

Message Triggers

Set up workflows that respond to incoming WhatsApp messages.

Automated Responses

Configure AI-powered responses for customer inquiries.

Advanced Features

Rich Media Support

Send engaging content with images, videos, and documents.

Interactive Elements

Create engaging conversations with interactive components.

Message Status Tracking

Monitor message delivery and engagement.

Best Practices

Message Guidelines

Follow WhatsApp’s messaging policies and best practices.

Performance Optimization

Optimize your WhatsApp integration for better performance.

Troubleshooting

Common Issues

Resolve common WhatsApp integration problems.

Error Codes

Understand common error codes and their solutions.
Error CodeDescriptionSolution
100Invalid parameterCheck message format
131000Message undeliverableVerify phone number
131021Re-engagement messageUse template message
131026Unsupported message typeUse supported format

Next Steps

Explore more integration options: