---
title: "Echobell Direct: alertas de webhook pessoais sem configurar canais"
date: 2026-03-05
description: "O Echobell Direct te dá uma URL de webhook pessoal para notificações instantâneas de scripts, jobs de CI e ferramentas de automação - sem precisar configurar canais."
author: Nooc
authorAvatarLink: /images/avatars/nooc.webp
authorLink: https://nooc.me
tags:
  - Echobell
  - Echobell Direct
  - alertas instantâneos
  - notificações push
  - anúncio
---

O [Echobell Direct](/pt/docs/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](/pt/docs/webhook).

## 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:

```text
https://hook.echobell.one/d/YOUR_KEY_TOKEN
```

Trate essa URL como um segredo — qualquer pessoa que a tenha pode enviar notificações para você.

### Passo 3: envie a sua primeira notificação

```bash
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](/pt/docs/direct)

## Níveis de urgência

O Direct aceita o campo `notificationType`, para você ajustar a urgência ao evento:

- `active` — atualizações normais
- `time-sensitive` — alertas importantes que atravessam o modo Foco
- `calling` — incidentes críticos (exige assinatura premium ativa; caso contrário, volta para time-sensitive)

Veja os [Tipos de notificação](/pt/docs/notification) 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](/pt/blog/get-notified-with-webhook-mcp).

## 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](/pt/docs/template) · [O que é o Echobell](/pt/docs/what-is-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 `calling` para 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](/pt/docs/direct). Quando o seu fluxo de trabalho passar a exigir colaboração ou modelos, os [Canais](/pt/docs/webhook) são o próximo passo natural.

## Conteúdo relacionado

- [Documentação da API do Direct](/pt/docs/direct) — referência completa dos campos e exemplos
- [WebhookMCP + Echobell](/pt/blog/get-notified-with-webhook-mcp) — notificações de conclusão de tarefas de IA usando o Direct
- [Como driblar o modo Foco do iOS](/pt/blog/how-to-bypass-ios-focus-mode-for-critical-alerts) — como escolher a urgência certa para a notificação
- [Notificações de webhook do Zapier](/pt/blog/zapier-webhook-notifications-to-phone) — automações para quem não é desenvolvedor
- [Tipos de notificação](/pt/docs/notification) — comportamento das notificações Normal, Urgente e em chamada