> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Discord

Discord 채널 웹훅을 사용하면 통화 중 리셉셔니스트가 채널에 메시지를 게시할 수 있습니다. 예를 들어 발신자가 콜백을 요청하거나 긴급한 문제를 알릴 때 사용할 수 있습니다.

## Discord에서 웹훅 만들기

서버에서 **Manage Webhooks** 권한이 필요합니다.

### 서버의 웹훅 열기

Discord에서 **Server Settings** → **Integrations** → **Webhooks**를 열고 **New Webhook**을 선택하세요.

### 채널 선택

새 웹훅을 열어 "Reception"과 같은 이름을 지정하고 게시할 채널을 선택하세요. **Save Changes**를 선택합니다.

### 웹훅 URL 복사

**Copy Webhook URL**을 선택하세요. URL은 `https://discord.com/api/webhooks/`로 시작합니다. 이 URL은 비밀로 취급하세요. URL을 가진 사람은 누구나 채널에 게시할 수 있습니다.

## 웹훅 도구 만들기

**Integrations**로 이동해 **Add integration**을 선택하고 **Webhook Tool**을 선택하세요.

| 필드                   | 값                                                                                |
| -------------------- | -------------------------------------------------------------------------------- |
| **Name**             | `notify_team_in_discord`                                                         |
| **Description**      | "팀의 Discord 채널에 메시지를 게시합니다. 발신자가 콜백을 요청하거나, 사람과 통화하기를 원하거나, 긴급한 문제를 알릴 때 사용하세요." |
| **Method**           | POST                                                                             |
| **URL**              | 끝에 `?wait=true`를 추가한 Discord 웹훅 URL                                              |
| **Body Parameters**  | `content`(문자열, 필수): "게시할 메시지(2,000자 미만): 발신자의 이름, 전화번호, 필요한 사항"                  |
| **Assign to agents** | **Receptionist**                                                                 |

`?wait=true`를 사용하면 Discord가 빈 응답 대신 게시된 메시지로 응답하므로, 리셉셔니스트가 메시지가 정상 전송되었음을 알 수 있습니다.

**Enable**을 선택한 다음 콜백을 요청하여 [리셉셔니스트를 테스트](/docs/ko/reception-ai/receptionist/testing)하세요. 메시지가 채널에 표시됩니다.

> **Tip**
>
> 각 웹훅은 하나의 채널에 게시합니다. 여러 채널에 게시하려면 채널마다 웹훅 하나와 도구 하나를
> 만드세요.

## 문제 해결

| 문제                        | 확인 사항                                                  |
| ------------------------- | ------------------------------------------------------ |
| Discord가 400을 반환함         | 본문 매개변수 이름은 정확히 `content`여야 하며, 메시지는 2,000자 미만이어야 합니다. |
| Discord가 401 또는 404를 반환함  | 웹훅이 삭제되었거나 URL이 재설정되었습니다. 현재 URL을 복사해 도구를 업데이트하세요.     |
| 포럼 채널에서 Discord가 400을 반환함 | 포럼 채널은 게시물마다 스레드가 필요합니다. 대신 웹훅을 텍스트 채널로 지정하세요.         |
| 리셉셔니스트가 게시하지 않음           | 도구 설명에 게시해야 하는 상황을 명시하세요.                              |