Instalar la API de WhatsApp en ¡Hola! Suite
Primer canal: ¡Hola! Store → WhatsApp → Instalar nuevo Otros canales: ¡Hola! Store → WhatsApp → Acceder → Instalar nuevo
Visión general
La app de la API de WhatsApp te permite conectar el número de WhatsApp de la empresa a ¡Hola! Suite por la integración oficial de Meta. Así, el equipo atiende varias conversaciones al mismo tiempo con el mismo número, con agente virtual, flujo de comunicación, plantillas de mensaje y envío masivo.
La instalación predeterminada es por el Broker ¡Hola! Suite, el socio de la propia ¡Hola! Suite: la conexión se hace con inicio de sesión en Facebook y habilita recursos como llamadas y bloqueo de contactos. Consulta Por el Broker ¡Hola! Suite.
Los socios Gupshup y 360 Dialog solo aparecen para empresas que ya tienen licencia de ellos. Consulta Por Gupshup o por 360 Dialog.
Requisitos previos
En ¡Hola! Suite
- Licencia de la app de WhatsApp contratada. Sin licencia disponible, aparece el botón Obtener, que lleva al contacto con el equipo comercial.
- Permiso para visualizar ¡Hola! Store en tu grupo de permisos.
- Agente virtual creado, si el canal va a usar uno. En la instalación, el campo es opcional.
En Meta
- Perfil personal de Facebook de una persona de la empresa, con acceso al portafolio empresarial de Meta (antiguo Administrador de Negocios). Usa un perfil real, para evitar sospecha de fraude por parte de Meta.
- Sitio web de la empresa seguro (HTTPS), con razón social y número de identificación fiscal visibles en el pie de página o en el encabezado.
- Correo electrónico comercial con el mismo dominio del sitio web.
- Recomendado: portafolio empresarial verificado. Consulta Verificar la empresa en el portafolio empresarial de Meta.
El número de teléfono
- Debe recibir SMS o llamada con el código de confirmación de Meta. Si el número tiene IVR, dirige la llamada a una única extensión durante la activación. Consulta Recibir el código de verificación de WhatsApp por llamada en la telefonía ¡Hola! Suite.
- No puede estar activo en otro lugar. Si lo está:
- en la aplicación WhatsApp o WhatsApp Business del celular: elimina la cuenta de la aplicación en el momento acordado con el equipo de ¡Hola! Suite. Consulta Eliminar la cuenta de WhatsApp en el celular para liberar el número;
- en la API de WhatsApp con otro socio: desactiva la verificación en dos pasos y haz la migración. Consulta Desactivar la verificación en dos pasos del número y Migrar el número de WhatsApp al Broker ¡Hola! Suite.
Pago de los mensajes
- Meta cobra por los mensajes enviados. En el Broker ¡Hola! Suite, el pago se hace con tarjeta de crédito internacional registrada en Meta. En Gupshup, el saldo queda en el socio; en 360 Dialog, depende del Tipo de pago elegido: Directo al socio o Intermediado. Consulta Precios de los mensajes de la API de WhatsApp.
Paso a paso
Por el Broker ¡Hola! Suite
- Accede a ¡Hola! Store y haz clic en WhatsApp.
- Haz clic en Instalar nuevo. Si ya hay un canal instalado, haz clic antes en Acceder y, en la lista, en Instalar nuevo. Se abre la ventana Instalar WhatsApp.
- En la etapa Información de identificación, completa:
- Nombre: nombre del canal dentro de ¡Hola! Suite (obligatorio).
- Agente virtual: agente virtual que va a recibir las conversaciones de este canal (opcional).
- Socio: selecciona ¡Hola! Suite.
- Haz clic en Continuar.
- En la etapa Conexión con el Socio, haz clic en Continuar con Facebook. Se abre una ventana de Meta.
- En la ventana de Meta, inicia sesión con el perfil de Facebook y sigue las etapas: elige o crea el portafolio empresarial, la cuenta de WhatsApp y el número.
- Escribe el código que Meta envíe por SMS o llamada para confirmar el número.
- Cuando se cierre la ventana de Meta, revisa en el área Selecciona qué cuenta deseas conectar:
- Cuenta: la cuenta de WhatsApp en Meta.
- Números: el número que se usará en este canal.
- Haz clic en Instalar aplicación.
Si necesitas iniciar sesión con otro perfil de Facebook o elegir otro número antes de instalar, haz clic en Editar conexión, que sustituye el botón Continuar con Facebook después del primer inicio de sesión.
Nunca elimines "¡Hola! Suite" como socio en tu cuenta de Meta. Eso desconecta el número de ¡Hola! Suite.
Por Gupshup o por 360 Dialog
Solo para empresas que ya tienen licencia de uno de estos socios. Para canales nuevos, usa el Broker ¡Hola! Suite.
- Accede a ¡Hola! Store y haz clic en WhatsApp.
- Haz clic en Instalar nuevo (o en Acceder y después en Instalar nuevo, si ya hay canal).
- En la etapa Información de identificación, completa Nombre y, si quieres, Agente virtual.
- En Socio, selecciona Gupshup o 360 Dialog.
- Haz clic en Continuar.
- Si todavía no tienes cuenta en el socio, haz clic en Crear una cuenta GupShup o Crear una cuenta 360Dialog y completa el registro en el sitio web del socio.
- En ¿Ya tiene una cuenta?, completa los datos del canal:
- Gupshup: ID de la app y Api Key.
- 360 Dialog: Channel ID, WABA account ID y Webhook; en Tipo de pago, Directo al socio o Intermediado; en Moneda de facturación, Dólar ($) o Euro (€). En el pago intermediado, la moneda no se puede cambiar.
- Haz clic en Instalar aplicación.
Desinstalar el canal
- Accede a ¡Hola! Store → WhatsApp → Acceder y haz clic en el canal.
- En la parte superior de la pantalla, haz clic en Desinstalar App.
- En la ventana Desinstalar WhatsApp, escribe el nombre del canal exactamente como está registrado.
- Haz clic en Desinstalar. El botón solo se habilita cuando el nombre coincide.
La conexión con el canal se deshace. Las atenciones en curso se interrumpen, y las atenciones finalizadas pierden su vínculo con el canal, lo que puede afectar las métricas.
Resultado esperado
Al hacer clic en Instalar aplicación, ¡Hola! Suite abre el canal creado en la pestaña Registro. A partir de ahí, los mensajes enviados al número llegan a ¡Hola! Suite y siguen el agente virtual y el flujo de comunicación configurados.
El canal también aparece en ¡Hola! Store → WhatsApp → Acceder, en la lista con las columnas Nombre, Número, Estado, Socio, Agente Virtual y Flujo de comunicación.
Configuraciones disponibles
Para ajustar el canal, accede a ¡Hola! Store → WhatsApp → Acceder y haz clic en él. Las pestañas Modelos de mensaje, Perfil y Llamadas solo están disponibles con el canal Activo. En cada sección, haz clic en Editar información para cambiar y guardar.
Pestaña Registro
Datos de registro
| Campo | Qué hace |
|---|---|
| Nombre | Nombre de identificación del canal. |
| Estado | Activo o Inactivo. |
| Agente virtual | Agente virtual responsable del canal. |
| Socio, Cuenta y Número de WhatsApp | Datos de la conexión hecha en la instalación. Solo para consulta. |
Calidad de la cuenta
| Campo | Qué muestra |
|---|---|
| Límite de conversaciones iniciadas por la empresa | Cuántas plantillas de mensaje puede enviar el canal fuera de la ventana de 24 horas por día: 2 Mil, 10 Mil o 100 Mil. Cuando Meta informa el límite del número, vale el límite de Meta. |
| Conversaciones iniciadas en las últimas 24h | Cuántas plantillas de mensaje se enviaron fuera de la ventana de 24 horas. |
| Clasificación de calidad | Calidad del número informada por Meta. Una calidad baja puede reducir el límite o restringir el número. |
¡Hola! Suite cuenta los envíos del día, de las 0h a las 23h59. Cuando se agota el límite, el envío masivo muestra el aviso "Este canal de comunicación alcanzó el límite diario de mensajes". Las reglas de Meta están en la documentación de límites de mensajes.
Información de pago (solo Gupshup y 360 Dialog)
Muestra el saldo y permite activar Notificar saldo por debajo de lo esperado, con Saldo mínimo para notificar y Usuarios a los que se debe notificar. En 360 Dialog, la sección también muestra Tipo de pago y Moneda de facturación, y el aviso de saldo solo existe en el pago Directo al socio. Consulta Agregar saldo en el hub de 360Dialog.
Preferencias
| Campo | Qué hace |
|---|---|
| Prioridad de atención en la fila | Prioridad de este canal en la distribución: Altísima, Alta, Media, Baja o Bajísima. Las atenciones de canales con mayor prioridad se presentan primero. |
| Menús interactivos | El flujo de comunicación envía las opciones como botones y listas de WhatsApp, en lugar de texto. Consulta Menús interactivos en WhatsApp. |
| Mostrar el nombre del agente en el encabezado de los mensajes | El cliente ve el nombre del agente en la parte superior de los mensajes. |
| Verificar si el contacto es humano | Confirma que quien escribe es una persona antes de abrir la atención. |
Con Verificar si el contacto es humano activo, el agente virtual pregunta "¿Eres humano?" antes de abrir la primera atención del contacto, con las opciones Sí y No en orden aleatorio. La atención solo se abre si la persona responde Sí. Después de eso, la pregunta no se repite para ese contacto. Si la respuesta es No, no se abre ninguna atención y la pregunta vuelve en el próximo mensaje.
El aviso de posición en la fila no está en el canal: se configura en la fila del departamento. Consulta Departamentos.
Pestaña Modelos de mensaje
Lista las plantillas de mensaje del número, con los botones:
- Auditar (ícono): historial de creación, edición y eliminación de las plantillas.
- Sincronizar: trae de Meta las plantillas que todavía no aparecen en ¡Hola! Suite, como las creadas en el Administrador de WhatsApp.
- Añadir nuevo: crea una plantilla y la envía para análisis de Meta. Consulta Creación de plantillas de mensaje de WhatsApp.
Pestaña Perfil
Define cómo aparece la empresa para los clientes en WhatsApp:
- Nombre de usuario: crea, edita o elimina el @ de la empresa (solo en el Broker ¡Hola! Suite). Consulta Nombres de usuario en WhatsApp.
- Información de la empresa: Foto de perfil, Área de actuación, Descripción, Dirección, Correo electrónico, Sitio web, Sitio web secundario y Mensaje.
- Previsualización: muestra cómo aparece el perfil en el celular del cliente.
Pestaña Llamadas
Configura las llamadas de voz por WhatsApp (solo en el Broker ¡Hola! Suite). Consulta Hacer y recibir llamadas por WhatsApp.
Botones en la parte superior de la pantalla
| Botón | Qué hace |
|---|---|
| Descargar registros | Descarga una hoja de cálculo con el historial técnico del canal. Útil cuando el soporte lo pida. |
| Compartir | Genera el enlace y el código QR del número. Consulta Compartir el enlace y el código QR de WhatsApp. |
| Desinstalar App | Elimina el canal. Consulta Desinstalar el canal. |
Problemas comunes
| Síntoma | Qué verificar |
|---|---|
| El socio aparece desactivado en Socio | No hay licencia disponible para ese socio. Habla con el equipo comercial. |
| El código de confirmación no llega | Verifica si el número recibe SMS o llamada, si el IVR está dirigido a una única extensión y si la cuenta de la aplicación WhatsApp ya fue eliminada. |
| El número está en otro socio y no se activa | Desactiva la verificación en dos pasos. Consulta Desactivar la verificación en dos pasos del número. |
| Las pestañas Modelos de mensaje, Perfil y Llamadas están bloqueadas | El canal está Inactivo. Cambia el Estado en Datos de registro. |
Buenas prácticas
- Usa un Nombre que identifique el número (ej.: "WhatsApp - Finanzas"), principalmente si la empresa tiene más de uno.
- Completa la pestaña Perfil: foto, descripción, dirección y sitio web transmiten confianza al cliente.
- Sigue la Clasificación de calidad y respeta las Políticas de uso de WhatsApp Business.
Contenidos relacionados
- API de WhatsApp Business
- Broker ¡Hola! Suite
- Eliminar la cuenta de WhatsApp en el celular para liberar el número
- Desactivar la verificación en dos pasos del número
- Verificar la empresa en el portafolio empresarial de Meta
- Crear una plantilla de mensaje de WhatsApp
- Configurar el agente virtual
- Grupo de permisos