Configuración de WhatsApp
Argonautas admite mensajería bidireccional de WhatsApp. Una vez conectado, los mensajes de WhatsApp de los huéspedes aparecerán en su bandeja de entrada unificada junto con los mensajes de correo electrónico, SMS y OTA. Esta guía cubre todo el proceso de configuración, los requisitos de las plantillas de mensajes y la solución de problemas.
Descripción general
La API de WhatsApp Business es la base para la comunicación profesional por WhatsApp. A diferencia de la aplicación de WhatsApp para consumidores, la API de WhatsApp Business permite a su equipo gestionar conversaciones desde una bandeja de entrada compartida, enviar mensajes de plantilla y automatizar respuestas, todo sin vincular el canal a un solo teléfono. Argonautas se conecta a su cuenta de WhatsApp Business para gestionar el aprovisionamiento de números, el enrutamiento y la entrega de mensajes.
Requisitos
Antes de comenzar, asegúrese de tener lo siguiente:
| Requisito | Detalles |
|---|---|
| Número de WhatsApp Business | Un número de teléfono registrado (o que se pueda registrar) con WhatsApp Business. Puede ser un número nuevo o uno existente, pero no puede estar actualmente en uso con la aplicación de WhatsApp para consumidores. |
| Cuenta del proveedor de mensajería | Una cuenta activa con nuestro proveedor de mensajería de WhatsApp, con acceso a la API. Su clave API debe tener estos permisos: Channels Sending and Receiving, Contacts API Access, Numbers API Access, Template Management, Webhook Subscription Management, Channels Viewer, Conversations API Access. Contacte a soporte si necesita ayuda para obtener las credenciales. |
| Facebook Business Manager | Una cuenta de Meta Business verificada vinculada a su perfil de WhatsApp Business. La API de WhatsApp Business requiere la verificación de Meta. |
| Acceso de administrador a Argonautas | Necesita privilegios de administrador para configurar canales de mensajería en Configuración. |
Conectar su número
Paso 1: Configurar las credenciales del proveedor
- Navegue a Configuración > Mensajería en Argonautas.
- En la sección WhatsApp, haga clic en Conectar WhatsApp.
- Ingrese su Clave API y su ID de espacio de trabajo. Estos se encuentran en el panel de control de su proveedor de mensajería, en Configuración de la API.
- Haga clic en Verificar conexión para confirmar que las credenciales son válidas.
Paso 2: Seleccionar su número
Una vez verificadas las credenciales, Argonautas consulta su espacio de trabajo de mensajería en busca de números de WhatsApp disponibles:
- Aparece una lista de números registrados en el modal de conexión.
- Seleccione el número que desea conectar.
- Haga clic en Conectar.
El sistema crea automáticamente el conector de canal y las suscripciones de webhook necesarias. No necesita configurar los webhooks manualmente.
[Captura de pantalla: El modal Conectar WhatsApp mostrando las credenciales verificadas y una lista de números disponibles para conectar.]
Paso 3: Verificar la conexión
Después de conectarse, la sección de WhatsApp en Configuración > Mensajería muestra:
- Estado: Conectado (indicador verde)
- Número: Su número de WhatsApp Business conectado
- ID del canal: El identificador del canal (útil para solicitudes de soporte)
Para confirmar que todo funciona de extremo a extremo, envíe un mensaje de prueba (consulte Pruebas a continuación).
Plantillas de mensajes
La API de WhatsApp Business requiere plantillas de mensajes preaprobadas para iniciar conversaciones con los clientes. Puede responder libremente dentro de un período de 24 horas después del último mensaje del cliente, pero iniciar una nueva conversación o enviar mensajes después de que se cierre el período requiere una plantilla.
Reglas de las plantillas
- Las plantillas deben enviarse a Meta para su aprobación a través de nuestro proveedor de mensajería.
- La aprobación suele tardar entre 24 y 48 horas.
- Las plantillas pueden incluir variables dinámicas (por ejemplo, nombre del huésped, fecha de check-in, nombre de la propiedad) que se completan en el momento del envío.
- Las plantillas deben seguir las políticas de contenido de Meta: sin contenido promocional en plantillas de utilidad, sin información engañosa.
Plantillas comunes para la gestión de propiedades
| Nombre de la plantilla | Caso de uso | Contenido de ejemplo |
|---|---|---|
| Confirmación de reserva | Se envía cuando se confirma una nueva reserva | "Hola , su reserva en del al está confirmada." |
| Información previa a la llegada | Se envía 1 o 2 días antes del check-in | "¡Bienvenido! Aquí están sus instrucciones de check-in para ..." |
| Seguimiento posterior al check-out | Se envía después de la salida | "Gracias por hospedarse en . Esperamos que haya disfrutado su visita." |
| Recordatorio de pago | Se envía cuando el saldo está vencido | "Hola , un pago de está pendiente para su próxima estadía." |
Las plantillas se gestionan en Configuración > Mensajería > Plantillas. Cree el contenido de la plantilla en Argonautas y se enviará a Meta para su aprobación.
Probar la conexión
Después de la configuración, verifique que los mensajes fluyan correctamente en ambas direcciones:
- Prueba de entrada: Envíe un mensaje de WhatsApp desde un teléfono personal a su número de Business conectado. El mensaje debería aparecer en la Bandeja de entrada de Argonautas en cuestión de segundos.
- Prueba de salida: Desde la Bandeja de entrada, responda al mensaje de prueba. La respuesta debería llegar al teléfono personal como un mensaje de WhatsApp de su número de Business.
- Prueba de plantilla: Si tiene plantillas aprobadas, use la función de redacción para enviar un mensaje de plantilla a un número de prueba. Verifique que la plantilla se muestre correctamente con las variables completadas.
Si algún paso falla, consulte la sección de solución de problemas a continuación.
Solución de problemas
Los mensajes no llegan a la Bandeja de entrada
Verifique la configuración del webhook. Argonautas registra los webhooks automáticamente durante la configuración. Si los webhooks se eliminaron accidentalmente, desconecte y vuelva a conectar el canal de WhatsApp en Configuración > Mensajería para volver a registrarlos.
Verifique los permisos de la clave API. La clave API debe incluir los permisos "Channels Sending and Receiving" y "Webhook Subscription Management". La falta de permisos impedirá la entrega de mensajes.
Verifique el panel de control de su proveedor. Confirme que el canal se muestre como activo. Si el proveedor informa fallos de entrega, el problema está aguas arriba de Argonautas.
Los mensajes salientes fallan
Período de 24 horas vencido. Si han pasado más de 24 horas desde el último mensaje del cliente, debe usar una plantilla aprobada para reanudar la conversación. Los mensajes libres serán rechazados por WhatsApp.
Plantilla no aprobada. Verifique el estado de aprobación de la plantilla en Configuración > Mensajería > Plantillas. Las plantillas pendientes o rechazadas no se pueden enviar.
Número no verificado. Si la verificación de su cuenta de Meta Business está incompleta, WhatsApp puede restringir el envío de mensajes salientes. Complete la verificación en Meta Business Manager.
La conexión se muestra como desconectada
Clave API caducada o revocada. Genere una nueva clave API en el panel de control de su proveedor y actualícela en Configuración > Mensajería.
Problema con el espacio de trabajo. Verifique que el ID del espacio de trabajo sea correcto y que el espacio de trabajo esté activo. El proveedor ocasionalmente requiere una reautenticación después de cambios en la facturación o el plan.
Vuelva a conectar el canal. Si las credenciales son correctas pero la conexión permanece inactiva, desconecte el canal de WhatsApp y vuelva a conectarlo. Esto vuelve a registrar todos los conectores y webhooks.
Mensajes entregados pero sin confirmaciones de lectura
Las confirmaciones de lectura (dos palomitas azul verdosas) dependen de la configuración de privacidad de WhatsApp del destinatario. Si un huésped ha desactivado las confirmaciones de lectura en su teléfono, los mensajes se mostrarán como entregados (dos palomitas grises) pero nunca como leídos. Este es el comportamiento normal de WhatsApp y no es un problema del sistema.
Conceptos clave
- Período de 24 horas -- Regla de WhatsApp que permite respuestas libres solo dentro de las 24 horas posteriores al último mensaje del cliente. Después de eso, solo se pueden enviar plantillas aprobadas.
- Plantilla de mensaje -- Un formato de mensaje preaprobado requerido para iniciar conversaciones o enviar mensajes fuera del período de 24 horas.
- Webhook -- Una devolución de llamada HTTP automatizada usada para enviar mensajes entrantes a Argonautas en tiempo real.
Preguntas frecuentes
¿Puedo usar mi número de WhatsApp existente? Sí, pero el número debe migrarse a la API de WhatsApp Business. Esto significa que ya no funcionará con las aplicaciones de WhatsApp para consumidores o WhatsApp Business. La migración se maneja a través de su proveedor de mensajería y Meta Business Manager.
¿Cuántos números de WhatsApp puedo conectar? Puede conectar un número de WhatsApp por empresa en Argonautas. Si gestiona varias marcas o empresas, cada una puede tener su propio número.
¿Los huéspedes necesitan guardar mi número para enviarme un mensaje? No. Los huéspedes pueden enviar mensajes directamente a su número de WhatsApp Business. Sin embargo, tener su número guardado facilita que los huéspedes lo encuentren y le envíen mensajes.
¿Qué sucede si el proveedor de mensajería tiene una interrupción? Los mensajes de WhatsApp entrantes y salientes se retrasarán hasta que se resuelva la interrupción. Los mensajes se ponen en cola y se entregan una vez que se restablece la conectividad. Contacte a soporte para obtener actualizaciones de estado en tiempo real.
¿Puedo enviar mensajes de WhatsApp a huéspedes que reservaron a través de Airbnb? Solo si tiene el número de teléfono del huésped y este ha iniciado una conversación de WhatsApp con usted (o si tiene una plantilla aprobada para contactarlo). Las políticas de privacidad de las OTA pueden limitar la disponibilidad del número de teléfono.
Relacionado
- Guía de mensajería -- La bandeja de entrada unificada y la gestión de conversaciones.
- Configuración de SMS -- Conectar canales de SMS.
- Configuración: Mensajería -- Todas las opciones de configuración de canales de mensajería.