Conectar WhatsApp Business con tu propia app de Meta

Antes de empezar: qué vas a conectar

Daplox utiliza WhatsApp Business Platform mediante la API oficial de Meta y las credenciales de tu propia app. La configuración se hace en Conectar Meta. Necesitas acceso de administrador en Daplox, WhatsApp habilitado en tu cuenta y una persona con permisos para administrar la app y los activos del negocio en Meta. Reserva un destinatario de prueba que haya aceptado recibir tus mensajes.

• Abrir Conectar Meta en Daplox
• Abrir tus apps en Meta for Developers
• Abrir la configuración del negocio en Meta

Los seis datos: de dónde salen y dónde van

1. Prepara tu app y el número en Meta

1. 1
   Abre Meta for Developers y elige la app del negocio

   Si no existe, pulsa Crear app y elige un caso de uso compatible con WhatsApp. Los nombres y el orden del asistente pueden variar según la cuenta de Meta. Selecciona el portafolio que administrará el canal y completa lo que te pida el panel; evita crear otra app si tu negocio ya tiene una destinada a esta integración.
2. 2
   Abre el producto o caso de uso WhatsApp y su Configuración de API

   Comprueba que puedes identificar la cuenta de WhatsApp y el número seleccionados. Para aprender el circuito, utiliza los recursos de prueba que te ofrezca Meta y agrega un destinatario autorizado en ese panel. Un número de prueba no sustituye al número comercial que usarás después.
3. 3
   Si vas a usar un número comercial, completa su alta en Meta

   Comprueba en WhatsApp Manager su estado, la verificación del teléfono y las tareas pendientes que indique Meta. Guardar su ID en Daplox no registra el número en Cloud API ni completa una migración. Mantén la prueba separada del canal que ya recibe clientes.
4. 4
   Abre Configuración de la app → Básica

   Localiza el ID de la app y su clave secreta. Deja abierto ese panel: vas a guardar ambos en Daplox y volver a esta misma app para configurar el webhook.

• Meta: introducción a WhatsApp Cloud API
• Meta: comprobar los números de una WABA y su registro

2. Registra esa misma app en Daplox

1. 1
   En Conectar Meta, abre Paso 1 — Registra tu app de Meta

   Pega el ID de la app y la Clave secreta de la app. Ambos deben pertenecer a la app que acabas de abrir en Meta.
2. 2
   Pulsa Guardar mi app

   Si ya había una app, verás Actualizar. Al actualizar tendrás que volver a pegar la clave secreta: Daplox no vuelve a mostrar el secreto guardado.
3. 3
   Identifica la URL de devolución de llamada y el Token de verificación

   Aparecen en Pega esto en tu app de Meta. Utiliza los valores de tu organización; no una URL copiada de otra cuenta ni una dirección inventada a partir del dominio.
4. 4
   Comprueba el estado de verificación

   Guardar la app no comprueba todavía su clave secreta. Daplox podrá marcarla verificada al recibir el primer webhook con firma válida. Consultar verificación actualiza ese estado; no envía por sí solo un mensaje de prueba.

3. Prepara un token con acceso a esa cuenta

El token de usuario que muestra la configuración inicial de Meta sirve para pruebas y normalmente vence a las 24 horas. Para operar, utiliza un token de usuario del sistema: su vigencia depende de la opción elegida al generarlo y puede ser revocado aunque no tenga vencimiento programado.

1. 1
   Abre Configuración del negocio → Usuarios → Usuarios del sistema en Meta

   Selecciona o crea el usuario que administrará esta integración. Asigna la app y la cuenta de WhatsApp necesarias con los permisos de administración correspondientes. Si no puedes asignarlas, pide al administrador del portafolio que revise su propiedad y tu acceso.
2. 2
   Genera el token seleccionando la misma app

   Para WhatsApp revisa whatsapp_business_management y whatsapp_business_messaging. El descubrimiento de activos del negocio también utiliza business_management; los permisos de otras redes dependen de las funciones que conectes.
3. 3
   Comprueba su alcance antes de pegarlo

   Tener un permiso en el token no sustituye la asignación del activo. Verifica que el usuario del sistema tiene acceso a la WABA y al número elegidos. Si Meta no ofrece un permiso, revisa la configuración y el acceso de esa app en su panel.

• Meta: tokens y permisos de Cloud API
• Meta: depurador oficial de tokens de acceso

4. Conecta el número en Daplox

1. 1
   En Paso 2, abre la conexión de WhatsApp Business

   Pega el Access Token, el Phone Number ID y el WABA ID de la misma cuenta. En Nombre visible escribe un nombre para identificar la conexión, por ejemplo WhatsApp Ventas; este campo no solicita a Meta la aprobación del nombre comercial del número.
2. 2
   Guarda y lee el resultado completo

   Daplox comprueba acceso al activo y que el número pertenece a la WABA. Si la conexión se guarda con un aviso de webhook, falta resolver la recepción aunque las credenciales sean válidas.
3. 3
   Pulsa Probar conexión en su tarjeta

   Revisa por separado el acceso del token y la suscripción del webhook. Esta comprobación consulta la configuración; no envía un WhatsApp ni demuestra que un destinatario lo recibió.

