Alertas por e-mail e eventos de webhook
Atualizado em · Para o gestor
O FlowField avisa quem precisa agir de dois jeitos: por e-mail, para as pessoas da equipe, e por webhook, para o seu sistema (n8n, ERP ou BI). Os avisos cobrem o que mais pede ação: um laudo emitido, uma não conformidade crítica, um prazo chegando e uma vistoria devolvida.
Avisos por e-mail
| Aviso | Quem recebe | Quando chega |
|---|---|---|
| Laudo emitido | Titular e gestores | A cada laudo emitido: número, resultado, quantas não conformidades abertas e o link de verificação. |
| Não conformidade crítica | Titular e gestores | Quando o laudo emitido traz não conformidade de gravidade crítica. Lista cada uma, com o prazo. |
| Prazo de não conformidade chegando | Titular e gestores | Quando pendências abertas têm o prazo nos próximos 3 dias. Vem um e-mail por pessoa, com a lista. |
| Vistoria devolvida | O inspetor responsável pela vistoria | Quando o gestor devolve a vistoria para correção, com o motivo e o link para abrir. |
Todos chegam ligados. O e-mail vai para o endereço da conta de cada pessoa.
Ligar e desligar os seus avisos
- Toque em Mais › Conta e aparelho.
- No cartão Avisos por e-mail, marque ou desmarque cada tipo. A mudança vale na hora.
Cada pessoa cuida dos seus avisos, em cada empresa. O inspetor só vê Vistoria devolvida. Também dá para parar pelo próprio e-mail: todo aviso traz um link para parar de receber aquele tipo. O link abre a página Parar de receber este aviso?, e o aviso só é desligado depois que você toca em Parar de receber. Para ligar de novo, volte ao cartão Avisos por e-mail.
O que vale saber
- O laudo de demonstração não gera aviso, nem por e-mail nem por webhook.
- Quem devolve a vistoria não recebe o aviso da própria devolução.
- O prazo das pendências é conferido uma vez por dia. Cada pendência avisa uma vez por prazo: se você prorrogar o prazo, vale um aviso novo. Por e-mail, o aviso é só do prazo chegando; a pendência que já venceu aparece em NCs vencidas, no painel, e sai no webhook.
- Cada empresa tem um limite de e-mails de aviso por hora. Passou dele, os avisos daquela hora são descartados e não chegam depois.
- O aviso de laudo emitido chega a cada laudo e pode pesar na caixa de entrada de quem emite muitos por dia. Se for o seu caso, desligue só esse tipo e mantenha os outros.
Eventos de webhook
Além dos eventos de vistoria, o webhook pode avisar o seu sistema sobre laudos e pendências. Ao criar o webhook em Mais › Integrações › Novo webhook, marque em Eventos:
- Laudo emitido (com o link do PDF) (
report.issued): sai na aprovação, depois do evento Laudo aprovado da mesma vistoria. Emdatavêm oiddo laudo, orecordIdda vistoria, o número (number,revisionecode), ohash, o resultado (resulteresultLabel),issuedAt, o formulário (formIdeformName),assetCode,projectName,client,openNonConformities,verifyUrlepdfUrl. OpdfUrlabre sem token, então a automação baixa o PDF direto. Reabrir e reemitir o laudo gera outro evento. - Não conformidade criada (
nonconformity.created): um evento por pendência aberta pela emissão. A reemissão não repete as que já existiam. Emdatavem a pendência, como na lista da API, maisformNameeassetCode. - Prazo de não conformidade (3 dias e vencida) (
nonconformity.due): pendência aberta que vence em até 3 dias (stageigual adue_soon, comdaysLeft) ou que já venceu (stageigual aoverdue). Sai uma vez por pendência, estágio e prazo; prorrogar o prazo vale um evento novo.
A assinatura, os cabeçalhos, as tentativas de reenvio e o botão Enviar teste são os mesmos dos outros eventos: veja Integrar com n8n e ERP: API e webhooks. Os eventos de uma mesma pendência chegam em ordem (a criada antes da que vence), e o laudo emitido chega depois do laudo aprovado da vistoria.
Exemplos com o n8n
- Mandar o laudo ao cliente ou a uma pasta: crie o webhook só com Laudo emitido (com o link do PDF), baixe o arquivo do
data.pdfUrle siga com o e-mail ao cliente ou o upload na pasta da obra. - Avisar a equipe no WhatsApp: com Não conformidade criada, filtre
data.severityigual acriticae mande a descrição, oformNamee oassetCode. - Cobrar quem está atrasado: com Prazo de não conformidade (3 dias e vencida), filtre
data.stageigual aoverduee abra uma tarefa no seu sistema para odata.responsible.