Enviar mensajes de WhatsApp
WhatsApp es una plataforma de mensajería globalmente popular que permite una comunicación segura y confiable entre individuos y empresas.
La API de WhatsApp Business proporciona a las organizaciones potentes capacidades para:
- Interactuar con clientes: Enviar mensajes personalizados, notificaciones y actualizaciones directamente a la aplicación de mensajería preferida de los clientes
- Automatizar conversaciones: Crear chatbots interactivos y sistemas de respuesta automatizada para consultas comunes
- Mejorar el soporte: Proporcionar servicio al cliente en tiempo real a través de una interfaz familiar con soporte para contenido multimedia
- Impulsar conversiones: Facilitar transacciones y seguimientos con clientes en un entorno seguro y conforme
En Mandala, la integración con WhatsApp permite a tus agentes aprovechar estas capacidades de mensajería como parte de sus flujos de trabajo. Esto crea oportunidades para escenarios sofisticados de interacción con clientes como recordatorios de citas, códigos de verificación, alertas y conversaciones interactivas. La integración conecta tus flujos de trabajo de IA con los canales de comunicación de los clientes, permitiendo que tus agentes entreguen información oportuna y relevante directamente a los dispositivos móviles de los usuarios. Al conectar Mandala con WhatsApp, puedes construir agentes inteligentes que interactúen con los clientes a través de su plataforma de mensajería preferida, mejorando la experiencia del usuario mientras automatizas tareas rutinarias de mensajería.
Instrucciones de uso
Integrar WhatsApp en el flujo de trabajo. Puede enviar mensajes.
Herramientas
whatsapp_send_message
Enviar mensajes de WhatsApp
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
phoneNumber | string | Sí | Número de teléfono del destinatario con código de país |
phoneNumberId | string | Sí | ID del número de teléfono de WhatsApp Business |
accessToken | string | Sí | Token de acceso de WhatsApp Business API (admite variables de entorno como {{WHATSAPP_ACCESS_TOKEN}}) |
mode | string | No | Modo: text, interactive, image, video, audio, document, sticker, location, contacts, reaction, raw (legacy: media con media.type) |
message | string | No | Cuerpo del mensaje (obligatorio solo para mode=text) |
media | object | No | Media para image/video/audio/document/sticker (requiere link; opcional caption/filename) |
interactive | object | No | Payload interactivo (lista/botones) |
location | object | No | Ubicación (latitude, longitude, opcional name, address) |
contacts | object | No | Contactos (array de contactos del Cloud API) |
reaction | object | No | Reacción (message_id, emoji) |
rawPayload | object | No | Enviar un payload raw de WhatsApp Cloud API (avanzado) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Estado de éxito del envío |
messageId | string | Identificador único del mensaje de WhatsApp (cuando esté disponible) |
httpStatus | number | Código HTTP devuelto por WhatsApp/Graph API |
error | string | Mensaje de error (si aplica) |
rawResponse | json | Respuesta completa de la API (útil para depuración) |
Notas sobre multimedia
- Para modos de media (
image/video/audio/document/sticker),media.linkdebe ser una URL directa y pública al archivo (por ejemplo,https://.../file.mp4que devuelva los bytes). - Los enlaces de YouTube no son archivos directos; envíalos como texto.
- Los stickers deben ser WebP (
image/webp). - Si aparece “File too large” al subir, reduce el tamaño/bitrate del archivo o envía un enlace como texto.
Notas
- Categoría:
tools - Tipo:
whatsapp