---
title: "Echobell Direct: 채널 설정 없이 받는 개인용 Webhook 알림"
date: 2026-03-05
description: "Echobell Direct는 개인용 Webhook URL을 제공해 스크립트, CI 작업, 자동화 도구에서 보내는 알림을 즉시 받게 해 줍니다. 채널 설정은 필요하지 않습니다."
author: Nooc
authorAvatarLink: /images/avatars/nooc.webp
authorLink: https://nooc.me
tags:
  - Echobell
  - Echobell Direct
  - 즉시 알림
  - 푸시 알림
  - 공지
---

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

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

## Echobell Direct란 무엇인가요?

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

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

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

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

## 3단계로 끝내는 설정

### 1단계: Direct 키 만들기

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

### 2단계: Webhook URL 복사하기

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

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

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

### 3단계: 첫 알림 보내기

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

전체 필드 레퍼런스: [Direct API](/ko/docs/direct)

## 긴급도 수준

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

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

동작에 대한 자세한 내용은 [알림 유형](/ko/docs/notification)을 참고하세요.

## 알림에 맥락 더하기

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

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

## Direct와 채널 비교

| | Direct | 채널 |
|---|---|---|
| 대상 | 개인 전용 | 팀원과 공유 |
| 템플릿 | 요청마다 지정하는 내용 | 재사용 가능한 고정 템플릿 |
| 설정 시간 | 1분 미만 | 채널 구성 필요 |
| 조건 | 지원하지 않음 | 지원함 |

알림이 여러 사람에게 전달되어야 하거나 서비스 전반에 일관된 형식을 유지하고 싶다면 채널을 사용하세요. [템플릿 문서](/ko/docs/template) · [Echobell이란](/ko/docs/what-is-echobell)

## 보안 권장 사항

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

## 자주 묻는 질문

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

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

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

---

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

## 관련 문서

- [Direct API 문서](/ko/docs/direct) — 전체 필드 레퍼런스와 예제
- [WebhookMCP + Echobell](/ko/blog/get-notified-with-webhook-mcp) — Direct로 AI 작업 완료 알림 받기
- [iOS 집중 모드를 우회하는 방법](/ko/blog/how-to-bypass-ios-focus-mode-for-critical-alerts) — 알맞은 알림 긴급도 고르기
- [Zapier Webhook 알림](/ko/blog/zapier-webhook-notifications-to-phone) — 비개발자를 위한 자동화 워크플로
- [알림 유형](/ko/docs/notification) — 일반, 긴급, 전화 알림의 동작 방식