Whatixo.Documentation English Ouvrir Whatixo
Documentation / API Whatixo

Groupes

Automatisez la gestion de vos communautés : créer un groupe par client VIP ou par formation, y ajouter les acheteurs, publier des annonces…

Toutes ces opérations s’exécutent avec le numéro indiqué par deviceId. Pour modifier un groupe (membres, nom, description), ce numéro doit en être administrateur. Les participants s’écrivent au format international (243812345678).

Créer un groupe

POSThttps://api.whatixo.com/api/whatsapp/groups/create
ChampTypeDescription
deviceIdrequisstringNuméro qui crée le groupe (il en devient l’administrateur).
namerequisstringNom du groupe.
participantsoptionnelstring[]Numéros à ajouter à la création.
 
curl -X POST https://api.whatixo.com/api/whatsapp/groups/create \
  -H "x-api-key: $WHATIXO_API_KEY" -H "Content-Type: application/json" \
  -d '{"deviceId":"8f2c1a7e-4b9d-4e21-9a6f-3c5d7e1b2a90","name":"Formation Novembre 2026","participants":["243812345601","243998877602"]}'
Réponse 200JSON
{
  "success": true,
  "group": {
    "id": "120363041234567890@g.us",
    "subject": "Formation Novembre 2026",
    "owner": "243812345678@s.whatsapp.net",
    "participants": [ { "id": "243812345601@s.whatsapp.net", "admin": null } ]
  }
}

Conservez group.id (se termine par @g.us) : c’est le groupId des autres appels, et le to pour écrire dans le groupe.

Lister les groupes

POSThttps://api.whatixo.com/api/whatsapp/groups/list
RequêteJSON
{ "deviceId": "8f2c1a7e-4b9d-4e21-9a6f-3c5d7e1b2a90" }
Réponse 200JSON
{
  "success": true,
  "count": 2,
  "groups": [
    { "id": "120363041234567890@g.us", "subject": "Clients VIP Boutique", "size": 184, "participants": [ … ] },
    { "id": "120363049876543210@g.us", "subject": "Grossistes Kinshasa", "size": 92, "participants": [ … ] }
  ]
}

Lister les membres

POSThttps://api.whatixo.com/api/whatsapp/groups/members
RequêteJSON
{ "deviceId": "8f2c1a7e-4b9d-4e21-9a6f-3c5d7e1b2a90", "groupId": "120363041234567890@g.us" }
Réponse 200JSON
{
  "success": true,
  "members": [
    { "id": "243812345678@s.whatsapp.net", "admin": "superadmin" },
    { "id": "243812345601@s.whatsapp.net", "admin": "admin" },
    { "id": "243998877602@s.whatsapp.net", "admin": null }
  ]
}

Gérer les membres

Quatre points d’accès avec le même corps :

Point d’accèsAction
POST /whatsapp/groups/members/addAjouter des participants
POST /whatsapp/groups/members/removeRetirer des participants
POST /whatsapp/groups/members/promoteNommer administrateurs
POST /whatsapp/groups/members/demoteRetirer le rôle d’administrateur
Corps de la requêteJSON
{
  "deviceId": "8f2c1a7e-4b9d-4e21-9a6f-3c5d7e1b2a90",
  "groupId": "120363041234567890@g.us",
  "participants": ["243812345601", "243998877602"]
}
Réponse 200JSON
{
  "success": true,
  "response": [
    { "status": "200", "jid": "243812345601@s.whatsapp.net" },
    { "status": "403", "jid": "243998877602@s.whatsapp.net" }
  ]
}

Chaque participant a son propre status : 200 réussi, 403 refusé (paramètres de confidentialité du contact : il doit être invité par lien), 409 déjà membre.

Renommer un groupe

POSThttps://api.whatixo.com/api/whatsapp/groups/settings/name
Corps de la requêteJSON
{ "deviceId": "8f2c1a7e-…", "groupId": "120363041234567890@g.us", "name": "Clients VIP 2027" }

Changer la description

POSThttps://api.whatixo.com/api/whatsapp/groups/settings/description
Corps de la requêteJSON
{ "deviceId": "8f2c1a7e-…", "groupId": "120363041234567890@g.us", "description": "Offres exclusives chaque vendredi 🎁" }

Réponse des deux appels : {"success":true,"message":"…mis à jour."}.

Erreurs fréquentes

CodeCause
400Paramètre manquant, ou numéro déconnecté (« Appareil déconnecté »).
404deviceId inconnu.
500WhatsApp a refusé l’opération : le numéro n’est pas administrateur, le groupe n’existe pas, ou la limite de membres est atteinte. Le champ details précise parfois la raison.