Alertas

Receba avisos automáticos no Telegram, e-mail, WhatsApp ou em um webhook quando algo importante acontece nas suas vendas — quedas anormais, picos de reembolso, metas atingidas — sem precisar ficar olhando dashboard.

---

Visão geral

Os Alertas avaliam suas métricas de vendas o tempo todo e disparam notificações quando uma condição que você definiu é atendida. Existem dois tipos de regra:

• Limite (THRESHOLD) — dispara quando uma métrica ultrapassa (ou fica abaixo de) um valor que você escolhe. Exemplo: “vendas do dia abaixo de 10”.
• Anomalia (ANOMALY) — dispara quando uma métrica foge do padrão histórico. O Synchro calcula a média dos últimos 14 dias e o desvio típico; se hoje está muito acima ou muito abaixo, é uma anomalia.

As notificações podem ser enviadas por:

• Telegram (recomendado) — entrega instantânea, sem custo de provedor e sem risco de bloqueio comercial.
• E-mail.
• WhatsApp (telefone individual, grupo ou canal).
• Webhook HTTPS (para integrar com Slack, Discord, n8n, Zapier ou seu próprio sistema).

Tempo estimado: 5 minutos por regra.

Importante: Alertas são um recurso de planos pagos. Os limites por plano são:

Plano	Regras de alerta
Free	0
Pro	3
Scale	10
Business	25

---

Pré-requisitos

• Plano Pro ou superior.
• Pelo menos uma plataforma de vendas conectada com vendas registradas.
• Para alertas por anomalia: ter pelo menos 14 dias de histórico de vendas (caso contrário a baseline não é confiável e a regra fica em espera).

---

Passo 1 — Criar uma regra

1. No menu lateral, abra Alertas.
2. Clique em + Nova regra.
3. Escolha o tipo: Limite ou Anomalia.

---

Passo 2 — Definir métrica, condição e janela

Os campos do formulário variam um pouco conforme o tipo de regra escolhido:

Métrica — o que será medido:

• Quantidade de vendas.
• Receita bruta (em centavos).
• Receita líquida (em centavos).
• Quantidade de reembolsos.

Para regras de Limite:

• Operador — >, >=, <, <=, =.
• Valor — número limite (ex.: 10 ou 100000 para R$ 1.000,00).

Para regras de Anomalia:

• Sensibilidade (k) — quão fora do padrão a métrica precisa estar pra disparar (padrão 2.5; valores menores = mais sensível).
• Janela de baseline — quantos dias usar pra calcular a média (padrão 14).

Dica: comece com regras de Limite (mais previsíveis) e adicione regras de Anomalia depois, quando você já souber qual é o “ritmo normal” do seu negócio.

---

Passo 3 — Configurar os destinos da notificação

Na seção Destinos, adicione um ou mais canais:

• Telegram (recomendado) — chat individual, grupo ou canal. Conecte uma vez via bot do Synchro e o destino fica disponível em qualquer regra.
• E-mail — qualquer endereço válido.
• WhatsApp — telefone — número no formato internacional (ex.: +5569933008597).
• WhatsApp — grupo — ID do grupo WhatsApp (...@g.us).
• WhatsApp — canal — ID do canal WhatsApp (...@newsletter).
• Webhook — URL HTTPS que receberá um POST com o payload do alerta em JSON.

Você pode adicionar quantos destinos quiser na mesma regra — todos são notificados quando a condição for atendida.

Importante: o Synchro envia WhatsApp via Meta Cloud API. Por limitação do provedor, WhatsApp para grupo e canal depende de configuração extra na sua conta business. Se a Meta rejeitar, o Synchro registra a falha no histórico e tenta os outros destinos.

---

Passo 4 — Ativar e testar

1. Clique em Salvar — a regra começa ativa.
2. Use o botão Enviar teste para receber uma notificação de exemplo nos destinos cadastrados. Confirma se os e-mails chegam, se o WhatsApp dispara e se o webhook responde.
3. Você pode pausar uma regra a qualquer momento sem apagar — útil em períodos de lançamento, quando você sabe que as métricas vão sair do padrão.

---

Passo 5 — Acompanhar o histórico

Na aba Histórico da página de Alertas, você vê todos os disparos: quando aconteceram, qual regra disparou, qual foi o valor da métrica e o status do envio em cada destino.

Dica: o Synchro evita disparar a mesma regra duas vezes no mesmo dia (deduplicação automática). Se uma regra de “vendas abaixo de 10” continuar sendo verdade no dia inteiro, você recebe uma notificação, não vinte.

---

Formato do JSON enviado ao Webhook

Quando você configura um destino do tipo Webhook, o Synchro faz um POST para a URL informada com o corpo abaixo. Use este shape para fazer parsing, rotear notificações no Slack/Discord/n8n ou disparar lógica no seu sistema.

Requisição:

• Método: POST
• Content-Type: application/json
• User-Agent: Synchro-Webhook
• Timeout: 5 segundos. Respostas 2xx são consideradas sucesso. Em falha (timeout, 5xx, conexão), o Synchro tenta novamente até 3 vezes.

Exemplo — regra de Limite (THRESHOLD)

