Conectar WhatsApp Business

Antes de empezar

Para completar esta guía necesitás tres cosas:

• Una cuenta de Facebook o Meta — si no tenés, la creás en el paso 1 (es gratis y tarda 2 minutos).
• Ser Administrador del backoffice de CanchaPlay.
• Un teléfono con WhatsApp instalado, para recibir el mensaje de prueba al final.

Al finalizar esta guía vas a tener tres datos anotados: Phone Number ID, Business Account ID y Access Token. Los tres se cargan en CanchaPlay en el último paso.

1. Creá la app en developers.facebook.com

   Abrí developers.facebook.com e iniciá sesión con tu cuenta de Facebook (o creá una gratis si no tenés). Una vez adentro:

   • Hacé clic en Mis apps (esquina superior derecha) → Crear app.
   • En la pantalla de tipo de app, elegí Empresa (en inglés: "Business") y hacé clic en Siguiente.
   • Escribí un nombre para la app — por ejemplo, Mi Club WhatsApp — y hacé clic en Crear app.

   Después de unos segundos, Meta te lleva al panel de tu app nueva.

2. Agregá WhatsApp a la app

   En el panel de tu app nueva, buscá la sección Agregar productos. Puede aparecer en el centro de la pantalla o en el menú izquierdo como "+ Agregar producto". Encontrá WhatsApp y hacé clic en Configurar.

   Meta agrega WhatsApp a tu app y te asigna automáticamente un número de teléfono de prueba gratuito. Vas a ver una pantalla llamada API Setup.

3. Anotá el Phone Number ID y el Business Account ID

   En la pantalla de API Setup aparecen varios datos. Necesitás dos de ellos — copiá cada uno en un bloc de notas antes de seguir:

   Phone Number ID

   Aparece en la pantalla de API Setup, debajo del número de teléfono que figura. Es un número de unos 15 dígitos, por ejemplo: 1141384089051520. No es el número de teléfono en sí — es un código interno. En el paso siguiente vas a registrar el número del club y obtener el ID definitivo.

   Business Account ID

   Aparece un poco más abajo, etiquetado como "WhatsApp Business Account ID". También es un número de unos 15 dígitos.

   Dejá esta pestaña abierta

   No cierres esta pestaña — en el siguiente paso la vas a usar para agregar el número de teléfono del club.

4. Agregá el número de teléfono del club

   El número de prueba que asignó Meta sirve para verificar que la integración funciona, pero los mensajes a tus clientes tienen que salir desde el número real del club. Para registrarlo, hacé lo siguiente desde la misma pestaña de Meta for Developers:

   En el menú izquierdo de tu app, dentro de la sección WhatsApp, hacé clic en Phone Numbers. Vas a ver el número de prueba listado. Hacé clic en el botón Add phone number.

   El número no puede tener WhatsApp activo

   El número que registres no puede estar usando WhatsApp en ningún teléfono — ni la app personal ni la Business. Si ya lo tiene, desinstalá WhatsApp en ese teléfono y esperá unos minutos antes de continuar. De lo contrario, Meta no lo deja registrar.

   Completá el formulario que aparece:

   • Display name: el nombre que van a ver tus clientes al recibir un mensaje, por ejemplo Club Demo. Tiene que ser el nombre real de tu negocio.
   • Category: la categoría de tu negocio — podés elegir Recreation o Sports.
   • Timezone: seleccioná tu zona horaria. Para Argentina: America/Buenos_Aires.
   • Phone number: ingresá el número en formato internacional, por ejemplo +541155554444.
   • Verification method: elegí SMS.

   Meta te manda un SMS con un código de 6 dígitos al número que ingresaste. Escribí ese código en el campo que aparece y hacé clic en Verify.

   Una vez verificado, el número aparece en la lista con su propio Phone Number ID. Copiá ese nuevo ID y reemplazá el que tenías anotado — ese es el que vas a cargar en CanchaPlay.

Este paso se hace en Meta Business Suite, que es un panel distinto al anterior. Abrilo en una pestaña nueva para no perder lo que tenés abierto.

