> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oxenty.api.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Enviar Carrossel

> Envia mensagem com carrossel de produtos

Envia uma mensagem interativa com carrossel de até 10 cards de produtos. Cada card pode ter imagem, título, descrição, preço e até 2 botões de ação.

## Request Body

<ParamField body="sessionId" type="string" required>
  ID da sessão WhatsApp.
</ParamField>

<ParamField body="to" type="string" required>
  Número do destinatário ou JID de grupo.
</ParamField>

<ParamField body="title" type="string">
  Título do carrossel (opcional).
</ParamField>

<ParamField body="footer" type="string">
  Texto de rodapé (opcional).
</ParamField>

<ParamField body="cards" type="array" required>
  Array de cards (máximo 10).

  <Expandable title="Propriedades do card">
    <ParamField body="image" type="string">
      URL da imagem do produto.
    </ParamField>

    <ParamField body="title" type="string" required>
      Título do card.
    </ParamField>

    <ParamField body="description" type="string">
      Descrição do produto.
    </ParamField>

    <ParamField body="buttons" type="array">
      Botões de ação (máximo 2).
    </ParamField>
  </Expandable>
</ParamField>

## Resposta

<ResponseField name="messageId" type="string">
  ID único da mensagem enviada.
</ResponseField>

<RequestExample>
  ```bash cURL theme={"system"}
  curl -X POST "https://api.oxenty.api.br/api/messages/carousel" \
    -H "X-API-Key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "sessionId": "550e8400-e29b-41d4-a716-446655440000",
      "to": "5511999999999",
      "title": "Nossos Produtos",
      "cards": [
        {
          "image": "https://example.com/produto1.jpg",
          "title": "Produto 1",
          "description": "Descrição do produto 1 - R$ 99,90",
          "buttons": [
            { "buttonId": "buy1", "buttonText": "Comprar" },
            { "buttonId": "info1", "buttonText": "Mais info" }
          ]
        },
        {
          "image": "https://example.com/produto2.jpg",
          "title": "Produto 2",
          "description": "Descrição do produto 2 - R$ 149,90",
          "buttons": [
            { "buttonId": "buy2", "buttonText": "Comprar" }
          ]
        }
      ]
    }'
  ```

  ```typescript TypeScript theme={"system"}
  const result = await client.messages.sendCarousel({
    sessionId: '550e8400-e29b-41d4-a716-446655440000',
    to: '5511999999999',
    title: 'Nossos Produtos',
    cards: [
      {
        image: 'https://example.com/produto1.jpg',
        title: 'Produto 1',
        description: 'Descrição do produto 1 - R$ 99,90',
        buttons: [
          { buttonId: 'buy1', buttonText: 'Comprar' },
          { buttonId: 'info1', buttonText: 'Mais info' },
        ],
      },
    ],
  });
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={"system"}
  {
    "messageId": "3EB0A1B2C3D4E5F6",
    "status": "sent"
  }
  ```
</ResponseExample>

<Warning>
  Este recurso pode não funcionar em todas as versões do WhatsApp. Recomendamos testar antes de usar em produção.
</Warning>