Primeiros passos com o Echobell - Guia completo de configuração

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.


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 e conheça nossa visão geral completa dos recursos.

Visão geral do Echobell

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 que determinam quais informações são enviadas aos inscritos
  • Os canais são acionados por webhooks ou e-mails
  • Você pode criar os seus próprios canais ou se inscrever em canais compartilhados por outras pessoas
  • Cada canal aceita condições 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: 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: 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 e os gatilhos por e-mail.

Tipos de notificação

Ao se inscrever em um canal, você pode escolher entre diferentes estilos de notificação 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 para entender quando usar cada tipo.

Primeiros passos

1. Configurar a sua conta

  1. Baixe o Echobell na App Store / Google Play
  2. Abra o app e faça login com o seu e-mail ou com a Apple

Configuração da conta

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

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

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:

# 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

Guias de integração

Conecte o Echobell a ferramentas e plataformas populares:

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 - 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 ou explore as integrações específicas para desenvolvedores para começar!