Overview

WhatsApp Business API covers messages, templates, media, mark-read. The Automize WhatsApp connector covers business messaging.

Regions: Global.
Plans: Free for first 1,000 conversations/month, then per-conversation.

Setting up the connection

Auth type: Bearer Token.

Meta Developers → WhatsApp Business API → create app.
Verify business via Meta Business Verification.
OAuth scope: whatsapp_business_messaging + management.
In Automize → Settings → Connectors → WhatsApp. Paste token + phone number ID.

Find your credentials at https://developers.facebook.com/docs/whatsapp/.

Rate limits

Tier-based – starts 1k unique recipients/24h, scales to unlimited.

Data model

WhatsApp Business:

    Phone Number ─── Conversations ─── Messages
                                     ├─ Templates (pre-approved)
                                     └─ Media

Available operations

6 operations available. Click any row to jump to its detail.

Operation	Category	What it does
Get media URL	General	Get the download URL for a WhatsApp media ID.
Get business profile	General	Get the WhatsApp Business profile settings.
Mark as read	General	Mark a WhatsApp message as read via the Business API.
Send media message	General	Send image, document, audio, or video via WhatsApp Business API.
Send text message	General	Send a text message to a phone number via WhatsApp Business API.
Send Template Message	General	Send a pre-approved template message

Operations

Get media URL

Get the download URL for a WhatsApp media ID.

Parameter	Required	Type	Description
Media ID `media_id`	Yes	text

Get business profile

Get the WhatsApp Business profile settings.

Parameter	Required	Type	Description
Phone number ID `phone_number_id`	Yes	text

Mark as read

Mark a WhatsApp message as read via the Business API.

Parameter	Required	Type
Phone number ID `phone_number_id`	Yes	text
Message ID `message_id`	Yes	text
Messaging Product `messaging_product`	No	text
Status `status`	No	text

Send media message

Send image, document, audio, or video via WhatsApp Business API.

Parameter	Required	Type
Phone number ID `phone_number_id`	Yes	text
To (intl format) `to`	Yes	text
Media type `type`	Yes	text
Media URL `link`	Yes	text
Caption `caption`	No	text

Send text message

Send a text message to a phone number via WhatsApp Business API.

Parameter	Required	Type
Phone number ID `phone_number_id`	Yes	text
To (intl format) `to`	Yes	text
Message text `text`	Yes	textarea

Tips

to (phone) + type (text, image, document, template).
Outside the 24h customer-initiated window → must use approved Template.

Send Template Message

Send a pre-approved template message

Parameter	Required	Type	Description
Phone Number Id `phone_number_id`	Yes	text