> ## Documentation Index
> Fetch the complete documentation index at: https://revolai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrationen Ueberblick

> Verbinden Sie KI-Agenten mit Kommunikationskanaelen, Produktivitaetstools und Werbeplattformen

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/revolai/u4jrzWUP0vGPhn5W/images/integrations-overview-light.png?fit=max&auto=format&n=u4jrzWUP0vGPhn5W&q=85&s=35912161a44233ad59ca5133b741ffab" alt="Integrationen Ueberblick" width="2873" height="1552" data-path="images/integrations-overview-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/revolai/u4jrzWUP0vGPhn5W/images/integrations-overview-dark.png?fit=max&auto=format&n=u4jrzWUP0vGPhn5W&q=85&s=db09aa52b3c494d18b03b1d4d9fc7c63" alt="Integrationen Ueberblick" width="2873" height="1549" data-path="images/integrations-overview-dark.png" />
</Frame>

## Was sind Integrationen?

Integrationen verbinden Ihre KI-Agenten mit externen Diensten — damit sie Telefonanrufe beantworten, in Messengern antworten, E-Mails senden, Dokumente erstellen und Analysedaten abrufen koennen. Jede Integration gibt Ihrem Agenten eine Reihe von **Tools**, die er waehrend Konversationen aufrufen kann.

## Verfuegbare Integrationen

<CardGroup cols={2}>
  <Card title="Telefonie" icon="phone" href="/integrations/voip">
    Twilio, Ringostat, Binotel — KI-gestuetzte Telefonanrufe und SMS
  </Card>

  <Card title="Messenger" icon="comments" href="/integrations/messengers">
    Telegram, WhatsApp, Instagram DM, Facebook Messenger
  </Card>

  <Card title="Google Workspace" icon="google" href="/integrations/google-workspace">
    Gmail, Docs, Sheets, Drive, Calendar, Meet
  </Card>

  <Card title="Werbekampagnen" icon="chart-line" href="/integrations/advertising">
    Google Ads, Facebook Ads — Kampagnenanalyse und -verwaltung
  </Card>

  <Card title="Benutzerdefinierter Webhook" icon="webhook" href="/integrations/webhook">
    Lead-Daten an jedes CRM oder externes System senden
  </Card>
</CardGroup>

## Funktionsweise

Jede Integration folgt demselben Muster:

<Steps>
  <Step title="Verbinden">
    Fuegen Sie eine Integration von der Integrationen-Seite hinzu. Je nach Anbieter geben Sie entweder API-Zugangsdaten ein (VoIP, Telegram) oder durchlaufen OAuth (Google, Meta).
  </Step>

  <Step title="Verifizieren">
    Revol testet Ihre Zugangsdaten gegen die API des Anbieters und ruft verfuegbare Ressourcen ab (Telefonnummern, Bot-Info, verbundene Konten).
  </Step>

  <Step title="Tools bereitstellen">
    Nach der Verifizierung erstellt Revol automatisch **Agenten-Tools** basierend auf dem Integrationstyp. Zum Beispiel gibt die Verbindung von Gmail Ihren Agenten `send_email`, `read_inbox`, `search_emails` und andere Tools.
  </Step>

  <Step title="Dem Agenten zuweisen">
    Im **Tools**-Tab des Agenten aktivieren Sie die benoetigten Tools. Fuegen Sie sie dann zu Workflow-Knoten hinzu — der Agent kann diese Tools waehrend Konversationen ueber LLM-Funktionsaufrufe verwenden.
  </Step>
</Steps>

## Authentifizierungsmethoden

| Methode                    | Verwendet von                                          | Funktionsweise                                                                                                                                                   |
| -------------------------- | ------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **API-Schluessel / Token** | Twilio, Ringostat, Binotel, Telegram                   | Zugangsdaten im Assistenten eingeben. Verschluesselt in der Datenbank gespeichert.                                                                               |
| **Google OAuth 2.0**       | Gmail, Docs, Sheets, Drive, Calendar, Meet, Google Ads | Klicken Sie auf "Mit Google verbinden", autorisieren Sie im Zustimmungsbildschirm. Revol speichert ein Refresh-Token und aktualisiert Access-Tokens automatisch. |
| **Meta OAuth**             | WhatsApp, Instagram, Facebook Messenger, Facebook Ads  | Klicken Sie auf "Mit Meta verbinden", autorisieren Sie ueber Meta. Revol tauscht den Code gegen ein langlebiges Token (\~60 Tage).                               |
| **Webhook-URL**            | Benutzerdefinierter Webhook                            | Keine Authentifizierung erforderlich — Sie geben die Ziel-URL und optionale Header an.                                                                           |

## Kanaele

Ein **Kanal** ist die Verbindung zwischen einer Integration und einem bestimmten KI-Agenten. Eine Integration (z.B. Ihr Twilio-Konto) kann mehrere Agenten ueber separate Kanaele bedienen.

