Tiendas e integraciones

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.

Antes de empezar
  • 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.
A TU RITMO

Sigue el recorrido

TU RECORRIDO
  1. 1Comprueba el negocio de Meta
  2. 2Crea una aplicación independiente
  3. 3Identifica el uso como proveedor de tecnología
  4. 4Completa los datos públicos de la aplicación
  5. 5Crea la configuración del registro integrado
  6. 6Autoriza los retornos y el SDK de la web
  7. 7Prepara los secretos en el servidor
  8. 8Registra y verifica el webhook propio
  9. 9Haz una prueba con un destinatario autorizado
  10. 10Prepara una plantilla de utilidad
  11. 11Prepara la revisión de los dos permisos
  12. 12Abre un único piloto cuando se cumplan los requisitos
Esquema de los pasos · no es una pantalla de la aplicación
PASO 1 DE 12

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.

1

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.

2

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.

3

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.

4

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.

5

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.

6

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.

7

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.

8

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.

9

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.

10

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.

11

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.

12

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.

Datos que deben coincidir
DatoComprobación
App ID y clave secretaPertenecen a la misma aplicación exclusiva.
Configuration IDConfiguración de Cloud API de esa aplicación, con los dos permisos WhatsApp.
Callback y VerifyTokenHTTPS del servidor de Kerryvo y el mismo VerifyToken en Meta y servidor.
Número y cuenta de mensajeríaActivos compartidos por el propietario y verificados en servidor, sin conexión previa incompatible.
CostesEstimaciones 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.

Documentación oficial para revisar cambios de Meta
TemaDirección
Alta y vídeos de Tech Providerhttps://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/get-started-for-tech-providers
Callbacks alternativos y sus límiteshttps://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/override
Precios actualeshttps://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.

Abrir esta pantalla en Kerryvo

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.