# Quotas et alertes : un plafond par inbox, une alerte avant la limite · Facteur

> Un plafond par inbox dès l'offre Solo, le comportement au plafond que vous choisissez, et des alertes avant la limite plutôt qu'après.
> https://facteur.eu/fr/produit/quotas

/ Quotas et alertes

#  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.

 [ Voir les offres ](/fr/tarifs) [ Lire l'article sur les quotas ](/fr/aide/quotas-et-retention) 

 

   Quotas du jour 4 inboxes · exemple 

- 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
 
       infra/quotas.ts TypeScript 

 

```
<span class="hl-comment">// Les plafonds se posent par l'API, donc depuis votre code d'infrastructure.</span>
<span class="hl-keyword">await</span> <span class="hl-property">fetch</span>(<span class="hl-value">'https://api.facteur.eu/v1/inboxes/j3k9x2mq'</span>, {
  <span class="hl-property">method</span>: <span class="hl-value">'PATCH'</span>,
  <span class="hl-property">headers</span>: {
    <span class="hl-property">authorization</span>: <span class="hl-value">'Bearer '</span> + process.<span class="hl-property">env</span>.<span class="hl-property">FACTEUR_API_KEY</span>, <span class="hl-comment">// clé en écriture</span>
    <span class="hl-value">'content-type'</span>: <span class="hl-value">'application/merge-patch+json'</span>,
  },
  <span class="hl-property">body</span>: <span class="hl-type">JSON</span>.<span class="hl-property">stringify</span>({
    <span class="hl-property">quota</span>: {
      <span class="hl-property">daily</span>: 5000,     <span class="hl-comment">// une boucle infinie s'arrête là</span>
      <span class="hl-property">monthly</span>: 80000,  <span class="hl-comment">// le budget du mois</span>
      <span class="hl-comment">// 'reject' : les messages suivants sont refusés, avec un code.</span>
      <span class="hl-comment">// 'alert'  : on prévient, on laisse passer.</span>
      <span class="hl-property">onExceed</span>: <span class="hl-value">'reject'</span>,
    },
  }),
});
```

 Les chiffres du tableau sont un exemple. Le code est un vrai appel : null retire un plafond.  

 

 Détail

## Ce que vous pouvez régler

 

01

### Dès la première offre payante

`Solo`

Plafonner 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.

 

02

### 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.

 

03

### Vous choisissez le comportement

`reject | alert`

Au 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.

 

04

### 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.

 

05

### 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.

 

06

### 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.

 

07

### 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.

 

08

### 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é.

 

09

### 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.

 



 

 

 Et quand ça déborde

## 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.

 

01

Option 1

### 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.

 

Option 1

 

02

Option 2

### 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.

 

Option 2

 

03

Option 3

### 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.

 

Option 3

 

 

 

 

 

 

 

## 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.

 [ Voir les offres ](/fr/tarifs) [ Voir l'observabilité ](/fr/produit/observabilite)
