Dies ist eine Aufgabe für den Administrator. Diese Bildschirme sind nur für den Eigentümer des Teams sichtbar.
Verbinden Sie Ihr Telefonsystem, damit Ihre Telefongespräche automatisch in Converdo ankommen und bewertet werden. Gehen Sie in den Einstellungen zu CRM & Telefonie. Das öffnet die Seite Connectoren („Verbinden Sie die Systeme, die Gesprächsdaten zur Bewertung nach Converdo bringen."). Drei Verbindungen können Sie heute nutzen: GoHighLevel, Rinkel und Voys.
GoHighLevel
GoHighLevel pusht jedes Gespräch nach Converdo, das anschließend die Aufnahme abruft und bewertet. Sie brauchen zwei Dinge:
- Die Webhook-URL. Kopieren Sie auf der Karte GoHighLevel die Webhook-URL und fügen Sie sie in den Webhook oder die Automation in GHL ein. In der App: „Fügen Sie diese URL in den Webhook/die Automation des Systems ein. Halten Sie sie geheim: Sie identifiziert Ihren Workspace."
- Ein Private-Integration-Token. In der App steht: „Erstellen Sie in GoHighLevel eine Private Integration (Settings → Private Integrations) mit diesen Scopes: View Conversations (conversations.readonly), View Conversation Messages (conversations/message.readonly), View Contacts (contacts.readonly). Fügen Sie das Token unten ein (beginnt meist mit pit-). Wird verschlüsselt gespeichert (Vault); wird nie wieder angezeigt."
Rinkel
Rinkel pusht jedes Gespräch nach Converdo, das die Aufnahme über die Rinkel-API abruft und bewertet. Sie brauchen das Rinkel-Expert-Abonnement: Webhooks und Gesprächsaufnahmen sind in den kleineren Paketen nicht enthalten.
Tragen Sie auf der Karte Rinkel Ihren API-Schlüssel ein: „Erzeugen Sie einen API-Schlüssel in My Rinkel (die Rinkel-API ist Beta und auf Professional und Expert verfügbar; bei Bedarf über rinkel.com/integrations anfragen). Converdo verwendet den Schlüssel ausschließlich, um Ihre Gesprächsaufnahmen abzurufen. Wird verschlüsselt gespeichert (Vault); wird nie wieder angezeigt." Klicken Sie danach auf Verbindung testen; bei Erfolg sehen Sie „Verbindung erfolgreich: Der API-Schlüssel funktioniert." Sehen Sie eine Fehlermeldung, prüfen Sie, ob Sie den Schlüssel vollständig kopiert haben, ohne Leerzeichen davor oder dahinter.
Durchlaufen Sie danach die vier Schritte, wie sie auf der Karte stehen:
- „Erzeugen Sie in Rinkel unter Integrationen → API einen API-Schlüssel und fügen Sie ihn unten ein. Converdo testet die Verbindung direkt beim Speichern."
- „Registrieren Sie unter Integrationen → Webhooks die Webhook-URL oben, mit Content-Type application/json. Nutzen Sie die Test-Schaltfläche von Rinkel und klicken Sie Save."
- „Aktivieren Sie dabei alle vier Call-Events. Converdo verarbeitet alle vier: Eingehender Anruf und Ausgehender Anruf (Richtung und Telefonnummer), Anrufbeginn (verknüpft den Mitarbeiter) und Anrufende (startet die Verarbeitung und das Abrufen der Aufnahme). Andere Events, etwa Call Insights, können aus bleiben; Converdo ignoriert sie."
- „Aktivieren Sie die Gesprächsaufnahme für die Nummern, die Sie bewerten möchten: Ohne Aufnahme gibt es nichts abzurufen. Webhooks und Aufnahmen erfordern das Rinkel-Expert-Abonnement."
Prüfen, ob es funktioniert
Führen Sie ein Testgespräch und legen Sie auf. Innerhalb weniger Minuten sollte das Gespräch in Ihrer Gespräche-Übersicht stehen. Auf der Connectorkarte sehen Sie außerdem, wann das letzte Gespräch eingegangen ist; das ist der schnellste Weg zu prüfen, ob die Verbindung noch lebt. Bleibt es aus, sehen Sie unter Wenn es nicht funktioniert (Rinkel) nach.
Den Schlüssel ersetzen oder das Token rotieren
Auf der Rinkel-Karte stehen zwei Schaltflächen mit unterschiedlichem Zweck:
- Ersetzen setzt einen neuen API-Schlüssel, etwa nachdem Sie ihn in Rinkel neu erzeugt haben. Die Webhook-URL bleibt gleich.
- Token rotieren erzeugt eine neue Webhook-URL. Tun Sie das, wenn Sie vermuten, dass die alte URL bei jemandem gelandet ist, der sie nicht haben sollte. Vergessen Sie nicht, die neue URL danach in Rinkel zu registrieren, sonst kommen keine Gespräche mehr an.
Wenn es nicht funktioniert (Rinkel)
Es kommen keine Gespräche an. Prüfen Sie in Rinkel, ob der Webhook noch registriert ist und ob die vier Ereignisse aktiviert sind. Testen Sie den Webhook erneut aus Rinkel heraus.
Gespräche kommen an, aber ohne Aufnahme. Dann ist die Gesprächsaufnahme in Rinkel für diese Nummer nicht aktiviert, oder der API-Schlüssel ist nicht mehr gültig. Prüfen Sie den Schlüssel mit der Test-Schaltfläche in Converdo.
Gespräche landen beim falschen Mitarbeiter oder bei niemandem. Converdo verknüpft über die Telefonnummer. Prüfen Sie unter Einstellungen → Mitarbeiter, ob die Nummer dieses Mitarbeiters stimmt und vollständig eingetragen ist.
GoHighLevel und Rinkel teilen sich dasselbe Webhook-Token. Rotieren Sie das Token, funktionieren beide URLs nicht mehr, bis Sie die neue URL an beiden Stellen erneut einfügen.
Voys
Voys sendet jedes Gespräch über einen Webhook an Converdo; Converdo holt die Aufnahme anschließend über die Voys-API ab und bewertet sie. Die Verbindung hat zwei Seiten: Einstellungen im Voys-Portal (die Converdo nicht sehen oder prüfen kann) und zwei Werte, die Sie auf die Voys-Karte auf der Connectoren-Seite übertragen.
Zuerst: im Voys-Portal
Fünf Einstellungen, in dieser Reihenfolge. Converdo kann nicht erkennen, ob sie gesetzt sind; lassen Sie eine aus, kommen still keine Gespräche oder keine Audioaufnahmen mehr an. Die Voys-Karte zeigt dieselben Punkte als Checkliste, mit den Fallstricken — halten Sie sie daneben.
- Erstellen Sie ein API-Token unter Persönliche Einstellungen → Benutzertokens, mit einem Konto, das Administrator ist und Aufnahmerechte hat. Dies ist der Schritt, der am häufigsten schiefgeht: Ein Token eines normalen Benutzers scheint zu funktionieren — Gespräche kommen an, die Verbindung meldet sich als aktiv — liefert aber keine Aufnahmen, und der Fehler, den Voys dann zurückgibt, ist nicht von „die Aufnahme ist noch nicht fertig" zu unterscheiden. Prüfen Sie die Rechte also, bevor Sie fortfahren.
- Schalten Sie die Gesprächsaufnahme global ein.
- Geben Sie dem Wählplan einen Aufnahmeschritt, eingestellt auf „bei Annahme starten".
- Schalten Sie die Aufnahme ausgehender Gespräche ein, pro VoIP-Konto. Sie ist standardmäßig aus, und nichts weist darauf hin.
- Richten Sie den Webhook unter Integration → Gesprächsbenachrichtigungen ein, mit der Webhook-URL oben auf der Voys-Karte. Achten Sie auf den Namen: Das ist das kostenlose Modul Gesprächsbenachrichtigungen. Das kostenpflichtige Produkt namens „Webhooks" ist etwas anderes (ein Wählplan-Schritt) und funktioniert hier nicht.
Dann: zwei Werte auf die Karte übertragen
- Client-UUID, aus Persönliche Einstellungen → Benutzertokens. Das ist kein Passwort — sie identifiziert nur, welche Voys-Umgebung zu diesem Konto gehört.
- Numerische Client-ID, aus der Adressleiste des Voys-Portals:
/client/<Nummer>/…, meist sechs Ziffern. Das ist nicht Ihre Handelsregisternummer und nicht die Client-UUID oben. Converdo nutzt sie, um die Liste der VoIP-Konten abzurufen.
Die Reihenfolge auf der Karte ist fest: Das API-Token legt die Verbindung an, die Client-UUID lässt sich also erst danach speichern. Tragen Sie die UUID zuerst ein, bittet die Karte Sie, zuerst das Token zu speichern.
Testen und Mitarbeiter verknüpfen
Klicken Sie auf der Karte auf Verbindung testen. Der Test sagt Ihnen, ob Token und Umgebung zusammenpassen und ob VoIP-Konten gefunden wurden; ein Rechteproblem oder eine falsche Client-ID bekommt dort eine eigene Meldung.
Wählen Sie danach für jeden Mitarbeiter die Nebenstellennummer unter Einstellungen → Mitarbeiter. Übernehmen Sie die Nummer des VoIP-Kontos (meist die 2xx-Reihe: die Nebenstellen), nicht die Benutzernummer (meist 6xx). Wählen Sie die falsche, gibt es keine Fehlermeldung — Gespräche werden dann still dem falschen oder gar keinem Mitarbeiter zugeordnet.
Was Sie danach erwarten dürfen
Ein Gespräch erscheint erst nach dem Ende in Ihrer Gespräche-Übersicht, nicht schon während des Telefonats: Voys meldet das Gespräch, sobald es abgeschlossen ist; danach holt Converdo die Aufnahme ab und bewertet sie.
Wenn es nicht funktioniert (Voys)
- Gespräche kommen an, aber ohne Aufnahme. Fast immer die Rechte des Token-Inhabers (Schritt 1) oder eine der Aufnahme-Einstellungen aus den Schritten 2-4. Erstellen Sie bei Bedarf ein neues Token unter einem Administrator mit Aufnahmerechten und ersetzen Sie es auf der Karte.
- Es kommt nichts an. Prüfen Sie den Webhook unter Integration → Gesprächsbenachrichtigungen, einschließlich des letzten Teils der URL — das ist Ihr persönliches Token und je Kunde verschieden.
- Die Client-UUID wird nicht akzeptiert. Es muss die vollständige UUID sein (vier Bindestriche), ohne Leerzeichen davor oder dahinter.
- Die Mitarbeiterliste aus Voys bleibt leer. Prüfen Sie die numerische Client-ID auf der Karte; für die Aufnahmen selbst wird diese ID nicht benötigt.
Routung in eine Abteilung (optional)
Unter Standardabteilung richten Sie ein Sicherheitsnetz ein: „Gespräche dieses Connectors, deren Mitarbeiter keine Abteilung ergibt, landen in dieser Abteilung. Leer gelassen gehen sie in die Triage."
Nach dem Verbinden
Sobald ein Gespräch eingeht, ruft Converdo die Aufnahme ab, transkribiert und bewertet sie. Sorgen Sie dafür, dass jeder Mitarbeiter als Teammitglied mit einer Funktionsrolle am Team hängt: Ohne diese Verknüpfung bleibt ein Gespräch auf Wartet auf Zuweisung (der Bildschirm Klärung nötig). Siehe Wie Converdo Ihre Gespräche bewertet.