Echobell Direct: 채널 설정 없이 받는 개인용 Webhook 알림

목차

• Echobell Direct란 무엇인가요?
• 3단계로 끝내는 설정
• 1단계: Direct 키 만들기
• 2단계: Webhook URL 복사하기
• 3단계: 첫 알림 보내기
• 긴급도 수준
• 알림에 맥락 더하기
• Direct와 채널 비교
• 보안 권장 사항
• 자주 묻는 질문
• 관련 문서

Echobell Direct는 채널 설정을 완전히 건너뛰는 개인용 알림 모드입니다. Direct 키를 만들면 Webhook URL이 발급되고, title과 body를 POST로 보내면 기기에서 즉시 알림을 받습니다. 구독자도, 템플릿도, 라우팅 설정도 필요하지 않습니다.

이 가이드에서는 Direct가 무엇인지, 어떻게 설정하는지, 그리고 채널 대신 언제 사용하면 좋은지를 다룹니다.

Echobell Direct란 무엇인가요?

Direct 키마다 고유한 Webhook URL(/d/{token})이 생성됩니다. 이 URL로 요청을 보내면 알림이 기기에 즉시 도착합니다.

다음과 같은 경우에 Direct를 사용하세요:

• 스크립트, cron 작업, CI 파이프라인에서 보내는 개인 알림
• 고정된 템플릿 대신 요청마다 직접 지정하는 제목과 본문
• 채널 전체를 구성하지 않는 빠른 설정

공유 알림이나 재사용 가능한 템플릿, 조건부 전달이 필요하다면 Webhook을 통한 채널을 대신 사용하세요.

3단계로 끝내는 설정

1단계: Direct 키 만들기

Echobell을 열고 채널 목록에서 Direct를 탭한 뒤 키를 만듭니다. 키 이름은 해당 서비스에 맞춰 지으세요(예: CI Server, Cron, AI Tasks).

2단계: Webhook URL 복사하기

키마다 다음 형식의 URL이 있습니다:

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

이 URL은 비밀 정보로 다루세요. URL을 아는 사람은 누구나 여러분에게 알림을 보낼 수 있습니다.

3단계: 첫 알림 보내기

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"
  }'

전체 필드 레퍼런스: Direct API

긴급도 수준

Direct는 notificationType을 지원하므로 이벤트에 맞춰 긴급도를 지정할 수 있습니다:

• active — 일반적인 업데이트
• time-sensitive — 집중 모드를 뚫고 전달되는 중요한 알림
• calling — 치명적인 장애 상황(활성 Premium 구독이 필요하며, 없으면 time-sensitive로 대체됩니다)

동작에 대한 자세한 내용은 알림 유형을 참고하세요.

알림에 맥락 더하기

요청 본문에 externalLink를 포함하면 알림에 URL을 첨부할 수 있습니다. 배포 로그나 대시보드, 풀 리퀘스트로 바로 연결할 때 유용합니다.

AI 에이전트나 오래 실행되는 비동기 작업이라면, 직접 폴링하는 대신 작업이 끝났을 때 알림을 받는 간단한 방법이 바로 Direct입니다. 참고: WebhookMCP + Echobell.

Direct와 채널 비교

알림이 여러 사람에게 전달되어야 하거나 서비스 전반에 일관된 형식을 유지하고 싶다면 채널을 사용하세요. 템플릿 문서 · Echobell이란

보안 권장 사항

• Direct 토큰은 코드가 아니라 환경 변수나 시크릿 관리 도구에 저장하세요
• 개별적으로 폐기할 수 있도록 서비스마다 키를 하나씩 만드세요
• URL이 유출되었을 가능성이 있다면 토큰을 즉시 교체하세요
• calling은 실제 장애 상황에만 사용하세요. 남용하면 알림 피로가 쌓입니다

자주 묻는 질문

Direct는 개발자만 쓸 수 있나요? 아닙니다. HTTP 요청을 보낼 수 있는 도구가 있다면 누구나 사용할 수 있습니다.

Direct는 GET 요청을 지원하나요? 지원합니다. 다만 JSON을 담은 POST 방식을 권장합니다.

구독이 만료된 상태에서 calling을 사용하면 어떻게 되나요? 자동으로 time-sensitive로 대체됩니다.

---

먼저 Direct 가이드로 시작해 보세요. 워크플로가 커져 협업이나 템플릿이 필요해지면 채널이 자연스러운 다음 단계가 됩니다.

관련 문서

• Direct API 문서 — 전체 필드 레퍼런스와 예제
• WebhookMCP + Echobell — Direct로 AI 작업 완료 알림 받기
• iOS 집중 모드를 우회하는 방법 — 알맞은 알림 긴급도 고르기
• Zapier Webhook 알림 — 비개발자를 위한 자동화 워크플로
• 알림 유형 — 일반, 긴급, 전화 알림의 동작 방식