> For the complete documentation index, see [llms.txt](https://usefin.gitbook.io/guia-fin/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://usefin.gitbook.io/guia-fin/alertas/quickstart-1/caso-de-uso.md).
# Caso de uso
### Visão Geral
Os **Alertas Dinâmicos** permitem configurar notificações automáticas com base em dados financeiros da sua empresa. A IA consulta os dados, formata a mensagem e entrega nos canais configurados — como WhatsApp e e-mail — no horário e frequência definidos por você.
### Criando um Novo Alerta Dinâmico
Clique no botão **+ Novo Alerta Dinâmico** no canto superior direito da tela de Alertas.
O formulário de criação é dividido em três abas: **Dados Básicos**, **Avançado** e **Visualização**.
***
#### Aba: Dados Básicos
**Nome do Alerta**
Defina um nome claro e descritivo para identificar o alerta na listagem.
> **Exemplo:** `Contas do dia - Apenas Pagamentos`
**Instrução**
Descreva o que a IA deve consultar e como formatar a mensagem. Seja específico sobre os campos que devem aparecer e a forma de agrupamento.
> **Exemplo de instrução:**
>
> ```
> Listar as contas de pagamento do dia, agrupado pelo pagamento.
> Traga as seguintes informações:
> Fornecedor, valor, data de vencimento, canal de envio da conta,
> meio de pagamento, código do boleto completo ou pix.
>
> Se a mesma conta tiver mais de um canal, deve agrupar no mesmo registro.
> ```
**Dica:** Quanto mais detalhada a instrução, mais precisa e consistente será a formatação da mensagem gerada pela IA.
**Usar Dados do Usuário**
Quando ativado, o alerta consultará os dados financeiros reais da empresa e a IA formatará a mensagem automaticamente.
| Opção | Comportamento |
| ------------ | -------------------------------------------------- |
| ✅ Ativado | IA consulta dados financeiros e formata a mensagem |
| ❌ Desativado | Mensagem estática, sem consulta de dados |
***
#### Aba: Avançado
**Alerta Ativo**
Controla se o alerta está habilitado para envio. Alertas inativos não são disparados.
**Usar IA para Formatação**
Quando ativado, a IA enriquece e formata a mensagem com base na instrução definida.
**Personalidade da IA**
Campo de texto livre onde você define o **template exato** que a IA deve seguir ao montar a mensagem. Suporta emojis e formatação Markdown compatível com WhatsApp (`*negrito*`, `_itálico_`).
**Exemplo de personalidade configurada:**
```
📋 *CONTAS A PAGAR — DD/MM/AAAA*
🔵 *BOLETO BANCÁRIO*
*1. [Fornecedor]*
✅ Se tiver o canal WhatsApp marcar como *Entregue*
💰 Valor: R$ 0.000,00
📅 Vencimento: DD/MM/AAAA
📤 Canais: E-mail • *WhatsApp*
🔢 Código: [linha digitável completa]
---
💳 Total: R$ 0.000,00 | X pagamentos
✅ X entregues via WhatsApp
```
**Regra de entrega:** Se um dos canais do pagamento for **WhatsApp**, o item deve ser marcado automaticamente como `✅ Entregue`. O canal WhatsApp deve ser destacado em negrito na lista de canais.
***
#### Aba: Visualização
Exibe uma **prévia real** da mensagem que será enviada, com dados do dia consultados ao vivo. Use esta aba para validar o resultado antes de ativar o alerta.
***
### Exemplo de Mensagem Gerada
Abaixo um exemplo de saída gerada pela IA com base nas configurações acima:
```
📋 CONTAS A PAGAR — 25/03/2026
🔵 BOLETO BANCÁRIO
1. Fornecedor Alfa Ltda ✅ Entregue
💰 Valor: R$ 630,00
📅 Vencimento: 25/03/2026
📤 Canais: E-mail • WhatsApp
🔢 Código: 00170653113002311111575771139600000063000
2. Distribuidora Beta S.A. ✅ Entregue
💰 Valor: R$ 255,11
📅 Vencimento: 25/03/2026
📤 Canais: WhatsApp
🔢 Código: 001940031000194868313111516190001100001255 11
---
💳 Total: R$ 885,11 | 2 pagamentos
✅ 2 entregues via WhatsApp
```
***
### Regras de Negócio
#### Múltiplos canais de entrega
Uma mesma conta pode ter mais de um canal de envio. Nesse caso, todos os canais devem ser exibidos na mesma linha, separados por `•`.
```
📤 Canais: E-mail • Portal do fornecedor • WhatsApp
```
#### Status "Entregue"
O badge `✅ Entregue` é exibido automaticamente ao lado do nome do fornecedor **sempre que WhatsApp estiver entre os canais**, independente dos outros canais presentes.
| Canais configurados | Exibe "Entregue"? |
| ------------------------------- | ----------------- |
| E-mail | ❌ Não |
| Portal | ❌ Não |
| WhatsApp | ✅ Sim |
| E-mail • WhatsApp | ✅ Sim |
| Nota fiscal • WhatsApp • E-mail | ✅ Sim |
#### Agrupamento por tipo de pagamento
As contas devem ser agrupadas por meio de pagamento, na seguinte ordem sugerida:
1. 🔵 Boleto Bancário
2. 🟢 PIX
3. 🟡 Transferência (TED/DOC)
***
### Alertas Pré-configurados
A plataforma disponibiliza alertas prontos que podem ser ativados ou duplicados:
| Alerta | Descrição | Envio | Horário |
| ------------------------------------- | ---------------------------------------------------------- | ------------- | ------- |
| Contas a vencer sem meio de pagamento | Contas nos próximos 7 dias sem meio de pagamento informado | Seg. a Sex. | 08:00 |
| Contas do dia - Apenas Pagamentos | Contas com vencimento no dia atual | Todos os dias | 06:00 |
| Resumo de Upload de Notas | Processamento e integração de notas fiscais | Seg. a Sex. | 18:00 |
| Resumo diário de conciliação | Relatório diário de conciliação | Seg. a Sex. | 20:00 |
| Comparativo semanal | Comparativo dos resultados financeiros da semana | Sexta | 17:00 |
***
### Ações disponíveis por alerta
| Ícone | Ação |
| ------------- | -------------------------------------- |
| 👁 Visualizar | Abre a prévia da mensagem gerada |
| 🔄 Duplicar | Cria uma cópia do alerta para edição |
| 🗑 Excluir | Remove permanentemente o alerta |
| Toggle | Ativa ou desativa o alerta sem excluir |
***
### Perguntas Frequentes
**O alerta é enviado mesmo sem dados no dia?** Não. Se nenhuma conta for identificada, o alerta não é acionado (comportamento padrão para o tipo "Contas a vencer sem meio de pagamento").
**Posso ter o mesmo alerta para empresas diferentes?** Sim. Use a opção **Duplicar** e altere a empresa vinculada.
**A IA pode errar o formato da mensagem?** Em casos raros. Use a aba **Visualização** para validar antes de ativar. Ajuste o campo **Personalidade da IA** para corrigir inconsistências de formatação.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://usefin.gitbook.io/guia-fin/alertas/quickstart-1/caso-de-uso.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.