Débuter avec le Developer API de WhatChimp

Updated 5 February 2026

Le Developer API de WhatChimp vous donne un accès programmatique aux fonctionnalités de WhatChimp : envoyez des messages, gérez les abonnés, déclenchez des bot flows, et plus encore, le tout via de simples requêtes HTTP. Que vous construisiez des intégrations, automatisiez des workflows, ou connectiez WhatChimp avec vos propres systèmes, l'API rend cela possible.

Video: https://www.youtube.com/watch?v=JPmo2B9VOM0

Qu'est-ce que le Developer API de WhatChimp ?

WhatChimp fournit une REST API permettant aux développeurs d'interagir avec la plateforme de manière programmatique. C'est la propre API de WhatChimp (pas directement la WhatsApp Business API) : WhatChimp gère la complexité de WhatsApp pour vous.

Vous pouvez envoyer des messages, gérer des contacts (abonnés), déclencher des bot flows, gérer des catalogues, et plus encore. L'API prend en charge les requêtes GET et POST pour la plupart des endpoints.

Trouver la Console API

Suivez ces étapes pour accéder à la Console API :

  1. Connectez-vous à votre compte WhatChimp sur app.whatchimp.com
  2. Allez dans Settings (icône d'engrenage dans la barre latérale)
  3. Cliquez sur API Developer Console (ou naviguez directement vers app.whatchimp.com/api/developer/console)

WhatChimp API Developer Console showing the endpoint sidebar with all available API endpoints

La Console API affiche tous les endpoints disponibles organisés en sections :

  • WhatsApp API : Envoyez des messages, obtenez les conversations, suivez la livraison, gérez les templates
  • Subscriber API : Créez, lisez, mettez à jour, supprimez des abonnés ; gérez les étiquettes, séquences, champs personnalisés
  • Label API : Listez et créez des étiquettes
  • Catalog API : Gérez les catalogues de produits et les commandes
  • Direct Login API : Générez des URLs de connexion directe

Générer votre clé API

Votre clé API est affichée en haut de la Console API Developer.

  1. Naviguez vers la Console API Developer
  2. Votre clé API existante est affichée sous "Your API key"
  3. Pour générer une nouvelle clé, cliquez sur le bouton Generate API key

API key displayed at the top of the Developer Console with the Generate API key button

Important : Gardez votre clé API sécurisée. Toute personne avec votre clé API peut accéder aux fonctionnalités API de votre compte WhatChimp. Si vous suspectez que votre clé a été compromise, générez-en une nouvelle immédiatement.

Authentification

Chaque requête API nécessite votre clé API. Incluez-la comme paramètre apiToken dans chaque requête.

URL de base :

https://app.whatchimp.com/api/v1/

Paramètre d'authentification :

ParamètreTypeRequisDescription
apiTokenStringOuiVotre clé API WhatChimp

Faire des requêtes

La plupart des endpoints de l'API WhatChimp acceptent les requêtes GET et POST.

Requête GET : Passez les paramètres comme query string :

https://app.whatchimp.com/api/v1/whatsapp/send?apiToken=YOUR-API-KEY&phone_number_id=PHONE-NUMBER-ID&message=Hello&phone_number=919999999999

Requête POST : Passez les paramètres comme données de formulaire :

curl -X POST \
  'https://app.whatchimp.com/api/v1/whatsapp/send' \
  -d 'apiToken=YOUR-API-KEY' \
  -d 'phone_number_id=PHONE-NUMBER-ID' \
  -d 'message=Hello' \
  -d 'phone_number=919999999999'

Format de réponse

Toutes les réponses de l'API renvoient du JSON avec une structure cohérente.

Réponse réussie :

{
  "status": "1",
  "message": "Message sent successfully."
}

Réponse d'erreur :

{
  "status": "0",
  "message": "Subscriber limit has been exceeded. You cannot have more subscribers."
}
  • status : "1" pour succès, "0" pour échec
  • message : Description du résultat, ou les données demandées

Démarrage rapide : Envoyer un message texte

Voici un exemple complet pour envoyer un message texte WhatsApp via l'API WhatChimp :

curl -X POST \
  'https://app.whatchimp.com/api/v1/whatsapp/send' \
  -d 'apiToken=YOUR-API-KEY' \
  -d 'phone_number_id=YOUR-PHONE-NUMBER-ID' \
  -d 'message=Hello from the WhatChimp API!' \
  -d 'phone_number=919999999999'

Paramètres :

ParamètreTypeRequisDescription
apiTokenStringOuiVotre clé API WhatChimp
phone_number_idStringOuiVotre ID de numéro de téléphone WhatsApp (trouvé dans les paramètres de votre compte WhatChimp)
messageStringOuiLe message texte à envoyer (encoder URL pour les requêtes GET)
phone_numberStringOuiNuméro de téléphone du destinataire avec code pays (par ex., 919999999999)

Exemple de réponse :

{
  "status": "1",
  "wa_message_id": "wamid.HBgNODgwMTcyMzMwOTAwMxUCABEYEjlGQkY3MEFEMEVGODhCNDkxNQA=",
  "message": "Message sent successfully."
}

Note : Les messages texte ne peuvent être envoyés que dans les 24 heures suivant le dernier message du client vers vous (fenêtre de session). Pour envoyer des messages aux clients en dehors de cette fenêtre, utilisez un message template pré-approuvé. En savoir plus dans WhatChimp Messaging API.

Paramètres communs

Ces paramètres apparaissent dans de nombreux endpoints de l'API WhatChimp :

ParamètreDescription
apiTokenVotre clé API WhatChimp (requis pour chaque requête)
phone_number_idVotre ID de numéro de téléphone WhatsApp : identifie quel compte WhatsApp utiliser
phone_numberNuméro de téléphone d'un abonné, incluant le code pays (sans signe +)

Et ensuite ?

Maintenant que vous connaissez les bases, explorez l'API complète :

More in WhatChimp APIs