Obtenir le Statut de Livraison des Messages via WhatChimp API

Suivez si vos messages ont été envoyés, livrés, lus ou échoués.

Updated 5 February 2026

Suivez si vos messages ont été envoyés, livrés, lus ou échoués, et découvrez pourquoi un message n'est pas passé.

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/message-status

https://app.whatchimp.com/api/v1/whatsapp/get/message-status

Paramètres

Paramètre	Type	Requis	Description
`apiToken`	String	Oui	Votre clé API WhatChimp
`wa_message_id`	String	Oui	L'ID du message WhatsApp (retourné lorsque vous avez envoyé le message)
`whatsapp_bot_id`	Number	Oui	Votre ID de bot WhatsApp

Où trouver le wa_message_id ? Chaque envoi réussi via l'API WhatChimp retourne un wa_message_id dans la réponse. Enregistrez cette valeur pour vérifier le statut de livraison plus tard.

Où trouver le whatsapp_bot_id ? Appelez l'endpoint User Info (GET /user/myInfo) : il retourne votre tableau whatsapp_bots_details avec les ID de bot.

Exemples de Requête

GET:

https://app.whatchimp.com/api/v1/whatsapp/get/message-status?apiToken=API-KEY&wa_message_id=wamid.HBgNODgwMTcyMzMwOTAwMxUCABEYEjlGQkY3MEFEMEVGODhCNDkxNQA=&whatsapp_bot_id=123

POST (cURL):

curl -X POST \
  'https://app.whatchimp.com/api/v1/whatsapp/get/message-status' \
  -d 'apiToken=API-KEY' \
  -d 'wa_message_id=wamid.HBgNODgwMTcyMzMwOTAwMxUCABEYEjlGQkY3MEFEMEVGODhCNDkxNQA=' \
  -d 'whatsapp_bot_id=123'

Message Delivery Status endpoint showing parameters and response in the API console

Réponse

{
  "status": "1",
  "message": {
    "message_status": "delivered",
    "delivery_status_updated_at": "2024-07-28 13:21:03",
    "read_time": null,
    "failed_time": null,
    "failed_reason": ""
  }
}

Valeurs de Statut de Livraison

Statut	Signification
`sent`	Message envoyé aux serveurs WhatsApp — en attente de livraison
`delivered`	Message livré sur l'appareil du destinataire
`read`	Message lu par le destinataire (tiques bleues)
`failed`	Échec de livraison du message — vérifiez `failed_reason` pour les détails

Champs de Réponse

Champ	Description
`message_status`	Statut de livraison actuel (voir tableau ci-dessus)
`delivery_status_updated_at`	Horodatage de la dernière mise à jour du statut
`read_time`	Quand le message a été lu (null s'il n'a pas encore été lu)
`failed_time`	Quand l'échec s'est produit (null si pas d'échec)
`failed_reason`	Description de l'erreur si le message a échoué

Raisons d'Échec Courantes

Raison	Signification	Solution
Phone number not on WhatsApp	Le numéro du destinataire n'est pas enregistré sur WhatsApp	Vérifiez que le numéro est correct et actif sur WhatsApp
Template not approved	Le modèle a été rejeté ou est encore en attente	Vérifiez le statut du modèle dans Bot Manager > Message Template
Rate limit exceeded	Trop de messages envoyés en peu de temps	Ralentissez votre taux d'envoi, vérifiez votre niveau de messagerie
Invalid phone number format	Le format du numéro est incorrect	Utilisez le code pays sans signe `+` (ex., `919999999999`)

Cas d'Usage

Accusés de livraison : confirmez que les messages ont été livrés avant de passer à l'action suivante dans votre workflow
Suivi de lecture : sachez quand un client a vu votre message
Gestion des erreurs : détectez les messages échoués et déclenchez des nouvelles tentatives ou des alertes
Surveillance des SLA : suivez les temps de livraison pour les messages sensibles au temps comme les OTP