Sumário
O Echobell Direct é um modo de alerta pessoal que dispensa completamente a configuração de canais. Você cria uma chave direta, recebe uma URL de webhook e envia title + body via POST para receber uma notificação instantânea no seu dispositivo. Sem inscritos, sem modelos, sem configuração de roteamento.
Este guia explica o que é o Direct, como configurá-lo e quando usá-lo no lugar dos canais.
O que é o Echobell Direct?
Cada chave direta gera uma URL de webhook exclusiva (/d/{token}). Envie uma requisição para essa URL e a notificação chega ao seu dispositivo imediatamente.
Use o Direct quando precisar de:
- Notificações pessoais vindas de scripts, cron jobs ou pipelines de CI
- Título e corpo personalizados a cada requisição, em vez de modelos fixos
- Configuração rápida, sem precisar montar um canal completo
Se você precisa de notificações compartilhadas, modelos reutilizáveis ou entrega condicional, use os Canais via Webhooks.
Configuração em 3 passos
Passo 1: crie uma chave direta
Abra o Echobell, toque em Direct na sua lista de canais e crie uma chave. Dê a ela o nome do serviço correspondente (por exemplo, CI Server, Cron, AI Tasks).
Passo 2: copie a sua URL de webhook
Cada chave tem uma URL neste formato:
https://hook.echobell.one/d/YOUR_KEY_TOKENTrate essa URL como um segredo — qualquer pessoa que a tenha pode enviar notificações para você.
Passo 3: envie a sua primeira notificação
curl -X POST https://hook.echobell.one/d/YOUR_KEY_TOKEN \
-H "Content-Type: application/json" \
-d '{
"title": "Deploy failed",
"body": "api-service failed health check",
"notificationType": "time-sensitive",
"externalLink": "https://dashboard.example.com/deploys/123"
}'Referência completa dos campos: API do Direct
Níveis de urgência
O Direct aceita o campo notificationType, para você ajustar a urgência ao evento:
active— atualizações normaistime-sensitive— alertas importantes que atravessam o modo Fococalling— incidentes críticos (exige assinatura premium ativa; caso contrário, volta para time-sensitive)
Veja os Tipos de notificação para todos os detalhes de comportamento.
Como adicionar contexto aos alertas
Inclua externalLink no corpo da requisição para anexar uma URL à notificação — útil para levar direto ao log de um deploy, a um painel ou a um pull request.
Para agentes de IA e tarefas assíncronas de longa duração, o Direct é uma forma simples de ser avisado quando o trabalho termina, em vez de ficar consultando manualmente. Veja também: WebhookMCP + Echobell.
Direct vs. Canais
| Direct | Canais | |
|---|---|---|
| Público | Somente pessoal | Compartilhado com o time |
| Modelos | Conteúdo por requisição | Modelos fixos e reutilizáveis |
| Tempo de configuração | Menos de um minuto | Exige configurar o canal |
| Condições | Não suportadas | Suportadas |
Use canais quando os alertas precisarem chegar a várias pessoas ou quando você quiser uma formatação consistente em todo um serviço. Documentação de modelos · O que é o Echobell
Práticas de segurança
- Guarde os tokens do Direct em variáveis de ambiente ou em um gerenciador de segredos, nunca no código
- Crie uma chave por serviço, para poder revogar cada uma separadamente
- Troque os tokens imediatamente se houver suspeita de que uma URL vazou
- Reserve
callingpara incidentes de verdade — o uso excessivo causa fadiga de alertas
Perguntas frequentes
O Direct é só para desenvolvedores? Não. Qualquer pessoa com uma ferramenta capaz de enviar requisições HTTP pode usá-lo.
O Direct aceita requisições GET? Sim, mas o recomendado é POST com JSON.
O que acontece se a minha assinatura expirar e eu usar calling? Ele volta automaticamente para time-sensitive.
Comece pelo guia do Direct. Quando o seu fluxo de trabalho passar a exigir colaboração ou modelos, os Canais são o próximo passo natural.
Conteúdo relacionado
- Documentação da API do Direct — referência completa dos campos e exemplos
- WebhookMCP + Echobell — notificações de conclusão de tarefas de IA usando o Direct
- Como driblar o modo Foco do iOS — como escolher a urgência certa para a notificação
- Notificações de webhook do Zapier — automações para quem não é desenvolvedor
- Tipos de notificação — comportamento das notificações Normal, Urgente e em chamada