Mensaje de Texto

Envía un mensaje de texto simple a un usuario

POST /v1/bots/{botId}/messages

cURL

curl --request POST \
  --url https://api.jelou.ai/v1/bots/BOT_ID/messages \
  --header 'Authorization: Basic <Base64Encoded clientId:clientSecret>' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "text",
    "text": "Hola, este es un mensaje de texto",
    "userId": "USER_ID"
  }'

200

{
  "success": true,
  "messageId": "msg_123456789"
}

cURL

curl --request POST \
  --url https://api.jelou.ai/v1/bots/BOT_ID/messages \
  --header 'Authorization: Basic <Base64Encoded clientId:clientSecret>' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "text",
    "text": "Hola, este es un mensaje de texto",
    "userId": "USER_ID"
  }'

200

{
  "success": true,
  "messageId": "msg_123456789"
}

​

Parámetros de ruta

botId · string · requerido

Identificador único del bot que envía el mensaje.

​

Parámetros del cuerpo

type · string · requerido

Tipo de mensaje. Debe ser "text".

userId · string · requerido

Destinatario del mensaje. Acepta un número de teléfono en formato E.164 sin el signo + (ej: 593999999999) o un BSUID (ej: US.13491208655302741918) para usuarios con protección de número activada en WhatsApp. Consulta Identificación del destinatario.

text · string · requerido

Contenido del mensaje.

previewUrl · boolean · predeterminado: "true"

Envía false para que los enlaces del mensaje lleguen sin la tarjeta de vista previa. Si lo omites, WhatsApp muestra la vista previa. Solo aplica a WhatsApp Cloud API y Gupshup CAPI; en otros canales y proveedores se ignora. Consulta Vista previa de enlaces.

​

Respuesta

success · boolean

true si el mensaje se envió correctamente.

messageId · string

Identificador del mensaje enviado.

​

Vista previa de enlaces

Cuando el mensaje incluye un enlace, WhatsApp muestra una tarjeta con el título, la descripción y la imagen de la página. Con previewUrl: false el enlace se envía como texto, sin esa tarjeta, y el usuario se enfoca en el mensaje. Es la misma opción Desactivar vista previa de enlaces del nodo Texto.

Valor de previewUrl	Resultado
false	El enlace se envía sin vista previa
true	El enlace se envía con vista previa
Sin enviar	El enlace se envía con vista previa

El campo va en la raíz del cuerpo, al mismo nivel que text, y acepta true o false. Cualquier otro valor responde con un error 422.

Cuerpo sin vista previa

{
  "type": "text",
  "text": "Revisa tu estado de cuenta aquí: https://example.com/estado",
  "previewUrl": false,
  "userId": "USER_ID"
}

No uses el formato de la API de Meta ("text": { "body": "...", "preview_url": false }). En este endpoint text debe ser un texto, así que ese cuerpo responde con un error 422.

previewUrl solo aplica a canales de WhatsApp conectados con WhatsApp Cloud API o Gupshup CAPI. En Instagram, Messenger y otros proveedores de WhatsApp el campo se ignora.

​

Límite de caracteres por canal

Canal	Límite
WhatsApp	4.096 caracteres
Instagram	1.000 caracteres
Messenger	1.000 caracteres

​

Casos de Uso

• Notificaciones simples
• Confirmaciones
• Mensajes informativos
• Respuestas automáticas básicas
• Enlaces a pagos, estados de cuenta o formularios sin vista previa

​

Siguientes pasos

Nodo Texto

Desactiva la vista previa de enlaces desde un workflow.

Mensaje con Opciones

Envía un texto con botones de selección.