> 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

Ihre Rezeption kann einem Anrufer über Brevo eine SMS senden, beispielsweise Ihre Adresse oder eine Zusammenfassung dessen, was im Gespräch vereinbart wurde. Ein [Webhook-Tool](/docs/de/reception-ai/integrations/webhooks) sendet die SMS. Um Kontakte zu suchen und zu speichern, verbinden Sie den [MCP-Server](/docs/de/reception-ai/integrations/mcp-server) von Brevo.

> **Warning**
>
> Senden Sie nur Anrufern eine SMS, die im Gespräch darum bitten oder ihr zustimmen, und halten Sie diese Nachrichten
> transaktional: keine Werbung. Marketing-SMS erfordern eine vorherige Einwilligung und eine Abmeldemöglichkeit gemäß Vorschriften
> wie dem TCPA in den USA und der DSGVO in der EU. Prüfen Sie, was für Ihr Unternehmen gilt, bevor Sie dies
> aktivieren.

## SMS zur Nachverfolgung senden

### Ihr Brevo-Konto vorbereiten

Für SMS werden Prepaid-Guthaben verwendet. Kaufen Sie in Brevo SMS-Guthaben und prüfen Sie, ob der SMS-Versand für die Länder verfügbar ist, in die Sie SMS senden. Einige Länder, darunter die USA und Kanada, akzeptieren keinen benutzerdefinierten Absendernamen.

### Einen API-Schlüssel erstellen

Öffnen Sie in Brevo **SMTP & API** → **API Keys** und wählen Sie **Generate a new API key**. Lassen Sie **Create MCP server API key** für diesen Schlüssel deaktiviert. Kopieren Sie den Schlüssel, der mit `xkeysib-` beginnt.

### Das Webhook-Tool erstellen

Gehen Sie zu **Integrations**, wählen Sie **Add integration** und anschließend **Webhook Tool**.

| Feld                 | Wert                                                                                                                                                                                                                                                                                                                                                                                                                      |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**             | `send_followup_text`                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Beschreibung**     | "Senden Sie dem Anrufer eine SMS. Verwenden Sie sie nur, wenn der Anrufer um eine SMS bittet oder dem Empfang zustimmt. Senden Sie niemals Werbung."                                                                                                                                                                                                                                                                      |
| **Methode**          | POST                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **URL**              | `https://api.brevo.com/v3/transactionalSMS/send`                                                                                                                                                                                                                                                                                                                                                                          |
| **Request Headers**  | `api-key`: Ihr API-Schlüssel  `accept`: `application/json`                                                                                                                                                                                                                                                                                                                                                                |
| **Body Parameters**  | `sender` (string, erforderlich): "Immer genau der Wert `YOUR_SENDER`."  `recipient` (string, erforderlich): "Die Mobilnummer des Anrufers mit Ländervorwahl, nur Ziffern, ohne `+` oder Leerzeichen. Zum Beispiel 14155550123."  `content` (string, erforderlich): "Die SMS mit weniger als 160 Zeichen. Beginnen Sie mit dem Unternehmensnamen."  `type` (string, erforderlich): "Immer genau der Wert `transactional`." |
| **Assign to agents** | **Receptionist**                                                                                                                                                                                                                                                                                                                                                                                                          |

Ersetzen Sie `YOUR_SENDER` durch Ihren Absendernamen (bis zu 11 Buchstaben und Ziffern) oder Ihre Versandnummer (bis zu 15 Ziffern).

### Testen

Wählen Sie **Enable** und [testen Sie dann Ihre Rezeption](/docs/de/reception-ai/receptionist/testing), indem Sie mit Ihrer eigenen Mobilnummer per SMS nach Ihrer Adresse fragen. Sie können die Zustellung in den SMS-Protokollen von Brevo prüfen.

Nachrichten mit mehr als 160 Zeichen werden als mehrere SMS gesendet. Jede davon verbraucht Guthaben.

## Kontakte suchen und speichern

### Einen MCP-Schlüssel erstellen

Öffnen Sie in Brevo **SMTP & API** → **API Keys**, wählen Sie **Generate a new API key** und aktivieren Sie **Create MCP server API key**. Kopieren Sie den Schlüssel.

> **Warning**
>
> Ein MCP-Schlüssel hat vollständigen Lese- und Schreibzugriff auf Ihr Brevo-Konto. Bewahren Sie ihn getrennt vom SMS-
> Schlüssel auf und verbinden Sie nur das untenstehende Kontakte-Modul.

### Den MCP-Server hinzufügen

Gehen Sie in Reception.ai zu **Integrations**, wählen Sie **Add integration** und anschließend **MCP Server**.

| Feld             | Wert                                          |
| ---------------- | --------------------------------------------- |
| **Name**         | Brevo-Kontakte                                |
| **Server type**  | Streamable HTTP                               |
| **Server URL**   | `https://mcp.brevo.com/v1/brevo_contacts/mcp` |
| **Secret Token** | Ihr MCP-Schlüssel                             |

Wählen Sie **Enable**. Reception.ai sendet den Schlüssel als Bearer-Token und listet die Kontakt-Tools von Brevo auf.

### Tools zuweisen

Öffnen Sie den Tab **Tools**. Weisen Sie die Tools zum Suchen und Erstellen von Kontakten dem **Client** (der Rezeption) zu. Lassen Sie Tools zum Löschen von Kontakten oder Ändern von Listen nicht zugewiesen, oder weisen Sie sie nur dem **Assistant** zu.

> **Note**
>
> `https://mcp.brevo.com/v1/brevo/mcp` stellt jedes Brevo-Modul bereit, einschließlich E-Mail-Kampagnen. Verwenden Sie es
> nur, wenn Ihr Team Kampagnen über den **Assistant** verwalten soll.

## Fehlerbehebung

| Problem                              | Prüfen Sie                                                                                                                                                   |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Brevo gibt 401 zurück                | Der Header muss `api-key` heißen. Wenn Brevo eine unbekannte IP-Adresse erwähnt, prüfen Sie die autorisierten IPs in den Sicherheitseinstellungen von Brevo. |
| Brevo gibt 400 zurück                | Prüfen Sie, ob die Nummer eine Ländervorwahl und kein `+` enthält und ob der Absendername höchstens 11 Zeichen lang ist.                                     |
| Die SMS kommt nie an                 | Prüfen Sie Ihr SMS-Guthaben und ob Brevo mit Ihrem Absender SMS in dieses Land senden kann.                                                                  |
| Keine MCP-Tools werden aufgelistet   | Verwenden Sie **Streamable HTTP** und einen MCP-Schlüssel, nicht den SMS-Schlüssel.                                                                          |
| Sie haben den MCP-Schlüssel geändert | Bearbeiten Sie die Integration und verwenden Sie **Rotate Secret Token (optional)**. Der gespeicherte Token wird nie wieder angezeigt.                       |