▶️Enviar mensagem com botões

Permite enviar uma mensagem de botões com texto simples para um número cadastrado no WhatsApp.

Um pouco sobre botões

Neste método você poderá enviar mensagens de texto com botões de ação, o conteúdo do botão poderão ser escolhidos pelo usuário e será utilizado como resposta da mensagem enviada junto com os botões.

Exemplo de body a ser enviado:

{
  "footer": "Não compartilhamos nada.",
  "text": "O que você está achando de usar a Zapfy?",
  "destination": "+55 61 9551-4650",
  "buttons": [
    {
      "id": "0",
      "body": "Muuito bom.",
      "type": "text"
    },
    {
      "id": "1",
      "body": "Excelente.",
      "type": "text"
    },
    {
      "id": 2,
      "body": "Quero ver o site"
    },
    {
      "id": 3,
      "body": "Quero ligar"
    }
  ]
}

Enviar uma mensagem de botões com texto

POST https://api.zapfy.me/v1/instance/{{instanceKey}}/token/{{instanceToken}}/message?type=buttons

Permite enviar uma mensagem de botões via rest para um contato no WhatsApp, note que essa mensagem será adicionada à uma fila e no momento da requisição será devolvido um id de identificação dessa mensagem, essa fila irá processar o envio da mensagem e depois irá chamar o webhookde delivery da instância que enviou a mensagem.

Após o envio, você receberá um webhook no método post na url da sua instância, veja a página de webhooks que temos aqui na documentação para melhor entendimento do que será enviado:

Webhooks

Path Parameters

Name
Type
Description

instanceKey*

String

instanceToken*

String

Query Parameters

Name
Type
Description

type*

String

Para envio de botões, valor deve ser buttons

Request Body

Name
Type
Description

text*

String

Texto a ser enviado

destination*

String

Número de telefone do usuário ou id de um grupo.

Exemplo: (556195514650)

Necessário conter DD e DDI.

footer

String

Texto que aparecerá no footer da mensagem

buttons*

Button[]

Array contendo botões

{
    "result": {
        "id": "c67fad44-c6eb-4ba2-9f4e-ddc5b526dbe9"
    },
    "message": "MESSAGE_SCHEDULED",
    "isValid": true
}

Webhooks disparados após o envio

O envio dessa mensagem resultará em webhooks do tipo Envio de buttons message e Alteração de status da mensagem

Last updated