Alertas e e-mails¶

Para: Adm · Fin — Conferido em 2026-10-18.

A tela Alertas liga e desliga 12 tipos de aviso da operação (caixa baixo, fila de revisão, webhook falhando, divergência de reconciliação e outros), escolhe por onde cada um sai (e-mail, webhook ou os dois) e guarda o histórico dos disparados. Esta página também lista os e-mails que o Dracma envia aos contatos da operação.

O que é¶

Cada operação tem uma regra por tipo de alerta. Uma regra tem: ligada ou desligada, o limiar (nos tipos que têm), os canais e o silêncio entre alertas iguais. Toda regra começa desligada, com o canal e-mail e silêncio de 60 minutos.

Quem vê as regras e o histórico: todos os papéis com acesso à operação. Quem configura: Administrador do tenant e Financeiro; os demais veem a regra em uma linha ("Ligada · limiar 50 itens · e-mail + webhook · silêncio 1 h").

Os 12 tipos:

Tipo	Severidade	Como dispara	O que avisa
Caixa abaixo do limiar	Crítico	Periódico	O Disponível da moeda ficou abaixo do limiar de Saldos e caixa. Não tem limiar próprio; configura-se a moeda (padrão BRL).
SLA de revisão estourado	Atenção	Periódico	Há N itens em revisão há mais de 24 horas. O limiar é N.
Fila de revisão acima de N itens	Atenção	Periódico	Saques e depósitos esperando revisão acima do limiar.
Taxa de automático variou	Atenção	Periódico	A taxa de saques decididos automaticamente na última hora variou mais que o limiar (em %) em relação à hora anterior. Exige uma amostra mínima de saques por hora (de 1 a 1000).
Conexão de PSP com circuit breaker aberto	Crítico	Periódico	Uma conexão de PSP parou de receber tentativas.
Entrega de webhook falhando	Atenção	Periódico	A entrega ao webhook está sem sucesso há mais que o limiar (em minutos), ou algum evento foi para a DLQ nas últimas 24 horas.
Certificado a vencer	Atenção	Periódico	Um certificado de conexão está perto do vencimento.
Rajada de 401/403 na API	Atenção	Periódico	Muitas recusas de autenticação em pouco tempo (chave vazada?).
Mudança de regra ativada	Informativo	Por evento	Uma versão de regras entrou em vigor.
Uso do interruptor de emergência	Crítico	Por evento	Suspender automático foi acionado.
Break-glass do staff	Crítico	Por evento	A equipe do Dracma usou acesso de emergência na operação.
Divergência de reconciliação	Crítico	Por evento	A conferência com o seu livro encontrou divergência.

Quando usar¶

Ligue pelo menos, antes do go-live:

• Caixa abaixo do limiar, depois de definir o limiar de cada moeda;
• Entrega de webhook falhando;
• Fila de revisão acima de N itens e SLA de revisão estourado;
• Divergência de reconciliação.

Como fazer¶

Configurar uma regra¶

1. Abra Alertas no menu Administração. Cada tipo é um cartão.
2. Marque Regra ligada.
3. Se o tipo tem limiar, preencha Limiar (número decimal; a unidade aparece no campo).
4. Em Canais, marque E-mail aos contatos de alerta da operação, Webhook cadastrado da operação ou os dois. Uma regra ligada precisa de pelo menos um canal.
5. Em Silêncio entre alertas iguais, informe os minutos (de 1 a 10080, isto é, até 7 dias). Enquanto a janela não termina, o mesmo alerta (do mesmo tipo e para o mesmo item, como a mesma moeda) não se repete.
6. Clique em Salvar regra. Não pede confirmação recente; a mudança fica na Auditoria.

No cartão aparecem também a data e o autor da última atualização.

Canais de saída¶

• E-mail: vai aos contatos de alerta da operação, em texto puro, com o assunto Alerta: <título> e os detalhes.
• Webhook: o Dracma envia ao endereço de webhook da operação um evento alert.fired, assinado como qualquer entrega. Ele não faz parte do catálogo de depósito e saque, e a escolha de eventos da operação não o filtra. O corpo traz, em data: alert_id, kind, severity, title, detail, value, threshold e fired_at. O seu receptor deve aceitar e responder 2xx a tipos de evento que não conhece (veja Receptor passo a passo).

