Skip to main content
POST
Conectar canal Meta WhatsApp

Visión general

Después de crear un canal del tipo META_WHATSAPP, tienes que conectarlo a un número de WhatsApp Business. Hay dos formas de hacerlo:
  • Desde el panel — Flujo guiado directamente en el Panel
  • Con el SDK + API — Integra el flujo de conexión en tu sistema

Conexión desde el panel

Es la forma más sencilla. Entra en el Panel, selecciona el canal que creaste y sigue el flujo de conexión guiado.

Conexión con el SDK + API

Usa este flujo cuando quieras que tu usuario conecte el canal desde tu propio sistema, sin necesidad de entrar al panel de . El flujo consta de 3 etapas:
1

Frontend — Iniciar la conexión con el SDK

En el frontend de tu aplicación, usa el SDK para iniciar el flujo de conexión. El SDK abrirá el proceso de autenticación con WhatsApp y devolverá la información necesaria.
La publicKey se puede exponer en el frontend. Más información en Autenticación.
2

Frontend → Backend — Enviar los datos

El SDK devuelve un objeto con la información de la conexión. Envía esos datos al backend de tu aplicación:
3

Backend — Finalizar la conexión mediante la API

En el backend, llama a la API de conexión enviando los datos recibidos del frontend:POST /v1/channels/{channelId}/connect
Esta llamada debe hacerse en el backend, ya que utiliza la Secret Key, que nunca debe exponerse en el frontend.

Flujo resumido

Una vez establecida la conexión, el canal está listo para enviar y recibir mensajes. Usa el channelId en los endpoints de mensajes libres y plantillas.

Autorizaciones

Authorization
string
header
requerido

Secret Key generada en el panel de Seguridad de Omni Z-API

Parámetros de ruta

channelId
string
requerido

ID del canal (obtenido con Crear canal)

Ejemplo:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

Cuerpo

application/json
wabaId
string
requerido

ID de la cuenta de WhatsApp Business

phoneId
string
requerido

ID del número de teléfono

code
string
requerido

Código de autorización generado por WhatsApp

coexistence
boolean
requerido

Indica si el número está en modo de coexistencia

Respuesta

Canal conectado correctamente

success
boolean

Indica si la operación se realizó correctamente