Skip to main content

​
Endpoint

POST https://api.jelou.ai/v1/bots/{botId}/messages

​
Parámetros de Ruta

​
botId
string
required
Identificador único del bot que envía el mensaje.

​
Cuerpo de la Solicitud

​
type
string
required
Debe ser "cta_url".
​
title
string
required
Encabezado del mensaje mostrado al usuario.
​
text
string
required
Contenido del mensaje.
​
caption
string
required
Texto de pie de página mostrado debajo del mensaje.
​
userId
string
required
Identificador único del usuario que recibirá el mensaje.
​
parameters
object
required
Configuración del botón URL.

​
Ejemplos de Solicitud

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": "cta_url",
    "title": "Bienvenido",
    "text": "Visita nuestro sitio web para aprender más",
    "caption": "Jelou",
    "userId": "USER_ID",
    "parameters": {
      "url": "https://apps.jelou.ai",
      "display_text": "Visitar Sitio Web"
    }
  }'

​
Respuesta

​
success
boolean
Indica si el mensaje fue enviado exitosamente.
​
messageId
string
Identificador único del mensaje enviado.

​
Ejemplo de Respuesta

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

​
Mejores Prácticas

URLs Seguras: Asegúrate de que las URLs sean HTTPS y proporcionen texto de botón claro y accionable.

​
Casos de Uso

  • Dirigir usuarios a sitios web externos
  • Enlazar a aplicaciones web
  • Compartir recursos en línea
  • Redirigir a formularios o páginas de registro