Obter Lista de Postback do Bot via WhatChimp API

Recupere todos os IDs de postback de fluxos do bot, necessários para vincular botões de Quick Reply a fluxos do bot.

Updated 5 February 2026

Recupere a lista de todas as ações de postback do bot configuradas em seus fluxos de bot do WhatsApp. Postbacks são os gatilhos que conectam botões interativos, modelos Quick Reply e opções de menu a fluxos de bot específicos.

Antes de começar: Certifique-se de ter sua chave API e ID do número de telefone. Consulte Primeiros Passos com WhatChimp Developer API para instruções de configuração.

O que são Postbacks?

Cada fluxo de bot que você cria no WhatChimp tem um ID de postback: um identificador único que aciona esse fluxo específico. Postbacks são usados quando:

Você vincula botões Quick Reply em mensagens de modelo a fluxos de bot (veja Send Template Messages with Quick Reply Buttons)
Você aciona fluxos de bot programaticamente do seu próprio sistema
Você mapeia botões de menu interativos para respostas específicas

Endpoint

GET/POST /api/v1/whatsapp/get/post-back-list

https://app.whatchimp.com/api/v1/whatsapp/get/post-back-list

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
`apiToken`	String	Sim	Sua chave API do WhatChimp
`phone_number_id`	String	Sim	Seu ID de número de telefone do WhatsApp

Exemplos de Requisição

GET:

https://app.whatchimp.com/api/v1/whatsapp/get/post-back-list?apiToken=API-KEY&phone_number_id=PHONE-NUMBER-ID

POST (cURL):

curl -X POST \
  'https://app.whatchimp.com/api/v1/whatsapp/get/post-back-list' \
  -d 'apiToken=API-KEY' \
  -d 'phone_number_id=PHONE-NUMBER-ID'

Resposta

{
  "status": "1",
  "message": [
    {
      "id": 671,
      "postback_id": "QUICK_REPLY_LOCATION_REPLY_BOT",
      "bot_name": "Location quick reply",
      "template_name": "Location quick reply",
      "visual_flow_type": "flow",
      "postback_type": "main"
    },
    {
      "id": 672,
      "postback_id": "QUICK_REPLY_ORDER_TRACKING",
      "bot_name": "Track Order Flow",
      "template_name": "Track Order Flow",
      "visual_flow_type": "flow",
      "postback_type": "main"
    }
  ]
}

Campos da Resposta

Campo	Descrição
`id`	ID interno do fluxo do bot
`postback_id`	O identificador único de postback: isso é o que você passa nas chamadas de API
`bot_name`	Nome de exibição do fluxo do bot
`template_name`	Nome do modelo associado ao fluxo
`visual_flow_type`	Tipo de fluxo: `"flow"` (construtor de fluxo visual) ou outros tipos
`postback_type`	`"main"` para gatilhos principais

Usando Postbacks com Modelos Quick Reply

O caso de uso mais comum para este endpoint é vincular botões Quick Reply a fluxos de bot ao enviar mensagens de modelo via API.

O fluxo:

Chame GET /whatsapp/get/post-back-list para obter todos os IDs de postback disponíveis
Escolha os IDs de postback que correspondem aos fluxos de bot que você quer que cada botão acione
Passe-os como um array JSON em template_quick_reply_button_values ao enviar o modelo

template_quick_reply_button_values=["QUICK_REPLY_ORDER_TRACKING", "QUICK_REPLY_LOCATION_REPLY_BOT"]

O primeiro ID de postback mapeia para o primeiro botão Quick Reply, o segundo para o segundo botão, e assim por diante.

Para um passo a passo completo, consulte Send Template Messages with Quick Reply Buttons via WhatChimp API.