Ir al contenido

Canales

Siete tipos de canal detrás de un solo endpoint

OmniMessage es una pasarela a la que traes tus propios canales. Conectas los remitentes que ya tienes, y todos se direccionan, se rastrean y se facturan de la misma forma.

Trae tus propios canales

Conecta una sola vez, en la consola o por API

Un remitente conectado se convierte en un canal con un ID. Ese ID es el único valor específico del canal en una solicitud de envío.

  • El remitente es tuyo

    El número, el bot o la cuenta están registrados a tu nombre con el proveedor. Dejar OmniMessage no significa dejar atrás tu remitente.

  • Dos facturas separadas

    OmniMessage cobra una tarifa de pasarela por cada mensaje saliente. Lo que Meta, Twilio u otro proveedor cobren por el canal te lo facturan ellos directamente.

  • Inicia sesión o pega las credenciales

    WhatsApp, Messenger e Instagram se autorizan iniciando sesión con Facebook en la consola, y TikTok iniciando sesión con TikTok. Telegram, SMS y SMS OTP usan credenciales, en la consola o a través de la API, y también puede hacerlo un número de WhatsApp que ya esté en la Cloud API.

  • Las credenciales son de solo escritura

    Los tokens, códigos y credenciales se pasan a la capa de entrega cuando conectas un canal. La pasarela no los almacena y la API nunca los devuelve.

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 y SMS OTP. Requiere el ámbito channels:write. Suscríbete a channel.connected y channel.disconnected para seguir el estado de la conexión.

WhatsApp Business

Envía desde un número de teléfono de WhatsApp Business Platform (Cloud API) que sea tuyo. OmniMessage reenvía tus mensajes a la Cloud API y te informa de los estados enviado, entregado, leído y fallido.

0,001 $ por mensaje saliente, o un crédito de paquete

Qué necesitas
Un inicio de sesión de Facebook con acceso a tu portfolio empresarial de Meta. Elige «Continuar con Facebook» en la consola y Meta Embedded Signup configura la cuenta de WhatsApp Business y el número. Un número que ya esté en la Cloud API también se puede conectar con sus ID y un token de acceso de usuario del sistema, en la consola o a través de la API.
Credenciales de API
wab_account_idphone_number_idaccess_token
Tipo de canal
whatsapp
Identificador del remitente
Número de teléfono del remitente en formato E.164, por ejemplo +971800123456.
Destinatario (to)
Número de teléfono en formato E.164.
Conviene saber
  • Fuera de la ventana de atención al cliente de 24 horas, WhatsApp solo acepta mensajes de plantilla aprobados.
  • Consulta las plantillas aprobadas de un canal con GET /v1/channels/:id/templates.
  • Las tarifas por conversación de Meta las cobra Meta a tu cuenta de WhatsApp Business. Son independientes de la tarifa de pasarela.

SMS

Envía SMS desde un número de teléfono de Twilio de tu propia cuenta de Twilio. Úsalo para notificaciones, recordatorios y conversaciones bidireccionales; los mensajes entrantes llegan a tu webhook.

0,0005 $ por mensaje saliente, o un crédito de paquete

Qué necesitas
Una cuenta de Twilio y un número de teléfono habilitado para mensajería.
Credenciales de API
account_sidphone_number_sidauth_token
Tipo de canal
sms
Identificador del remitente
Número de teléfono del remitente en formato E.164.
Destinatario (to)
Número de teléfono en formato E.164.
Tipos de mensaje
TextoArchivos adjuntos
Conviene saber
  • Los archivos multimedia adjuntos dependen de lo que admitan tu número y la red de destino.
  • Las tarifas del operador y de Twilio las cobra Twilio a tu cuenta de Twilio. Son independientes de la tarifa de pasarela.

SMS OTP

Un tipo de canal dedicado a los códigos de verificación. Solo acepta texto sin formato, de modo que un flujo de inicio de sesión no puede enviar otra cosa por él por accidente.

0,0005 $ por mensaje saliente, o un crédito de paquete

