> ## Documentation Index
> Fetch the complete documentation index at: https://meepa.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# WhatsApp

> Connect MeepaGateway to WhatsApp

Connects via the [Meta Cloud API](https://developers.facebook.com/docs/whatsapp/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`:

```yaml theme={null}
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
```

<ParamField path="access_token" type="string" required>
  Meta permanent access token for the WhatsApp Business API.
</ParamField>

<ParamField path="phone_number_id" type="string" required>
  WhatsApp phone number ID from the Meta Developer dashboard.
</ParamField>

<ParamField path="verify_token" type="string" required>
  Custom string used to verify webhook registration with Meta.
</ParamField>

<ParamField path="webhook_port" type="integer" default="8444">
  Local port for the inbound webhook listener.
</ParamField>

## 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.

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