Skip to main content
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.