---
title: Primeiros passos com o Echobell - Guia completo de configuração
sidebarTitle: Primeiros passos
description: "Configure o Echobell em minutos: crie canais de notificação, conecte gatilhos por webhook ou e-mail e receba alertas push instantâneos ou chamadas no seu celular."
---

# Primeiros passos com o Echobell

Boas-vindas ao Echobell, o app de alertas instantâneos que ajuda você a ficar por dentro das notificações importantes. Seja você um desenvolvedor que precisa de alertas de webhook para o seu pipeline de CI/CD, um administrador de sistemas monitorando servidores ou um time que gerencia notificações críticas, este guia completo mostra como configurar e usar o Echobell com eficiência.

Ao final deste guia, você vai saber como criar canais de notificação, configurar gatilhos por webhook e por e-mail, personalizar modelos de notificação e integrar o Echobell às ferramentas e aos fluxos de trabalho que você já usa.

## O que é o Echobell?

O Echobell é uma ferramenta poderosa de gerenciamento de notificações, criada para desenvolvedores, times de DevOps e qualquer pessoa que precise de alertas instantâneos confiáveis. Ele une os seus sistemas ao seu celular, garantindo que as informações críticas cheguem até você imediatamente.

**Principais recursos:**

- **Integração com webhooks**: conecte qualquer sistema capaz de fazer requisições HTTP — ferramentas de monitoramento, pipelines de CI/CD, dispositivos IoT e muito mais
- **Gatilhos por e-mail**: transforme qualquer e-mail em uma notificação instantânea encaminhando-o para o endereço de e-mail exclusivo do seu canal
- **Modelos personalizados**: use variáveis dinâmicas para criar notificações informativas e ricas em contexto
- **Tipos de notificação flexíveis**: escolha entre notificações normais, alertas urgentes ou notificações em formato de chamada telefônica para problemas críticos
- **Design com privacidade em primeiro lugar**: o seu histórico de notificações fica no seu dispositivo, não nos nossos servidores
- **Colaboração em time**: compartilhe canais com colegas de time e gerencie o acesso dos inscritos

Saiba mais sobre [o que torna o Echobell único](/docs/what-is-echobell) e conheça nossa [visão geral completa dos recursos](/docs/features).

![Visão geral do Echobell](/images/docs/screenshot-overview.en.webp)

## Conceitos principais

Antes de colocar a mão na massa, vamos entender alguns conceitos essenciais:

### Canais

Um **canal** é a unidade central do Echobell para organizar e distribuir notificações:

- Cada canal tem um **nome** e uma **cor** exclusivos, para identificar com facilidade as diferentes origens de alerta
- Os canais contêm **[modelos de notificação](/docs/template)** que determinam quais informações são enviadas aos inscritos
- Os canais são acionados por **[webhooks](/docs/webhook)** ou **[e-mails](/docs/email-trigger)**
- Você pode criar os seus próprios canais ou se inscrever em canais compartilhados por outras pessoas
- Cada canal aceita **[condições](/docs/conditions)** para filtrar quais gatilhos realmente enviam notificações
- Os canais podem ser compartilhados por links de inscrição seguros com colegas de time ou com o público

Pense em um canal como um pipeline de notificações: os dados entram pelos gatilhos, são formatados pelos modelos, filtrados pelas condições e entregues como notificações a todos os inscritos.

### Gatilhos

Um **gatilho** é o que ativa um canal para enviar notificações. O Echobell aceita dois métodos de gatilho:

- **[Webhook](/docs/webhook)**: um endpoint de URL que ativa o canal quando é chamado via HTTP GET ou POST. Perfeito para integrar com sistemas de monitoramento, pipelines de CI/CD, funções serverless e qualquer ferramenta capaz de fazer requisições HTTP.
  
- **[Gatilho por e-mail](/docs/email-trigger)**: um endereço de e-mail exclusivo vinculado ao canal. Quando um e-mail é enviado para esse endereço, o canal é ativado. Ideal para alertas baseados em e-mail, encaminhamento de mensagens importantes ou sistemas que só oferecem notificações por e-mail.

Você pode usar os dois tipos de gatilho ao mesmo tempo no mesmo canal, o que dá o máximo de flexibilidade na forma de enviar alertas. Saiba mais sobre a [integração com webhooks](/docs/webhook) e os [gatilhos por e-mail](/docs/email-trigger).

### Tipos de notificação

Ao se inscrever em um canal, você pode escolher entre diferentes [estilos de notificação](/docs/notification) que determinam como os alertas aparecem no seu dispositivo:

