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

# Alertas de nós

> Receba um e-mail quando um nó API / SOAP falhar repetidamente ou quando um Agente de IA tiver um problema de modelo ou de segurança

Os **Alertas de nós** avisam você por e-mail quando algo nos nós dos seus workflows precisa da sua atenção. Você escolhe quem recebe os e-mails e, para os Agentes de IA, quais tipos de alerta quer receber.

## O que são os alertas de nós

Há dois grupos de alertas, um para cada tipo de nó:

| Tipo de nó | Alertas disponíveis |
| - | - |
| **API / SOAP** | Falhas repetidas contra o mesmo endpoint |
| **Agente de IA** | Ciclo de vida do modelo e Segurança |

> [!NOTE]
>
> Os avisos de ciclo de vida do modelo também aparecem no sino da Central de notificações, sob o filtro **Infraestrutura**, independentemente de você ter configurado destinatários. O e-mail é um canal adicional.

## Como configurá-los

**1. Abra Alertas de nós**

Vá em **Configuração** > **Alertas de nós**.

**2. Escolha o tipo de nó**

No submenu **Tipo de nó** selecione a aba **API / SOAP** ou **Agente de IA**. Cada aba tem sua própria lista de destinatários.

**3. Adicione destinatários**

No cartão **Destinatários**, digite um e-mail e clique em **+ Adicionar**. Para remover um, clique no **✕** ao lado dele.

**4. Escolha os tipos de alerta (somente Agente de IA)**

No cartão **Tipos de alerta** marque **Ciclo de vida do modelo**, **Segurança** ou ambos.

**5. Salve as alterações**

Clique em **Salvar**. Para desfazer o que você alterou, clique em **Descartar**.

![Tela Alertas de nós com a aba Agente de IA, a lista de destinatários e as caixas de tipos de alerta](https://mintcdn.com/jelouai/j5HzQgWZwzH-STMs/assets/images/configuracion/alertas-nodos/settings-es.png?fit=max\&auto=format\&n=j5HzQgWZwzH-STMs\&q=85\&s=e57fc40e8c32683c49cbb6a63eaee355)

Configuração > Alertas de nós > Agente de IA (a tela é exibida em espanhol)

Enquanto uma aba não tiver destinatários, você verá a mensagem *"Ainda não há destinatários. Os alertas não serão enviados por e-mail."*

## Alertas de API / SOAP

Um e-mail é enviado quando um nó API ou SOAP **falha 100 vezes em 5 minutos contra o mesmo endpoint**. Depois desse aviso, esperamos **8 horas** antes de avisar novamente sobre esse mesmo endpoint.

O e-mail inclui:

* Empresa, URL do serviço, usuários afetados, quantidade de eventos e intervalo de monitoramento.
* A requisição que falhou e a mensagem de erro.
* Tipo e nome do modelo, ID da execução, ID do alerta e ID do nó.

## Alertas de Agente de IA

A aba **Agente de IA** tem o cartão **Tipos de alerta** com duas opções. Se nenhuma seleção específica for feita, todos os tipos são enviados.

### Ciclo de vida do modelo

Você recebe um e-mail quando um modelo usado por um nó **AI Agent** ou **AI Task** está prestes a ser descontinuado, já foi retirado ou não existe mais no catálogo. No máximo um e-mail a cada 3 dias por modelo.

O e-mail inclui o modelo, seu status, a data de retirada e onde ele é usado (skill e ID do nó).

![E-mail com o selo âmbar de ciclo de vida do modelo e os detalhes do modelo afetado](https://mintcdn.com/jelouai/j5HzQgWZwzH-STMs/assets/images/configuracion/alertas-nodos/email-ciclo-de-vida.png?fit=max\&auto=format\&n=j5HzQgWZwzH-STMs\&q=85\&s=160ce47e6c6a5568e02fc3273dba0b8c)

E-mail de ciclo de vida do modelo (exibido em espanhol)

### Segurança

Você recebe um e-mail quando uma ameaça de segurança é detectada ou bloqueada em um agente de IA, por exemplo injeção de prompt, jailbreak ou vazamento do prompt do sistema.

O e-mail inclui o resultado (bloqueada ou detectada), a fase, os tipos de ameaça, o nível, a confiança, os métodos de detecção e onde ocorreu.

![E-mail com o selo vermelho de segurança e os detalhes da ameaça bloqueada](https://mintcdn.com/jelouai/j5HzQgWZwzH-STMs/assets/images/configuracion/alertas-nodos/email-seguridad.png?fit=max\&auto=format\&n=j5HzQgWZwzH-STMs\&q=85\&s=a8dd7d0ba1024528694d6dbb1016d441)

E-mail de ameaça de segurança (exibido em espanhol)

## Limites para evitar spam

| Alerta | Limite |
| - | - |
| API / SOAP | 100 falhas em 5 minutos por endpoint; depois 8 horas de espera para esse mesmo endpoint |
| Ciclo de vida do modelo | No máximo um e-mail a cada 3 dias por modelo |
| Segurança | No máximo um e-mail por hora para cada nó e tipo de ameaça |

## Idioma dos e-mails

Os e-mails usam o novo design da Jelou, com um selo colorido por tipo de alerta: âmbar para ciclo de vida do modelo e vermelho para segurança. Estão disponíveis em espanhol, inglês e português.

## Perguntas frequentes

> **Por que não estou recebendo e-mails?**
>
> Verifique estas duas causas:
>
> * **Não há destinatários**: a aba do tipo de nó não tem e-mails adicionados. Adicione-os e clique em **Salvar**.
> * **O tipo de alerta está desmarcado**: na aba **Agente de IA**, confirme que **Ciclo de vida do modelo** ou **Segurança** está marcado.
>
> Lembre-se também de que os limites de envio podem fazer com que um novo evento não gere outro e-mail imediatamente.

> **Cada aba tem seus próprios destinatários?**
>
> Sim. **API / SOAP** e **Agente de IA** são configurados separadamente.

> **Se eu não configurar e-mails, ainda vejo os avisos de modelos?**
>
> Sim, os avisos de ciclo de vida do modelo continuam aparecendo no sino, sob o filtro **Infraestrutura**.

## Nós relacionados

> **[Nó API](https://docs.jelou.ai/pt/guias/nodos/api.md)**
>
> Conecte seu fluxo a serviços externos.

> **[Nó AI Agent](https://docs.jelou.ai/pt/guias/nodos/ai-agent.md)**
>
> Configure seu agente de IA.


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