Send a message

Fetch the customer channel token, then send the message with the request body for that channel type. Use the HookMyApp channel ID (ch_...) when you fetch the token. Then send through the gateway endpoint:

POST /meta/v22.0/{PHONE_NUMBER_ID}/messages for WhatsApp
POST /meta/v25.0/{INSTAGRAM_ACCOUNT_ID}/messages for Instagram

For WhatsApp, use to for the recipient phone number in international format. For Instagram, use the inbound sender.id as the outbound recipient.id. Supported customer-channel sends:

WhatsApp text, media, location, contacts, interactive messages, templates, and reactions
Instagram text, media, quick replies, cards, reactions, and sender actions

Authentication

Use an hmok_ org API key to fetch the channel token:

curl https://api.hookmyapp.com/meta/channels/{channelId}/token \
  -H "Authorization: Bearer hmok_..." \
  -H "X-Workspace-Id: ws_..."

Use the returned hmat_ channel token to send the message. Do not use an hmok_ API key for the send call.

Authorization: Bearer hmat_...

Provider endpoints

Channel type	Endpoint	Path value
WhatsApp	`POST /meta/v22.0/{PHONE_NUMBER_ID}/messages`	`WHATSAPP_PHONE_NUMBER_ID`
Instagram	`POST /meta/v25.0/{INSTAGRAM_ACCOUNT_ID}/messages`	`INSTAGRAM_ACCOUNT_ID`

Use the provider-specific API page when you want the interactive request builder:

WhatsApp example

curl -X POST "https://gateway.hookmyapp.com/meta/v22.0/{PHONE_NUMBER_ID}/messages" \
  -H "Authorization: Bearer hmat_..." \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "15551234567",
    "type": "text",
    "text": { "body": "Hello! Your order #12345 has been shipped." }
  }'

Successful WhatsApp sends return Meta’s message identifier:

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "15551234567",
      "wa_id": "15551234567"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgNMTU1NTE0OTU5Nzg1FQIAERgSMDhGRjdBMDEyOTcxQzFFQkFBAA=="
    }
  ]
}

Instagram example

curl -X POST "https://gateway.hookmyapp.com/meta/v25.0/{INSTAGRAM_ACCOUNT_ID}/messages" \
  -H "Authorization: Bearer hmat_..." \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": { "id": "17841400000000001" },
    "message": { "text": "Hello from HookMyApp" }
  }'

Next steps

API overview: Fetch channel tokens and manage customer channels.
WhatsApp text guide: WhatsApp text request shape.
Instagram text guide: Instagram text request shape.

Customer Messaging

API Reference

Authentication

Provider endpoints

WhatsApp example

Instagram example

Next steps

​Authentication

​Provider endpoints

​WhatsApp example

​Instagram example

​Next steps

Authentication

Provider endpoints

WhatsApp example

Instagram example

Next steps