## À quoi servent les limites de messages

Une limite de messages surveille le nombre de messages qu'une application peut
envoyer par jour. Le portail la présente comme un mécanisme permettant de définir
et de surveiller les limites de messages d'une API, et en donne lui-même la
raison : garder l'utilisation de l'API sous contrôle afin d'éviter des coûts
indésirables et d'empêcher toute utilisation abusive du canal.

La limite peut être répartie par pays et, en plus, vous décidez de ce qu'il
advient des messages au-delà de la limite — s'ils attendent, partent le
lendemain ou sont supprimés.

> [!NOTE]
> Cette page traite des `Limites des messages API`, c'est-à-dire du nombre de
> messages envoyés. Le nombre de requêtes qu'une application peut adresser à l'API
> est traité sur la page distincte [Limites de requêtes de l'API](https://www.bulkgate.com/fr/documentation/administration-api-et-tokens/limites-requetes-api/).

## Où trouver les limites

1. Dans le menu du portail, cliquez sur `Modules et API`
2. Sous `Mes API et modules`, cliquez sur la carte de votre application
3. Restez sur l'onglet `Réglages` et faites défiler jusqu'à la partie `Limites de l'API`

La carte `Limites des messages API` affiche la configuration actuelle sur trois
lignes — `Nombre maximal de messages API par jour`, `Limite de messages par pays`
et `Actions au-delà des limites`. Tant que rien n'est défini, elle affiche à la
place `Vous n'avez aucun paramètre.` et un bouton `Configurer`.

![La carte Limites des messages API dans le détail de l'application](docs:api-limits/limit-card_en)

## Comment définir les limites

Le bouton `Configurer` (ou `Modifier`, si vous avez déjà des limites) ouvre la
fenêtre `Limites des messages API` en trois étapes. Vous passez de l'une à
l'autre avec les boutons `Suivant` et `Retour` ; rien n'est enregistré avant le
dernier clic sur `Enregistrer`.

### Étape 1 — Nombre maximal de messages API par jour

Saisissez le nombre de messages que l'application peut envoyer en une journée.
Sans nombre positif, le bouton `Suivant` reste désactivé.

![La première étape avec le nombre maximal de messages par jour](docs:api-limits/limit-step-total_en)

### Étape 2 — Limite de messages par pays

Laissez `Sans limites`, ou choisissez
`Définir la limite personnalisée pour un pays spécifique` et sélectionnez dans le champ `Rechercher un pays` les pays que
vous souhaitez traiter séparément. Chacun est ajouté à une liste où vous lui
attribuez l'un des trois modes :

| Mode | Signification |
|:--|:--|
| `API maximale` | Le pays puise dans la limite journalière commune et n'a pas de plafond propre |
| `Limite` | Le pays a sa propre limite journalière, que vous saisissez dans le champ voisin |
| `Bloquer` | Rien n'est envoyé vers ce pays |

Dès que la liste contient plus d'une entrée, une ligne `Autres pays` apparaît ;
elle définit le mode de tous les pays restants en une seule fois. L'icône de
corbeille retire un pays de la liste.

![La deuxième étape avec les limites par pays](docs:api-limits/limit-step-country_en)

### Étape 3 — Actions au-delà des limites

Le portail demande `Que faire des messages dépassant la limite ?` et propose
trois options :

| Option | Comportement |
|:--|:--|
| `Enregistrer les messages dans la boîte d'envoi` | Les messages au-delà de la limite sont enregistrés dans la boîte d'envoi pour être traités plus tard |
| `Envoyer demain` | Les messages au-delà de la limite partent le lendemain, à l'heure que vous définissez avec l'option |
| `Supprimer les messages` | Les messages au-delà de la limite sont supprimés |

![La troisième étape avec les actions au-delà des limites](docs:api-limits/limit-step-policy_en)

> [!WARNING]
> Un pays bloqué suit sa propre règle — les messages qui lui sont destinés sont
> supprimés, quelle que soit l'action au-delà des limites que vous avez définie.

## Comment suivre l'utilisation de la limite

Au-dessus des onglets `Réglages` et `Statistiques` se trouve le panneau
`État actuel des limites de l'API`, avec le pourcentage utilisé et une barre de
progression. Si vous répartissez la limite par pays, une ligne s'ajoute pour
chacun d'eux ; un pays bloqué affiche `refusé` à la place de la barre.

![Le panneau État actuel des limites de l'API](docs:api-limits/limit-status_en)

À 80 %, le portail vous avertit par `Your daily limit will soon be exceeded.`, et
une fois la limite entièrement utilisée par
`Vous avez atteint votre limite API quotidienne !`.

Le bouton `Réinitialiser la limite` remet à zéro le compteur des messages du
jour — la fenêtre de confirmation précise que
`Le compteur des messages envoyés aujourd'hui sera remis à zéro.` L'icône à côté d'une ligne de pays réinitialise
uniquement ce pays. Tant que l'application n'a rien envoyé aujourd'hui, le bouton
reste désactivé.

## Avertissements en cas de trafic inhabituel

En plus des limites que vous définissez vous-même, le portail surveille aussi
l'évolution du trafic de votre application dans le temps. Il compare les messages
du jour avec ce que l'application envoyait au cours de la période précédente et
vous avertit lorsque les deux divergent sensiblement.

Il distingue deux cas :

| Ce qui se passe | Comment cela se manifeste |
|:--|:--|
| Des messages commencent à partir vers un pays où votre application n'envoie habituellement pas | Les messages sont enregistrés dans la boîte d'envoi et l'avertissement arrive par e-mail et par SMS |
| Un pays vers lequel vous envoyez régulièrement reçoit sensiblement plus de messages que d'habitude | L'envoi continue et l'avertissement arrive par e-mail |

Le premier cas sert donc aussi de protection — les messages attendent votre
approbation, quelle que soit l'action au-delà des limites que vous avez définie.

> [!IMPORTANT]
> Ce contrôle ne s'exécute que tant que vous n'avez défini aucune limite par pays
> personnalisée à l'étape `Limite de messages par pays`. Dès que vous gérez les
> pays vous-même, le portail suit vos réglages et ne surveille plus les tendances.

Pour ne pas vous submerger, le portail n'envoie que quelques avertissements sur un
même phénomène, puis se tait. Il a également besoin d'un historique d'envoi —
pour une application nouvellement créée, sans rien à comparer, les tendances ne
sont pas évaluées.

## Comment supprimer les limites

La flèche à côté du bouton `Modifier` ouvre un menu avec l'option `Effacer`. La
fenêtre de confirmation `Supprimer les limites de l'API` précise qu'une fois les
limites supprimées, l'API ne restreindra plus l'envoi de messages en fonction des
limites.