Aller au contenu
Wbiztool

API des comptes WhatsApp

API de liste des comptes WhatsApp

Utilisez cette API pour obtenir en un seul appel la liste complète de tous vos numéros WhatsApp et leur statut de connexion. Contrairement à Lister les numéros connectés, elle inclut les numéros déconnectés.

POSThttps://wbiztool.com/api/v1/whatsapp/accounts/

Corps: JSON ou champs de formulaire

DifférenceLister les comptesLister les numéros connectés
Inclut les numéros déconnectés et supprimésOuiNon
Clés des élémentswhatsapp_client_id, whatsapp_number, statusid, whatsapp_client_id, whatsapp_client_number, is_connected
message en cas de succèsAbsentokay

Exemple rapide#

curl -X POST https://wbiztool.com/api/v1/whatsapp/accounts/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY"
  }'

Remplacez 12345 et YOUR_API_KEY par vos propres valeurs. Consultez Authentification pour savoir où les trouver.

Aucun des deux clients officiels n'a de méthode pour cet endpoint : appelez-le donc directement, comme dans les exemples.

Paramètres de la requête#

client_idintegerobligatoire

Votre ID client API, dans Paramètres → Clés API.

api_keystringobligatoire

Votre clé API, sur cette même page. La liste porte sur l'espace de travail dans lequel cette clé a été créée.

Réponse#

Une requête réussie renvoie le code HTTP 200 :

{
  "whatsapp_clients": [
    {
      "whatsapp_client_id": 678,
      "whatsapp_number": "919876543210",
      "status": "connected"
    },
    {
      "whatsapp_client_id": 702,
      "whatsapp_number": "919812345678",
      "status": "not_connected"
    }
  ],
  "status": 1
}
ChampTypeDescription
statusinteger1 en cas de succès, 0 si la requête a échoué.
whatsapp_clientsarrayTous les numéros WhatsApp ajoutés à cet espace de travail depuis sa création. Présent uniquement en cas de succès.
whatsapp_clients[].whatsapp_client_idintegerL'ID du numéro. Transmettez-le comme whatsapp_client dans les autres appels API.
whatsapp_clients[].whatsapp_numberstringLe numéro de téléphone tel qu'il a été enregistré lors de son ajout.
whatsapp_clients[].statusstringconnected ou not_connected.

L'ordre de la liste n'est pas garanti. Triez par whatsapp_client_id si l'ordre compte.

Une réponse réussie ne contient pas de champ message : lisez-la donc avec une valeur de repli, comme dans les exemples.

Erreurs#

MessageHTTPComment corriger
Auth Error200Envoyez à la fois client_id et api_key dans le corps d'une requête POST, en JSON valide ou en champs de formulaire.
Invalid Client Id403Envoyez client_id sous forme de nombre entier, par exemple 12345.
Auth Error: invalid api key400Vérifiez que la clé existe, n'a pas été supprimée et appartient à ce client_id.

Si le serveur rencontre un problème inattendu, ou si la requête n'est pas un POST, la réponse est un objet vide : {}. Considérez l'absence de status comme un échec.

Conseils#

  • Reconnecter un numéro : un numéro not_connected peut être reconnecté dans les paramètres WhatsApp ou avec Connecter un numéro.
  • Un seul numéro : pour vérifier un seul numéro, utilisez Statut de connexion.
  • Plusieurs espaces de travail : la clé API détermine l'espace de travail listé. Utilisez une clé créée dans l'espace de travail souhaité.