Brevo | ElevenLabs Documentation

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 invia l’SMS. Per cercare e salvare i contatti, collega il server MCP di Brevo.

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

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.

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.