Enviar lista

Envia uma mensagem com lista de opções organizadas em seções clicáveis.

Endpoint

POST /chat/send/list

Parâmetros

Nome	Tipo	Obrigatório	Descrição
to	string	Sim	JID do destinatário
title	string	Sim	Título da mensagem
body	string	Sim	Texto principal
footer	string	Não	Texto do rodapé
buttonText	string	Sim	Texto do botão que abre a lista
sections	object[]	Sim	Seções com itens da lista
sections[].title	string	Sim	Título da seção
sections[].rows	object[]	Sim	Itens da seção
sections[].rows[].id	string	Sim	Identificador único do item
sections[].rows[].title	string	Sim	Título do item
sections[].rows[].description	string	Não	Descrição do item

Request

cURL

curl -X POST https://endpoint.wi.api.br/chat/send/list \
  -H "x-api-key: $WIAPI_KEY" \
  -H "x-instance: session_01" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "5511998765432@s.whatsapp.net",
    "title": "Catálogo de Produtos",
    "body": "Selecione um produto para mais detalhes",
    "footer": "Preços sujeitos a alteração",
    "buttonText": "Ver produtos",
    "sections": [
      {
        "title": "Camisetas",
        "rows": [
          { "id": "cam_001", "title": "Camiseta Básica", "description": "100% algodão - R$ 49,90" },
          { "id": "cam_002", "title": "Camiseta Premium", "description": "Pima cotton - R$ 89,90" }
        ]
      },
      {
        "title": "Calças",
        "rows": [
          { "id": "cal_001", "title": "Calça Jeans Slim", "description": "Stretch - R$ 149,90" }
        ]
      }
    ]
  }'

JavaScript

const response = await fetch("https://endpoint.wi.api.br/chat/send/list", {
  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",
    title: "Catálogo de Produtos",
    body: "Selecione um produto para mais detalhes",
    footer: "Preços sujeitos a alteração",
    buttonText: "Ver produtos",
    sections: [
      {
        title: "Camisetas",
        rows: [
          { id: "cam_001", title: "Camiseta Básica", description: "100% algodão - R$ 49,90" },
          { id: "cam_002", title: "Camiseta Premium", description: "Pima cotton - R$ 89,90" },
        ],
      },
      {
        title: "Calças",
        rows: [
          { id: "cal_001", title: "Calça Jeans Slim", description: "Stretch - R$ 149,90" },
        ],
      },
    ],
  }),
});

const data = await response.json();

Python

import requests

response = requests.post(
    "https://endpoint.wi.api.br/chat/send/list",
    headers={
        "x-api-key": WIAPI_KEY,
        "x-instance": "session_01",
    },
    json={
        "to": "5511998765432@s.whatsapp.net",
        "title": "Catálogo de Produtos",
        "body": "Selecione um produto para mais detalhes",
        "footer": "Preços sujeitos a alteração",
        "buttonText": "Ver produtos",
        "sections": [
            {
                "title": "Camisetas",
                "rows": [
                    {"id": "cam_001", "title": "Camiseta Básica", "description": "100% algodão - R$ 49,90"},
                    {"id": "cam_002", "title": "Camiseta Premium", "description": "Pima cotton - R$ 89,90"},
                ],
            },
            {
                "title": "Calças",
                "rows": [
                    {"id": "cal_001", "title": "Calça Jeans Slim", "description": "Stretch - R$ 149,90"},
                ],
            },
        ],
    },
)

data = response.json()

Response

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