Notifications
Où voir une diffusion terminée, un paiement, un solde faible ou un incident du bot, et comment marquer les notifications comme lues.
Sur cette page
Cliquez sur la cloche en haut du compte pour savoir si une diffusion est terminée, si un paiement a abouti ou si un bot rencontre un problème. Le même flux regroupe les événements de tous vos bots et les annonces de GetMyBot. Changer de projet ne change pas ce flux.
Cloche et compteur
Le nombre près de la cloche indique les notifications non lues. Il se met à jour avec les nouveaux événements. Pour une intégration, le compteur est disponible par GET /api/notifications/unread-count.
Flux de notifications
Le flux (GET /api/notifications) réunit deux sources :
- Notifications : événements de vos bots et de votre compte.
- Annonces : messages généraux de la plateforme pour tous.
Chaque élément indique un titre, un texte, le bot concerné s’il y en a un, l’heure et l’état « lu ».
Types d’événements
| Événement | Code | Quand il apparaît |
|---|---|---|
| Diffusion terminée | broadcast_done | L’envoi en masse est terminé |
| Paiement effectué | payment_succeeded | Un rechargement du solde est confirmé |
| Forfait renouvelé | subscription_renewed | L’abonnement est renouvelé |
| Solde faible | balance_low | Le solde de requêtes est presque épuisé |
| Erreur du bot | bot_error | Le bot a rencontré un problème |
| Nouveaux abonnés | new_subscribers | L’audience du bot a grandi |
| Bot hors ligne | bot_offline | Le bot n’a émis aucun signe de vie pendant plus longtemps que le seuil de sa fiche Santé du bot. Le texte donne la cause et l’action à entreprendre. Le propriétaire reçoit une notification par incident |
| Bot de nouveau en ligne | bot_online | Les signes de vie ont repris. Le texte précise la durée de l’interruption. Seuls les destinataires de l’avis « Bot hors ligne » reçoivent celui-ci |
Marquer comme lu
Cliquez sur une notification pour la marquer comme lue, ou choisissez Tout marquer comme lu. Les intégrations peuvent utiliser :
- Un élément :
POST /api/notifications/read, avec source et identifiant. - Tout le flux :
POST /api/notifications/read-allmarque tout comme lu et remet le compteur à zéro.
Ces notifications ne sont pas destinées aux clients
Ce flux s’adresse à vous et à votre équipe dans le compte et les applications des opérateurs. Pour les visiteurs du site, utilisez les notifications du navigateur. Pour intégrer le chat dans votre application mobile, utilisez le SDK client. Ces fonctions se configurent séparément.
Pour aller plus loin
- Diffusions : « Diffusion terminée ».
- Paiements et solde : « Paiement effectué », « Forfait renouvelé », « Solde faible ».
- Personnes (CRM) : « Nouveaux abonnés ».
- Statistiques et journal : consommation et solde.
- Projets et canaux : avis de présence et fiche Santé du bot.