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

1. Cuenta 360Dialog con un número de WhatsApp Business aprobado. Alta aquí: 360dialog.com.
2. API key (la generas en su hub).
3. Plan Pro o superior en rag.art.

Pasos

1. En rag.art → /bots/<id>/channels/whatsapp.
2. Introduce tu API key de 360Dialog y el número que conectaste.
3. 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.

1. En el hub de 360Dialog → Webhooks → pega ambos valores y guarda.
2. 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.