---
title: "Gatilhos por e-mail - transforme e-mails em alertas e chamadas"
sidebarTitle: Gatilhos por e-mail
description: "Acione notificações do Echobell por e-mail: envie uma mensagem para o endereço do seu canal para disparar alertas push ou chamadas telefônicas, com remetente e assunto como variáveis de modelo."
---

# Gatilhos por e-mail

Os gatilhos por e-mail oferecem uma maneira simples de enviar notificações pelo Echobell sem exigir nenhum conhecimento de programação. Cada canal pode ter um endereço de e-mail dedicado e, quando um e-mail é enviado para esse endereço, ele aciona automaticamente notificações para todos os inscritos daquele canal.

## Como funcionam os gatilhos por e-mail

Quando você configura um gatilho por e-mail para um canal:

1. Um endereço de e-mail exclusivo é atribuído ao seu canal
2. Qualquer e-mail enviado para esse endereço aciona o canal
3. O conteúdo do e-mail é automaticamente convertido em variáveis
4. Essas variáveis podem ser usadas nos seus modelos de notificação

## Variáveis de e-mail disponíveis

Quando um e-mail aciona o seu canal, o Echobell extrai automaticamente as seguintes variáveis, que você pode usar nos seus modelos de notificação:

- `from`: O endereço de e-mail do remetente
- `to`: O endereço de e-mail do destinatário (o endereço de e-mail do seu canal)
- `subject`: O assunto do e-mail
- `text`: O conteúdo em texto simples do e-mail
- `html`: O conteúdo HTML do e-mail (se disponível)

## Variáveis de hora do sistema (UTC)

Além dos campos do e-mail, variáveis de hora do sistema somente leitura estão sempre disponíveis nos modelos e nas condições (UTC). Os campos planos incluem `date`, `time`, `year`, `month`, `dayOfWeek`, `hour`, `minute` e `second`. Outros — como `sys.dayOfWeekName`, `sys.epochMs` e `sys.epochSeconds` — estão disponíveis apenas no namespace `sys.`. Consulte [Condições](/docs/conditions) para ver a lista completa e exemplos de uso.

## Usando variáveis de e-mail em modelos

Você pode usar essas variáveis nos seus modelos de notificação com a sintaxe `{{variableName}}`. Por exemplo:

```
Modelo de título: Novo e-mail de {{from}}
Modelo de corpo: Assunto: {{subject}}

{{text}}
```

## Casos de uso

Os gatilhos por e-mail são especialmente úteis para:

- Encaminhar e-mails importantes como notificações
- Criar fluxos de notificação sem programar
- Integrar com sistemas legados que suportam e-mail, mas não webhooks
- Configurar alertas a partir de sistemas de monitoramento baseados em e-mail
- Converter newsletters por e-mail em notificações no celular

<Callout type="info">
  Se o remetente do e-mail precisar verificar o endereço antes de acionar
  notificações, você encontra um link nos registros dos e-mails de verificação.
  Abra o link para conferir o conteúdo do e-mail e verificar o endereço.
</Callout>

## Privacidade e armazenamento de dados

Como em todos os recursos do Echobell:

- Apenas os dados de configuração do canal são armazenados nos nossos servidores
- O conteúdo das notificações e dos gatilhos por e-mail é armazenado localmente no seu dispositivo
- Os seus dados de e-mail nunca saem do seu controle

## Boas práticas

1. Use endereços de e-mail claros e específicos para canais diferentes
2. Configure modelos de notificação adequados que correspondam ao conteúdo dos seus e-mails
3. Considere usar os tipos de notificação Urgente ou Chamada para e-mails urgentes
4. Teste a configuração do seu gatilho por e-mail com um e-mail de exemplo antes de depender dela

## Configurando gatilhos por e-mail

1. Crie ou selecione um canal no Echobell
2. Navegue até as configurações do canal
3. Localize a seção Gatilho por e-mail
4. Copie o endereço de e-mail fornecido
5. Use esse endereço de e-mail onde quiser acionar notificações

<Callout type="warn">
  Mantenha o endereço de e-mail do seu canal em sigilo para evitar acionamentos
  não autorizados.
</Callout>