> ## Documentation Index
> Fetch the complete documentation index at: https://firespark.cloud/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurar alertas de monitoreo

> Recibe un mensaje en Slack, Discord, Microsoft Teams o email cuando falla una integración de pagos, inyección de pedidos, sync de menús, webhooks o API.

Las alertas de monitoreo avisan a tu equipo cuando algo **fuera** de Fire spark falla: un proveedor de pagos rechaza un cobro, tu POS rechaza un pedido, una importación de menú se rompe o tu endpoint de webhooks deja de responder. Los errores propios de Fire spark nunca disparan tus alertas — de esos se encarga nuestro equipo.

Cada alerta tiene un canal (Slack, Discord, Microsoft Teams o email), las fallas que la disparan y, opcionalmente, a quién avisar.

## Qué puede disparar una alerta

| Disparador | Se dispara cuando |
| - | - |
| **Integration API rejections (4xx)** | Tus servidores llaman a la Admin o Integrations API con una petición que Fire spark rechaza |
| **Payment failures** | Un proveedor de pagos rechaza o da error |
| **Payment terminal failures** | Un terminal de pago o bridge local de un kiosco falla una prueba, un cierre de lote u otra operación de terminal |
| **Order injection failures** | Un pedido no llega a tu POS o cocina después de todos los reintentos |
| **Webhook delivery failures** | Tu endpoint rechaza o no responde a tiempo un webhook de Fire spark |
| **Menu sync failures** | Falla una importación de menú desde tu POS |

## Antes de empezar

* Un rol en el dashboard que pueda administrar alertas de monitoreo.
* Para **Slack**: permiso para agregar apps a tu workspace y acceso al canal que recibirá las alertas.
* Para **Discord**: el permiso **Manage Webhooks** (Gestionar webhooks) en el servidor.
* Para **Microsoft Teams**: permiso para agregar conectores o incoming webhooks al canal del equipo.

## Consigue la URL del webhook

Slack, Discord y Microsoft Teams entregan las alertas mediante un **incoming webhook**: una URL privada que publica mensajes en un canal. Sus pantallas cambian de vez en cuando, así que sigue sus guías oficiales para los pasos exactos.

