Ir al contenido

Conectar un canal

La conexión de canales no se hace por API todavía. Se realiza desde el panel del tenant, con las credenciales de admin que recibiste al crear el tenant. Esta página documenta ese flujo de forma honesta para que sepas exactamente qué automatizar por API y qué queda manual.

Al crear el tenant con POST /partner/tenants recibes:

{
"admin_email": "admin@acme.com",
"admin_temp_password": "Xk9mP2..."
}

Esas credenciales son las que tu cliente (o tú en su nombre) usa para entrar al panel y conectar el canal. La contraseña temporal solo se muestra una vez — guárdala o reenvíasela al cliente.

CanalModoQué necesita el tenant
WhatsApp (API oficial)Meta Cloud APIUn número de WhatsApp Business y acceso a Meta Business
WhatsApp (WEB_QR)Escaneo de QRUn teléfono con WhatsApp para escanear el QR
InstagramMetaCuenta de Instagram conectada a una página de Facebook
MessengerMetaPágina de Facebook
WebchatWidget embebiblePegar un snippet en el sitio del cliente
  1. Inicia sesión en el panel del tenant, en su propio subdominio: https://{subdomain}.overtaker.online (el subdomain lo devolvió POST /partner/tenants), con el admin_email y admin_temp_password. Cada tenant solo puede iniciar sesión desde su subdominio asignado.
  2. Cambia la contraseña temporal en el primer ingreso.
  3. Ve a Integraciones / Canales.
  4. Elige el canal y sigue el asistente:
    • WhatsApp API oficial / Instagram / Messenger: autorizas con Meta Business y seleccionas el número o página.
    • WhatsApp WEB_QR: escaneas el QR con el teléfono del cliente.
    • Webchat: copias el snippet del widget al sitio del cliente.
  5. Verifica por API que el canal quedó activo:
Ventana de terminal
curl https://api.overtaker.online/api/v1/partner/tenants/{tenant_id}/health \
-H "Authorization: Bearer sk_live_xxx"

Cuando channel_connected pasa a true y ready es true, el agente ya atiende a los clientes finales por ese canal.

  • ✅ Crear el tenant y sus credenciales de admin
  • ✅ Configurar el agente y cargar conocimiento
  • ✅ Detectar cuándo el canal quedó conectado (polling a /health o esperando el primer evento message.received)
  • ❌ Conectar el canal en sí (requiere el flujo manual del panel)