WhatsApp Business
rag.art usa 360Dialog como proveedor oficial de la WhatsApp Business API. La conexión toma 10 minutos una vez tengas la cuenta aprobada por Meta.
Requisitos previos
- Cuenta 360Dialog con un número de WhatsApp Business aprobado. Alta aquí: 360dialog.com.
- API key (la generas en su hub).
- Plan Pro o superior en rag.art.
Pasos
- En rag.art →
/bots/<id>/channels/whatsapp. - Introduce tu API key de 360Dialog y el número que conectaste.
- rag.art genera dos valores que debes copiar en 360Dialog:
- Webhook URL:
https://rag.art/api/channels/whatsapp/webhook?bot=<id>. - Verify token: cadena aleatoria de 32 caracteres.
- En el hub de 360Dialog → Webhooks → pega ambos valores y guarda.
- Envía un mensaje de prueba al número desde un teléfono cualquiera. En la pestaña deberías ver "Última conexión: hace <1min" y el bot responder.
Límites y políticas
- WhatsApp limita los mensajes proactivos (iniciados por la empresa) a plantillas aprobadas por Meta. rag.art no envía mensajes proactivos por defecto: solo responde a conversaciones iniciadas por el usuario.
- Dentro de la ventana de 24h tras el último mensaje del usuario, puedes responder con texto libre. Fuera de esa ventana necesitas plantilla.
- Si un usuario envía audios o imágenes, el bot responde "Por ahora solo entiendo texto". El soporte de audio (Whisper) está en roadmap.
Cómo se debitan los mensajes
Cada mensaje de respuesta que genera el bot consume 1 mensaje de tu cuota, igual que en el widget. El envío por WhatsApp no tiene coste adicional de 360Dialog per-conversation si estás en tu plan estándar, pero revisa con ellos los costes de "business-initiated conversations" si los usas.
Desconectar
/bots/<id>/channels/whatsapp → botón Desconectar. Elimina el webhook en 360Dialog y marca el canal como disconnected en rag.art. La conversación histórica permanece consultable.
Troubleshooting
- El bot no responde: revisa que el webhook en 360Dialog apunta a rag.art y que la verificación fue exitosa.
- Respuestas recortadas: WhatsApp limita a 4 096 caracteres por mensaje; rag.art parte en varios chunks automáticamente.
- Número rechazado por Meta: es asunto de 360Dialog; su soporte ayuda a reintentar la verificación.