Enviar carrossel

Envia um carrossel de cards com imagem, texto e botões. Cada card pode ter botões de resposta rápida ou URL.

Endpoint

POST /chat/send/carousel

Parâmetros

Nome	Tipo	Obrigatório	Descrição
to	string	Sim	JID do destinatário
message	string	Sim	Texto principal acima do carrossel
carousel	object[]	Sim	Lista de cards do carrossel
carousel[].text	string	Não	Texto do card
carousel[].mediaUrl	string	Não	URL da mídia do card
carousel[].mediaType	string	Não	Tipo de mídia (image, video)
carousel[].filename	string	Não	Nome do arquivo de mídia
carousel[].caption	string	Não	Legenda da mídia
carousel[].buttons	object[]	Não	Botões do card
carousel[].buttons[].type	string	Sim	Tipo (quick_reply ou url)
carousel[].buttons[].id	string	Não	ID do botão (para quick_reply)
carousel[].buttons[].label	string	Sim	Texto do botão
carousel[].buttons[].url	string	Não	URL de destino (para url)

Request

cURL

curl -X POST https://endpoint.wi.api.br/chat/send/carousel \
  -H "x-api-key: $WIAPI_KEY" \
  -H "x-instance: session_01" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "5511998765432@s.whatsapp.net",
    "message": "Confira nossos destaques da semana:",
    "carousel": [
      {
        "text": "Camiseta Premium",
        "mediaUrl": "https://cdn.minhaempresa.com.br/produtos/camiseta.jpg",
        "mediaType": "image",
        "buttons": [
          { "type": "quick_reply", "id": "buy_cam", "label": "Comprar" },
          { "type": "url", "label": "Ver detalhes", "url": "https://minhaempresa.com.br/p/camiseta" }
        ]
      },
      {
        "text": "Calça Jeans Slim",
        "mediaUrl": "https://cdn.minhaempresa.com.br/produtos/calca.jpg",
        "mediaType": "image",
        "buttons": [
          { "type": "quick_reply", "id": "buy_cal", "label": "Comprar" }
        ]
      }
    ]
  }'

JavaScript

const response = await fetch("https://endpoint.wi.api.br/chat/send/carousel", {
  method: "POST",
  headers: {
    "x-api-key": process.env.WIAPI_KEY,
    "x-instance": "session_01",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    to: "5511998765432@s.whatsapp.net",
    message: "Confira nossos destaques da semana:",
    carousel: [
      {
        text: "Camiseta Premium",
        mediaUrl: "https://cdn.minhaempresa.com.br/produtos/camiseta.jpg",
        mediaType: "image",
        buttons: [
          { type: "quick_reply", id: "buy_cam", label: "Comprar" },
          { type: "url", label: "Ver detalhes", url: "https://minhaempresa.com.br/p/camiseta" },
        ],
      },
      {
        text: "Calça Jeans Slim",
        mediaUrl: "https://cdn.minhaempresa.com.br/produtos/calca.jpg",
        mediaType: "image",
        buttons: [
          { type: "quick_reply", id: "buy_cal", label: "Comprar" },
        ],
      },
    ],
  }),
});

const data = await response.json();

Python

import requests

response = requests.post(
    "https://endpoint.wi.api.br/chat/send/carousel",
    headers={
        "x-api-key": WIAPI_KEY,
        "x-instance": "session_01",
    },
    json={
        "to": "5511998765432@s.whatsapp.net",
        "message": "Confira nossos destaques da semana:",
        "carousel": [
            {
                "text": "Camiseta Premium",
                "mediaUrl": "https://cdn.minhaempresa.com.br/produtos/camiseta.jpg",
                "mediaType": "image",
                "buttons": [
                    {"type": "quick_reply", "id": "buy_cam", "label": "Comprar"},
                    {"type": "url", "label": "Ver detalhes", "url": "https://minhaempresa.com.br/p/camiseta"},
                ],
            },
            {
                "text": "Calça Jeans Slim",
                "mediaUrl": "https://cdn.minhaempresa.com.br/produtos/calca.jpg",
                "mediaType": "image",
                "buttons": [
                    {"type": "quick_reply", "id": "buy_cal", "label": "Comprar"},
                ],
            },
        ],
    },
)

data = response.json()

Response

{
  "messageId": "3EB0C3D4E5F6A7B80D9E31",
  "messageid": "3EB0C3D4E5F6A7B80D9E31"
}