> ## 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.
</Note>

## Como configurá-los

<Steps>
  <Step title="Abra Alertas de nós">
    Vá em **Configuração** > **Alertas de nós**.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Adicione destinatários">
    No cartão **Destinatários**, digite um e-mail e clique em **+ Adicionar**. Para remover um, clique no **✕** ao lado dele.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Salve as alterações">
    Clique em **Salvar**. Para desfazer o que você alterou, clique em **Descartar**.
  </Step>
</Steps>

<Frame caption="Configuração > Alertas de nós > Agente de IA (a tela é exibida em espanhol)">
  <img src="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" alt="Tela Alertas de nós com a aba Agente de IA, a lista de destinatários e as caixas de tipos de alerta" width="3200" height="1800" data-path="assets/images/configuracion/alertas-nodos/settings-es.png" />
</Frame>

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ó).

<Frame caption="E-mail de ciclo de vida do modelo (exibido em espanhol)">
  <img src="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" alt="E-mail com o selo âmbar de ciclo de vida do modelo e os detalhes do modelo afetado" width="1500" height="1466" data-path="assets/images/configuracion/alertas-nodos/email-ciclo-de-vida.png" />
</Frame>

### 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.

<Frame caption="E-mail de ameaça de segurança (exibido em espanhol)">
  <img src="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" alt="E-mail com o selo vermelho de segurança e os detalhes da ameaça bloqueada" width="1500" height="1466" data-path="assets/images/configuracion/alertas-nodos/email-seguridad.png" />
</Frame>

## 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

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

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

  <Accordion title="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**.
  </Accordion>
</AccordionGroup>

## Nós relacionados

<CardGroup cols={2}>
  <Card title="Nó API" icon="globe" href="/pt/guias/nodos/api">
    Conecte seu fluxo a serviços externos.
  </Card>

  <Card title="Nó AI Agent" icon="robot" href="/pt/guias/nodos/ai-agent">
    Configure seu agente de IA.
  </Card>
</CardGroup>


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