## Para que servem os limites de mensagens

Um limite de mensagens controla quantas mensagens uma única aplicação pode enviar por dia. O portal descreve-o como um mecanismo para definir e monitorizar os limites de mensagens de uma API e indica ele próprio o motivo: manter a utilização da API sob controlo, para que não surjam custos financeiros indesejados e ninguém utilize o canal de forma abusiva.

O limite pode ser repartido por país e, além disso, decide o que acontece às mensagens acima do limite — se ficam à espera, se são enviadas no dia seguinte ou se são descartadas.

> [!NOTE]
> Esta página trata dos `Limites de mensagens da API`, ou seja, do número de
> mensagens enviadas. Quantos pedidos uma aplicação pode enviar à API é explicado
> na página separada [Limites de pedidos da API](https://www.bulkgate.com/pt/documentacao/administracao-da-api/limites-de-pedidos-api/).

## Onde encontrar os limites

1. No menu do portal, clique em `Módulos e APIs`
2. Em `Minhas APIs e módulos`, clique no cartão da sua aplicação
3. Mantenha-se no separador `Definições` e desça até à parte `Limites de API`

O cartão `Limites de mensagens da API` mostra a configuração atual em três linhas — `Máximo de mensagens de API por dia`, `Limite de mensagens por país` e `Ações acima do limite`. Enquanto não estiver nada definido, mostra em vez disso `Você não tem configurações.` e o botão `Configurar`.

![O cartão Limites de mensagens da API no detalhe da aplicação](docs:api-limits/limit-card_en)

## Como definir os limites

O botão `Configurar` (ou `Editar`, se já tiver limites) abre a janela `Limites de mensagens da API` com três passos. Navega entre eles com os botões `Próximo` e `De volta`; nada é guardado até ao `Salve` final.

### Passo 1 — Máximo de mensagens de API por dia

Introduza quantas mensagens a aplicação pode enviar num único dia. Sem um número positivo, o botão `Próximo` permanece desativado.

![O primeiro passo com o número máximo de mensagens por dia](docs:api-limits/limit-step-total_en)

### Passo 2 — Limite de mensagens por país

Deixe `Sem limite` ou escolha `Defina o limite personalizado para um país específico` e, no campo `País de pesquisa`, selecione os países que pretende tratar separadamente. Cada país é adicionado a uma lista, onde lhe atribui um de três modos:

| Modo | O que significa |
|:--|:--|
| `Máximo da API` | O país utiliza o limite diário comum e não tem um limite próprio |
| `Limite` | O país tem o seu próprio limite diário, que introduz no campo ao lado |
| `Bloquear` | Não é enviado nada para esse país |

Assim que a lista tiver mais do que uma entrada, aparece a linha `Outros países`, que define o modo para todos os restantes países de uma só vez. O ícone do caixote do lixo remove um país da lista.

![O segundo passo com os limites por país](docs:api-limits/limit-step-country_en)

### Passo 3 — Ações acima do limite

O portal pergunta `O que fazer com mensagens que ultrapassam o limite?` e oferece três opções:

| Opção | Comportamento |
|:--|:--|
| `Salvar mensagens na caixa de saída` | As mensagens acima do limite são guardadas na caixa de saída para processamento posterior |
| `Enviar amanhã` | As mensagens acima do limite são enviadas no dia seguinte, à hora que definir nesta opção |
| `Descartar mensagens` | As mensagens acima do limite são descartadas |

![O terceiro passo com as ações acima do limite](docs:api-limits/limit-step-policy_en)

> [!WARNING]
> Um país bloqueado segue uma regra própria — as mensagens para esse país são
> descartadas, independentemente da ação acima do limite que tiver definido.

## Como acompanhar a utilização do limite

Por cima dos separadores `Definições` e `Estatisticas` encontra-se o painel `Status atual dos limites da API`, com a percentagem utilizada e uma barra de progresso. Se repartir o limite por país, é acrescentada uma linha para cada um deles; um país bloqueado mostra `negado` em vez da barra.

![O painel Status atual dos limites da API](docs:api-limits/limit-status_en)

Aos 80 %, o portal avisa com `Your daily limit will soon be exceeded.` e, quando o limite estiver totalmente esgotado, com `Você atingiu seu limite diário de API!`.

O botão `Redefinir limite` repõe a zero o contador das mensagens de hoje — a janela de confirmação indica que `O contador de mensagens enviadas hoje será zerado.` O ícone ao lado da linha de um país repõe apenas esse país. Enquanto a aplicação não tiver enviado nada hoje, o botão permanece desativado.

## Avisos sobre tráfego invulgar

Além dos limites que define, o portal acompanha também a evolução do tráfego da sua aplicação ao longo do tempo. Compara as mensagens de hoje com o que a aplicação enviava no período anterior e avisa-o quando os dois valores divergem de forma significativa.

Distingue dois casos:

| O que acontece | Como se manifesta |
|:--|:--|
| As mensagens começam a ser enviadas para um país para o qual a sua aplicação normalmente não envia | As mensagens são guardadas na caixa de saída e o aviso chega por e-mail e por SMS |
| Um país para o qual envia regularmente recebe muito mais mensagens do que o habitual | O envio continua e o aviso chega por e-mail |

O primeiro caso funciona, portanto, também como salvaguarda — as mensagens aguardam até as aprovar, independentemente da ação acima do limite que tiver definido.

> [!IMPORTANT]
> Esta verificação só é efetuada enquanto não tiver limites personalizados por país
> definidos no passo `Limite de mensagens por país`. Assim que tratar os países por si,
> o portal segue as suas definições e não acompanha as tendências.

Para não o inundar de avisos, o portal envia apenas alguns avisos sobre o mesmo fenómeno e depois deixa de avisar. Também precisa de um histórico de envios — numa aplicação recém-criada, sem nada com que comparar, as tendências não são avaliadas.

## Como remover os limites

A seta ao lado do botão `Editar` abre um menu com a opção `Excluir`. A janela de confirmação `Remover limites da API` indica que, depois de eliminados, a API deixará de restringir o envio de mensagens de acordo com os limites.