Carrusel

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": "CAROUSEL",
    "userId": "USER_ID",
    "text": "Mira nuestras ofertas",
    "parameters": {
      "cards": [
        {
          "card_index": 0,
          "type": "cta_url",
          "header": {
            "type": "image",
            "image": { "link": "https://example.com/image1.png" }
          },
          "body": { "text": "Oferta exclusiva #1" },
          "action": {
            "name": "cta_url",
            "parameters": {
              "display_text": "Comprar",
              "url": "https://shop.example.com/deal1"
            }
          }
        },
        {
          "card_index": 1,
          "type": "cta_url",
          "header": {
            "type": "image",
            "image": { "link": "https://example.com/image2.png" }
          },
          "body": { "text": "Oferta exclusiva #2" },
          "action": {
            "name": "cta_url",
            "parameters": {
              "display_text": "Comprar",
              "url": "https://shop.example.com/deal2"
            }
          }
        }
      ]
    }
  }'

{
  "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": "CAROUSEL",
    "userId": "USER_ID",
    "text": "Mira nuestras ofertas",
    "parameters": {
      "cards": [
        {
          "card_index": 0,
          "type": "cta_url",
          "header": {
            "type": "image",
            "image": { "link": "https://example.com/image1.png" }
          },
          "body": { "text": "Oferta exclusiva #1" },
          "action": {
            "name": "cta_url",
            "parameters": {
              "display_text": "Comprar",
              "url": "https://shop.example.com/deal1"
            }
          }
        },
        {
          "card_index": 1,
          "type": "cta_url",
          "header": {
            "type": "image",
            "image": { "link": "https://example.com/image2.png" }
          },
          "body": { "text": "Oferta exclusiva #2" },
          "action": {
            "name": "cta_url",
            "parameters": {
              "display_text": "Comprar",
              "url": "https://shop.example.com/deal2"
            }
          }
        }
      ]
    }
  }'

{
  "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": {}
}

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": "CAROUSEL",
    "userId": "USER_ID",
    "text": "Mira nuestras ofertas",
    "parameters": {
      "cards": [
        {
          "card_index": 0,
          "type": "cta_url",
          "header": {
            "type": "image",
            "image": { "link": "https://example.com/image1.png" }
          },
          "body": { "text": "Oferta exclusiva #1" },
          "action": {
            "name": "cta_url",
            "parameters": {
              "display_text": "Comprar",
              "url": "https://shop.example.com/deal1"
            }
          }
        },
        {
          "card_index": 1,
          "type": "cta_url",
          "header": {
            "type": "image",
            "image": { "link": "https://example.com/image2.png" }
          },
          "body": { "text": "Oferta exclusiva #2" },
          "action": {
            "name": "cta_url",
            "parameters": {
              "display_text": "Comprar",
              "url": "https://shop.example.com/deal2"
            }
          }
        }
      ]
    }
  }'

Estructura de cada tarjeta

Campo	Tipo	Descripción
`card_index`	number	Posición de la tarjeta (empezando en 0).
`type`	string	Opcional. Inclúyelo solo cuando la acción es `cta_url`. Omítelo para tarjetas con botones `quick_reply`.
`header.type`	string	`image` o `video`.
`header.image.link` / `header.video.link`	string	URL pública del header.
`body.text`	string	Texto del cuerpo de la tarjeta.
`action`	object	Acción al interactuar con la tarjeta.

Tarjeta con botones de respuesta rápida

No incluyas el campo type a nivel de la tarjeta cuando uses botones quick_reply. Solo se incluye cuando la acción es cta_url. Si lo agregas en tarjetas con quick_reply, Meta rechaza el mensaje con error 400/500.

{
  "card_index": 0,
  "header": {
    "type": "image",
    "image": { "link": "https://example.com/image.png" }
  },
  "body": { "text": "¿Te interesa esta oferta?" },
  "action": {
    "buttons": [
      {
        "type": "quick_reply",
        "quick_reply": {
          "title": "Sí, comprar",
          "payload": { "option": "buy" }
        }
      },
      {
        "type": "quick_reply",
        "quick_reply": {
          "title": "No, gracias",
          "payload": { "option": "skip" }
        }
      }
    ]
  }
}

Campos del botón `quick_reply`

Campo	Tipo	Descripción
`quick_reply.title`	string	Texto visible del botón (máx. 20 caracteres).
`quick_reply.payload`	object \| string	Información que recibirás en el webhook cuando el usuario seleccione el botón. Útil para identificar qué tarjeta eligió.
`quick_reply.id`	string	Opcional. Si no lo envías, el sistema genera un UUID automáticamente.

Restricciones

Tarjetas: mínimo 1, máximo 10 por carrusel.
Header: solo image o video.
Providers compatibles: WhatsApp Cloud API y Gupshup CAPI.

Este es un carrusel interactivo enviado dentro de una sesión activa de WhatsApp. No requiere plantilla HSM aprobada por Meta.

Casos de Uso

Catálogos de productos con CTA a la tienda
Comparación de planes o servicios
Promociones múltiples con botones de compra
Selección rápida entre opciones con imagen

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"

Llamada

Workflows

⌘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

Estructura de cada tarjeta

Tarjeta con botones de respuesta rápida

Campos del botón `quick_reply`

Restricciones

Casos de Uso

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta

​Estructura de cada tarjeta

​Tarjeta con botones de respuesta rápida

​Campos del botón quick_reply

​Restricciones

​Casos de Uso

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta

Estructura de cada tarjeta

Tarjeta con botones de respuesta rápida

Campos del botón `quick_reply`

Restricciones

Casos de Uso