Introduction à l'API Whatixo

Découvrez comment intégrer la puissance de Whatixo directement au cœur de vos propres applications et processus métiers.

Qu'est-ce qu'une API et comment l'utiliser ?

Une API (Interface de Programmation d'Application) est une passerelle sécurisée permettant à deux logiciels de communiquer entre eux sans intervention humaine.

Grâce à l'API Whatixo, vous n'êtes plus obligé de passer par notre tableau de bord pour effectuer des actions. Vous pouvez donner l'ordre à vos propres serveurs d'exécuter des requêtes automatiquement. Voici quelques cas d'usage courants :

  • E-commerce (Shopify, WooCommerce) : Envoyer automatiquement un message WhatsApp au client dès que sa commande est expédiée.
  • CRM interne : Synchroniser vos fiches clients et lancer des séquences de relance (Nurturing) depuis votre propre logiciel.
  • No-Code (Make, Zapier) : Connecter Whatixo à des milliers d'applications pour publier des statuts ou créer des groupes selon des déclencheurs personnalisés.

Toutes nos URL sont orientées ressources, acceptent des corps de requête en JSON et renvoient des réponses typées en JSON.

1. Clé d'API (Bearer Token)

Toutes les requêtes doivent être authentifiées avec un Bearer Token valide. Votre clé API commence systématiquement par le préfixe wtx_.

Pour récupérer votre clé :
  1. Rendez-vous sur www.whatixo.com/settings.
  2. Ouvrez le sous-onglet API et appareils.
  3. Copiez votre clé secrète dans le champ dédié.
Authorization: Bearer wtx_votre_cle_api_secrete

2. Identifiant d'appareil (deviceId)

Le paramètre deviceId est obligatoire pour chaque action de messagerie. Il désigne l'instance WhatsApp physique qui transmettra le paquet. Vous retrouvez les identifiants de vos appareils connectés sur www.whatixo.com/settings (sous-onglet API et appareils).

3. Identifiant JID de Groupe (<groupId>@g.us)

Sur WhatsApp, les groupes possèdent une adresse unique appelée JID au format <groupId>@g.us.

Pour obtenir le JID de n'importe quel groupe dans lequel votre appareil est présent :
  1. Accédez à la section Audiences et contacts sur www.whatixo.com/audience.
  2. Ouvrez le sous-onglet Aspirateur de groupes.
  3. Lancez le scan de votre appareil : l'aspirateur listera l'intégralité de vos groupes et affichera leurs JID (123456789-987654@g.us).
  4. Copiez ce JID pour l'utiliser en tant que paramètre to ou groupId dans vos appels d'API.