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.

Credenciales del tenant

Al crear el tenant con POST /partner/tenants recibís:

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

Esas credenciales son las que tu cliente (o vos en su nombre) usa para entrar al panel y conectar el canal. La contraseña temporal solo se muestra una vez — guardala o reenviásela al cliente.

Canales disponibles

Canal	Modo	Qué necesita el tenant
WhatsApp (API oficial)	Meta Cloud API	Un número de WhatsApp Business y acceso a Meta Business
WhatsApp (WEB_QR)	Escaneo de QR	Un teléfono con WhatsApp para escanear el QR
Instagram	Meta	Cuenta de Instagram conectada a una página de Facebook
Messenger	Meta	Página de Facebook
Webchat	Widget embebible	Pegar un snippet en el sitio del cliente

Flujo de conexión

Iniciá 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.
Cambiá la contraseña temporal en el primer ingreso.
Andá a Integraciones / Canales.
Elegí el canal y seguí el asistente:
- WhatsApp API oficial / Instagram / Messenger: autorizás con Meta Business y seleccionás el número o página.
- WhatsApp WEB_QR: escaneás el QR con el teléfono del cliente.
- Webchat: copiás el snippet del widget al sitio del cliente.
Verificá por API que el canal quedó activo:

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.

Qué puede automatizar tu plataforma

✅ 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)