Visão geral dos canais

O que cada canal suporta e como conectar cada um

​

Um channelId, cinco plataformas

No você conecta o canal uma vez e usa os mesmos endpoints para todos: enviar mensagem, webhooks, tudo igual. O que muda é o fluxo de conexão e o que cada plataforma aceita receber.

Meta

WhatsApp Oficial, Instagram e Messenger conectam pelo OAuth da Meta.

QR Code

WhatsApp Web conecta escaneando o QR Code.

Telegram

Telegram conecta com o token do bot.

​

Matriz de capacidades

Nem tudo funciona em todo canal — o limite é da plataforma, não da nossa API.

Recurso	WhatsApp Oficial	WhatsApp Web	Instagram	Messenger	Telegram
Texto	✅	✅	✅	✅	✅
Imagem	✅	✅	✅	✅	✅
Áudio	✅	✅	✅	✅	✅
Vídeo	✅	✅	✅	✅	✅
Documento	✅	✅	✅	✅	✅
Sticker	✅	✅	⚠️	✅	✅
Localização	✅	✅	❌	❌	✅
Contato	✅	✅	❌	❌	✅
Botões rápidos	✅	✅	✅	✅	✅
Botões de ação	✅	✅	✅	✅	✅
Template pré-aprovado	✅ WABA	❌	❌ ¹	✅ Utility	❌
Flows	✅	❌	❌	❌	❌
Reação (emoji)	✅	✅	✅	🔍	✅
Enquete	❌	✅	❌	❌	✅

​

O content.type de cada recurso

Recurso	content.type	Endpoint
Texto	TEXT	Enviar texto
Imagem	IMAGE	Enviar imagem
Áudio	AUDIO	Enviar áudio
Vídeo	VIDEO	Enviar vídeo
Sticker	STICKER	Enviar sticker
Localização	LOCATION	Enviar localização
Contato	CONTACT	Enviar contato
Botões rápidos	INTERACTIVE_BUTTON	Enviar texto com botões
Botões de ação	INTERACTIVE_ACTION	Enviar botões de ação
Template	TEMPLATE	Enviar template

⚠️ Instagram e sticker: a plataforma aceita apenas o sticker de coração (like_heart), não sticker arbitrário.

¹ Instagram e template pré-aprovado: o message_templates do Graph API existe apenas no node Page. O Omni Z-API conecta o Instagram via Instagram Login (node IGUserForIGOnlyAPI), que não expõe essa edge. Detalhes em Conectar Instagram.

🔍 Célula não confirmada na documentação oficial da plataforma.

​

Janela de conversa: só o WhatsApp Oficial tem

A regra da janela de 24 horas é exclusiva do WhatsApp Oficial. Nos outros canais você envia mensagem a qualquer momento, sem janela e sem template.

Canal	Janela	Como iniciar conversa fora dela
Meta WhatsApp	24 h, reiniciada a cada mensagem do cliente	Template aprovado
WhatsApp Web	não tem	envie direto
Instagram	24 h (7 dias com human agent tag)	Utility Template ou Marketing Messages
Messenger	24 h (7 dias com human agent tag)	Utility Template ou Marketing Messages
Telegram	não tem	envie direto

​

Como identificamos o contato

O campo recipient.identifier muda de formato conforme o canal:

Canal	Identificador	Exemplo
Meta WhatsApp	telefone com DDI	5511999999999
WhatsApp Web	telefone com DDI	5511999999999
Instagram	usuário	@sua_loja
Messenger	página do Facebook	ID da página
Telegram	usuário do bot	@seu_bot

​

Template pré-aprovado: WhatsApp e Messenger

Dois canais têm template que passa por aprovação da Meta, com escopos diferentes:

Canal	Recurso	Escopo	Categorias
WhatsApp Oficial	message template	WABA	UTILITY, MARKETING, AUTHENTICATION
Messenger	Utility Template	página	só UTILITY

Instagram, WhatsApp Web e Telegram não têm. No Instagram isso é consequência do modelo de login que usamos — veja Conectar Instagram.

Flows são exclusivos do WhatsApp Oficial.

Os endpoints de Templates do Omni Z-API cobrem hoje apenas o WhatsApp Oficial. O Utility Template do Messenger está em implementação.

​

Próximos passos

Ciclo de vida do canal

Criar, conectar, assinar, desconectar e remover.

Enviar sua primeira mensagem

O endpoint é o mesmo para todos os canais.