Implementación de la API de WhatsApp
Introducción
La implementación de la API de WhatsApp en ¡Hola! Suite es un proceso estratégico que transforma el canal de comunicación más popular de Brasil en una poderosa herramienta de atención empresarial. Esta integración oficial permite a las empresas utilizar WhatsApp de forma profesional, escalable y cumpliendo con las políticas de Meta (Facebook).
La implementación de la API de WhatsApp permite a las empresas gestionar conversaciones a gran escala, automatizar respuestas, integrar múltiples agentes y mantener un historial completo de interacciones, todo dentro de una plataforma centralizada y profesional.
La API de WhatsApp Business se diferencia significativamente de la tradicional WhatsApp Business, ya que ofrece funciones avanzadas como múltiples usuarios simultáneos, integración con sistemas corporativos, automatizaciones sofisticadas y capacidad de servicio ilimitada. Una implementación adecuada garantiza que su empresa aproveche todo el potencial de esta herramienta, manteniendo el cumplimiento de las directrices Meta y brindando una experiencia superior al cliente.
Requisitos de implementación
Para activar la API de WhatsApp necesitas:
☐ Cuenta de Facebook: Perfil personal (individual) para administrar la cuenta y evitar sospechas de fraude por parte de Meta
☐ Sitio web funcional: Política comercial visible + SSL activo + Nombre de la empresa y CNPJ en el pie de página o encabezado
☐ Correo electrónico comercial: Mismo dominio que el sitio web
☐ Tarjeta de crédito internacional: Debe aceptar compras internacionales (no se aceptan ELO y AMEX emitidas en Brasil)
☐ Tarjeta CNPJ válida: Datos actualizados y correctos para pasar la verificación de Metas
A medida que avanza en el proceso de activación, debe tener en cuenta los siguientes requisitos:
☐ Desactivación de IVR: Si el número utiliza IVR, la llamada de verificación debe redirigirse a una sola extensión, para garantizar la recepción directa. ☐ Eliminar tu cuenta de WhatsApp: Si el número ya está activo en WhatsApp Business, deberás eliminar la cuenta. El equipo le informará del momento adecuado para ello. ☐ Si el número ya está en otro proveedor de API de WhatsApp, será necesaria una Migración BSP, deshabilitando así la 2FA del corredor para la migración.
Acceso al formulario
Ruta: Menú (¡Hola! Store -> WhatsApp -> Instalar)
Configuración e implementación de la API de WhatsApp
Después de instalar WhatsApp, se le dirigirá a la configuración inicial. Complete la información básica del canal:
Nombre: Identificación interna del canal.
Agente virtual: Elige el agente responsable del servicio.
Socio: Seleccione ¡Hola! Suite o Gupshup como proveedor de integración.
Después de eso, seleccione Continuar.
Conexión con pareja
En el siguiente paso, iniciará la conexión con el socio ¡Hola! Suite.
Inicie sesión con la cuenta Facebook Business de su empresa.
Haz clic en Continuar con Facebook.
Integración a través de Gupshup
Si elige Gupshup, creará su cuenta directamente con el corredor.
Después de eso, complete:
ID de aplicación
Clave API
Integración a través de ¡Hola! Suite Broker
Si eliges el Broker propio de ¡Hola! Suite, el proceso es aún más sencillo:
Seguirás el flujo de activación automática.
Recibirás un código OTP para validar la integración.
Los datos principales como nombre de cuenta y número de WhatsApp se completarán automáticamente.
Después de completar la conexión con el socio, haga clic en Continuar.
Finalización de la instalación
La conexión se validará automáticamente, trayendo todos los datos necesarios.Al final, simplemente seleccione Instalar WhatsApp para completar la implementación.
Nunca elimines a ¡Hola! Suite como socio de tu cuenta Meta si quieres mantener tu número activo.
La eliminación del socio puede resultar en la desactivación de tu WhatsApp Business y la interrupción del servicio.
Después de instalar el canal, serás dirigido a la pestaña de registro.
Registro
En Registro se encuentra disponible la información esencial del canal, organizada para facilitar su identificación y gestión.
1. Datos de registro
Configurar la identificación interna y el comportamiento inicial del canal. En esta sección, puede editar el Nombre del canal (para informes y administración), cambiar el Estado (Activo/Inactivo) y vincular un Agente virtual
2. Calidad de la cuenta
En esta sección, usted controla la salud de su número con el Objetivo. Monitorear estos indicadores es esencial para garantizar que sus mensajes continúen entregándose sin bloqueos.
| Indicador | Descripción |
|---|---|
| Límite de conversación (Nivel) | La cantidad máxima de conversaciones iniciadas por la empresa que puede abrir en un período de 24 horas (por ejemplo, 1000, 10 000 o ilimitadas). |
| Conversaciones (24h) | Cuenta cuántas conversaciones ha iniciado tu empresa en las últimas 24 horas, ayudándote a controlar el consumo de tu límite diario. |
| Calificación de calidad | El estado actual de la reputación de su número. Una calificación baja puede reducir su límite de envío o bloquear el número. |
3. Preferencias
| Campo | Descripción | Ejemplo de uso / Recomendación* |
|---|---|---|
| Prioridad de los servicios de cola | Define la prioridad del canal en el enrutamiento de llamadas. Los canales con mayor prioridad verán sus conversaciones mostradas o distribuidas antes que aquellos con menor prioridad. Las opciones disponibles son: muy bajo, bajo, medio, alto y muy alto. | Configure Promedio para el canal de Instagram y Alto para el canal de WhatsApp, asegurando que los mensajes de WhatsApp tengan prioridad en visualización y servicio. |
| Mostrar el nombre del asistente en el encabezado del mensaje | Determina si el nombre del agente se mostrará en la parte superior de cada mensaje al cliente. Seleccione entre activo (mostrar) o inactivo (ocultar). | Activo: el cliente verá el nombre del asistente antes del mensaje, por ejemplo: “João Silva: ¡Hola, buenas tardes!” Inactivo: el mensaje se mostrará sin la identificación del asistente, por ejemplo: “Buenas tardes!” |
| Comprueba si el contacto es humano | Cuando se activa, el sistema identifica si la interacción la realiza un usuario humano o un proceso automatizado, adaptando el flujo de servicio según sea necesario. | Activo: evita que los sistemas automatizados externos inicien servicios inapropiados o ocupen la cola innecesariamente. |
| Notificar posición en la cola | Cuando se activa, envía automáticamente al cliente un mensaje informando su posición en la cola de espera. Puede personalizar el texto y definir el intervalo de envío de notificaciones. | Permite insertar variables dinámicas en el mensaje (Nombre de la empresa, Posición de cola y Protocolo), que serán reemplazadas automáticamente al enviar, además de configurar el intervalo de repetición de advertencia, en minutos. |
Plantillas de mensajes
En esta sección, puede administrar el ciclo de vida de sus plantillas de mensajes. Además de crear y editar modelos, el sistema ofrece herramientas de trazabilidad (auditoría) y actualización de datos con el Meta.
| Campo | Descripción |
|---|---|
| Auditoría | Permite visualizar el registro de cambios realizados en los modelos de mensajes, garantizando control y trazabilidad de los cambios. |
| Sincronización | Actualiza la lista de modelos conectándose directamente a Meta. Utilice esta opción para importar modelos creados en Business Manager (BM) que aún no aparecen aquí. |
| Agregar nuevo | Comienza a crear una nueva plantilla de mensaje que se enviará para su aprobación. |
Límites de envío
Meta controla los límites de envío del modelo de mensajes según los niveles de confianza y la interacción de la cuenta comercial. Estos límites determinan cuántas plantillas de mensajes se pueden enviar a contactos únicos dentro de un período de 24 horas.
Los límites definidos por la Meta son:
Nivel 1: 250 mensajes/24h
Nivel 2: 2.000 mensajes/24h
Nivel 3: 10.000 mensajes/24h
Nivel 4: 100.000 mensajes/24h
Nivel 5: Ilimitado
Actualización importante: Meta ha actualizado la API para plantillas de mensajes en WhatsApp. Ahora, a través del Broker ¡Hola! Suite, podrás elegir cómo enviar tus mensajes promocionales:
- Entrega inmediata: Mensajes enviados en el momento de la activación.
- Entrega optimizada: Mensajes entregados en los momentos considerados más efectivos por Meta.
Nota: Esta opción solo está disponible para los usuarios del corredor ¡Hola!. Los usuarios de otros brokers, como 360 Dialog, seguirán con el método de envío tradicional.
Perfil
La sección Perfil es donde defines la identidad pública de tu empresa en WhatsApp. Toda la información ingresada en esta pantalla se mostrará a su cliente cuando haga clic en su nombre de contacto o vea su perfil comercial.
1. Información de la empresa
En la parte izquierda de la pantalla encontrarás los campos de registro. Para modificar cualquier dato, haga clic en el botón "Editar información".
| Campo | Qué completar |
|---|---|
| Área de actividad | El segmento de su negocio (por ejemplo, Finanzas, Comercio minorista, Otros). |
| Descripción | Un breve texto sobre lo que hace su empresa o sus valores. |
| Dirección | La dirección física de su sede o sucursal. |
| Correo electrónico | Correo electrónico de contacto comercial. |
| Sitio web | Tu sitio web principal. |
| Sitio web secundario | Un segundo enlace (por ejemplo, Linktree, Blog o Store). |
| Mensaje | La frase de estado que se muestra en el perfil. |
2. Vista previa Después de editar cierta información y guardar, el panel Vista previa a la derecha muestra, en tiempo real, exactamente cómo aparecerá el perfil en la pantalla del teléfono celular de su cliente.
Identidad visual: Muestra su logotipo (foto de perfil), nombre para mostrar y número oficial.
Enlaces de colores: Tenga en cuenta que los correos electrónicos y los sitios web se vuelven verdes (activos), lo que indica que el cliente puede hacer clic en ellos.
Acciones adicionales (menú superior)
En la esquina superior derecha, encontrarás herramientas de administración de cuentas:
Información de Migración: Se utiliza para migrar canales de una base a otra.
Descargar registros: Genera un archivo de historial técnico (útil para soporte).
Compartir: Genera un enlace o código QR de tu contacto. Para obtener más información, visita: Compartir WhatsApp
Desinstalar aplicación: Elimina la integración de la aplicación.
Consideraciones finales
La implementación de la API de WhatsApp requiere atención al detalle y el cumplimiento de los requisitos establecidos por Meta. Es fundamental mantener toda la información actualizada y seguir cuidadosamente cada paso del proceso para garantizar una integración exitosa y aprovechar al máximo las funciones que ofrece la plataforma.