Llamada

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": "voice_call",
    "header": "¿Necesitas Ayuda?",
    "text": "Haz clic en el botón para hablar con un agente",
    "userId": "USER_ID",
    "parameters": {
      "display_text": "Llamar Soporte"
    }
  }'

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

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

POST

bots

{botId}

messages

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": "voice_call",
    "header": "¿Necesitas Ayuda?",
    "text": "Haz clic en el botón para hablar con un agente",
    "userId": "USER_ID",
    "parameters": {
      "display_text": "Llamar Soporte"
    }
  }'

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

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

Configuración Requerida: Para enviar mensajes con botones de llamada, tu cuenta de WhatsApp debe tener la configuración de llamadas activada. Contacta al equipo de soporte para más información.

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": "voice_call",
    "header": "¿Necesitas Ayuda?",
    "text": "Haz clic en el botón para hablar con un agente",
    "userId": "USER_ID",
    "parameters": {
      "display_text": "Llamar Soporte"
    }
  }'

Mejores Prácticas

Uso Moderado: Usa botones de llamada con moderación y solo cuando el soporte en vivo sea realmente necesario. Asegúrate de que tu equipo de soporte esté disponible cuando se envíen estos botones.

Casos de Uso

Soporte en vivo urgente
Consultas complejas que requieren explicación verbal
Servicio al cliente personalizado
Escalación de problemas técnicos

Autorizaciones

Authorization

string

header

requerido

Basic authentication using Base64 encoded clientId:clientSecret

Parámetros de ruta

botId

string

requerido

The unique identifier of the bot

Cuerpo

application/json

Message payload. The structure varies based on the message type.

type

enum<string>

requerido

Type of message to send

Opciones disponibles:

text

Ejemplo:

"text"

userId

string

requerido

Unique identifier of the user receiving the message. Accepts either a phone number in E.164 format without the leading '+' (e.g. '593999999999') or a BSUID (Business-Scoped User ID, e.g. 'US.13491208655302741918') for users who have enabled phone number privacy in WhatsApp.

Ejemplo:

"593999999999"

text

string

requerido

Text content of the message

Ejemplo:

"Hello, this is a text message"

botId

string

Unique identifier of the bot sending the message

Ejemplo:

"BOT_ID"

Respuesta

Message sent successfully

success

boolean

Ejemplo:

true

messageId

string

Ejemplo:

"msg_123456789"

Whatsapp Flows

Carrusel

⌘I

API reference

Envío de mensajes

Campañas

Conversaciones

Métricas

Usuarios

Recursos

Widget

Datum

Panel de Atención Externo

Gestión de Memoria

Mejores Prácticas

Casos de Uso

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta

​Mejores Prácticas

​Casos de Uso

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta

Mejores Prácticas

Casos de Uso