DocumentaciónLabiaEntrar
Todos los temas

Canales e integracionesConectar WhatsApp (API oficial)

Conectar WhatsApp (API oficial)

Vincula tu número por Meta en minutos; también hay un canal por código QR.

Configuración › Conexiones › WhatsApp API

Qué es

La conexión de tu número de WhatsApp con la API oficial de Meta. Es la vía recomendada: permite plantillas, campañas, varios números y no depende de un teléfono encendido. La primera conexión va incluida en tu plan.

Antes de empezar

  • Una cuenta de WhatsApp Business y ser administrador de su cuenta de Meta (portafolio comercial).
  • Un número que puedas verificar por SMS o llamada. Si ya lo usas en la app de WhatsApp Business, Meta te ofrece coexistencia: el número sigue funcionando en tu teléfono y, además, en Labia (ver más abajo).

Cómo conectar

  1. Entra a Conexiones › WhatsApp API y pulsa Conectar número.
  2. Se abre el asistente de Meta dentro del panel (si tu navegador lo bloquea, se abre en una ventana aparte). Inicia sesión con Facebook, elige o crea tu portafolio comercial y tu cuenta de WhatsApp Business, da de alta el número y verifícalo.
  3. Acepta los permisos de mensajería.
  4. Si tu cuenta de Meta administra varios números, Labia te pregunta cuál quieres conectar (puedes cambiarlo después desconectando y volviendo a conectar).
  5. Verás «WhatsApp conectado» con tu número. El sistema le pide a Meta los chats y contactos anteriores de ese número; van llegando en unos minutos.
  6. Asigna el canal a tu agente: en Agentes › tu agente › pestaña Canales de conversación. Sin esto, el chat te avisa «no hay un agente activo conectado a este canal» y el bot no responde.

Después de conectar

  • Cada número muestra su estado de salud real según Meta (calidad, cupo de envío, restricciones). Ver Salud del número.
  • Traer historial: vuelve a pedirle a Meta los chats anteriores si la primera sincronización falló (Meta solo lo acepta dentro de las 24 h del alta).
  • Desconectar libera el número y deja la conexión lista para otro. Dar de baja (solo conexiones adicionales) deja de facturarse y sus chats dejan de verse; no se puede deshacer.
  • Coexistencia: lo que escribas desde la app del teléfono aparece en el chat marcado como enviado desde la app, y los mensajes importados quedan marcados como historial.

Más de un número

Con el primero funcionando, aparece «¿Necesitas otro número?». Una conexión adicional tiene precio mensual (el primer pago se prorratea) y sirve para separar ventas de soporte, otra sucursal u otra marca: plantillas y campañas propias, chats separados, mismos agentes y CRM. Se habilita al verificar el pago. El cupo de conexiones lo ves en Plan.

Errores frecuentes

  • «No encontramos ninguna cuenta de WhatsApp Business»: el número no está dado de alta en la API dentro de Meta Business. Revísalo ahí y vuelve a intentar.
  • «No te queda cupo para conectar otro número»: agrega una conexión adicional.
  • «La conexión tardó demasiado y caducó»: vuelve a pulsar Conectar número.

Conectar por código QR (canal no oficial)

Existe una alternativa que no pasa por la API de Meta: vinculas el número escaneando un QR, como en WhatsApp Web. Se contrata como plan aparte en Integraciones › pestaña WhatsApp Web, y está pensada para integrar tus propios sistemas. Sus límites son importantes:

  • Solo mensajes de texto; sin plantillas ni campañas; sin la ventana de 24 h.
  • No está autorizado por Meta: hay riesgo de bloqueo del número si envías spam o mucho volumen. Úsalo con moderación y con números secundarios.
  • El teléfono debe quedar encendido y con internet; si la sesión se cae, hay que volver a escanear.
  • No lo usan los agentes de IA (para evitar bloqueos). Para que el bot atienda, conecta por la API oficial.

Instagram y Messenger

Se conectan desde la misma pantalla con «Conectar con Facebook» (necesitas ser administrador de la página) y «Conectar con Instagram» (cuenta profesional vinculada a una página de Facebook). Hoy estos dos canales aparecen como Próximamente para las cuentas nuevas; te avisamos cuando puedas activarlos.

Conecta el número y asigna el canal al agente en la misma sesión: es el olvido más común detrás de «el bot no responde».

Abrir conexiones · Relacionado: Salud del número · Clientes con nombre de usuario

Conectar WhatsApp (API oficial) · Documentación de Labia