1. Abrí la Configuración del negocio

   En una pestaña nueva, andá a business.facebook.com e iniciá sesión con la misma cuenta de antes. Si te pide elegir un negocio, seleccioná el tuyo.

   En el menú de la izquierda, buscá el ícono de engranaje (⚙) y hacé clic. Se abre el panel de Configuración del negocio.

2. Creá un usuario del sistema

   Dentro del panel de Configuración del negocio, en el menú izquierdo andá a Usuarios → Usuarios del sistema. Hacé clic en el botón Agregar.

   Se abre un formulario. Completalo así:

   • Nombre del usuario del sistema: escribí algo descriptivo, por ejemplo CanchaPlay Bot.
   • Rol del usuario del sistema: elegí Empleado.

   Hacé clic en Crear usuario del sistema. El usuario aparece en la lista.

3. Asignale tu app al usuario

   Con el usuario CanchaPlay Bot seleccionado en la lista, hacé clic en el botón Asignar recursos (o "Add Assets").

   En la ventana que aparece:

   • En el tipo de recurso del menú izquierdo, elegí Apps.
   • En la lista del centro, seleccioná la app que creaste en la Fase 1 (la que llamaste "Mi Club WhatsApp" o como la hayas nombrado).
   • Activá el permiso Control total.
   • Hacé clic en Guardar cambios.

4. Generá el token permanente y copialo antes de cerrar

   Volvé a la lista de usuarios del sistema, seleccioná CanchaPlay Bot y hacé clic en Generar nuevo token. Completá el formulario así:

   • App: elegí la misma app de la Fase 1.
   • Vencimiento del token: seleccioná Nunca.
   • Permisos: buscá y activá estas dos opciones:
     • whatsapp_business_messaging
     • whatsapp_business_management

   Hacé clic en Generar token.

   Copiá el token ahora — Meta lo muestra una sola vez

   Cuando aparezca el token (una cadena larga de letras y números que empieza con EAA...), copialo y pegalo en el mismo bloc de notas donde anotaste los datos anteriores. Una vez que cerrés esta ventana, no podés verlo de nuevo — si lo perdés, tenés que generar uno nuevo.

1. Cargá los tres datos en CanchaPlay

   En CanchaPlay, andá a Configuración → Notificaciones y activá el toggle WhatsApp Business. Se despliegan tres campos. Pegá cada dato en el campo que corresponde:

   • PHONE NUMBER ID → el primer número de ~15 dígitos.
   • BUSINESS ACCOUNT ID → el segundo número de ~15 dígitos.
   • ACCESS TOKEN → la cadena larga que empieza con EAA....

   No hace falta un botón de Guardar — cada campo se guarda automáticamente en cuanto terminás de escribir en él.

2. Creá las plantillas de mensajes

   Con los tres datos guardados, va a aparecer la sección Plantillas de mensajes. Hacé clic en el botón Crear plantillas.

   CanchaPlay le envía a Meta todos los modelos de mensaje que necesita: confirmación de reserva, recordatorio previo al turno, aviso de cancelación, y más. El proceso tarda entre unos segundos y 1 minuto. Podés ver el estado de cada plantilla en la tabla que aparece debajo.

   Estado de las plantillas

   Si el estado dice PENDING, Meta aún no las aprobó. Generalmente la aprobación es inmediata, pero en algunos casos puede tardar hasta 24 hs. Una vez que el estado diga APPROVED, los mensajes se van a empezar a enviar solos.

3. Probá que los mensajes lleguen

   En CanchaPlay, en la sección Probar conexión, ingresá cualquier número con WhatsApp sin el + y sin espacios (ejemplo: 5491155554444) y hacé clic en Enviar test.

   En pocos segundos vas a recibir un WhatsApp que dice "Hello World". Ese mensaje confirma que la integración está funcionando correctamente.

   ¡Todo listo!

   A partir de este momento, CanchaPlay va a mandar mensajes automáticos a tus clientes. No necesitás hacer nada más — el sistema funciona solo.