Qué necesitas
Una cuenta con tu proveedor de SMS OTP y su clave de API.
Credenciales de API
api_key
Tipo de canal
sms_otp
Identificador del remitente
El ID de remitente o el número registrado con tu proveedor.
Destinatario (to)
Número de teléfono en formato E.164.
Tipos de mensaje
Texto
Conviene saber
  • Solo texto. Los archivos adjuntos y los tipos interactivos se rechazan con unsupported_message_type.
  • Las tarifas del proveedor las cobra tu proveedor. Son independientes de la tarifa de pasarela.

Telegram

Envía a través de un bot de Telegram que hayas creado. El token del bot es la única credencial, y las personas que escriben al bot llegan como eventos message.received.

0,0003 $ por mensaje saliente, o un crédito de paquete

Qué necesitas
Un bot de Telegram y su token de @BotFather. El nombre de usuario del bot se lee de Telegram al conectar.
Credenciales de API
access_token
Tipo de canal
telegram
Identificador del remitente
El nombre de usuario del bot, leído de Telegram con el token.
Destinatario (to)
ID de chat de Telegram.
Conviene saber
  • Un bot solo puede escribir a una persona que haya iniciado una conversación con él.
  • El ID de chat de cada persona se incluye en los eventos message.received que genera.

Messenger

Responde a las personas que contactan con tu página de Facebook con texto, contenido multimedia y botones de respuesta. Los mensajes entrantes llegan a tu webhook con el ID de remitente que necesitas para contestar.

0,0005 $ por mensaje saliente, o un crédito de paquete

Qué necesitas
Una página de Facebook y un inicio de sesión de Facebook con control total sobre ella.
Cómo se conecta
En la consola, continúa con Facebook y elige la página desde la que quieres enviar.Este tipo de canal no tiene credenciales que copiar y no se puede crear con una clave de API.
Tipo de canal
messenger
Identificador del remitente
La página desde la que envía el canal.
Destinatario (to)
ID de usuario específico de la página.
Conviene saber
  • Los ID específicos de la página se emiten por página. Los recibes en los eventos message.received.
  • Las políticas de mensajería de Meta determinan qué puedes enviar y cuándo.

Instagram

Responde a los mensajes directos enviados a tu cuenta profesional de Instagram con texto, contenido multimedia y botones de respuesta, a través del mismo endpoint que el resto de los canales.

0,0005 $ por mensaje saliente, o un crédito de paquete

Qué necesitas
Una cuenta profesional de Instagram vinculada a una página de Facebook que administres.
Cómo se conecta
En la consola, continúa con Facebook y elige la página a la que está vinculada tu cuenta de Instagram. Las páginas sin una cuenta profesional vinculada no se pueden conectar.Este tipo de canal no tiene credenciales que copiar y no se puede crear con una clave de API.
Tipo de canal
instagram
Identificador del remitente
La cuenta de Instagram desde la que envía el canal.
Destinatario (to)
ID de usuario específico de la página.
Conviene saber
  • Los ID específicos se emiten por cuenta. Los recibes en los eventos message.received.
  • Las políticas de mensajería de Meta determinan qué puedes enviar y cuándo.

TikTok

Responde a las personas que escriben a tu cuenta de empresa de TikTok con texto, contenido multimedia y botones de respuesta, y sigue cada mensaje con los mismos estados y webhooks.

0,0005 $ por mensaje saliente, o un crédito de paquete

Qué necesitas
Una cuenta de TikTok Business en la que puedas iniciar sesión.
Cómo se conecta
En la consola, continúa con TikTok y aprueba el acceso a los mensajes de tu cuenta de empresa.Este tipo de canal no tiene credenciales que copiar y no se puede crear con una clave de API.
Tipo de canal
tiktok
Identificador del remitente
La cuenta de TikTok desde la que envía el canal.
Destinatario (to)
El ID de remitente de un evento message.received.
Conviene saber
  • Las políticas de mensajería de TikTok determinan qué puedes enviar y cuándo.

Conecta tu primer canal

Crea una cuenta, añade un remitente que ya tengas y envía a través de él con la misma solicitud que probaste en el sandbox.