Conectar WhatsApp Cloud API con Botinfy (Nueva Cuenta)
Esta guía te ayudará a conectar WhatsApp Cloud API con la plataforma Botinfy cuando estás creando una nueva cuenta de WhatsApp Business desde cero.
El registro integrado es una forma conveniente de registrar tu número en WhatsApp Business API directamente desde la plataforma Botinfy. Después del registro, podrás comenzar a usar la API con la ayuda de Botinfy para mejorar la experiencia de atención al cliente.
IMPORTANT
Es altamente recomendable comenzar WhatsApp Cloud API con un Meta Business Manager verificado. Sin embargo, no es obligatorio hacerlo. Puedes crear un nuevo Meta Business Manager durante el proceso si no tienes uno.
Prerrequisitos
Antes de poder comenzar a usar WhatsApp Business API, necesitarás lo siguiente:
- Una cuenta de Facebook. Debe ser una cuenta activa y sin restricciones.
- Acceso de administrador a tu cuenta de Meta Business Manager. Si no tienes una cuenta de Meta Business Manager, puedes crear una durante el proceso de registro integrado. La cuenta de Meta Business Manager no debe estar bloqueada.
- Tarjeta de crédito (Mastercard / Visa → No American Express!)
- Un número de teléfono que pueda ser registrado como remitente. Este número NO debe estar conectado a ninguna cuenta de WhatsApp (privada o WhatsApp Business API). Necesitarás acceso a este número para recibir un SMS o una llamada de voz para la verificación.
Instrucciones Paso a Paso
Paso 1: Iniciar sesión con Facebook
Para comenzar el proceso, inicia sesión en la plataforma Botinfy y navega al Dashboard. Haz clic en "WhatsApp Cloud" desde la barra lateral izquierda y luego haz clic en el botón "Conectar WhatsApp Cloud".
En la ventana emergente, inicia sesión con tu cuenta de Facebook o selecciona la cuenta con la que ya has iniciado sesión en tu navegador.
Paso 2: Crear o Seleccionar una cuenta de Meta Business Manager
Selecciona crear una nueva cuenta de Meta Business Manager. Para crear una nueva cuenta, necesitarás preparar la siguiente información:
- Nombre legal del negocio
- Número de teléfono del negocio
- Sitio web del negocio
- Dirección de correo electrónico del negocio
- País
- Dirección corporativa
- Ciudad
- Estado/provincia/región
NOTE
El nuevo Meta Business Manager creado estará "sin verificar". Se recomienda verificar tu Meta Business Manager lo antes posible para evitar restricciones.
Paso 3: Crear Perfil de WhatsApp Business
1. Ingresa el nombre de tu Cuenta de WhatsApp Business (WABA)
Tu audiencia no verá esta información en tu perfil de WhatsApp.
2. Ingresa el nombre de tu Perfil de WhatsApp Business (Display Name)
Los nombres para mostrar deben ser revisados por Meta, lo cual es uno de los factores importantes para aumentar el límite de números.
Un nombre para mostrar debe tener una marca consistente con fuentes externas (por ejemplo, el sitio web de una empresa o marketing).
Los nombres para mostrar deben estar relacionados con tu negocio y no deben violar las políticas de Comercio y Negocios de WhatsApp. Además, el nombre para mostrar debe cumplir con las directrices de nombres para mostrar de WhatsApp.
3. Elige una categoría de negocio de la lista
4. Ingresa una descripción para tu negocio
Puedes editar la descripción en cualquier momento, incluso después de la verificación del remitente.
Paso 4: Verificar Número de WhatsApp Business
- Ingresa el número de teléfono que deseas usar como tu número de WhatsApp Business. Ten en cuenta que este número de teléfono no puede usar ningún servicio de WhatsApp.
- Elige uno de los siguientes métodos de verificación:
- SMS
- Llamada de voz
Una vez que tu número esté verificado, serás redirigido a la pantalla de finalización. Haz clic en el botón "Finalizar" y serás redirigido de vuelta a la plataforma Botinfy.
Paso 5: Completar el registro de tu número
Una vez que seas redirigido a la plataforma Botinfy, verás la pantalla de configuración. Haz clic en el botón "Sincronizar Números".
Verás los números que acabas de registrar dentro de la plataforma Botinfy. Por defecto, el estado es "Pausado", necesitas cambiar el estado a "Activo".
Por defecto, si vas a "WhatsApp Manager" y luego a "Phone numbers", notarás que el estado es "Pendiente".
Ahora, si regresas a Botinfy y haces clic en "Configuración", haz clic en "Registrar número" y registra tu número (Suele ser los primeros 6 numeros del numero de telefono. Ej: 584241 ).
Una vez que completes el registro, verás que el estado de tu número de teléfono es "Conectado".
¡Ahora tu bot está listo para probar!
Paso 6: Verificación rápida de conexión
Una vez que el número de WhatsApp esté conectado, puedes hacer clic en "Crear flujo" y crear un flujo simple en tu flujo principal.
Haz clic en el botón "Publicar" para publicar el flujo y luego envía cualquier mensaje desde tu número personal de WhatsApp a este número de WhatsApp Cloud API.
Deberías recibir el mensaje de texto de vuelta. Si ves el mensaje, entonces la conexión está bien. Tu bot es receptivo y funciona correctamente.
Ahora puedes ir a "Contenido", "Plantillas de Mensajes" y hacer clic en el botón "Sincronizar". Si no ves ningún mensaje de error, entonces los mensajes de plantilla de WhatsApp también están funcionando.
NOTE
No habrá ningún mensaje de plantilla que se sincronice de vuelta a Botinfy cuando recién comiences. También puedes hacer clic en "+ Nueva Plantilla" y crear un nuevo mensaje de plantilla de WhatsApp directamente desde Botinfy.
Por último, puedes ir a "WhatsApp Manager" en tu Meta Business Manager y conectar una tarjeta de crédito válida a la facturación, y luego puedes probar enviar un mensaje de plantilla de WhatsApp a un usuario de WhatsApp.
Si tu método de pago es válido, el mensaje de plantilla debería entregarse correctamente.
Configuración de WhatsApp Cloud
Proceso de verificación del Business Manager (Opcional pero Recomendado)
Antes de enviar cualquier mensaje de plantilla para probar o poner tu chatbot en vivo, conecta tu tarjeta de crédito válida a la sección de facturación en WhatsApp Manager.
También es riesgoso que tu número/cuenta de Meta Business Manager se restrinja si no tienes una cuenta de Meta Business Manager verificada.
Verificar método de pago
Es importante configurar un método de pago válido en WhatsApp Manager para poder enviar mensajes de plantilla y evitar restricciones.
Health Check
Puedes verificar el estado de salud de tu número de WhatsApp en la sección de configuración de Botinfy.
Números de teléfono
Puedes gestionar múltiples números de teléfono desde la plataforma Botinfy. Por defecto, Meta permite un máximo de 2 números de teléfono por cuenta de WhatsApp Business, pero este límite puede aumentarse hasta 20 números después de la verificación del negocio.
Plantillas de Mensajes
Las plantillas de mensajes son mensajes preaprobados que puedes enviar a tus usuarios. Puedes crear y gestionar plantillas directamente desde Botinfy o sincronizarlas desde WhatsApp Manager.
Catálogo
Puedes crear y gestionar un catálogo de productos que se mostrará en WhatsApp Business. Esto es útil para empresas que venden productos directamente a través de WhatsApp.
Actualizar Nombre para Mostrar de WhatsApp
Puedes actualizar el nombre para mostrar de WhatsApp desde la configuración de Botinfy o directamente desde WhatsApp Manager.
Errores Comunes y Soluciones
Errores de Creación de Cuenta de Business Manager
Ocurrió un error al procesar esta solicitud. Por favor, inténtalo de nuevo más tarde.
Este es el error más poco claro que necesita asistencia adicional. La creación de la cuenta comercial podría haber fallado por varias razones.
- Solución: Usa una cuenta de Facebook activa o contacta con Soporte para resolver el problema.
Has alcanzado el límite para el número de Negocios que puedes crear en este momento.
Hay un límite en el número de Cuentas Comerciales que puedes crear.
- Solución: Usa una Cuenta Comercial existente o elimina/cierra Cuentas Comerciales no utilizadas.
Tu cuenta de Facebook es demasiado nueva para crear una cuenta comercial. Inténtalo de nuevo en una hora.
Las cuentas nuevas de Facebook tienen que esperar un tiempo para crear una cuenta de Business Manager.
- Solución: Usa una cuenta de Facebook activa existente o espera unas horas antes de usar tu nueva cuenta.
Errores de Verificación de Número
Este número está registrado en una cuenta de WhatsApp existente. Para usar este número, desconéctalo de la cuenta existente.
El número de teléfono ya estaba registrado en nuestra plataforma (es decir, WhatsApp Messenger, WhatsApp Business App o WhatsApp Business API).
- Solución: Ve a la configuración de "WhatsApp Cloud" en Botinfy y desregistra el número si deseas usarlo, o registra un nuevo número.
Tu número de teléfono no parece ser válido. Por favor, verifícalo o inténtalo de nuevo después de 5 minutos.
Se ingresó un número de teléfono incorrecto o no admitimos números de este formato.
- Solución: Asegúrate de que el número sea operativo y verificado por un proveedor de telecomunicaciones.
Has adivinado demasiadas veces.
Para bloquear el spam, el sistema solo permite un número limitado de intentos de verificación.
- Solución: Tienes que esperar aproximadamente 12 horas antes de volver a intentar.
Próximos Pasos
Una vez que hayas completado la conexión de WhatsApp Cloud API con Botinfy:
- Configura tu flujo principal en Botinfy
- Crea plantillas de mensajes para comunicaciones iniciadas por el negocio
- Configura tu catálogo de productos (si aplica)
- Verifica tu Meta Business Manager para evitar restricciones
- Configura un método de pago válido en WhatsApp Manager
¡Tu bot de WhatsApp está listo para comenzar a interactuar con tus clientes!