Preparar WhatsApp en Meta para Kerryvo
Manual de administración técnica: negocio de Meta, aplicación independiente, registro integrado, webhook, permisos y revisión antes de abrir el piloto.
- Esta guía corresponde al equipo que administra la integración de Kerryvo. Para conectar un negocio a la aplicación ya preparada, utiliza la guía «Conectar WhatsApp Business y controlar el consumo».
- Acceso administrador al portfolio comercial correcto en Meta y al servidor de la integración. La verificación del negocio y la revisión de la aplicación son trámites diferentes.
- Un receptor autorizado para los ensayos, sin datos de clientes reales. El piloto permanece desactivado durante la preparación; no se añaden tarjetas ni se migran números como parte de una prueba.
Sigue el recorrido
- 1Comprueba el negocio de Meta
- 2Crea una aplicación independiente
- 3Identifica el uso como proveedor de tecnología
- 4Completa los datos públicos de la aplicación
- 5Crea la configuración del registro integrado
- 6Autoriza los retornos y el SDK de la web
- 7Prepara los secretos en el servidor
- 8Registra y verifica el webhook propio
- 9Haz una prueba con un destinatario autorizado
- 10Prepara una plantilla de utilidad
- 11Prepara la revisión de los dos permisos
- 12Abre un único piloto cuando se cumplan los requisitos
Comprueba el negocio de Meta
Entra con la cuenta administradora en Meta Business y revisa el portfolio comercial del servicio. Comprueba su nombre y el estado de verificación. Si Meta pide datos o documentación, completa el trámite con los datos reales de la entidad.
El portfolio correcto aparece verificado. Esto todavía no concede acceso avanzado a la aplicación.
Comprueba el negocio de Meta
Entra con la cuenta administradora en Meta Business y revisa el portfolio comercial del servicio. Comprueba su nombre y el estado de verificación. Si Meta pide datos o documentación, completa el trámite con los datos reales de la entidad.
Qué deberías ver. El portfolio correcto aparece verificado. Esto todavía no concede acceso avanzado a la aplicación.
Crea una aplicación independiente
En developers.facebook.com/apps, pulsa «Crear app». Indica el nombre del servicio y un correo de contacto atendido. Selecciona «Conectarte con los clientes a través de WhatsApp» y vincula el portfolio comprobado. Revisa el resumen y las condiciones antes de crearla.
Qué deberías ver. Tienes un identificador de aplicación exclusivo para esta integración.
Identifica el uso como proveedor de tecnología
En el panel de la aplicación, abre «Conviértete en proveedor de tecnología». Confirma esa opción si la aplicación va a prestar servicios a negocios de otros portfolios. En Casos de uso → Personalizar, abre el caso de WhatsApp y revisa su registro como proveedor independiente.
Qué deberías ver. Meta muestra la verificación del negocio y la revisión de la app como pasos distintos.
Completa los datos públicos de la aplicación
En Configuración de la app → Básica, prepara el icono cuadrado, la categoría «Mensajes», el dominio app.kerryvo.com y las URL vigentes de privacidad, condiciones e instrucciones de eliminación. Guarda y comprueba los valores.
Qué deberías ver. La aplicación identifica al servicio y ofrece información de privacidad y contacto coherente con su tratamiento real.
Crea la configuración del registro integrado
En Inicio de sesión con Facebook para empresas → Configuraciones, crea una configuración. Elige «Registro insertado de WhatsApp», únicamente «WhatsApp Cloud API», usuario del sistema y caducidad de 60 días. Deja seleccionadas solo las cuentas de WhatsApp y los permisos whatsapp_business_messaging y whatsapp_business_management.
Qué deberías ver. Meta devuelve un identificador de configuración que pertenece a esta aplicación.
Autoriza los retornos y el SDK de la web
En Inicio de sesión con Facebook para empresas → Configurar, revisa OAuth de cliente y web, navegador integrado y SDK para JavaScript. Conserva HTTPS y coincidencia estricta. Añade como retornos https://app.kerryvo.com/ y https://app.kerryvo.com/comunicaciones/conexion (conserva también el retorno anterior /ajustes/whatsapp si ya estaba autorizado), y como origen del SDK https://app.kerryvo.com. Guarda.
Qué deberías ver. Los dominios y retornos coinciden exactamente con la web que iniciará la conexión.
Prepara los secretos en el servidor
El administrador del servidor configura el identificador de app, el de configuración, la versión Graph y el callback. Guarda la clave secreta de esa app y un VerifyToken aleatorio en archivos privados legibles por el servicio. Mantén WhatsApp y la IA desactivados durante la preparación.
Qué deberías ver. El servidor tiene sus credenciales sin publicarlas en JavaScript, documentación, capturas o Git.
Registra y verifica el webhook propio
En la configuración de WhatsApp de esta aplicación, registra https://app.kerryvo.com/api/whatsapp-webhook y su VerifyToken. La verificación debe llegar por HTTPS y devolver el challenge. Suscribe messages, account_update, history, smb_app_state_sync y smb_message_echoes con la versión Graph revisada.
Qué deberías ver. Meta confirma el callback de esta app y aparecen los campos necesarios suscritos.
Haz una prueba con un destinatario autorizado
En Casos de uso → Personalizar → WhatsApp → Paso 1. Pruébalo, revisa las condiciones de Cloud API antes de continuar. Utiliza el número de prueba de Meta y añade únicamente el receptor autorizado. Sigue su verificación y comprueba un mensaje real tanto en Meta como en el WhatsApp receptor.
Qué deberías ver. Tienes una prueba real identificada como ensayo. Una respuesta de API no sustituye la comprobación de entrega.
Prepara una plantilla de utilidad
El administrador crea en WhatsApp Manager una plantilla operativa de citas. El formato inicial de Kerryvo utiliza un componente BODY y cinco variables posicionales: nombre, servicio, negocio, fecha y hora. Revisa el idioma, la categoría UTILITY y el estado real antes de usarla.
Qué deberías ver. Puedes identificar la plantilla y su aprobación real. Una plantilla pendiente no está disponible para enviar avisos.
Prepara la revisión de los dos permisos
En Revisión de la app, prepara las justificaciones de whatsapp_business_messaging y whatsapp_business_management, el acceso de demostración y el tratamiento de datos. Graba el envío y recepción reales y, en otro vídeo, la creación de una plantilla. Meta admite como alternativa la demostración con API Setup y WhatsApp Manager.
Qué deberías ver. La solicitud tiene evidencias reales, sin tokens ni datos de terceros visibles. El envío final se revisa antes de presentarlo.
Abre un único piloto cuando se cumplan los requisitos
Selecciona una empresa de demostración autorizada y con módulo Comunicaciones en prueba. Comprueba agenda, correo, permisos y límites. Para un número Business con historial, limita la demostración a contactos autorizados y excluye la importación de historial y agenda antes de conectarlo. Conecta mediante coexistencia y valida envío, reserva con código, cambio, cancelación, avisos, toma de control, BAJA y desconexión. La bandeja está en Comunicaciones → Mensajería; las plantillas y el bot tienen sus propias secciones. Amplía el acceso solo después de la aprobación y la aceptación del ensayo.
Qué deberías ver. Conoces el resultado de cada prueba y las empresas que pueden utilizar el canal. Publicar la pantalla no activa números automáticamente.
Datos que deben coincidir
Desliza la tabla para ver todas las columnas.
| Dato | Comprobación |
|---|---|
| App ID y clave secreta | Pertenecen a la misma aplicación exclusiva. |
| Configuration ID | Configuración de Cloud API de esa aplicación, con los dos permisos WhatsApp. |
| Callback y VerifyToken | HTTPS del servidor de Kerryvo y el mismo VerifyToken en Meta y servidor. |
| Número y cuenta de mensajería | Activos compartidos por el propietario y verificados en servidor, sin conexión previa incompatible. |
| Costes | Estimaciones positivas por servicio y plantilla, límite mensual e IA opcional; las 24 horas regulan el envío, no garantizan gratuidad. |
Documentación oficial para revisar cambios de Meta
Desliza la tabla para ver todas las columnas.
| Tema | Dirección |
|---|---|
| Alta y vídeos de Tech Provider | https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/get-started-for-tech-providers |
| Callbacks alternativos y sus límites | https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/override |
| Precios actuales | https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing |
Al terminar
La integración tiene una aplicación propia, un callback comprobado y un expediente de revisión preparado; conoces las comprobaciones que faltan antes de activar negocios.
Se abrirá tu cuenta. Comprueba la empresa activa antes de realizar cambios.
Si algo no encaja
¿Por qué Meta rechaza el nombre de la aplicación?
Comprueba si contiene WhatsApp u otra marca reservada de Meta. Cambia el nombre visible por uno propio del servicio; el nombre de una configuración de registro es un campo diferente.
¿Por qué falla la verificación del webhook?
Comprueba el HTTPS público, el callback exacto y el VerifyToken del servidor. Revisa si un proxy o una protección web está devolviendo un desafío o un 403 a Meta. No desactives la validación de firma ni sustituyas un callback ajeno para resolverlo.
¿Puedo aprovechar la aplicación de otra integración?
Una aplicación tiene un callback general y ciertos avisos siempre llegan allí. Para aislar todos los eventos utiliza una app propia. Kerryvo rechaza cuentas ya suscritas de forma incompatible antes de cambiar su webhook.
¿El negocio verificado ya permite conectar cualquier cliente?
No. La revisión y el acceso avanzado de los dos permisos WhatsApp siguen siendo necesarios para administrar activos de otros negocios.
¿Tengo que pagar para crear una prueba?
Revisa lo que Meta propone en su asistente. Este procedimiento utiliza su número de prueba y no requiere añadir una tarjeta ni activar facturación de producción como parte de la preparación. Los números reales y sus mensajes tienen las condiciones y tarifas de Meta.
¿Debo crear las plantillas desde Kerryvo para el vídeo?
El piloto consulta plantillas, pero no incluye su creación. La documentación de Tech Provider permite demostrar la creación desde WhatsApp Manager y el envío desde API Setup. Graba la operación real y comprueba el requisito del formulario vigente.
¿Te ha servido esta guía?
Tu respuesta nos ayuda a mejorar las explicaciones.