Obtenir la Liste de Postback du Bot via WhatChimp API

Récupérez tous les ID de postback de flux de bot, nécessaires pour lier les boutons Quick Reply aux flux de bot.

Updated 5 February 2026

Récupérez la liste de toutes les actions de postback de bot configurées dans vos flux de bot WhatsApp. Les postbacks sont les déclencheurs qui connectent les boutons interactifs, les modèles Quick Reply et les options de menu à des flux de bot spécifiques.

Avant de commencer : Assurez-vous d'avoir votre clé API et votre ID de numéro de téléphone. Consultez Premiers Pas avec WhatChimp Developer API pour les instructions de configuration.

Qu'est-ce que les Postbacks ?

Chaque flux de bot que vous créez dans WhatChimp a un ID de postback: un identifiant unique qui déclenche ce flux spécifique. Les postbacks sont utilisés quand :

Vous liez des boutons Quick Reply sur les messages de modèle aux flux de bot (voir Send Template Messages with Quick Reply Buttons)
Vous déclenchez des flux de bot par programmation depuis votre propre système
Vous mappez des boutons de menu interactifs à des réponses spécifiques

Endpoint

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

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

Paramètres

Paramètre	Type	Requis	Description
`apiToken`	String	Oui	Votre clé API WhatChimp
`phone_number_id`	String	Oui	Votre ID de numéro de téléphone WhatsApp

Exemples de Requête

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'

Réponse

{
  "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"
    }
  ]
}

Champs de Réponse

Champ	Description
`id`	ID interne du flux de bot
`postback_id`	L'identifiant unique de postback : c'est ce que vous passez dans les appels API
`bot_name`	Nom d'affichage du flux de bot
`template_name`	Nom de modèle associé au flux
`visual_flow_type`	Type de flux : `"flow"` (constructeur de flux visuel) ou autres types
`postback_type`	`"main"` pour les déclencheurs principaux

Utiliser les Postbacks avec les Modèles Quick Reply

Le cas d'usage le plus courant pour cet endpoint est de lier les boutons Quick Reply aux flux de bot lors de l'envoi de messages de modèle via l'API.

Le flux :

Appelez GET /whatsapp/get/post-back-list pour obtenir tous les ID de postback disponibles
Choisissez les ID de postback qui correspondent aux flux de bot que vous voulez que chaque bouton déclenche
Passez-les comme un tableau JSON dans template_quick_reply_button_values lors de l'envoi du modèle

template_quick_reply_button_values=["QUICK_REPLY_ORDER_TRACKING", "QUICK_REPLY_LOCATION_REPLY_BOT"]

Le premier ID de postback se mappe au premier bouton Quick Reply, le second au second bouton, et ainsi de suite.

Pour un guide complet, consultez Send Template Messages with Quick Reply Buttons via WhatChimp API.