Iris.Md logoIris.Md
← All channels

WhatsApp

stable

Cloud API · 1:1, groups, media, voice notes.

In
✓
Out
✓
Auth
Meta token
§ Required environment

Env vars

IRIS_WHATSAPP_TOKEN
Required

Permanent access token from Meta for Developers.

IRIS_WHATSAPP_PHONE_NUMBER_ID
Required

Phone number ID from the WhatsApp Business platform.

IRIS_WHATSAPP_VERIFY_TOKEN
Required

Verification token you choose and Meta calls back with.

§ Setup

Step by step

  1. 01

    Set up a Meta app

    Create a Meta app, add the WhatsApp product, and link a test phone number.

  2. 02

    Configure the webhook

    Point the WhatsApp webhook at https://your-host/api/public/whatsapp and subscribe to the messages field.

  3. 03

    Export credentials

    Save the access token, phone number ID, and verify token.

    export IRIS_WHATSAPP_TOKEN="EAA..."
export IRIS_WHATSAPP_PHONE_NUMBER_ID="..."
export IRIS_WHATSAPP_VERIFY_TOKEN="iris-verify"
  4. 04

    Enable the channel

    Iris.Md will start serving the webhook handler.

    iris channels enable whatsapp
§ Success

You're done when

  • ✓Webhook verification turns green in the Meta dashboard
  • ✓Test number can send and receive
  • ✓iris logs --follow shows whatsapp: message received