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

# Telefonie (VoIP)

> Verbinden Sie Twilio, Ringostat oder Binotel fuer KI-gestuetzte Telefonanrufe

## Unterstuetzte Anbieter

| Anbieter      | Eingehende Anrufe | Ausgehende Anrufe | SMS  | Webhook-Auto-Setup |
| ------------- | ----------------- | ----------------- | ---- | ------------------ |
| **Twilio**    | Ja                | Ja                | Ja   | Automatisch        |
| **Ringostat** | Ja                | Ja                | Nein | Manuell            |
| **Binotel**   | Ja                | Ja                | Nein | Manuell            |

## Einrichtung

<Tabs>
  <Tab title="Twilio">
    ### Zugangsdaten

    Sie benoetigen zwei Werte aus der [Twilio Console](https://console.twilio.com/):

    | Feld            | Wo zu finden             |
    | --------------- | ------------------------ |
    | **Account SID** | Dashboard → Account Info |
    | **Auth Token**  | Dashboard → Account Info |

    ### Schritte

    <Steps>
      <Step title="Integration hinzufuegen">
        Gehen Sie zu **Integrationen** → **Integration hinzufuegen** → waehlen Sie **Twilio** aus der Kategorie Telefonie.
      </Step>

      <Step title="Zugangsdaten eingeben">
        Waehlen Sie ein Unternehmen, geben Sie der Integration einen Namen (z.B. "Haupttelefonleitung") und geben Sie Ihre Account SID und Ihren Auth Token ein.
      </Step>

      <Step title="Verifizieren und Nummer waehlen">
        Klicken Sie auf **Verbindung testen**. Revol ruft Ihre verfuegbaren Telefonnummern ab. Waehlen Sie die zu verwendende Nummer aus.
      </Step>

      <Step title="Speichern">
        Revol konfiguriert automatisch die Webhook-URL fuer die ausgewaehlte Twilio-Nummer. Eingehende Anrufe und SMS werden an Ihren Agenten weitergeleitet.
      </Step>
    </Steps>

    <Note>
      Twilio-Webhook-URLs werden automatisch konfiguriert. Sie muessen nichts in der Twilio Console einstellen.
    </Note>
  </Tab>

  <Tab title="Ringostat">
    ### Zugangsdaten

    | Feld                          | Wo zu finden                               |
    | ----------------------------- | ------------------------------------------ |
    | **API-Schluessel (Auth-key)** | Ringostat Dashboard → API-Einstellungen    |
    | **Projekt-ID**                | Ringostat Dashboard → Projekteinstellungen |

    ### Schritte

    <Steps>
      <Step title="Integration hinzufuegen">
        Gehen Sie zu **Integrationen** → **Integration hinzufuegen** → waehlen Sie **Ringostat**.
      </Step>

      <Step title="Zugangsdaten eingeben">
        Geben Sie Ihren API-Schluessel und Ihre Projekt-ID ein.
      </Step>

      <Step title="Verifizieren">
        Revol ruft Ihre SIP-Konten ab, um die Verbindung zu bestaetigen.
      </Step>

      <Step title="Webhook konfigurieren">
        Setzen Sie im Ringostat Dashboard die Webhook-URL, die nach der Verifizierung in Revol angezeigt wird.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Binotel">
    ### Zugangsdaten

    | Feld               | Wo zu finden                            |
    | ------------------ | --------------------------------------- |
    | **API-Schluessel** | Binotel Dashboard → Einstellungen → API |
    | **API-Geheimnis**  | Binotel Dashboard → Einstellungen → API |

    ### Schritte

    <Steps>
      <Step title="Integration hinzufuegen">
        Gehen Sie zu **Integrationen** → **Integration hinzufuegen** → waehlen Sie **Binotel**.
      </Step>

      <Step title="Zugangsdaten eingeben">
        Geben Sie Ihren API-Schluessel und Ihr API-Geheimnis ein.
      </Step>

      <Step title="Verifizieren">
        Revol ruft Ihre internen Telefonnummern ab, um die Verbindung zu bestaetigen.
      </Step>

      <Step title="Webhook konfigurieren">
        Setzen Sie im Binotel Dashboard die Webhook-URL, die nach der Verifizierung in Revol angezeigt wird.
      </Step>
    </Steps>

    <Warning>
      Binotel-Webhooks werden per IP-Zulassungsliste validiert. Nur Anfragen von Binotel-Servern werden in der Produktion akzeptiert.
    </Warning>
  </Tab>
</Tabs>

## Agenten-Tools

Nach dem Verbinden eines VoIP-Anbieters werden die folgenden Tools automatisch bereitgestellt:

| Tool                   | Twilio | Ringostat | Binotel | Beschreibung                                                                  |
| ---------------------- | ------ | --------- | ------- | ----------------------------------------------------------------------------- |
| **make\_call**         | Ja     | Ja        | Ja      | Einen ausgehenden Anruf mit optionaler Begruessungsnachricht starten          |
| **send\_sms**          | Ja     | —         | —       | Eine SMS-Nachricht senden (Absendernummer wird automatisch gewaehlt)          |
| **get\_call\_history** | Ja     | Ja        | Ja      | Aktuelle Anrufprotokolle mit Filtern abrufen (Telefon, Status, Datumsbereich) |

Diese Tools werden im **Tools**-Tab des Agenten verfuegbar und koennen zu Workflow-Knoten hinzugefuegt werden.

## Sprachanruf-Ablauf

Wenn ein eingehender Anruf eintrifft, verarbeitet Revol ihn ueber den Workflow des zugewiesenen Agenten:

<Steps>
  <Step title="Eingehender Anruf">
    Der VoIP-Anbieter sendet eine Webhook-Benachrichtigung an Revol mit den Anruferinformationen.
  </Step>

  <Step title="Begruessung">
    Revol generiert eine Audio-Begruessung mittels Text-zu-Sprache (konfigurierbare Stimme und Sprache) und spielt sie dem Anrufer vor.
  </Step>

  <Step title="Sprache-zu-Text">
    Die Sprache des Anrufers wird aufgenommen und mit Whisper oder Google STT transkribiert.
  </Step>

  <Step title="KI-Verarbeitung">
    Der transkribierte Text wird an den Workflow des Agenten gesendet. Der Agent verarbeitet ihn ueber LLM-Knoten, Wissensdatenbank-Abfragen und Tool-Aufrufe.
  </Step>

  <Step title="Text-zu-Sprache">
    Die Textantwort des Agenten wird mit OpenAI TTS mit konfigurierbarer Stimme und Geschwindigkeit in Audio umgewandelt.
  </Step>

  <Step title="Antwort">
    Das Audio wird dem Anrufer abgespielt. Die Konversation laeuft in einer Schleife, bis der Anruf beendet wird.
  </Step>
</Steps>

## Tools in Workflow-Knoten verwenden

Um Ihren Agenten VoIP-Tools waehrend Konversationen nutzen zu lassen:

1. Gehen Sie zum **Workflow**-Tab des Agenten
2. Erstellen oder waehlen Sie einen **benutzerdefinierten Knoten** (LLM-gestuetzt)
3. Aktivieren Sie in den Knoteneinstellungen die VoIP-Tools (z.B. `make_call`, `get_call_history`)
4. Das LLM entscheidet automatisch basierend auf dem Konversationskontext, wann diese Tools aufgerufen werden

Wenn beispielsweise ein Kunde fragt "Koennen Sie mich unter +380501234567 zurueckrufen?", wird der Agent das `make_call`-Tool verwenden, um einen ausgehenden Anruf zu starten.

## Webhook-Sicherheit

| Anbieter  | Validierungsmethode                                           |
| --------- | ------------------------------------------------------------- |
| Twilio    | HMAC-SHA1-Signaturverifizierung (`X-Twilio-Signature`-Header) |
| Ringostat | Strukturelle Parametervalidierung                             |
| Binotel   | IP-Zulassungsliste (nur Binotel-Server-IPs in der Produktion) |

Alle VoIP-Webhooks sind auf **120 Anfragen pro Minute** pro Kanal ratenbegrenzt.