## Para qué sirven los límites de mensajes

El límite de mensajes controla cuántos mensajes puede enviar una aplicación al día.
El portal lo describe como un mecanismo para configurar y supervisar los límites de
mensajes de una API y él mismo indica el motivo: mantener bajo control el uso de la
API para que no se produzcan costes no deseados y nadie abuse del canal.

El límite puede desglosarse por países y, además, usted decide qué ocurre con los
mensajes que lo superan: si esperan, salen al día siguiente o se descartan.

> [!NOTE]
> Esta página trata de `Límites de mensajes de API`, es decir, del número de mensajes
> enviados. Cuántas solicitudes puede enviar una aplicación a la API se explica en la
> página aparte [Límites de peticiones de la API](https://www.bulkgate.com/es/documentacion/administracion-de-la-api/limites-de-peticiones-de-la-api/).

## Dónde encontrar los límites

1. En el menú del portal, haga clic en `Módulos y APIs`
2. En `Mis APIs y módulos`, haga clic en la tarjeta de su aplicación
3. Permanezca en la pestaña `Ajustes` y desplácese hasta la parte `Límites de API`

La tarjeta `Límites de mensajes de API` muestra la configuración actual en tres filas:
`Mensajes API máximos por día`, `Límite de mensajes por país` y `Acciones por encima
del límite`. Mientras no haya nada configurado, muestra en su lugar `No tienes
configuración.` y el botón `Configurar`.

![La tarjeta Límites de mensajes de API en el detalle de la aplicación](docs:api-limits/limit-card_en)

## Cómo configurar los límites

El botón `Configurar` (o `Editar`, si ya tiene límites) abre la ventana `Límites de
mensajes de API` con tres pasos. Entre ellos se desplaza con los botones `Siguiente`
y `Volver`; no se guarda nada hasta el `Salvar` final.

### Paso 1 — Mensajes API máximos por día

Indique cuántos mensajes puede enviar la aplicación en un solo día. Sin un número
positivo, el botón `Siguiente` permanece desactivado.

![El primer paso con el número máximo de mensajes al día](docs:api-limits/limit-step-total_en)

### Paso 2 — Límite de mensajes por país

Deje `Sin límite` o elija `Establecer el límite personalizado para un país específico`
y, en el campo `País de búsqueda`, seleccione los países que quiere tratar por
separado. Cada uno se añade a una lista en la que le asigna uno de estos tres modos:

| Modo | Qué significa |
|:--|:--|
| `API máximo` | El país consume del límite diario común y no tiene un tope propio |
| `Límite` | El país tiene su propio límite diario, que escribe en el campo de al lado |
| `Bloquear` | A ese país no se envía nada |

En cuanto la lista contiene más de una entrada, aparece la fila `Otros paises`, que
establece el modo para todos los países restantes a la vez. El icono de la papelera
elimina un país de la lista.

![El segundo paso con los límites por país](docs:api-limits/limit-step-country_en)

### Paso 3 — Acciones por encima del límite

El portal pregunta `¿Qué hacer con los mensajes que superan el límite?` y ofrece
tres opciones:

| Opción | Comportamiento |
|:--|:--|
| `Guardar mensajes en la bandeja de salida` | Los mensajes que superan el límite se guardan en la bandeja de salida para procesarlos más tarde |
| `enviar mañana` | Los mensajes que superan el límite salen al día siguiente a la hora que configure en la opción |
| `Descartar mensajes` | Los mensajes que superan el límite se descartan |

![El tercer paso con las acciones por encima del límite](docs:api-limits/limit-step-policy_en)

> [!WARNING]
> Un país bloqueado sigue su propia regla: los mensajes que se le envían se descartan
> independientemente de la acción por encima del límite que haya configurado.

## Cómo supervisar el consumo del límite

Encima de las pestañas `Ajustes` y `Estadística` se encuentra el panel `Estado de los
límites de API de hoy` con el porcentaje consumido y una barra de progreso. Si
desglosa el límite por países, se añade una fila para cada uno de ellos; un país
bloqueado muestra `negado` en lugar de la barra.

![El panel Estado de los límites de API de hoy](docs:api-limits/limit-status_en)

Al llegar al 80 %, el portal avisa con `Your daily limit will soon be exceeded.` y,
una vez consumido todo el límite, con `¡Has alcanzado tu límite diario de API!`.

El botón `Restablecer límite` pone a cero el contador de los mensajes de hoy; la
ventana de confirmación advierte de que `El contador de mensajes enviados hoy se
pondrá a cero.` El icono junto a la fila de un país restablece solo ese país.
Mientras la aplicación no haya enviado nada hoy, el botón permanece desactivado.

## Avisos de tráfico inusual

Además de los límites que configure usted mismo, el portal también vigila cómo
evoluciona el tráfico de su aplicación con el tiempo. Compara los mensajes de hoy con
lo que la aplicación enviaba en el periodo anterior y le avisa cuando ambos difieren
de forma notable.

Distingue dos casos:

| Qué ocurre | Cómo se manifiesta |
|:--|:--|
| Los mensajes empiezan a ir a un país al que su aplicación normalmente no envía | Los mensajes se guardan en la bandeja de salida y el aviso llega por correo electrónico y SMS |
| Un país al que envía con regularidad recibe notablemente más mensajes de lo habitual | El envío continúa y el aviso llega por correo electrónico |

Así, el primer caso sirve también como medida de seguridad: los mensajes esperan hasta
que usted los apruebe, independientemente de la acción por encima del límite que haya
configurado.

> [!IMPORTANT]
> Esta comprobación solo funciona mientras no tenga configurados límites propios por
> país en el paso `Límite de mensajes por país`. En cuanto gestione usted los países,
> el portal sigue su configuración y no vigila las tendencias.

Para no saturarle, el portal envía solo unos pocos avisos sobre el mismo fenómeno y
después deja de hacerlo. Además, necesita un historial de envíos: en una aplicación
recién creada, sin nada con qué comparar, las tendencias no se evalúan.

## Cómo eliminar los límites

La flecha junto al botón `Editar` abre un menú con la opción `Borrar`. La ventana de
confirmación `Eliminar límites de API` advierte de que, una vez eliminados, la API
dejará de restringir el envío de mensajes según los límites.