Canais

Sete tipos de canal atrás de um só endpoint

A OmniMessage é um gateway para o qual traz os seus próprios canais. Liga remetentes que já são seus, e todos são endereçados, acompanhados e cobrados da mesma forma.

Obter uma chave de API Ler a documentação

Traga o seu próprio canal

Ligue uma vez, na consola ou por API

Um remetente ligado passa a ser um canal com um ID. Esse ID é o único valor específico do canal num pedido de envio.

O remetente é seu
O número, o bot ou a conta estão registados em seu nome junto do fornecedor. Sair da OmniMessage não significa deixar o seu remetente para trás.
Duas faturas separadas
A OmniMessage cobra uma taxa de gateway por mensagem de saída. O que a Meta, a Twilio ou outro fornecedor cobrarem pelo canal é-lhe faturado por eles.
Inicie sessão ou cole as credenciais
O WhatsApp, o Messenger e o Instagram são autorizados iniciando sessão com o Facebook na consola, e o TikTok iniciando sessão com o TikTok. O Telegram, o SMS e o SMS OTP exigem credenciais, na consola ou através da API, tal como pode acontecer com um número de WhatsApp que já esteja na Cloud API.
As credenciais são só de escrita
Os tokens, códigos e credenciais são transmitidos à camada de entrega quando liga um canal. Não são guardados pelo gateway e a API nunca os devolve.

POST /v1/channels

curl https://api.omnimessage.co/v1/channels \
  -H "Authorization: Bearer om_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "type": "whatsapp",
    "name": "Support line",
    "identifier": "+971800123456",
    "credentials": {
      "wab_account_id": "...",
      "phone_number_id": "...",
      "access_token": "..."
    }
  }'

201 Created

{
  "id": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "object": "channel",
  "mode": "live",
  "type": "whatsapp",
  "name": "Support line",
  "identifier": "+971800123456",
  "status": "active",
  "connection_status": "pending",
  "capabilities": ["text", "attachments", "template", "button", "list", "location", "contacts", "cta_url"],
  "created_at": "2026-10-01T08:00:00.000Z"
}

Para WhatsApp, Telegram, SMS e SMS OTP. Requer o âmbito channels:write. Subscreva channel.connected e channel.disconnected para acompanhar o estado da ligação.

WhatsApp Business

Envie a partir de um número de telefone da WhatsApp Business Platform (Cloud API) que seja seu. A OmniMessage encaminha as suas mensagens para a Cloud API e comunica-lhe os estados enviada, entregue, lida e falhada.

0,001 $ por mensagem de saída, ou um crédito de pacote

O que é necessário: Um início de sessão do Facebook com acesso ao seu portefólio empresarial da Meta. Continue com o Facebook na consola e o Meta Embedded Signup configura a conta do WhatsApp Business e o número. Um número que já esteja na Cloud API também pode ser ligado com os respetivos IDs e um token de acesso de utilizador do sistema, na consola ou através da API.
Credenciais de API: wab_account_idphone_number_idaccess_token
Tipo de canal: whatsapp
Identificador do remetente: Número de telefone do remetente no formato E.164, por exemplo +971800123456.
Destinatário (to): Número de telefone no formato E.164.
Tipos de mensagem: Texto Anexos Modelo Botões de resposta Lista Botão de URL Localização Contactos
Convém saber: Fora da janela de atendimento ao cliente de 24 horas, o WhatsApp só aceita mensagens de modelo aprovadas.
Liste os modelos aprovados de um canal com GET /v1/channels/:id/templates.
As taxas de conversação da Meta são cobradas pela Meta à sua conta do WhatsApp Business. São independentes da taxa do gateway.

SMS

Envie SMS a partir de um número de telefone da Twilio na sua própria conta Twilio. Utilize-o para notificações, lembretes e conversas bidirecionais, com as mensagens de entrada entregues no seu webhook.

0,0005 $ por mensagem de saída, ou um crédito de pacote

O que é necessário: Uma conta Twilio e um número de telefone ativado para mensagens.
Credenciais de API: account_sidphone_number_sidauth_token
Tipo de canal: sms
Identificador do remetente: Número de telefone do remetente no formato E.164.
Destinatário (to): Número de telefone no formato E.164.
Tipos de mensagem: Texto Anexos
Convém saber: Os anexos multimédia dependem do que o seu número e a rede de destino suportam.
As taxas dos operadores e da Twilio são cobradas pela Twilio à sua conta Twilio. São independentes da taxa do gateway.

SMS OTP

Um tipo de canal dedicado a códigos de verificação. Aceita apenas texto simples, pelo que um fluxo de início de sessão não consegue enviar outra coisa por engano.

0,0005 $ por mensagem de saída, ou um crédito de pacote

