Passer au contenu principal
L’API Statuts vous permet de publier et gérer des statuts (stories) WhatsApp depuis vos comptes connectés.

​
Qu’est-ce qu’un statut WhatsApp ?

Les statuts WhatsApp sont des publications temporaires qui :
  • Disparaissent après 24h automatiquement
  • Peuvent contenir du texte, des images ou des vidéos
  • Sont visibles par vos contacts selon vos paramètres de confidentialité
  • Permettent de partager des moments ou des informations importantes

​
Fonctionnalités disponibles

​
📤 Publier un statut

Publiez du contenu texte, image ou vidéo sur votre statut WhatsApp. Publier un statut →

​
🔒 Gérer la confidentialité

Contrôlez qui peut voir vos statuts : tous vos contacts, certains uniquement, ou personne.

​
Cas d’usage

​
Marketing & Communication

  • Partager des offres promotionnelles limitées dans le temps
  • Annoncer des événements ou nouveautés
  • Créer de l’engagement avec votre audience

​
Business

  • Partager des actualités de l’entreprise
  • Publier du contenu exclusif pour vos clients
  • Maintenir une présence régulière auprès de vos contacts

​
Automatisation

  • Programmer des publications via API
  • Publier du contenu sur plusieurs comptes simultanément
  • Intégrer avec vos systèmes existants

​
Types de contenu supportés

TypeDescriptionFormats
TexteMessages texte avec personnalisationPolice, couleur de fond
ImagePhotos avec légende optionnelleJPG, PNG (~5MB max)
VidéoVidéos courtes avec légendeMP4 (~16MB max)

​
Paramètres de confidentialité

ModeVisibilité
allTous vos contacts
contactsTous vos contacts (défaut)
contacts_exceptContacts sauf liste noire
nonePersonne (privé)

​
Limites et restrictions

  • Durée : 24h maximum (automatique WhatsApp)
  • Fréquence : Pas de limite API, mais éviter le spam
  • Taille : Images ~5MB, Vidéos ~16MB
  • Formats : JPG, PNG pour images / MP4 pour vidéos

​
Différence avec les messages

CritèreStatutsMessages normaux
Durée de vie24hPermanent
DestinatairesContacts (configurables)Destinataires spécifiques
RéponsesPrivées uniquementConversation normale
VisibilitéBroadcast publicPrivé 1-à-1 ou groupe

​
Exemples rapides

​
Publier un statut texte

POST /api/whatsapp/status/post
{
  "accountId": "account_xxx",
  "type": "text",
  "content": "Nouvelle promotion ! -20% aujourd'hui"
}

​
Publier une image

POST /api/whatsapp/status/post
{
  "accountId": "account_xxx",
  "type": "image",
  "imageUrl": "https://example.com/promo.jpg",
  "caption": "Découvrez notre nouvelle collection !"
}

​
Définir la confidentialité

PUT /api/whatsapp/status/privacy
{
  "accountId": "account_xxx",
  "privacyType": "contacts"
}

​
Notes importantes

  • Les statuts sont publiés depuis le compte WhatsApp connecté
  • La confidentialité est configurée au niveau du compte WhatsApp
  • Les listes de contacts proviennent de l’application WhatsApp
  • Vous ne pouvez pas voir qui a vu votre statut via l’API (fonctionnalité WhatsApp uniquement)