Le quota d'une inbox ne devrait jamais dépendre d'une autre
Chaque inbox peut avoir son plafond de messages par jour et par mois, dès l'offre Solo. Une suite de tests qui s'emballe s'arrête à sa limite, sans vider le volume du reste de l'équipe.
-
ci-nightly 4 120 / 5 000
-
e2e-signature 7 640 / 8 000
alerte à 90 % envoyée
-
recette-manuelle 240 / 2 000
-
load-test 3 000 / 3 000
plafond atteint, messages refusés
// Les plafonds se posent par l'API, donc depuis votre code d'infrastructure.
await fetch('https://api.facteur.eu/v1/inboxes/j3k9x2mq', {
method: 'PATCH',
headers: {
authorization: 'Bearer ' + process.env.FACTEUR_API_KEY, // clé en écriture
'content-type': 'application/merge-patch+json',
},
body: JSON.stringify({
quota: {
daily: 5000, // une boucle infinie s'arrête là
monthly: 80000, // le budget du mois
// 'reject' : les messages suivants sont refusés, avec un code.
// 'alert' : on prévient, on laisse passer.
onExceed: 'reject',
},
}),
});Ce que vous pouvez régler
Dès la première offre payante
SoloPlafonner une inbox n'est pas réservé à une offre haute. C'est le minimum pour qu'une équipe partage un compte sans se gêner, donc c'est inclus dès l'offre Solo. L'offre Free n'en a pas.
Limites par jour et par mois
Les deux, indépendamment, par inbox. La limite du jour arrête une boucle infinie ; celle du mois protège le budget. Le plafond du mois peut aussi être une part du volume de l'offre, et un espace de travail peut avoir le sien.
Vous choisissez le comportement
reject | alertAu plafond, l'inbox refuse les messages suivants. Chacun laisse une trace avec le code INBOX_QUOTA_EXCEEDED, que votre test lit par l'API : il échoue pour la bonne raison. Ou bien l'inbox continue d'accepter et se contente de prévenir. Selon qu'elle sert la CI ou une démo client, le bon choix n'est pas le même.
Des alertes avant le mur
80 · 100 %Sans réglage, les propriétaires et les administrateurs sont prévenus à 80 % puis à 100 % du volume de la période. Vous pouvez ajouter jusqu'à quatre seuils de votre choix. Une alerte part une fois par seuil franchi et par période, jamais deux.
Prévenu là où vous lisez
Jusqu'à trois destinations par règle d'alerte, en plus des administrateurs : une adresse e-mail, un salon Slack ou Discord, un service PagerDuty ou OpsGenie. L'alerte porte le chiffre, l'organisation, l'espace ou l'inbox concernés, et un lien vers l'écran de consommation. Pour PagerDuty et OpsGenie, Facteur ouvre l'incident et ne le referme jamais : c'est la personne d'astreinte qui le clôt.
Consommation par inbox
L'écran de consommation répond à « qui a consommé mon quota », pas seulement à « combien ». Il donne ce que chaque inbox a reçu et refusé sur la période, et la consommation de l'organisation jour par jour.
Prévenu avant l'épuisement
Quand le rythme des derniers jours épuiserait le volume avant la fin de la période, une alerte le dit, avec le jour prévu. Une autre part quand les pièces jointes occupent 80 % du stockage compris.
Plafond de dépense
Un montant au-delà duquel le dépassement s'arrête : les messages suivants sont refusés jusqu'à la période suivante. Une facture surprise est un défaut de conception, pas une fatalité.
Des plafonds pilotés par l'API
PATCH /inboxes/{inboxId}Le plafond du jour, celui du mois et le comportement au plafond se posent avec une clé d'API. Vos quotas vivent dans votre dépôt, pas dans la mémoire de la dernière personne qui a cliqué. Les destinataires des alertes se règlent dans l'application, et seulement là : une clé volée ne peut pas faire taire les alertes d'un compte.
Trois issues, et vous choisissez laquelle
Dépasser son volume est un événement normal dans la vie d'un projet. Ce ne devrait pas être un incident.
Un pack, tout de suite
Un pack ajoute des opérations à celles de l'offre, sans toucher à l'abonnement. Le paiement par carte n'est pas encore en service : d'ici là, un pack s'achète en écrivant au support depuis l'application.
Le dépassement prend le relais
Rien à faire, rien qui casse. Sur une offre payante, les messages en plus sont facturés en fin de période, dans la limite de votre plafond de dépense.
On refuse, franchement
Un refus explicite plutôt qu'un message avalé en silence. Le message refusé laisse une trace avec son code, dans l'application et par l'API. Votre test échoue pour la bonne raison, et vous le voyez.
Reprenez la main sur votre capacité
Plafonds par inbox, alertes avant la limite et plafond de dépense : inclus dès l'offre Solo, sans discussion commerciale.