Na aba Entregas de Webhooks no painel, uma entrega alert.fired pode aparecer como Ignorado: é um alerta cuja regra não escolheu o canal webhook.

Contatos de alerta¶

Os e-mails vão para os contatos de alerta da operação: até 5 endereços, cadastrados pelo Dracma no onboarding.

E-mails que o Dracma envia à operação¶

Todos os e-mails são em texto puro, nunca trazem dados pessoais do jogador e têm um rodapé que explica por que o endereço os recebe. Na operação de Teste o assunto começa com [Dracma sandbox].

E-mail	Quando sai	O que traz
Webhook em DLQ	Uma entrega esgotou as tentativas e foi para a DLQ.	Operação, ambiente, evento, entrega, número de tentativas e o último HTTP. Avisa que o evento não foi perdido e que a reentrega é pela DLQ. Assunto: Webhook em DLQ: <tipo> <id>.
Saque aguardando revisão manual	Um saque foi para revisão.	Operação, ambiente, saque, valor (na menor unidade), horário do evento. Pede para decidir no painel.
Resumo diário	Todo dia, a partir das 06:00 (America/Sao_Paulo), referente ao dia anterior (dia de Brasília).	Por tipo de evento: quantidade e soma por moeda. O assunto avisa que não é a reconciliação oficial.
Alerta	Um alerta com canal e-mail disparou.	O tipo e a severidade, o horário, o identificador do alerta, o valor e o limiar (quando houver) e o detalhe.
Informação solicitada	Um revisor pediu informação sobre um saque (Revisão).	O texto do revisor e o identificador do saque no seu sistema.

Um mesmo fato gera um e-mail (o resumo, um por dia; a DLQ, um por entrega).

O resumo diário não substitui a Reconciliação no painel: use-o só como aviso.

Histórico¶

Abaixo das regras, o Histórico lista os alertas disparados (20 por vez), com a data, o título, a severidade, o detalhe, o valor e o limiar, e os canais por onde saíram.

Exemplos¶

Aviso de fila grande, enviado por e-mail e webhook:

Campo	Valor
Regra	Fila de revisão acima de N itens
Regra ligada	sim
Limiar (itens)	20
Canais	E-mail e Webhook
Silêncio	120 minutos

Com essa regra, se a fila passar de 20 itens, os contatos recebem um e-mail "Alerta: Fila de revisão acima de N itens" e o receptor recebe um alert.fired. Enquanto o problema continuar, o aviso se repete no máximo uma vez a cada 2 horas.

Erros e casos de borda¶

Mensagem	Causa	O que fazer
"Regra salva."	Sucesso.	Nenhuma.
"O período de silêncio deve ser um número de minutos entre 1 e 10080."	Silêncio fora da faixa.	Corrija.
"Escolha ao menos um canal (e-mail ou webhook) para uma regra ligada."	Regra ligada sem canal.	Marque um canal.
"Informe um limiar numérico válido para este tipo."	Limiar ausente ou inválido; ou limiar num tipo que não tem.	Corrija.
"Parâmetro extra inválido (moeda ou amostra mínima)."	Moeda ou amostra fora do formato.	Corrija.
"A api recusou algum campo da regra. Revise os valores."	validation_failed.	Revise.
"Sem permissão para configurar alertas nesta operação."	Seu papel só vê.	Peça a um Administrador ou Financeiro.
"Serviço de autorização indisponível. Tente de novo em instantes."	Dependência fora do ar.	Repita.

Casos de borda:

• Alerta de caixa não dispara. Confira se a moeda tem limiar definido em Saldos e caixa.
• Alerta ligado, nada chega. Veja o histórico; se o alerta aparece lá com canal e-mail e o e-mail não chegou, a operação provavelmente está sem contatos.
• Muitos alertas iguais. Aumente o silêncio.
• Para parar de receber e-mails num endereço, peça a remoção ao suporte.

Veja também¶

• Saldos e caixa
• Webhooks no painel
• Reconciliação no painel
• Suporte