Envío de Mensajes

WhatsApp permite enviar mensajes fácilmente a los usuarios a través de chatbots, para que los clientes reciban información en distintos formatos mediante su canal de mensajería preferido.

Al usar esta API y configurar los parámetros en la solicitud, puedes escribir un mensaje, definir su Tipo de dato y enviarlo a un usuario de WhatsApp. También puedes identificar los parámetros obligatorios y opcionales. Tras enviar la solicitud, recibirás una respuesta con el resultado.

El envío de mensajes es una herramienta poderosa para llegar a múltiples usuarios al mismo tiempo. Esto es posible creando plantillas comunes y personalizando variables para cada usuario, permitiendo enviar todos los mensajes de una vez. Para ello, se pueden utilizar Mensajes Altamente Estructurados (HSM).

Además, la comunicación saliente permite enviar mensajes personalizados y gestionar interacciones posteriores mediante webhooks, facilitando una comunicación más precisa y efectiva.

Métodos de envío de mensajes

Existen dos enfoques principales para enviar mensajes en WhatsApp:

1. Interacciones Abiertas Automáticas:
   Incluye mensajes como difusiones, plantillas, respuestas rápidas y autorespuestas. Son iniciadas por una Cuenta de WhatsApp Business cuando el usuario interactúa con la marca por primera vez.

2. Interacciones Iniciadas Manualmente:
   Las marcas pueden responder con mensajes simples o botones interactivos, enviar publicidad segmentada, solicitar opiniones o enviar encuestas. Esto permite una comunicación más proactiva.

⚠️ Importante: Este endpoint solo enviará mensajes a usuarios que hayan contactado con el bot en las últimas 24 horas.

Enviar un mensaje

[POST] [https://api.jelou.ai/v1/whatsapp/messages]

Este endpoint te permite enviar un mensaje individual y elegir su Tipo de dato (texto, audio, imagen, etc.).

Cuerpo de la solicitud

Propiedad	Tipo de dato de dato	Descripción
userId	string	Número de teléfono del cliente (sin el signo "+").
type	string	Tipo de dato de mensaje: texto, imagen, archivo o ubicación.
botId	string	ID del bot.

Respuesta exitosa (200)

{
  "messageId": "<messageId>",
  "bubble": {
    "type": "<type>",
    "text": "<text>"
  },
  "botId": "<botId>",
  "userId": "<userId>",
  "received": <time given in milliseconds>,
  "status": "<status>"
}

nota

💡 Dependiendo del Tipo de dato de mensaje, pueden requerirse argumentos adicionales. Consulta Tipo de datos de Mensajes para más detalles.