{
  "eventId": "0193f7a0-7c8d-7a2b-9c1e-2f4a8e3b1d50",
  "ruleId": "0193f79f-1abc-7def-8123-aabbccddeeff",
  "ruleName": "Queda de vendas",
  "firedAt": "2026-05-19T13:15:00.000Z",
  "payload": {
    "ruleType": "THRESHOLD",
    "metric": "sales_count",
    "comparator": "<",
    "current": 5,
    "threshold": 10,
    "direction": "low"
  }
}

Exemplo — regra de Anomalia (ANOMALY)

{
  "eventId": "0193f7a0-7c8d-7a2b-9c1e-2f4a8e3b1d50",
  "ruleId": "0193f79f-1abc-7def-8123-aabbccddeeff",
  "ruleName": "Pico anormal de reembolsos",
  "firedAt": "2026-05-19T13:15:00.000Z",
  "payload": {
    "ruleType": "ANOMALY",
    "metric": "refund_count",
    "comparator": "anomaly_high",
    "current": 18,
    "threshold": null,
    "baselineMean": 4.2,
    "baselineStddev": 1.8,
    "deviation": 7.66,
    "direction": "high"
  }
}

Campos do payload

Campo	Tipo	Descrição
eventId	string (UUID)	ID único do disparo. Use como chave de idempotência no seu lado — se receber o mesmo eventId duas vezes, é retry, ignore.
ruleId	string (UUID)	ID da regra que disparou.
ruleName	string	Nome da regra (igual ao que aparece na lista de Alertas).
firedAt	string (ISO-8601)	Quando o disparo foi gerado, em UTC.
payload.ruleType	"THRESHOLD" | "ANOMALY"	Tipo da regra.
payload.metric	enum	sales_count, gross_cents, net_cents, refund_count, chargeback_count.
payload.comparator	enum	THRESHOLD: <, <=, >, >=. ANOMALY: anomaly_high, anomaly_low.
payload.current	number	Valor atual da métrica no momento da avaliação.
payload.threshold	number | null	Valor limite configurado (apenas THRESHOLD; em ANOMALY vem null).
payload.baselineMean	number (opcional)	Média histórica usada como baseline (apenas ANOMALY).
payload.baselineStddev	number (opcional)	Desvio-padrão histórico (apenas ANOMALY).
payload.deviation	number (opcional)	Quantos desvios-padrão current está fora da média (apenas ANOMALY).
payload.direction	"high" | "low"	Direção do disparo — métrica acima ou abaixo do esperado.

Atenção a moeda: gross_cents e net_cents são centavos inteiros. Para exibir em Reais, divida por 100 (ex.: current: 150000 ⇒ R$ 1.500,00).

Deduplicação: uma mesma regra dispara no máximo 1 vez por dia. A chave interna é ruleId:YYYY-MM-DD. Ainda assim, use eventId no seu lado para garantir idempotência em retries.

---

Verificação

Para confirmar que sua regra está funcionando:

1. Crie uma regra de teste com um threshold fácil de bater (ex.: “vendas hoje > 0”, se você sabe que tem venda no dia).
2. Aguarde o próximo ciclo de avaliação (até 5 minutos).
3. Confirme que o disparo aparece em Histórico e que a notificação chegou.
4. Apague a regra de teste depois.

---

Solução de problemas

Sintoma	O que fazer
Regra de Anomalia não dispara nunca	A baseline pode ser insuficiente (menos de 14 dias úteis) ou a sensibilidade está muito alta. Reduza k para 2.0 ou aguarde mais histórico.
Alerta disparou só uma vez no dia	Comportamento esperado — deduplicação evita spam. Cada regra dispara no máximo 1 vez por dia.
Telegram não chega	Confirme que você iniciou conversa com o bot do Synchro (chat individual) ou que o bot foi adicionado ao grupo/canal como administrador.
WhatsApp não chega	Verifique se o número está no formato internacional (+55…). Para grupo/canal, confirme que o ID termina em @g.us ou @newsletter.
Webhook não recebe POST	URL precisa ser HTTPS e responder em até 5 segundos. O Synchro tenta novamente em caso de falha (até 3 tentativas).
”Limite de regras atingido” ao criar	Você atingiu o número de regras do seu plano. Apague uma regra inativa ou faça upgrade em Configurações → Plano.
Recebi notificação que parece estranha	Os Alertas avaliam cross-platform nesta versão (somando todas as plataformas). Avaliação por plataforma específica chega numa atualização futura.

---

Perguntas frequentes

O alerta avalia por plataforma ou somando tudo? Nesta versão, as regras avaliam a soma de todas as plataformas conectadas (cross-platform). Em uma atualização futura, você poderá criar regras por plataforma específica ou por integração.

Posso pausar uma regra durante um lançamento? Sim. Use o botão Pausar na lista de regras. Pausar não apaga — você reativa depois sem perder configuração.

Qual a frequência de avaliação? A cada 5 minutos. As métricas que alimentam os alertas são recalculadas automaticamente pelo Synchro.

Posso receber em mais de um destino na mesma regra? Sim, quantos quiser. Cada regra pode ter múltiplos e-mails, telefones, grupos, canais e webhooks.

Existe regra “para sempre” e regra “uma vez”? Hoje toda regra é contínua (avalia indefinidamente até você pausar/apagar). Cada regra dispara no máximo 1 vez por dia para não virar spam.