API Botão Quick Reply

Envia uma mensagem com botões de resposta rápida: o cliente toca e a resposta volta como mensagem dele.

API: Pro

Endpoint

https://apichat.agpt.com.br/api/messages/whatsmeow/sendButtonsPRO

Método

POST

Autenticação

Bearer {seutokenaqui}

Payload

{
    "openTicket": 0,
    "queueId": 0,
    "body": [
      {
        "phone": "554130776744",
        "title": "Confirmação",
        "body": "Podemos confirmar seu pedido?",
        "footer": "Toque em uma opção",
        "buttons": [
         {
           "type": "quick_reply",
           "text": "Sim",
           "id": "opcao_sim"
         },
         {
           "type": "quick_reply",
           "text": "Não",
           "id": "opcao_nao"
         }
        ]
      }
    ]
}

“openTicket”: 0 não abre ticket e 1 abre. Para abrir é obrigatório informar um Setor em queueId, e a conversa vai para Aguardando mesmo que já esteja em atendimento.

“queueId”: ID do Setor desejado (só funciona quando "openTicket": "1").

“phone”: telefone do destinatário no formato ddi ddd numero (somente números).

“title”: texto do título, acima da mensagem.

“body”: texto principal da mensagem.

“footer”: texto do rodapé, abaixo da mensagem.

“buttons”: a lista de botões da mensagem.

“type”: quick_reply.

“text”: o rótulo que aparece no botão, e que volta como resposta do cliente.

“id”: identificador do botão, para a sua automação saber qual foi tocado.

A mensagem fica gravada no atendimento com uma descrição legível do que foi oferecido: título, texto, rodapé e o rótulo de cada botão entre colchetes.

Resposta de sucesso não garante que o cliente recebeu. Se o motor recusar o envio — por exemplo com a conexão fora do ar — a recusa vira nota interna no atendimento e a resposta ainda volta como sucesso.

Opcional repetir até 3 botões.

Utilize o código em requisições HTTPS com ferramentas como cURL ou bibliotecas de integração.

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://apichat.agpt.com.br/api/messages/whatsmeow/sendButtonsPRO',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "openTicket": 0,
    "queueId": 0,
    "body": [
      {
        "phone": "554130776744",
        "title": "Confirmação",
        "body": "Podemos confirmar seu pedido?",
        "footer": "Toque em uma opção",
        "buttons": [
         {
           "type": "quick_reply",
           "text": "Sim",
           "id": "opcao_sim"
         },
         {
           "type": "quick_reply",
           "text": "Não",
           "id": "opcao_nao"
         }
        ]
      }
    ]
}',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json',
    'Authorization: Bearer {seutokenaqui}' //Token cadastrado na conexão
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
Copiar como cURL