> 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.

# Mailchimp

접수 담당자가 발신자를 메일링 리스트에 등록할 수 있습니다. 이메일 주소를 확인한 후 Mailchimp의 Marketing API를 통해 Mailchimp 대상에 추가합니다. Mailchimp는 새 연락처가 구독되기 전에 확인 이메일을 보냅니다.

## 시작하기 전에

Mailchimp에서 다음 값이 필요합니다.

| 값          | 찾는 위치                                                                           |
| ---------- | ------------------------------------------------------------------------------- |
| **API 키**  | 프로필 → **Extras** → **API keys** → **Create A Key**                              |
| **서버 접두사** | 대시 뒤에 오는 API 키의 끝부분(예: `us21`)                                                  |
| **대상 ID**  | **Audience** → **All contacts** → **Settings** → **Audience name and defaults** |

Mailchimp는 HTTP 기본 인증으로 API 키를 인증합니다. 컴퓨터에서 헤더 값을 생성하세요.

```bash
printf 'reception:YOUR_API_KEY' | base64
```

## 웹훅 도구 만들기

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

| 필드           | 값                                                                                            |
| ------------ | -------------------------------------------------------------------------------------------- |
| **이름**       | `add_to_mailing_list`                                                                        |
| **설명**       | "발신자를 메일링 리스트에 추가합니다. 발신자가 가입을 요청하고 이메일 주소를 한 글자씩 확인한 후에만 사용하세요."                            |
| **메서드**      | POST                                                                                         |
| **URL**      | `https://SERVER_PREFIX.api.mailchimp.com/3.0/lists/AUDIENCE_ID/members`                      |
| **요청 헤더**    | `Authorization`을 `Basic ` 뒤에 인코딩된 값을 붙여 설정                                                   |
| **본문 매개변수**  | `email_address` (문자열, 필수): "발신자의 이메일 주소."  `status` (문자열, 필수): "항상 정확히 `pending` 값으로 설정하세요." |
| **에이전트에 할당** | **Receptionist**                                                                             |

**Enable**을 선택한 다음 메일링 리스트 가입을 요청하여 [접수 담당자를 테스트하세요](/docs/ko/reception-ai/receptionist/testing). 연락처가 이메일을 확인할 때까지 대상에 **Pending**으로 표시됩니다.

> **Warning**
>
> `pending`은 Mailchimp의 수신 동의 확인 이메일을 보냅니다. 전화로 동의한다고 말하는 것이 모든 국가에서
> 서면 동의로 인정되는 것은 아니므로, 필요하지 않다고 확신하지 않는 한 이중 수신 동의를 유지하세요.

이 도구는 최상위 필드만 전송하므로 Mailchimp가 `merge_fields` 아래에 중첩하는 이름 등의 병합 필드는 채울 수 없습니다. 이를 추가하려면 대신 [Zapier](/docs/ko/reception-ai/integrations/zapier)를 통해 가입을 연결하세요.

## 문제 해결

| 문제                 | 확인할 사항                                                         |
| ------------------ | -------------------------------------------------------------- |
| Mailchimp의 401     | 헤더 값을 다시 인코딩하고 URL의 서버 접두사가 API 키와 일치하는지 확인하세요.                |
| Mailchimp의 404     | URL의 대상 ID를 확인하세요.                                             |
| `Member Exists`    | 해당 주소는 이미 리스트에 있습니다. 접수 담당자가 이미 구독 중이라고 발신자에게 안내할 수 있습니다.      |
| `Invalid Resource` | 이메일 주소 형식이 잘못되었습니다. 제출 전에 접수 담당자가 발신자에게 주소를 다시 철자대로 읽어주도록 하세요. |