> 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

Receptionistは、発信者をメーリングリストに登録できます。メールアドレスを確認した後、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 Basic認証を使ってAPIキーを認証します。お使いのコンピューターでヘッダー値を作成してください。

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

## Webhookツールを作成する

**Integrations** に移動して **Add integration** を選択し、**Webhook Tool** を選びます。

| フィールド            | 値                                                                           |
| ---------------- | --------------------------------------------------------------------------- |
| **名前**           | `add_to_mailing_list`                                                       |
| **説明**           | 「発信者をメーリングリストに追加します。発信者が登録を希望し、メールアドレスを1文字ずつ確認した後にのみ使用してください。」              |
| **メソッド**         | POST                                                                        |
| **URL**          | `https://SERVER_PREFIX.api.mailchimp.com/3.0/lists/AUDIENCE_ID/members`     |
| **リクエストヘッダー**    | `Authorization`を`Basic `の後にエンコードした値を続けたものに設定                                |
| **本文パラメーター**     | `email_address`（文字列、必須）：「発信者のメールアドレス。」  `status`（文字列、必須）：「常に正確な値`pending`。」 |
| **エージェントへの割り当て** | **Receptionist**                                                            |

**Enable** を選択し、メーリングリストへの登録を依頼して[Receptionistをテスト](/docs/ja/reception-ai/receptionist/testing)します。メールを確認するまで、連絡先はオーディエンスに **Pending** として表示されます。

> **Warning**
>
> `pending`にすると、Mailchimpからオプトイン確認メールが送信されます。電話で発信者が同意しても、
> すべての国で書面による同意と見なされるわけではありません。不要であることが確実でない限り、ダブルオプトインを維持してください。

このツールは最上位のフィールドのみを送信するため、Mailchimpが`merge_fields`の下にネストしている名などのマージフィールドには入力できません。追加するには、代わりに[Zapier](/docs/ja/reception-ai/integrations/zapier)経由で登録を処理してください。

## トラブルシューティング

| 問題                 | 確認事項                                                           |
| ------------------ | -------------------------------------------------------------- |
| Mailchimpから401     | ヘッダー値を再エンコードし、URLのサーバープレフィックスがAPIキーと一致していることを確認します。            |
| Mailchimpから404     | URL内のオーディエンスIDを確認します。                                          |
| `Member Exists`    | そのアドレスはすでにリストに登録されています。Receptionistから発信者に、すでに購読済みであることを伝えられます。 |
| `Invalid Resource` | メールアドレスの形式が正しくありません。送信前に、Receptionistが発信者へアドレスを読み返すようにしてください。  |