Verfuegbare Kanaltypen:

| Kanal          | Erfordert Integration | Beschreibung                              |
| -------------- | --------------------- | ----------------------------------------- |
| **Web-Widget** | Nein                  | Eingebautes Chat-Widget fuer Ihre Website |
| **Telefon**    | VoIP-Integration      | Ein-/ausgehende Sprachanrufe und SMS      |
| **Telegram**   | Telegram-Integration  | Bot-Nachrichten in Telegram               |
| **WhatsApp**   | WhatsApp-Integration  | WhatsApp Business-Nachrichten             |
| **Instagram**  | Instagram-Integration | Instagram Direct Messages                 |

Um einen Kanal einzurichten, gehen Sie zum **Kanaele**-Tab des Agenten, waehlen Sie den Kanaltyp und bestimmen Sie, welche Integration verwendet werden soll.

## Webhook-Sicherheit

Alle eingehenden Webhook-Endpunkte (VoIP-Anrufe, Messenger-Nachrichten) sind geschuetzt durch:

* **Signaturvalidierung** — kryptografische Verifizierung der Anfragenauthentizitaet pro Anbieter
* **Idempotenz** — Erkennung doppelter Webhooks zur Vermeidung von Doppelverarbeitung
* **Ratenbegrenzung** — 120 Anfragen pro Minute pro Kanal
* **IP-Zulassungsliste** — wo vom Anbieter unterstuetzt (z.B. Binotel)

## Alle Integrationen

| Integration                 | Kategorie      | Authentifizierung | Tools                                                         |
| --------------------------- | -------------- | ----------------- | ------------------------------------------------------------- |
| Twilio                      | Telefonie      | API-Schluessel    | 3 Tools — Anrufe, SMS, Anrufverlauf                           |
| Ringostat                   | Telefonie      | API-Schluessel    | 2 Tools — Anrufe, Anrufverlauf                                |
| Binotel                     | Telefonie      | API-Schluessel    | 2 Tools — Anrufe, Anrufverlauf                                |
| Telegram                    | Messenger      | Bot-Token         | 6 Tools — Nachrichten, Dateien, Verlauf, Bearbeiten, Loeschen |
| WhatsApp Business           | Messenger      | Meta OAuth        | 6 Tools — Nachrichten, Vorlagen, Medien, Verlauf              |
| Instagram DM                | Messenger      | Meta OAuth        | 6 Tools — Nachrichten, Medien, Verlauf, Kommentare            |
| Facebook Messenger          | Messenger      | Meta OAuth        | 6 Tools — Nachrichten, Vorlagen, Medien, Schaltflaechen       |
| Gmail                       | Produktivitaet | Google OAuth      | 6 Tools — Senden, Lesen, Suchen, Antworten, Entwuerfe         |
| Google Docs                 | Produktivitaet | Google OAuth      | 5 Tools — Erstellen, Lesen, Anhaengen, Suchen, Exportieren    |
| Google Sheets               | Produktivitaet | Google OAuth      | 7 Tools — Lesen, Schreiben, Anhaengen, Suchen, Erstellen      |
| Google Drive                | Produktivitaet | Google OAuth      | 8 Tools — Auflisten, Suchen, Hochladen, Teilen, Ordner        |
| Google Calendar             | Produktivitaet | Google OAuth      | 6 Tools — Termine, Verfuegbarkeit, Freie Zeitfenster          |
| Google Meet                 | Produktivitaet | Google OAuth      | 1 Tool — Meeting-Link erstellen                               |
| Google Ads                  | Werbung        | Google OAuth      | 3 Tools — Kampagnen, Keywords, Pausieren                      |
| Facebook Ads                | Werbung        | Meta OAuth        | 4 Tools — Kampagnen, Anzeigengruppen, Insights, Pausieren     |
| Benutzerdefinierter Webhook | CRM            | URL               | 2 Tools — Nutzlast senden, Verbindung testen                  |

**Gesamt: 67 Agenten-Tools** ueber 16 Integrationen.

## Naechste Schritte

<CardGroup cols={2}>
  <Card title="VoIP-Einrichtung" icon="phone" href="/integrations/voip">
    Verbinden Sie Twilio, Ringostat oder Binotel fuer KI-Telefonanrufe
  </Card>

  <Card title="Messenger-Einrichtung" icon="comments" href="/integrations/messengers">
    Verbinden Sie Telegram, WhatsApp, Instagram oder Facebook
  </Card>

  <Card title="Google Workspace" icon="google" href="/integrations/google-workspace">
    Verbinden Sie Gmail, Docs, Sheets, Drive, Calendar, Meet
  </Card>

  <Card title="Werbung" icon="chart-line" href="/integrations/advertising">
    Verbinden Sie Google Ads oder Facebook Ads
  </Card>
</CardGroup>