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

# Brevo

Il tuo receptionist può inviare a un chiamante un messaggio di testo tramite Brevo, ad esempio il tuo indirizzo o un riepilogo di quanto concordato durante la chiamata. Uno [strumento webhook](/docs/it/reception-ai/integrations/webhooks) invia l'SMS. Per cercare e salvare i contatti, collega il [server MCP](/docs/it/reception-ai/integrations/mcp-server) di Brevo.

> **Warning**
>
> Invia messaggi di testo solo ai chiamanti che ne richiedono uno o acconsentono a riceverlo durante la chiamata e mantieni questi messaggi
> transazionali: niente promozioni. I messaggi di marketing richiedono il consenso preventivo e un'opzione di rinuncia secondo normative
> come il TCPA negli Stati Uniti e il GDPR nell'UE. Verifica cosa si applica alla tua attività prima di attivare
> questa funzione.

## Invia un messaggio di follow-up

### Prepara il tuo account Brevo

Gli SMS usano crediti prepagati. In Brevo, acquista crediti SMS e verifica che l'invio di SMS sia disponibile per i paesi a cui invii messaggi. Alcuni paesi, come gli Stati Uniti e il Canada, non accettano un nome mittente personalizzato.

### Crea una chiave API

In Brevo, apri **SMTP & API** → **Chiavi API** e seleziona **Genera una nuova chiave API**. Lascia disattivata l'opzione **Crea chiave API per server MCP** per questa chiave. Copia la chiave, che inizia con `xkeysib-`.

### Crea lo strumento webhook

Vai su **Integrazioni**, seleziona **Aggiungi integrazione** e scegli **Strumento webhook**.

| Campo                      | Valore                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nome**                   | `send_followup_text`                                                                                                                                                                                                                                                                                                                                                                                                                               |
| **Descrizione**            | "Invia un messaggio di testo al chiamante. Usalo solo dopo che il chiamante ha richiesto un messaggio o ha accettato di riceverne uno. Non inviare mai promozioni."                                                                                                                                                                                                                                                                                |
| **Metodo**                 | POST                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| **URL**                    | `https://api.brevo.com/v3/transactionalSMS/send`                                                                                                                                                                                                                                                                                                                                                                                                   |
| **Header della richiesta** | `api-key`: la tua chiave API  `accept`: `application/json`                                                                                                                                                                                                                                                                                                                                                                                         |
| **Parametri del body**     | `sender` (stringa, obbligatorio): "Sempre il valore esatto `YOUR_SENDER`."  `recipient` (stringa, obbligatorio): "Il numero di cellulare del chiamante con prefisso internazionale, solo cifre, senza `+` né spazi. Ad esempio 14155550123."  `content` (stringa, obbligatorio): "Il messaggio di testo, con meno di 160 caratteri. Inizia con il nome dell'attività."  `type` (stringa, obbligatorio): "Sempre il valore esatto `transactional`." |
| **Assegna agli agenti**    | **Receptionist**                                                                                                                                                                                                                                                                                                                                                                                                                                   |

Sostituisci `YOUR_SENDER` con il tuo nome mittente (fino a 11 lettere e cifre) o numero di invio (fino a 15 cifre).

### Verificalo

Seleziona **Abilita**, poi [verifica il tuo receptionist](/docs/it/reception-ai/receptionist/testing) chiedendo di ricevere il tuo indirizzo via SMS e usando il tuo numero di cellulare. Puoi controllare la consegna nei log SMS di Brevo.

I messaggi con più di 160 caratteri vengono inviati come più SMS e ciascuno usa crediti.

## Cerca e salva i contatti

### Crea una chiave MCP

In Brevo, apri **SMTP & API** → **Chiavi API**, seleziona **Genera una nuova chiave API** e attiva **Crea chiave API per server MCP**. Copia la chiave.

> **Warning**
>
> Una chiave MCP dispone dell'accesso completo in lettura e scrittura al tuo account Brevo. Tienila separata dalla chiave SMS
> e collega solo il modulo contatti indicato di seguito.

### Aggiungi il server MCP

In Reception.ai, vai su **Integrazioni**, seleziona **Aggiungi integrazione** e scegli **Server MCP**.

| Campo              | Valore                                        |
| ------------------ | --------------------------------------------- |
| **Nome**           | Contatti Brevo                                |
| **Tipo di server** | HTTP streamable                               |
| **URL del server** | `https://mcp.brevo.com/v1/brevo_contacts/mcp` |
| **Token segreto**  | La tua chiave MCP                             |

Seleziona **Abilita**. Reception.ai invia la chiave come bearer token e mostra gli strumenti per i contatti di Brevo.

### Assegna gli strumenti

Apri la scheda **Strumenti**. Assegna al **Client** (receptionist) gli strumenti che cercano e creano contatti. Lascia non assegnati gli strumenti che eliminano contatti o modificano liste, oppure assegnali solo all'**Assistente**.

> **Note**
>
> `https://mcp.brevo.com/v1/brevo/mcp` espone ogni modulo Brevo, comprese le campagne email. Usalo
> solo se vuoi che il tuo team gestisca le campagne dall'**Assistente**.

## Risoluzione dei problemi

| Problema                        | Cosa controllare                                                                                                                                              |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Brevo restituisce 401           | L'header deve chiamarsi `api-key`. Se Brevo menziona un indirizzo IP non riconosciuto, controlla gli IP autorizzati nelle impostazioni di sicurezza di Brevo. |
| Brevo restituisce 400           | Verifica che il numero abbia il prefisso internazionale e non contenga `+`, e che il nome mittente abbia al massimo 11 caratteri.                             |
| Il messaggio non arriva mai     | Controlla i tuoi crediti SMS e se Brevo può inviare SMS a quel paese con il tuo mittente.                                                                     |
| Non sono elencati strumenti MCP | Usa **HTTP streamable** e una chiave MCP, non la chiave SMS.                                                                                                  |
| Hai modificato la chiave MCP    | Modifica l'integrazione e usa **Ruota token segreto (facoltativo)**. Il token salvato non viene più mostrato.                                                 |