Wozapfy/ docsAbrir painel ↗

Enviar mensagem com botões

Enviar mensagem com botões para um número ou grupo no WhatsApp.

A mensagem é persistida e o id retornado identifica-a nos webhooks NEW-MESSAGE e MESSAGE-UPDATED.

POSThttps://api.wozapfy.com/v1/instance/{instanceKey}/token/{instanceToken}/message?type=buttons

Path Parameters

NomeTipoDescrição
instanceKey*StringKey de identificação da instância.
instanceToken*StringToken de acesso da instância.

Query Parameters

NomeTipoDescrição
type*StringValor deve ser buttons.

Request Body

NomeTipoDescrição
destination*StringTelefone com DDI e DDD, formatado ou não (ex.: +55 61 9551-4650), ou JID de grupo terminado em @g.us.
text*StringTexto a ser enviado (até 65.536 caracteres).
footerStringTexto do rodapé (até 1.000 caracteres).
buttons*Button[]1 a 10 itens { id, body, type? }. id texto ou número; body até 20 caracteres; type opcional, "text".

Exemplo de body

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

Respostas

200 Mensagem agendada

{
  "result": {
    "id": "c67fad44-c6eb-4ba2-9f4e-ddc5b526dbe9"
  },
  "message": "MESSAGE_SCHEDULED",
  "isValid": true
}
Renderização e interação de botões ainda precisam de validação com um número pareado.