Ir para o conteúdo

SendButtons#

O método é destinado para enviar uma mensagem com botões em um chat privado ou em grupo. A mensagem será adicionada à fila para envio. A mensagem para envio é armazenada por 24 horas na fila e será enviada imediatamente após a autorização do telefone. A velocidade de envio das mensagens da fila é regulada pelo parâmetro Intervalo de Envio de Mensagens.

Solicitação#

Para enviar, você precisa executar uma solicitação para o seguinte endereço:

POST https://api.green-api.com/waInstance{{idInstance}}/SendButtons/{{apiTokenInstance}}

Para obter os parâmetros da solicitação idInstance e apiTokenInstance, consulte a seção Antes de começar.

Características ao trabalhar com botões#

  • o nome do botão pode ter no máximo 25 caracteres;
  • pode haver no máximo 3 botões desse tipo;
  • o botão pode ser pressionado apenas 1 vez.

Parâmetros da Solicitação#

Parâmetro Tipo Obrigatório Descrição
chatId string Sim Identificador do chat
message string Sim Texto da mensagem. Suporta caracteres emoji 😃
footer string Não Rodapé da mensagem. Útil para destacar visualmente o texto relacionado aos botões
buttons array Sim Botões da mensagem
quotedMessageId string Não Identificador da mensagem citada, se especificado, a mensagem será enviada citando a mensagem do chat especificada
archiveChat boolean Não Arquiva o chat para o qual a mensagem foi enviada. Aceita os valores: true

Campos do array buttons

Parâmetro Tipo Descrição
buttonId integer Identificador do botão
buttonText string texto no botão

O comprimento máximo da mensagem de texto é de 4096 caracteres

Exemplo de Corpo da Solicitação#

Envio de mensagem para o chat privado:

{
    "chatId": "11001234567@c.us",
    "message": "Hello",
    "footer": "Please choose the color:",
    "buttons": [
        {
            "buttonId": "1",
            "buttonText": "green"
        },
        {
            "buttonId": "2",
            "buttonText": "red"
        },
        {
            "buttonId": "3",
            "buttonText": "blue"
        }
    ]
}

Resposta#

Campos da Resposta#

Campo Tipo Descrição
idMessage string Identificador da mensagem enviada

Exemplo de Corpo da Resposta#

{
    "idMessage": "3EB0C767D097B7C7C030"
}

Exemplo de Exibição ao Destinatário#

Exemplo de exibição dos botões

Erros de SendButtons#

Veja a lista de erros comuns a todos os métodos na seção Erros Padrão

Erros Possíveis

Ao usar o método SendButtons, as mensagens podem não ser exibidas nas versões web, desktop e móvel do aplicativo. A capacidade de enviar mensagens com botões foi implementada por nós de maneira de baixo nível. O cliente oficial do WhatsApp-Web não oferece a função de envio de botões. Em grande parte, a estabilidade do método SendButtons não depende de nós, o WhatsApp está constantemente fazendo mudanças em seu funcionamento.

Recomendamos sempre duplicar os botões com mensagens comuns.

Por exemplo, usar números para determinar a escolha.

Escolha a ação:

1 - ação 1

2 - ação 2

3 - ação 3

Exemplo curl#

curl --location --request POST 'https://api.green-api.com/waInstance{{idInstance}}/SendButtons/{{apiTokenInstance}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "chatId": "11001234567@c.us",
    "message": "Please choose the color:",
    "buttons": [{"buttonId": "1", "buttonText": "green"}, {"buttonId": "2", "buttonText": "red"}, {"buttonId": "3", "buttonText": "blue"}]
}'