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

# Disparar alertas

> Avise todos os inscritos no momento em que o item fica disponível.

Quando o item fica disponível, você dispara um alerta e todos os inscritos no item recebem o aviso ao mesmo tempo.

> [!NOTE]
>
> Para disparar você precisa da permissão **Disparar eventos**. O dono sempre pode.

## Disparar agora

**1. Abra o item e clique em Disparar alerta**

O Need Alert calcula o custo na hora e mostra quantas pessoas serão notificadas, quantos créditos o disparo usa e o saldo atual.

**2. Escreva o aviso**

* **Título (opcional):** se ficar em branco, o título é o nome do item.
* **Mensagem:** até 200 caracteres. Exemplo: "Saiu uma fornada agora, corre que ainda está quentinho!"

**3. Confirme**

Clique em **Disparar**. O status aparece como **Enviando** e muda para **Enviado** quando todos foram avisados.

## O que acontece com as inscrições

* Num item de **aviso único**, a inscrição de cada pessoa avisada é encerrada.
* Num item de **aviso recorrente**, a inscrição continua ativa, a menos que a pessoa tenha atingido o número de avisos que escolheu.

A pessoa recebe uma notificação no celular ou no computador, se permitiu avisos, e o aviso também fica em **Meus alertas** e em **Notificações**, dentro do Need Alert. Quem ainda não confirmou o e-mail da conta não entra na contagem de destinatários: não é avisado nem cobrado.

## Custo

Cada pessoa avisada consome **1 crédito**. O débito é feito no momento do disparo, com base em quem está inscrito naquele instante.

* **Nenhum inscrito:** o disparo fica registrado e não custa nada.
* **Saldo insuficiente:** o disparo não é enviado. O aviso mostra quanto falta e, se você tem a permissão **Gerenciar créditos**, o link **Comprar créditos**. Veja [Créditos](https://docs.needalert.app/establishments/credits.md).

## Quando o disparo não é aceito

| Situação | Motivo |
| - | - |
| O item está pausado ou arquivado | Só itens **Ativos** recebem disparos. |
| A unidade está inativa ou suspensa | Uma unidade suspensa não pode disparar novos eventos. |
| Já existe um disparo do item em andamento | Espere o anterior terminar. |
| Você acabou de disparar este item | Há um intervalo curto, de alguns segundos, entre disparos do mesmo item, para evitar clique duplo. |

## Se o envio falhar

Raramente, uma falha técnica impede o envio mesmo depois de várias tentativas. O disparo aparece como **Falhou**, com o motivo **Erro no envio**. Os avisos que já saíram continuam contados, e os créditos já debitados não voltam sozinhos. Esse caso não manda e-mail nem notificação: o disparo só muda de status em **Disparos**. Fale com o suporte: a equipe do Need Alert pode retomar o envio para quem ainda não foi avisado, sem nova cobrança, desde que o item e a unidade continuem ativos.

## Histórico

A seção **Disparos** mostra todos os alertas da unidade: data, item, mensagem, status, destinatários, créditos usados, quantos avisos foram entregues e quantos falharam, e quem disparou. Os últimos disparos de cada item também aparecem na página do item.

> [!TIP]
>
> Quer avisar num horário certo, como a saída do forno às 16h? [Agende o disparo](https://docs.needalert.app/establishments/schedule-alerts.md).


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