Skip to main content
LibredeskLibredesk
Búsqueda

WhatsApp

Conecta un número de WhatsApp mediante la API Cloud de Meta.

Abhinav Raut · Última actualización

Nota: WhatsApp sigue en desarrollo y aún no está disponible en una versión publicada.

libredesk se conecta directamente a la API de WhatsApp Cloud de Meta. Debes crear una aplicación de Meta, registrar un número empresarial y añadir sus credenciales a una bandeja de WhatsApp.

Requisitos

  • Cuenta de Facebook con acceso a un portafolio empresarial.
  • Número que pueda recibir SMS o llamadas y que no esté registrado en la aplicación móvil de WhatsApp.
  • URL HTTPS pública para libredesk y una política de privacidad pública.

Crear la aplicación

  1. En Meta for Developers, crea una aplicación y elige Conectar con clientes mediante WhatsApp.
  2. Asocia el portafolio empresarial y abre la configuración de producción.
  3. Registra el número, completa el perfil empresarial y verifica el código recibido.

Copia el ID del número de teléfono y el ID de la cuenta de WhatsApp Business. Son identificadores numéricos, no el teléfono, el ID de la aplicación ni el del portafolio.

Token y secreto

  1. En la configuración empresarial, crea un usuario del sistema con rol de administrador.
  2. Asígnale la aplicación y la cuenta de WhatsApp.
  3. Genera un token, preferiblemente sin caducidad, con whatsapp_business_messaging y whatsapp_business_management.
  4. Copia el secreto desde Configuración de la aplicación → Básica.

Los tokens de usuario del panel caducan. Usa un token de usuario del sistema.

Registrar el número en Cloud API

curl -X POST 'https://graph.facebook.com/GRAPH_API_VERSION/PHONE_NUMBER_ID/register' \
  -H 'Authorization: Bearer SYSTEM_USER_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"messaging_product":"whatsapp","pin":"SIX_DIGIT_PIN"}'

El PIN de seis dígitos es independiente del código recibido por SMS o llamada.

Publicar y conectar

Añade la política de privacidad, publica la aplicación y comprueba que esté en modo Live. En libredesk configura primero la URL raíz pública y después crea una bandeja de WhatsApp con ambos ID, el token, el secreto, la versión de API y un token de verificación generado con openssl rand -hex 32.

Webhooks

  1. Copia desde la bandeja la URL de retorno y el token de verificación.
  2. En Meta configura ambos valores y suscríbete a messages y message_template_status_update.
  3. Guarda de nuevo la bandeja para reintentar el registro automático.

Probar y solucionar problemas

Envía un mensaje desde otro teléfono y responde desde libredesk. Si no aparece, comprueba el modo Live, la URL HTTPS pública, los registros del servidor, las suscripciones y que el secreto pertenezca a la misma aplicación. Las respuestas iniciadas por la empresa fuera de la ventana de 24 horas requieren una plantilla aprobada y un método de pago en Meta.

Was this article helpful?