O que é necessário: Uma conta junto do seu fornecedor de SMS OTP e a respetiva chave de API.
Credenciais de API: api_key
Tipo de canal: sms_otp
Identificador do remetente: O ID de remetente ou o número registado junto do seu fornecedor.
Destinatário (to): Número de telefone no formato E.164.
Tipos de mensagem: Texto
Convém saber: Apenas texto. Os anexos e os tipos interativos são rejeitados com unsupported_message_type.
As taxas do fornecedor são cobradas pelo seu fornecedor. São independentes da taxa do gateway.

Envie através de um bot de Telegram criado por si. O token do bot é a única credencial, e as pessoas que escrevem ao bot chegam como eventos message.received.

0,0003 $ por mensagem de saída, ou um crédito de pacote

O que é necessário: Um bot de Telegram e o respetivo token, obtido junto do @BotFather. O nome de utilizador do bot é lido do Telegram quando faz a ligação.
Credenciais de API: access_token
Tipo de canal: telegram
Identificador do remetente: O nome de utilizador do bot, lido do Telegram com o token.
Destinatário (to): ID de chat do Telegram.
Tipos de mensagem: Texto Anexos Botões de resposta Localização Contactos Sondagem
Convém saber: Um bot só pode enviar mensagens a uma pessoa que tenha iniciado uma conversa com ele.
O ID de chat de cada pessoa é incluído nos eventos message.received que ela desencadeia.

Messenger

Responda às pessoas que contactam a sua Página do Facebook com texto, multimédia e botões de resposta. As mensagens de entrada chegam ao seu webhook com o ID do remetente de que precisa para responder.

0,0005 $ por mensagem de saída, ou um crédito de pacote

O que é necessário: Uma Página do Facebook e um início de sessão do Facebook com controlo total sobre ela.
Como ligar: Na consola, continue com o Facebook e escolha a Página a partir da qual pretende enviar.Não há credenciais para copiar neste tipo de canal, e este não pode ser criado com uma chave de API.
Tipo de canal: messenger
Identificador do remetente: A Página a partir da qual o canal envia.
Destinatário (to): ID de utilizador específico da Página.
Tipos de mensagem: Texto Anexos Botões de resposta
Convém saber: Os IDs específicos da Página são emitidos por Página. Recebe-os nos eventos message.received.
As políticas de mensagens da Meta aplicam-se ao que pode enviar e quando.

Instagram

Responda às mensagens diretas enviadas para a sua conta profissional do Instagram com texto, multimédia e botões de resposta, através do mesmo endpoint de todos os outros canais.

0,0005 $ por mensagem de saída, ou um crédito de pacote

O que é necessário: Uma conta profissional do Instagram associada a uma Página do Facebook que seja gerida por si.
Como ligar: Na consola, continue com o Facebook e escolha a Página a que a sua conta do Instagram está associada. Não é possível ligar Páginas sem uma conta profissional associada.Não há credenciais para copiar neste tipo de canal, e este não pode ser criado com uma chave de API.
Tipo de canal: instagram
Identificador do remetente: A conta do Instagram a partir da qual o canal envia.
Destinatário (to): ID de utilizador específico da Página.
Tipos de mensagem: Texto Anexos Botões de resposta
Convém saber: Os IDs específicos são emitidos por conta. Recebe-os nos eventos message.received.
As políticas de mensagens da Meta aplicam-se ao que pode enviar e quando.

TikTok

Responda às pessoas que escrevem para a sua conta empresarial do TikTok com texto, multimédia e botões de resposta, e acompanhe cada mensagem com os mesmos estados e webhooks.

0,0005 $ por mensagem de saída, ou um crédito de pacote

O que é necessário: Uma conta TikTok Business em que consiga iniciar sessão.
Como ligar: Na consola, continue com o TikTok e aprove o acesso às mensagens da sua conta empresarial.Não há credenciais para copiar neste tipo de canal, e este não pode ser criado com uma chave de API.
Tipo de canal: tiktok
Identificador do remetente: A conta do TikTok a partir da qual o canal envia.
Destinatário (to): O ID do remetente de um evento message.received.
Tipos de mensagem: Texto Anexos Botões de resposta
Convém saber: As políticas de mensagens do TikTok aplicam-se ao que pode enviar e quando.

Ligue o seu primeiro canal

Crie uma conta, adicione um remetente que já seja seu e envie através dele com o mesmo pedido que testou na sandbox.

Obter uma chave de API Ler a documentação

Ligue uma vez, na consola ou por API

O remetente é seu

Duas faturas separadas

Inicie sessão ou cole as credenciais

As credenciais são só de escrita

WhatsApp Business

SMS

SMS OTP

Telegram

Messenger

Instagram

TikTok

Ligue o seu primeiro canal