- **Normal (Ativo)**: notificação padrão do app, que aparece na sua central de notificações. Ideal para atualizações não urgentes e alertas informativos.

- **Urgente**: notificação de alta prioridade, capaz de atravessar os modos de Foco e a configuração Não perturbe. Recomendada para alertas importantes que precisam de atenção imediata, mas não são emergências críticas.

- **Chamada**: alerta em formato de chamada, com toque e interface em tela cheia, parecido com receber uma ligação. Essencial para incidentes críticos que exigem resposta imediata, como quedas em produção ou alertas de segurança.

O tipo de notificação escolhido depende da urgência do conteúdo do canal. Se precisar, você pode se inscrever várias vezes no mesmo canal com tipos de notificação diferentes. Leia nosso [guia detalhado sobre notificações](/docs/notification) para entender quando usar cada tipo.

## Primeiros passos

### 1. Configurar a sua conta

1. Baixe o Echobell na [App Store](https://apps.apple.com/app/apple-store/id6743597198?pt=128151925&ct=docs-index-pt&mt=8) / [Google Play](https://play.google.com/store/apps/details?id=one.echobell.echobellandroid)
2. Abra o app e faça login com o seu e-mail ou com a Apple

![Configuração da conta](/images/docs/screenshot-sign-in.en.webp)

### 2. Criar o seu primeiro canal

1. Na tela principal, toque no botão do canto inferior direito para abrir a tela **Canais**
2. Toque no botão **+** para criar um novo canal
3. Digite um nome para o seu canal (por exemplo, "Alertas do servidor")
4. Escolha uma cor para identificar o seu canal
5. Configure os seus modelos de notificação:
   - **Modelo de título**: o que aparece como título da notificação
   - **Modelo de corpo**: o conteúdo detalhado da notificação
6. Opcionalmente, defina se você quer se inscrever no próprio canal
7. Escolha um **tipo de notificação** para o seu canal (Normal, Urgente ou Chamada)
8. Salve o seu novo canal

![Criar canal](/images/docs/screenshot-create-channel.en.webp)

### 3. Configurar um gatilho

Depois de criar o canal, existem duas formas de acionar notificações: por webhooks ou por e-mails. Toque no canal que você acabou de criar para abrir as configurações dele. Nas configurações do canal, você encontra a seção **Gatilhos**.

![Configurações do canal](/images/docs/screenshot-channel-settings.en.webp)

#### Gatilho por webhook

1. Toque no botão **webhook** para copiar a URL de webhook gerada
2. Integre essa URL aos seus sistemas (por exemplo, monitoramento de servidores, pipeline de CI/CD)
3. Quando a URL for chamada, o seu canal será acionado

Você pode fornecer variáveis aos seus modelos de notificação de duas formas:

```bash
# Example webhook call with query parameters
curl -X GET "https://hook.echobell.one/t/<channel-token>?server=production&status=critical&message=CPU%20usage%20at%2095%25"

# OR with JSON body
curl -X POST https://hook.echobell.one/t/<channel-token> \
  -H "Content-Type: application/json" \
  -d '{"server": "production", "status": "critical", "message": "CPU usage at 95%"}'
```

Essas variáveis serão usadas para preencher os seus modelos de notificação. Por exemplo, se o seu modelo de título for `{{server}} - {{status}}`, ele será renderizado como "production - critical".

**Variáveis especiais:**

- `externalLink`: se você incluir essa variável, ela será exibida como um link clicável nos registros de notificação

#### Gatilho por e-mail

1. Toque no botão **e-mail** para copiar o endereço de e-mail gerado para o seu canal
2. Quando um e-mail for enviado para esse endereço, o seu canal será acionado

Com os gatilhos por e-mail, o Echobell extrai automaticamente estas variáveis da mensagem:

- `from`: o endereço de e-mail do remetente
- `to`: o endereço de e-mail do destinatário (o 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

Você pode usar essas variáveis nos seus modelos, como `{{subject}}` ou `{{text}}`.

### 4. Personalizar os modelos de notificação

Os modelos usam variáveis preenchidas a partir dos dados do gatilho:

1. Nas configurações do canal, vá até **Modelos de notificação**
2. Para o modelo de título, você pode usar: `{{server}} - {{status}}`
3. Para o modelo de corpo, você pode usar: `{{message}} Detected at {{timestamp}}`
4. As variáveis ficam entre chaves duplas: `{{variable_name}}`
5. Teste o seu modelo com dados de exemplo

### 5. Inscrever-se em canais

1. Você pode compartilhar o link de inscrição dos seus canais com outras pessoas
2. Ou pode usar links de inscrição compartilhados por outras pessoas para se inscrever nos canais
3. Toque em **Inscrever-se** na tela de canais
4. Informe o link de inscrição
5. Escolha o **tipo de notificação** que preferir:
   - Normal para alertas padrão
   - Urgente para alertas importantes
   - Chamada para situações críticas
6. Confirme a sua inscrição

## Configurações do app

Você pode personalizar como o Echobell lida com as notificações nestas configurações:

- **Repetir conteúdo de voz**: nas notificações em chamada, esta opção faz o conteúdo da notificação ser repetido
- **Repetir chamada com falha**: tenta novamente, de forma automática, as notificações em chamada que falharam por causa do modo Foco ou de outros motivos

## Privacidade e armazenamento de dados

O Echobell prioriza a sua privacidade:

- Somente as contas de usuário, os canais e os dados de inscrição ficam armazenados nos nossos servidores
- O conteúdo e o histórico das notificações são armazenados localmente no seu dispositivo
- Os dados dos seus alertas nunca saem do seu controle

## Próximos passos

Agora que você configurou o seu primeiro canal, explore estes recursos para aproveitar o Echobell ao máximo:

### Guias essenciais

- **[O que é o Echobell?](/docs/what-is-echobell)** - entenda os conceitos principais e a filosofia por trás do Echobell
- **[Visão geral dos recursos](/docs/features)** - explore todos os recursos e funcionalidades disponíveis
- **[Guia de modelos](/docs/template)** - domine a sintaxe dos modelos e crie notificações dinâmicas
- **[Condições](/docs/conditions)** - aprenda a filtrar notificações com base nos dados do gatilho
- **[Integração com webhooks](/docs/webhook)** - aprofunde-se na configuração de webhooks e nas boas práticas
- **[Gatilhos por e-mail](/docs/email-trigger)** - configure gatilhos de notificação baseados em e-mail

### Guias de integração

Conecte o Echobell a ferramentas e plataformas populares:

- **[Integração com Grafana](/docs/developer/grafana)** - monitore a sua infraestrutura com alertas instantâneos
- **[GitHub Actions](/docs/developer/github)** - receba notificações de eventos do pipeline de CI/CD
- **[Prometheus](/docs/developer/prometheus)** - configure alertas para métricas do Prometheus
- **[Home Assistant](/docs/developer/home-assistant)** - notificações de automação residencial
- **[Monitoramento de uptime](/docs/developer/uptime-kuma)** - alertas de disponibilidade de sites e serviços
- **[TradingView](/docs/trader/tradingview)** - alertas de trading e notificações de mercado

### Boas práticas

- **Comece simples**: crie primeiro canais básicos com modelos simples e depois aumente a complexidade aos poucos
- **Teste os seus modelos**: use chamadas de webhook de teste para conferir se os seus modelos são renderizados corretamente antes de colocá-los no ar
- **Use as condições com critério**: elimine o ruído definindo condições nos canais para alertar apenas em eventos importantes
- **Escolha os tipos de notificação adequados**: reserve as notificações em "Chamada" para alertas realmente críticos e evite a fadiga de alertas
- **Organize com cores**: use as cores dos canais de forma estratégica para identificar rapidamente a origem dos alertas
- **Documente os seus canais**: use as notas do canal para registrar o que o aciona e como responder

### Casos de uso comuns

Descubra como outras pessoas usam o Echobell:

- **Monitoramento de servidores**: receba alertas instantâneos quando o uso de CPU, memória ou disco ultrapassar os limites definidos
- **Notificações de CI/CD**: saiba na hora quando builds falham ou implantações são concluídas
- **Alertas de e-commerce**: receba notificações de novos pedidos, problemas de pagamento ou avisos de estoque
- **Monitoramento de segurança**: alertas críticos para falhas de autenticação, atividades suspeitas ou eventos de segurança
- **IoT e casa inteligente**: notificações de sensores, câmeras e sistemas de automação residencial
- **Coordenação do time**: compartilhe canais com os membros do time para responder a incidentes em conjunto

### Obter ajuda

Precisa de ajuda ou tem dúvidas?

- **[Central de suporte](/docs/support)** - consulte as perguntas mais comuns e os guias de solução de problemas
- **Suporte por e-mail**: fale com a gente em echobell@weelone.com
- **Comunidade**: participe das discussões e compartilhe os seus casos de uso com outros usuários do Echobell

Pronto para integrar o Echobell aos seus sistemas? Confira o nosso [guia de integração com webhooks](/docs/webhook) ou explore as [integrações específicas para desenvolvedores](/docs/developer/github) para começar!