Obtenir l'Historique des Conversations via WhatChimp API

Récupérez l'historique complet des messages avec n'importe quel abonné : messages envoyés, reçus, horodatages et statut de livraison.

Updated 5 February 2026

Récupérez l'historique complet des conversations avec n'importe quel abonné : chaque message envoyé et reçu, avec horodatages, informations sur l'expéditeur et statut de livraison.

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.

Endpoint

GET/POST /api/v1/whatsapp/get/conversation

https://app.whatchimp.com/api/v1/whatsapp/get/conversation

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
`phone_number`	String	Oui	Numéro de téléphone de l'abonné avec code pays (ex., `919999999999`)
`limit`	Number	Oui	Nombre de messages à récupérer
`offset`	Number	Non	Décalage de pagination (commencer à partir de cette position)

Exemples de Requête

GET:

https://app.whatchimp.com/api/v1/whatsapp/get/conversation?apiToken=API-KEY&phone_number_id=PHONE-NUMBER-ID&phone_number=919999999999&limit=10&offset=1

POST (cURL):

curl -X POST \
  'https://app.whatchimp.com/api/v1/whatsapp/get/conversation' \
  -d 'apiToken=API-KEY' \
  -d 'phone_number_id=PHONE-NUMBER-ID' \
  -d 'phone_number=919999999999' \
  -d 'limit=10' \
  -d 'offset=1'

Get Conversation endpoint showing parameters, request examples, and sample response in the API console

Réponse

{
  "status": "1",
  "message": [
    {
      "id": 8003,
      "sender": "bot",
      "agent_name": null,
      "message_content": "{...}",
      "conversation_time": "2024-07-28 13:21:03",
      "wa_message_id": "wamid.HBgNODgwMTcyMzMwOTAwMxUCABEYEjlGQkY3MEFEMEVGODhCNDkxNQA=",
      "message_status": "delivered",
      "delivery_status_updated_at": "2024-07-28 13:21:05"
    },
    {
      "id": 8004,
      "sender": "subscriber",
      "agent_name": null,
      "message_content": "Bonjour, j'ai besoin d'aide avec ma commande",
      "conversation_time": "2024-07-28 13:25:10",
      "wa_message_id": "wamid.HBgNODgwMTcyMzMwOTAwMxUCABIYEjlGQkY3MEFEMEVGODhCNDkxNQA=",
      "message_status": null,
      "delivery_status_updated_at": null
    }
  ]
}

Champs de Réponse

Champ	Description
`id`	ID interne du message
`sender`	Qui a envoyé le message : `"bot"`, `"subscriber"`, ou le nom d'un agent
`agent_name`	Nom de l'agent humain (si le message a été envoyé depuis Live Chat)
`message_content`	Le texte du message. Pour les messages du bot, c'est une chaîne JSON avec la charge utile complète du message
`conversation_time`	Horodatage de l'envoi du message
`wa_message_id`	ID du message WhatsApp : utilisez-le avec la Delivery Status API pour suivre la livraison
`message_status`	Statut de livraison actuel (`sent`, `delivered`, `read`, `failed`)
`delivery_status_updated_at`	Quand le statut de livraison a été mis à jour pour la dernière fois

Pagination

Utilisez limit et offset pour paginer les longues conversations :

# 10 premiers messages
?limit=10&offset=1

# 10 messages suivants
?limit=10&offset=11

# 10 suivants
?limit=10&offset=21

Cas d'Usage

Intégration CRM : synchronisez l'historique des conversations dans votre CRM ou système d'assistance
Analytique : analysez les temps de réponse, les volumes de messages et les modèles de conversation
Piste d'audit : conservez un enregistrement de toutes les interactions avec les clients
Débogage de chatbot : examinez ce que votre bot a envoyé par rapport à ce que le client a répondu