Obtener Lista de Postback del Bot vía WhatChimp API

Recupera todos los IDs de postback de flujos del bot, necesarios para vincular botones de Quick Reply a flujos del bot.

Updated 5 February 2026

Recupera la lista de todas las acciones de postback del bot configuradas en tus flujos de bot de WhatsApp. Los postbacks son los activadores que conectan botones interactivos, plantillas de Quick Reply y opciones de menú a flujos de bot específicos.

Antes de comenzar: Asegúrate de tener tu clave API y tu ID de número de teléfono. Consulta Primeros Pasos con WhatChimp Developer API para instrucciones de configuración.

¿Qué son los Postbacks?

Cada flujo de bot que creas en WhatChimp tiene un ID de postback: un identificador único que activa ese flujo específico. Los postbacks se usan cuando:

Vinculas botones de Quick Reply en mensajes de plantilla a flujos de bot (consulta Send Template Messages with Quick Reply Buttons)
Activas flujos de bot programáticamente desde tu propio sistema
Mapeas botones de menú interactivos a respuestas 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	Requerido	Descripción
`apiToken`	String	Sí	Tu clave API de WhatChimp
`phone_number_id`	String	Sí	Tu ID de número de teléfono de WhatsApp

Ejemplos de Solicitud

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'

Respuesta

{
  "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 de Respuesta

Campo	Descripción
`id`	ID interno del flujo del bot
`postback_id`	El identificador único de postback: esto es lo que pasas en las llamadas API
`bot_name`	Nombre para mostrar del flujo del bot
`template_name`	Nombre de plantilla asociado con el flujo
`visual_flow_type`	Tipo de flujo: `"flow"` (constructor de flujo visual) u otros tipos
`postback_type`	`"main"` para activadores principales

Usando Postbacks con Plantillas de Quick Reply

El caso de uso más común para este endpoint es vincular botones de Quick Reply a flujos de bot al enviar mensajes de plantilla vía API.

El flujo:

Llama GET /whatsapp/get/post-back-list para obtener todos los IDs de postback disponibles
Elige los IDs de postback que coincidan con los flujos de bot que quieres que cada botón active
Pásalos como un array JSON en template_quick_reply_button_values al enviar la plantilla

template_quick_reply_button_values=["QUICK_REPLY_ORDER_TRACKING", "QUICK_REPLY_LOCATION_REPLY_BOT"]

El primer ID de postback se mapea al primer botón de Quick Reply, el segundo al segundo botón, y así sucesivamente.

Para un tutorial completo, consulta Send Template Messages with Quick Reply Buttons via WhatChimp API.