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.
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": "..."
}
}'{
"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.
- Tipos de mensaje
- TextoArchivos adjuntosPlantillaBotones de respuestaListaBotón de URLUbicaciónContactos
- 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.
- Solo texto. Los archivos adjuntos y los tipos interactivos se rechazan con
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.receivedque 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.
- Tipos de mensaje
- TextoArchivos adjuntosBotones de respuesta
- 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.
- Los ID específicos de la página se emiten por página. Los recibes en los eventos
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.
- Tipos de mensaje
- TextoArchivos adjuntosBotones de respuesta
- 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.
- Los ID específicos se emiten por cuenta. Los recibes en los eventos
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. - Tipos de mensaje
- TextoArchivos adjuntosBotones de respuesta
- 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.