Echobell
App Store Google Play

Integração com Upptime - Alertas de monitoramento de uptime

Integre o Upptime ao Echobell para receber notificações push ou chamadas telefônicas assim que seu site sair do ar. Guia de configuração baseado em GitHub Actions.

Você pode encaminhar os eventos de queda e recuperação do Upptime diretamente para o Echobell, para que seu time receba alertas push urgentes ou chamadas telefônicas sem precisar montar um pipeline separado. Este guia foca na configuração do lado do Echobell e usa as variáveis de notificação nativas do Upptime. Para opções específicas do Upptime, consulte a documentação oficial de notificações.

Por que usar o Echobell para alertas do Upptime

  • Escalonamento para chamada telefônica em quedas críticas, mantendo as verificações de rotina como push padrão ou urgente
  • Modelos e variáveis para que cada alerta mostre o site afetado, o status, o código de resposta e o link da issue no GitHub
  • Sem infraestrutura extra—basta uma URL de webhook segura por canal do Echobell

Pré-requisitos

  • Um repositório Upptime já existente com GitHub Actions habilitado
  • Permissão para adicionar secrets no repositório do GitHub
  • Um canal do Echobell com uma URL de webhook (no app, abra o canal → copie a URL do webhook)

Prepare um canal do Echobell

  1. Crie ou abra um canal no Echobell e escolha o estilo de notificação que preferir (padrão, urgente ou chamada).
  2. Copie a URL de webhook do canal; ela se parece com https://hook.echobell.one/t/<channel-token>.
  3. (Opcional) Defina um modelo que use variáveis como {{site}}, {{status}}, {{code}}, {{url}} e {{issue}} para que seus alertas fiquem estruturados.

Adicione os secrets do Upptime para o Echobell

No seu repositório Upptime, vá em Settings → Secrets and variables → Actions e adicione:

  • NOTIFICATION_CUSTOM_WEBHOOK=true
  • NOTIFICATION_CUSTOM_WEBHOOK_URL=https://hook.echobell.one/t/<channel-token>?site=$SITE_NAME&status=$STATUS&url=$SITE_URL&issue=$ISSUE_URL&code=$RESPONSE_CODE&emoji=$EMOJI
  • (Opcional) NOTIFICATIONS_DOWN_MESSAGE=$EMOJI $SITE_NAME is $STATUS ($RESPONSE_CODE) – $ISSUE_URL
  • (Opcional) NOTIFICATIONS_UP_MESSAGE=$EMOJI $SITE_NAME is back up – $SITE_URL

Observações:

  • Os parâmetros de consulta levam dados estruturados até o Echobell. O Upptime substitui as variáveis e o Echobell as armazena como variáveis de modelo (site, status, url, issue, code, emoji).
  • Mantenha a URL codificada (substitua espaços por %20 se você personalizar o texto) para não quebrar a requisição.
  • Outros provedores ou estratégias de notificação continuam sendo gerenciados no Upptime—adicione apenas o que precisar para o Echobell e mantenha o restante na interface de secrets do GitHub.

Mapeie as variáveis no Echobell

Use um modelo conciso para que os alertas continuem legíveis:

Title: {{emoji}} Upptime: {{site}} is {{status}}
Body: Response {{code}} · {{url}}
External link: {{issue}}

Você pode mudar o estilo de notificação do canal para "Urgente" ou "Chamada" nos sites de alta prioridade, mantendo os demais como push padrão.

Teste a integração

  • Aponte temporariamente uma URL monitorada para um endpoint inexistente ou pause um serviço para provocar uma falha.
  • Confirme que o alerta chega no Echobell com os campos do seu modelo preenchidos.
  • Restaure o serviço e verifique a mensagem de recuperação.

Solução de problemas

  • Verifique se NOTIFICATION_CUSTOM_WEBHOOK e NOTIFICATION_CUSTOM_WEBHOOK_URL estão escritos exatamente como na lista de secrets.
  • Se você alterar o token do canal do Echobell, atualize o secret.
  • Para falhas do lado do Upptime ou provedores adicionais, consulte a documentação oficial e os logs do GitHub Actions.