5. Configura la recepción en Meta y la suscripción de la cuenta

El webhook es la dirección a la que Meta envía mensajes y estados. Hay dos ajustes: la URL de devolución de llamada de tu app y la suscripción de esa app a la WABA. Completar uno no sustituye al otro.

1. 1
   Copia la URL y el token de verificación que muestra Daplox para tu app

   También puedes consultarlos en Configuración de Webhooks en Meta de esta pantalla. Si el token aparece como solo visible para administradores, entra con el administrador de la organización. Si falta la configuración, resuélvela antes de continuar.
2. 2
   Vuelve a la misma app en Meta → WhatsApp → Configuración

   En la configuración del webhook, pega la URL en Callback URL / URL de devolución de llamada y el token en Verify Token / Token de verificación. Verifica y guarda. Copia los valores completos, sin espacios añadidos. La URL debe ser HTTPS pública y accesible para Meta.
3. 3
   Suscribe el campo messages de WhatsApp Business Account

   Hazlo en los campos de webhook de WhatsApp de esa app. No elijas los campos de una página de Facebook ni cambies la URL de otra integración por accidente.
4. 4
   Regresa a Daplox y comprueba la tarjeta del número

   Al conectar, Daplox intenta suscribir la app a la WABA. Si muestra que falta la suscripción, pulsa Reintentar webhook y luego Probar conexión. Reintentar webhook no corrige una Callback URL o un Verify Token mal pegados en Meta.

• Meta: suscribir una app a la WABA
• Meta: recepción de webhooks y estados

6. Haz una prueba completa en ambos sentidos

1. 1
   Comprueba primero el circuito de prueba de Meta

   Si estás usando sus recursos de prueba, elige el destinatario autorizado en Configuración de API y ejecuta su mensaje de ejemplo. El ejemplo oficial utiliza la plantilla hello_world. Guarda el resultado sin copiar el token.
2. 2
   Envía un mensaje desde el teléfono de prueba al número conectado

   Abre Conversaciones en Daplox y comprueba el texto, la hora y la conexión que lo recibió. Asegúrate de escribir al número que corresponde al Phone Number ID guardado.
3. 3
   Consulta la verificación de tu app

   Tras el primer evento válido, utiliza Consultar verificación. Si sigue pendiente y no aparece el mensaje, revisa URL, campo messages, suscripción a la WABA y App Secret antes de cambiar otros ajustes.
4. 4
   Responde desde esa conversación en Daplox

   Comprueba la llegada en el teléfono receptor. Si hay una automatización o un chatbot activo, tenlo en cuenta para evitar dos respuestas durante la prueba. Para mensajes fuera de la ventana de atención utiliza una plantilla aprobada aplicable.
5. 5
   Distingue aceptación de entrega

   Un identificador de mensaje confirma que la API aceptó la solicitud. Los estados sent, delivered, read o failed se informan después por webhook; comprueba la recepción real y el estado disponible, no solo que el mensaje figure en la conversación.

• Meta: enviar el mensaje de prueba hello_world
• Meta: notificaciones de estado de los mensajes
• Cómo trabajar en el Inbox unificado

7. Antes de atender clientes: permisos, revisión y reglas de envío

Revisa en Meta las tareas aplicables a tu app, negocio y número. La verificación del negocio, el estado de la cuenta, el registro del teléfono, el nombre comercial y el acceso de la app son comprobaciones distintas. No asumas que todas son obligatorias para toda prueba ni que una aprobación completa automáticamente las demás. El panel de Meta indica los requisitos y restricciones de tu caso; no hay un plazo garantizado en Daplox.

La incorporación de negocios de terceros mediante Embedded Signup tiene requisitos de revisión y acceso avanzado propios de proveedores. Esta guía describe la conexión manual de tus activos con tu app. Si tu app dará acceso a otras empresas, consulta ese proceso específico con Meta antes de operar.

En la tarjeta de Daplox puedes consultar el estado de revisión. Sin comprobar significa que ese dato no pudo leerse; no demuestra aprobación ni rechazo. Si la consulta falla y se muestran datos anteriores, vuelve a comprobarlos en Meta antes de tomar decisiones.

• WhatsApp: política oficial de mensajería empresarial
• Meta: Embedded Signup para proveedores y sus requisitos
• Crear y utilizar plantillas de WhatsApp

Si cambias credenciales o la prueba falla

Si rotas el token o el App Secret, actualiza la credencial correspondiente y repite Probar conexión y la prueba en ambos sentidos. No uses Quitar como primer paso de diagnóstico: retirar tu app interrumpe la recepción de sus webhooks. Si el error dice que el activo pertenece a otra organización de Daplox, pide revisar esa vinculación; crear más conexiones no resuelve el conflicto.

• Diagnosticar WhatsApp: token, webhook o mensaje no entregado

Guía contrastada con la configuración de Daplox y las referencias oficiales enlazadas el 12 de septiembre de 2026. Las pantallas y requisitos de Meta pueden cambiar; utiliza los nombres de los datos y las comprobaciones de cada paso para orientarte.