POST/customers/send-message

Menus de Lista

Consulte menus de lista, com parâmetros e exemplos de requisição e resposta na API do iHelp.

POSThttps://apiv3.ihelpchat.com/api/v2/customers/send-message

Compatibilidade

Disponível apenas em canais de API oficial.

Menu de lista é uma mensagem interativa: o cliente toca em um botão e o WhatsApp abre uma lista de opções para ele escolher. Usa o mesmo endpoint da Mensagem comum, com messageType: 21 e o objeto interactiveMetaMessage.

Como o cliente vê no WhatsApp:

Mensagem com botão Ver opções

Lista de opções aberta

Janela de 24 horas

Só é possível enviar dentro de um atendimento em que o cliente enviou alguma mensagem nas últimas 24 horas. Fora dessa janela, use um template.

POST

https://apiv3.ihelpchat.com/api/v2/customers/send-message

Body (JSON):

{
    "canalId": "5e7e84d85c7f025d027baa46",
    "contato": "5517981259808",
    "messageType": 21,
    "texto": "conteudo da mensagem 123",
    "interactiveMetaMessage": {
        "button": "Ver opções",
        "sections": [
            {
                "rows": [
                    { "id": "pagar_boleto",  "title": "💳 Pagar Boleto",   "description": "Gerar 2ª via do boleto" },
                    { "id": "nota_fiscal",   "title": "📄 2ª Via da Nota", "description": "Reenviar nota fiscal" },
                    { "id": "falar_humano",  "title": "🙋 Falar com atendente 3" }
                ]
            }
        ]
    }
}
  • texto: corpo da mensagem exibido acima do botão
  • interactiveMetaMessage.button: texto do botão que abre a lista
  • interactiveMetaMessage.sections: lista de seções, cada uma com suas rows
  • rows[].id: identificador da opção, devolvido na resposta do cliente
  • rows[].title: texto da opção
  • rows[].description: descrição da opção (opcional)