WhatsApp

Connect MeepaGateway to WhatsApp

Connects via the Meta Cloud API webhook.

Prerequisites

• A Meta Developer account with WhatsApp Business API access
• A verified phone number and phone number ID
• A permanent system user access token

Configuration

In ~/.meepagateway/agents/<id>/agent.yaml:

connectors:
  - type: whatsapp
    access_token: "your-meta-access-token"
    phone_number_id: "your-phone-number-id"
    verify_token: "your-webhook-verify-token"
    webhook_port: 8444

access_token · string · required

Meta permanent access token for the WhatsApp Business API.

phone_number_id · string · required

WhatsApp phone number ID from the Meta Developer dashboard.

verify_token · string · required

Custom string used to verify webhook registration with Meta.

webhook_port · integer · default: "8444"

Local port for the inbound webhook listener.

Behavior

MeepaGateway starts an HTTP listener that handles both the Meta verification challenge (GET /) and message delivery (POST /). Configure this URL in the Meta Developer Portal as your webhook endpoint.

WhatsApp requires a publicly reachable HTTPS endpoint. Use a reverse proxy like Caddy to terminate TLS in front of the webhook port.