API Botão Carrossel

🧩 A API de botões Carrossel permite o envio de um Carrossel de Imagens acompanhadas por texto e botões de ação.

API: Pro

Verifique aqui os Pré-Requisitos para utilizar Botões

Endpoint

https://{BACKEND_URL}/api/messages/whatsmeow/sendCarousel

Método

POST

Autenticação

Bearer {seutokenaqui}

Payload

{
    "number": "",
    "openTicket": "0",
    "queueId": 0,
    "cards": [
        {
          "title": "Produto 1",
          "body": "Descrição do produto",
          "footer": "R$ 99,90",
          "imageUrl": "https://picsum.photos/400/400",
          "buttons": [
            {"id": "comprar_1", "text": "Comprar"},
            {"id": "info_1", "text": "Mais info"}
          ]
        },
        {
          "title": "Produto 2",
          "body": "Outro produto incrível",
          "footer": "R$ 149,90",
          "imageUrl": "https://picsum.photos/401/401",
          "buttons": [
            {"id": "comprar_2", "text": "Comprar"}
          ]
        }
    ]
  }

➡️ “number”: telefone do destinatário no formato ddi ddd numero (somente números) ➡️ “openTicket”: – “0” Não abre ticket– “1” Abre Ticket – Atenção: para abrir ticket é obrigatório definir uma fila. – ao abrir ticket a conversa irá para aguardando mesmo que já esteja em atendimento. “queueId”: ID da fila desejada ( Só funciona quando "openTicket": "1" )

➡️ “cards”: array de cards “title”: título do card que aparece na resposta do botão “body”: texto abaixo da imagem do card. “footer”: texto de rodapé. “imageUrl”: url da imagem pro card. “buttons”: array de botões.-> id: retorno-> text: texto do botão ##### 📌 Adicione mais botões ao card se desejar.

📌 É possível ter um carrossel com até 10 cards.

API Utilize o código em requisições HTTPS com ferramentas como cURL ou bibliotecas de integração.

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://{BACKEND_URL}/api/messages/whatsmeow/sendCarousel',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "openTicket": 0,
    "body" : [
      {
        "number": "",
    "openTicket": "0",
    "queueId": 0,
    "cards": [
        {
          "title": "Produto 1",
          "body": "Descrição do produto",
          "footer": "R$ 99,90",
          "imageUrl": "https://picsum.photos/400/400",
          "buttons": [
            {"id": "comprar_1", "text": "Comprar"},
            {"id": "info_1", "text": "Mais info"}
          ]
        },
        {
          "title": "Produto 2",
          "body": "Outro produto incrível",
          "footer": "R$ 149,90",
          "imageUrl": "https://picsum.photos/401/401",
          "buttons": [
            {"id": "comprar_2", "text": "Comprar"}
          ]
        }
    ]
  }',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json',
    'Authorization: Bearer {seutokenaqui}' //Token cadastrado na conexão
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;