TrochaiDocs

Conectar WhatsApp

Conecte su número de WhatsApp Business a Trochai mediante el registro integrado de Facebook o configuración manual.

Conectar WhatsApp

Para recibir y enviar mensajes de WhatsApp desde Trochai, necesita vincular su número de WhatsApp Business a la plataforma. Trochai se conecta directamente a la API de WhatsApp Business de Meta (Cloud API), lo que garantiza una conexión confiable y segura.

Solo los usuarios con rol de Administrador pueden configurar la conexión de WhatsApp. Si usted es un agente, solicite a su administrador que realice este paso.

Requisitos previos

Antes de conectar WhatsApp, asegúrese de tener listos los requisitos previos. Si aún no los ha preparado, consulte la guía completa de requisitos previos de WhatsApp.

En resumen, necesita:

  • Una cuenta de Meta Business Manager verificada en business.facebook.com.
  • Un número de teléfono que no esté registrado en WhatsApp ni en WhatsApp Business App.
  • Acceso a la cuenta de Facebook con rol de Administrador en su Business Manager.

Si actualmente usa WhatsApp Business App (la aplicación de teléfono) con el número que desea conectar, tenga en cuenta que al migrar a la API de WhatsApp Business, dejará de poder usar la aplicación con ese número. El número se administrará exclusivamente desde Trochai.

Método recomendado: Registro integrado con Facebook

El método más rápido y sencillo es el registro integrado (Embedded Signup). Con este método, Trochai configura todo automáticamente: cuenta de WhatsApp Business, número de teléfono y webhook.

Cómo funciona

Ir a Configuración > Canales

Desde la barra lateral, haga clic en Configuración y luego seleccione la pestaña Canales.

Agregar un canal

Haga clic en el botón Conectar Canal de WhatsApp. Será redirigido a la página de conexión donde verá dos opciones.

Seleccionar "Registro integrado" (recomendado)

Verá dos tarjetas:

  • Registro integrado (recomendado) -- Configuración automática con un clic.
  • Configuración manual -- Para usuarios avanzados que ya tienen credenciales de la API.

Haga clic en el botón azul Continuar con Facebook en la tarjeta de registro integrado.

Iniciar sesión en Facebook

Se abrirá una ventana emergente de Facebook. Inicie sesión con la cuenta de Facebook que administra su negocio.

Configurar su cuenta de WhatsApp Business

Siga los pasos que Facebook le presenta:

  1. Seleccionar o crear un Meta Business Manager: Si ya tiene uno, selecciónelo. Si no, cree uno nuevo ingresando el nombre de su negocio.
  2. Crear o seleccionar una cuenta de WhatsApp Business (WABA): Si ya tiene una WABA, puede seleccionarla. De lo contrario, se creará una nueva.
  3. Seleccionar o registrar un número de teléfono: Elija un número existente o registre uno nuevo. Deberá verificar el número con un código SMS o llamada telefónica.
  4. Otorgar permisos: Autorice a Trochai a administrar mensajes en nombre de su cuenta de WhatsApp Business.

Finalización automática

Una vez completado el flujo de Facebook, Trochai automáticamente:

  • Registra las credenciales de su cuenta (token de acceso, ID del número de teléfono, ID de WABA).
  • Configura el webhook para recibir mensajes entrantes.
  • Activa el canal.

Verá un mensaje de confirmación y será redirigido a la lista de canales, donde su nuevo canal aparecerá como Conectado.

Ventajas del registro integrado

  • No necesita crear manualmente una app de Facebook ni configurar tokens.
  • El webhook se configura automáticamente.
  • Puede crear una cuenta de Meta Business Manager durante el proceso si no tiene una.
  • Todo el flujo toma menos de 5 minutos.

Método alternativo: Configuración manual

Si ya cuenta con credenciales de la API de WhatsApp Business (por ejemplo, si tiene un desarrollador en su equipo o ya usó otro proveedor), puede configurar la conexión manualmente.

La configuración manual requiere conocimiento técnico. Si no está familiarizado con la API de WhatsApp Business de Meta, le recomendamos usar el registro integrado.

Requisitos para la configuración manual

Necesitará las siguientes credenciales de su app de Facebook:

  • Phone Number ID -- El identificador único de su número de teléfono en la API de Meta.
  • WABA ID -- El identificador de su cuenta de WhatsApp Business.
  • Access Token -- Un token de acceso permanente (System User Token) para la API de Meta.
  • Verify Token -- Un token personalizado que usted elige para verificar el webhook.

Pasos de configuración manual

Confirmar requisitos previos

En Configuración > Canales > Agregar Canal, seleccione Configuración manual. Verá un asistente de cuatro pasos. En el primer paso, confirme que cumple con los requisitos previos:

  • Cuenta de Meta Business Manager activa
  • Número de teléfono verificado en la API de WhatsApp Business
  • App de Facebook creada y configurada
  • Token de acceso permanente generado

Marque la casilla de confirmación y haga clic en Siguiente.

Ingresar credenciales

Ingrese las credenciales de su app de Facebook:

  • Phone Number ID: Lo encuentra en el panel de la API de WhatsApp Business en su app de Facebook.
  • WABA ID: Disponible en la misma sección del panel.
  • Access Token: Genere un token permanente de System User en la configuración de su Business Manager.
  • Verify Token: Elija un texto secreto cualquiera (por ejemplo, mi-token-secreto-2024).
  • Número visible (opcional): El número de teléfono formateado para mostrar en la interfaz (por ejemplo, +506 8888 8888).

Haga clic en Siguiente.

Configurar el webhook

Trochai le mostrará la URL del webhook y el token de verificación que debe configurar en su app de Facebook:

  1. Copie la URL del webhook haciendo clic en el icono de copiar.
  2. Copie el Verify Token.
  3. Abra su app de Facebook en developers.facebook.com.
  4. Vaya a WhatsApp > Configuración y pegue la URL del webhook y el token de verificación.
  5. Suscriba los campos: messages, message_deliveries, message_reads.

Haga clic en Siguiente cuando haya completado la configuración del webhook.

Probar la conexión

Haga clic en Probar conexión para verificar que las credenciales son correctas. Trochai intentará comunicarse con la API de Meta usando su token de acceso y Phone Number ID.

  • Si la prueba es exitosa, verá un icono verde con el mensaje "Conexión exitosa" y el número de teléfono asociado.
  • Si falla, revise sus credenciales e inténtelo de nuevo.

Haga clic en Finalizar configuración para guardar el canal.

Probar que funciona

Una vez conectado el canal, envíe un mensaje de WhatsApp al número que configuró desde otro teléfono. El mensaje debería aparecer en su bandeja de entrada de Trochai en pocos segundos.

Si no aparece, revise la sección de solución de problemas de WhatsApp.

Múltiples canales

Trochai soporta múltiples canales de WhatsApp en una misma organización. Esto es útil si su agencia maneja varios números (por ejemplo, uno por sucursal o uno por idioma).

Para agregar un segundo canal, repita el proceso desde Configuración > Canales y haga clic en Agregar canal.

En la bandeja de entrada, podrá filtrar las conversaciones por canal para separar los mensajes de cada número.

Administrar canales existentes

Desde Configuración > Canales puede:

  • Ver el estado de cada canal (conectado o inactivo).
  • Editar las credenciales si necesita actualizar un token de acceso.
  • Probar la conexión de un canal existente.
  • Eliminar un canal que ya no desea usar.

Siguientes pasos

Con WhatsApp conectado, ahora puede invitar a su equipo para que comiencen a atender conversaciones.

Invitar equipo →

On this page