Meta API quickstart

This quickstart verifies your credentials and sends a WhatsApp template message through the Eazybe Meta API.

Prerequisites

An Eazybe organization with a connected WhatsApp Business Account
An Eazybe bearer token — this is your organization’s Access code in Eazybe Workspace → Staff → Organization Details. See how to find your bearer token.
An approved WhatsApp message template
A recipient who has opted in to receive messages

Set your API host and token

Set the Eazybe staging API v2 base URL and your bearer token.

export EAZYBE_API_HOST="https://cerberus.eazybe.com/staging/api/v2"
export EAZYBE_TOKEN="YOUR_EAZYBE_TOKEN"

Keep both values in server-side environment variables or a secrets manager.

Discover your WABA and phone-number IDs

curl "$EAZYBE_API_HOST/meta/phone-numbers" \
  -H "Authorization: Bearer $EAZYBE_TOKEN"

{
  "status": true,
  "status_code": 200,
  "message": "Meta phone numbers fetched successfully",
  "data": {
    "total_wabas": 1,
    "successful": 1,
    "failed": 0,
    "accounts": [
      {
        "waba_id": "1029384756",
        "status": true,
        "phone_numbers": [
          {
            "id": "5647382910",
            "display_phone_number": "+91 99000 00000",
            "verified_name": "Acme Support",
            "quality_rating": "GREEN",
            "code_verification_status": "VERIFIED",
            "status": "CONNECTED"
          }
        ]
      }
    ]
  }
}

Save:

accounts[].waba_id as your wabaId
accounts[].phone_numbers[].id as your phoneNumberId

A WABA with status: false needs to be reconnected. Other connected WABAs can still be used.

Confirm that your template is approved

List all templates connected to the WABA:

curl "$EAZYBE_API_HOST/meta/wabas/1029384756/templates/all" \
  -H "Authorization: Bearer $EAZYBE_TOKEN"

Find the template you want to send and confirm that its status is APPROVED.

Send the template

Replace the path ID, recipient, template name, language, and parameters with your values.

curl -X POST \
  "$EAZYBE_API_HOST/meta/phone-numbers/5647382910/messages/template" \
  -H "Authorization: Bearer $EAZYBE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "919900000001",
    "template": {
      "name": "order_update",
      "language": {
        "code": "en"
      },
      "components": [
        {
          "type": "body",
          "parameters": [
            {
              "type": "text",
              "text": "Ravi"
            }
          ]
        }
      ]
    }
  }'

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "919900000001",
      "wa_id": "919900000001"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgMOTE5OTAwMDAwMDAxFQIAERgS..."
    }
  ]
}

Store messages[0].id. You will use this wamid for read receipts, reactions, typing indicators, and delivery reconciliation.

Subscribe to inbound events

Subscribe the WABA to your callback:

curl -X POST \
  "$EAZYBE_API_HOST/meta/wabas/1029384756/webhook-subscriptions" \
  -H "Authorization: Bearer $EAZYBE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "overrideCallbackUri": "https://your-app.com/webhooks/whatsapp",
    "verifyToken": "YOUR_SHARED_VERIFY_TOKEN"
  }'

Your callback must answer Meta’s verification request with the supplied hub.challenge, then process standard WhatsApp webhook payloads.

Overview

API Documentation

Meta API Documentation

Webhooks

Meta API quickstart

Prerequisites

Next steps

Send messages

Manage templates

​Prerequisites

​Next steps

Send messages

Manage templates

Prerequisites

Next steps