One channelId, five platforms
In you connect the channel once and use the same endpoints for all of them: send message, webhooks, all identical. What changes is the connection flow and what each platform accepts.
Meta
WhatsApp Official, Instagram and Messenger connect through Meta OAuth.
QR Code
WhatsApp Web connects by scanning the QR Code.
Telegram
Telegram connects with the bot token.
Capability matrix
Not everything works on every channel — the limit comes from the platform, not from our API.The content.type for each feature
⚠️ Instagram and stickers: the platform only accepts the heart sticker (
like_heart), not arbitrary stickers.¹ Instagram and pre-approved templates: the Graph API message_templates edge exists only on the Page node. Omni Z-API connects Instagram through Instagram Login (the IGUserForIGOnlyAPI node), which does not expose that edge. Details in Connect Instagram.🔍 Cell not confirmed in the platform’s official documentation.Conversation window: only WhatsApp Official has one
How we identify the contact
Therecipient.identifier field changes format depending on the channel:
Pre-approved templates: WhatsApp and Messenger
Two channels have templates that go through Meta approval, with different scopes:
Instagram, WhatsApp Web and Telegram have none. On Instagram that follows from the login model we use — see Connect Instagram.
Flows are WhatsApp Official only.
Omni Z-API’s Templates endpoints currently cover WhatsApp Official only. The Messenger Utility Template is being implemented.
Next steps
Channel lifecycle
Create, connect, subscribe, disconnect and delete.
Send your first message
The endpoint is the same for every channel.