Saltar al contenido principal

¿Qué es un canal?

En Omni Z-API, un canal representa una conexión con WhatsApp a través de la API Oficial de Meta. Cada canal está vinculado a un número de teléfono de WhatsApp Business. Por ejemplo, al conectar el número +55 11 99999-9999 se crea un canal con un channelId único que se usa en todas las llamadas a la API. El channelId es el identificador único del canal y se utiliza en todas las llamadas a la API para enviar mensajes libres, plantillas, webhooks, etc.

Plataformas compatibles

El channelId y los endpoints de mensajes y webhooks funcionan igual para todos los tipos. Lo que cambia es el flujo de conexión y, en el caso de Meta Cloud API, la ventana de 24 horas.

Flujo para empezar

1

Genera tus credenciales

Si aún no lo has hecho, genera tu Public Key y tu Secret Key en Autenticación.
2

Crea el canal

Crea un canal nuevo desde el Panel o mediante la API con el endpoint Crear canal.
3

Conecta el canal

Utiliza el flujo de conexión con SDK + API, que se integra con la autenticación oficial de Meta.
4

Activa la suscripción (cuentas ENTERPRISE)

Los partners y revendedores con rol ENTERPRISE deben activar la suscripción del canal mediante Suscribir canal antes de empezar a usarlo.
5

Envía mensajes

Con el canal conectado, usa el channelId para enviar mensajes libres (dentro de la ventana de 24 h) o plantillas (fuera de la ventana).

Endpoints de canales

Crear canal

Crea un canal nuevo mediante la API.

Conectar canal

Conecta un canal con el SDK y la API de Meta.

Desconectar canal

Desconecta definitivamente un canal.

Gestión de la suscripción (ENTERPRISE)

Los endpoints de suscripción que aparecen a continuación requieren el rol ENTERPRISE en tu cuenta. Ponte en contacto con soporte para habilitarlo.

Suscribir canal

Activa la suscripción de un canal o añádelo a una suscripción existente.

Cancelar suscripción

Cancela la suscripción de un canal de forma programática.

Eliminar canal

Elimina permanentemente un canal mediante la API.