> [tab] Slack
>
> 1. Crea una app de Slack (o reutiliza una) y activa **Incoming Webhooks**.
>
> 2. Haz clic en **Add New Webhook to Workspace** y elige el canal de alertas.
>
> 3. Copia la URL. Empieza con `https://hooks.slack.com/services/`.
>
> > [card] [Slack: Sending messages using incoming webhooks](https://docs.slack.dev/messaging/sending-messages-using-incoming-webhooks)
> >
> > Guía oficial paso a paso de Slack (en inglés).
>
> > [!NOTE]
> >
> > Para publicar en un canal privado debes ser miembro de ese canal al crear el webhook.

> [tab] Discord
>
> 1. Abre **Ajustes del servidor → Integraciones → Webhooks**.
>
> 2. Haz clic en **Nuevo webhook**, elige el canal y, si quieres, cámbiale el nombre (por ejemplo, "Alertas Fire spark").
>
> 3. Haz clic en **Copiar URL de webhook**. Empieza con `https://discord.com/api/webhooks/`.
>
> > [card] [Discord: Introducción a los webhooks](https://support.discord.com/hc/es/articles/228383668)
> >
> > Guía oficial del soporte de Discord.

> [tab] Microsoft Teams
>
> 1. En Teams, abre el canal que recibirá las alertas.
>
> 2. Abre **Connectors** (o **Workflows → Create from blank → When a Teams webhook request is received** en tenants nuevos) y agrega un **Incoming Webhook**.
>
> 3. Nombra el conector (por ejemplo, "Alertas Fire spark") y copia la URL. Suele empezar con `https://` e incluir `webhook.office.com/webhookb2/` o `outlook.office.com/webhook/`.
>
> > [card] [Microsoft Teams: Create incoming webhooks](https://learn.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/how-to/add-incoming-webhook)
> >
> > Guía oficial de Microsoft (en inglés).

> [tab] Email
>
> Email no necesita URL. Fire spark envía la alerta a los roles y miembros que elijas en **Recipients**, al email de su cuenta de Fire spark.

> [!WARNING]
>
> Cualquiera con la URL del webhook puede publicar en tu canal. No la compartas ni la subas a un repositorio. Fire spark la guarda cifrada y, después de guardar, solo muestra una versión enmascarada.

## Crea la alerta

**1. Abre las alertas**

En el dashboard, ve a **Monitoring → Notifications** y haz clic en **New alert**.

**2. Completa la pestaña General**

* **Name**: algo que tu equipo reconozca, como "Fallas de inyección al POS".
* **Destination**: elige Slack, Discord, Microsoft Teams o Email y pega la URL del webhook cuando corresponda.
* **Triggers**: elige qué fallas disparan esta alerta.
* **Recipients** (opcional en Slack, Discord y Teams): roles o miembros a nombrar en el mensaje. Obligatorio para email.

**3. Guarda y envía una prueba**

Haz clic en **Save**. En la tarjeta de la alerta, usa **Send test** para confirmar que el mensaje llega a tu canal.

La vista previa a la derecha del formulario muestra cómo se verá el mensaje con datos de ejemplo.

## Mencionar personas

Usa el campo **Mention** para notificar a personas en Slack o Discord, o para agregar una nota breve al inicio de mensajes en Teams.

> [tab] Slack
>
> * `@here` o `@channel` notifican al canal. Fire spark los convierte al formato de Slack.
> * Para mencionar a una persona usa su member ID: `<@U0123ABCDE>`.
>
> [Cómo formatea Slack las menciones](https://docs.slack.dev/messaging/formatting-message-text#mentioning-users) (en inglés)

> [tab] Discord
>
> * `@here` o `@everyone` notifican al canal.
> * Para una persona usa `<@USER_ID>` y para un rol `<@&ROLE_ID>`.
> * Para copiar IDs, activa el **Modo desarrollador** en Discord y haz clic derecho sobre el usuario o rol.
>
> [Discord: ¿Dónde encuentro mi ID de usuario, servidor o mensaje?](https://support.discord.com/hc/es/articles/206346498)

> [tab] Microsoft Teams
>
> Los incoming webhooks de Teams no soportan `@here` igual que Slack y Discord. Usa **Mention** para texto opcional (por ejemplo, el nombre del equipo) que aparece arriba del cuerpo de la alerta.

## Opciones avanzadas

La pestaña **Advanced** cubre casos especiales. Los valores por defecto sirven para la mayoría de equipos.

| Opción | Qué hace |
| - | - |
| **Production only** | Ignora fallas de entornos de prueba. Activado por defecto. |
| **Cooldown** | Minutos mínimos antes de que la misma alerta vuelva a dispararse. Evita que una ráfaga de fallas inunde el canal. |
| **Conditions** | Dispara solo cuando se cumplen reglas: fallas repetidas en una ventana de tiempo, status HTTP, ruta de la API, mensaje de error, horario, o datos del pedido, cliente, menú y pago. Las condiciones de pedido, cliente, menú y pago solo funcionan cuando todos los disparadores son fallas de pago, inyección de pedidos o webhooks. |
| **Messages** | Personaliza el texto de cada disparador. Haz clic en un placeholder para insertarlo. |

Placeholders disponibles en los mensajes:

| Placeholder | Ejemplo |
| - | - |
| `{{merchant}}` | El nombre de tu merchant |
| `{{env}}` | `production` |
| `{{event}}` | `payment.failed` |
| `{{message}}` | El error que reportó el proveedor |
| `{{status}}` | Status HTTP, como `422` |
| `{{path}}` | Ruta de la API, como `/v1/orders` |
| `{{entity_id}}` | ID del pedido, menú o webhook |
| `{{timestamp}}` | Cuándo ocurrió |
| `{{url}}` | Link al evento en el dashboard |

## Solución de problemas

> [accordion] El mensaje de prueba nunca llega
>
> Revisa que la URL sea la URL completa del incoming webhook y que el webhook siga existiendo en Slack, Discord o Teams. Si alguien borró el webhook o archivó el canal, crea uno nuevo y pega la nueva URL en la alerta.

> [accordion] La tarjeta de la alerta muestra un error
>
> La tarjeta muestra el último error de entrega. **Hourly alert limit reached for this merchant** significa que Fire spark pausó las alertas por el resto de la hora para no inundar tus canales. Sube el cooldown o acota la alerta con condiciones.

> [accordion] Las menciones aparecen como texto
>
> En Slack, las personas necesitan su member ID (`<@U0123ABCDE>`), no su nombre visible. En Discord usa `<@USER_ID>` o `<@&ROLE_ID>`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.