> 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

La tua receptionist può iscrivere i chiamanti alla tua mailing list. Conferma il loro indirizzo email, quindi li aggiunge al tuo pubblico Mailchimp tramite l'API Marketing di Mailchimp. Mailchimp invia a ogni nuovo contatto un'email di conferma prima dell'iscrizione.

## Prima di iniziare

Ti servono questi valori da Mailchimp:

| Valore                  | Dove trovarlo                                                                   |
| ----------------------- | ------------------------------------------------------------------------------- |
| **Chiave API**          | Profilo → **Extras** → **API keys** → **Create A Key**                          |
| **Prefisso del server** | La parte finale della chiave API dopo il trattino, ad esempio `us21`            |
| **ID del pubblico**     | **Audience** → **All contacts** → **Settings** → **Audience name and defaults** |

Mailchimp autentica le chiavi API con l'autenticazione HTTP Basic. Crea il valore dell'header sul tuo computer:

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

## Crea lo strumento webhook

Vai a **Integrations**, seleziona **Add integration** e scegli **Webhook Tool**.

| Campo                      | Valore                                                                                                                                                               |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nome**                   | `add_to_mailing_list`                                                                                                                                                |
| **Descrizione**            | "Aggiungi il chiamante alla mailing list. Usalo solo dopo che il chiamante ha chiesto di iscriversi e ha confermato il proprio indirizzo email lettera per lettera." |
| **Metodo**                 | POST                                                                                                                                                                 |
| **URL**                    | `https://SERVER_PREFIX.api.mailchimp.com/3.0/lists/AUDIENCE_ID/members`                                                                                              |
| **Header della richiesta** | `Authorization` impostato su `Basic ` seguito dal valore codificato                                                                                                  |
| **Parametri del body**     | `email_address` (stringa, obbligatorio): "L'indirizzo email del chiamante."  `status` (stringa, obbligatorio): "Sempre l'esatto valore `pending`."                   |
| **Assegna agli agenti**    | **Receptionist**                                                                                                                                                     |

Seleziona **Enable**, quindi [testa la tua receptionist](/docs/it/reception-ai/receptionist/testing) chiedendo di iscriverti alla mailing list. Il contatto appare nel tuo pubblico come **Pending** finché non conferma l'email.

> **Warning**
>
> `pending` invia l'email di conferma dell'iscrizione di Mailchimp. Il consenso telefonico di un chiamante non è
> un consenso scritto in tutti i Paesi, quindi mantieni il doppio opt-in a meno che tu non sia certo di non averne bisogno.

Lo strumento invia solo campi di primo livello, quindi non può compilare campi merge come il nome, che Mailchimp annida in `merge_fields`. Per aggiungerli, inoltra invece l'iscrizione tramite [Zapier](/docs/it/reception-ai/integrations/zapier).

## Risoluzione dei problemi

| Problema           | Cosa controllare                                                                                                       |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------- |
| 401 da Mailchimp   | Codifica di nuovo il valore dell'header e verifica che il prefisso del server nell'URL corrisponda alla chiave API.    |
| 404 da Mailchimp   | Verifica l'ID del pubblico nell'URL.                                                                                   |
| `Member Exists`    | L'indirizzo è già nella lista. La tua receptionist può dire al chiamante che è già iscritto.                           |
| `Invalid Resource` | L'indirizzo email non è valido. Chiedi alla tua receptionist di ripetere gli indirizzi ai chiamanti prima di inviarli. |