Um die Verimor-Telefonie in Mavibot zu nutzen, müssen Sie einen API-Schlüssel aus Ihrem Verimor-Konto abrufen und ihn in den Integrationseinstellungen eingeben.

Verimor ist ein türkischer Telekommunikationsanbieter. Sein Produkt Bulut Santralim ist eine Cloud-Telefonanlage: Mitarbeiter arbeiten mit internen Durchwahlen, und Anrufe werden über diese Durchwahlen geleitet.

Der Bot kann einen Mitarbeiter mit einem Kunden verbinden, Anrufe durchstellen und beenden, Aufzeichnungen abrufen und Anrufereignisse an den Chat senden.

Erforderliche Daten abrufen

  1. Aktivieren Sie den Dienst Bulut Santralim bei Verimor und erstellen Sie interne Durchwahlen für Ihre Mitarbeiter.
  2. Öffnen Sie Online İşlem Merkezi → Bulut Santralim → Santral Ayarlarım und kopieren Sie den API-Schlüssel. Er sieht wie folgt aus:
K12345678-1234-5678-4321-123456789012
  1. Notieren Sie die internen Durchwahlen der Mitarbeiter. Sie müssen diese in den Zugriffseinstellungen angeben.

Der API-Schlüssel gilt für die gesamte Telefonanlage und wird sowohl für Anrufe als auch für den Empfang von Ereignissen verwendet. Wenn Sie ihn im Verimor-Dashboard neu generieren, speichern Sie das Verbindungsformular erneut. Andernfalls funktionieren sowohl Anrufe als auch Chat-Ereignisse nicht mehr.

Verbindung

Wählen Sie im Telefonie-Tab Verimor aus und geben Sie Folgendes ein:

  • API-Schlüssel — der Schlüssel aus dem Abschnitt Santral Ayarlarım.
  • Ausgehende Rufnummer — die externe Nummer, die der Kunde sieht, im Format 908505320000. Dieses Feld ist optional. Wenn es leer bleibt, wird die Nummer verwendet, die der internen Durchwahl des Mitarbeiters zugewiesen ist.

Die Integration ist nun verbunden.

Um die Integration zu trennen, leeren Sie das Feld API-Schlüssel und speichern Sie die Einstellungen.

Sie müssen die Benachrichtigungs-URL nicht manuell konfigurieren. Mavibot setzt sie automatisch in Ihrer Telefonanlage, wenn der API-Schlüssel gespeichert wird.

Mitarbeiter

Geben Sie in den Mitarbeitereinstellungen die interne Durchwahl (dahili) des Mitarbeiters ein — normalerweise 3–4 Ziffern, z. B. 1001.

Geben Sie die interne Telefonanlagen-Durchwahl ein, nicht die Mobilfunknummer des Mitarbeiters. Ohne diese funktioniert die Anrufschaltfläche in der Kundenkarte für diesen Mitarbeiter nicht.

Anruf von der Kundenkarte

Neben der Telefonnummer des Kunden in der Chat-Karte erscheint eine Anrufschaltfläche.

Die Telefonanlage ruft zuerst die interne Durchwahl des Mitarbeiters an. Erst nachdem der Mitarbeiter abhebt, wird der Kunde angerufen.

Diese Reihenfolge ist beabsichtigt: Der Kunde hört keine Stille in der Leitung, da der Mitarbeiter bereits verbunden ist, wenn das Telefon des Kunden zu klingeln beginnt.

Rechnerfunktionen

Mitarbeiter-zu-Kunde-Anruf

verimor_employee_call(client_phone, employee_extension, caller_id)

Parameter:

  • client_phone — die Telefonnummer des Kunden. Erforderlich. Verwenden Sie das türkische Format 908505320000 oder 00493027590915 für internationale Anrufe.
  • employee_extension — die interne Durchwahl des Mitarbeiters, dessen Telefon klingeln soll. Erforderlich.
  • caller_id — die Nummer, die der Kunde sieht. Optional. Wenn nicht angegeben, wird die ausgehende Nummer aus den Verbindungseinstellungen verwendet.

Die Funktion gibt call_uuid zurück — die Anrufkennung. Sie wird auch in der Variablen verimor_call_uuid gespeichert.

Anruf durchstellen

verimor_transfer_call(employee_extension, call_uuid)

Stellt den aktuellen Anruf an eine andere interne Durchwahl durch.

Parameter:

  • employee_extension — die interne Durchwahl, an die der Anruf durchgestellt wird. Erforderlich.
  • call_uuid — die Anrufkennung. Optional. Wenn nicht angegeben, wird der letzte Anruf des Kunden verwendet.

Anruf beenden

verimor_hangup_call(call_uuid)

Parameter:

  • call_uuid — die Anrufkennung. Optional. Wenn nicht angegeben, wird der letzte Anruf des Kunden verwendet.
verimor_get_record_link(call_uuid)

Fordert einen neuen Link zur Anrufaufzeichnung an.

Parameter:

  • call_uuid — die Anrufkennung. Optional. Wenn nicht angegeben, wird der letzte Anruf des Kunden verwendet.

Rückmeldungen während eines Anrufs

Während des Anrufs werden Rückmeldungen im folgenden Format an den Chat gesendet:

verimor_call_event answer

Mögliche Ereignisse:

Ereignis Wann es ausgelöst wird
ringing Der Anruf klingelt
answer Der Anruf wurde angenommen
hangup Der Anruf wurde beendet
user_hangup Der Mitarbeiter hat den Anruf beendet

Anrufe zwischen Mitarbeitern erscheinen nicht im Chat.

Ein typisches Szenario "keine Antwort → Nachricht im Messenger senden" kann durch hangup und die Überprüfung der Variablen verimor_call_answered ausgelöst werden.

Kundenvariablen nach einem Anruf

Variable Wert
verimor_call_uuid Anrufkennung
verimor_call_direction Richtung: inbound — der Kunde ruft Sie an, outbound — Sie rufen den Kunden an
verimor_call_extension Interne Durchwahl des Mitarbeiters, der den Anruf bearbeitet hat
verimor_call_duration Anrufdauer in Sekunden
verimor_call_answered 1 — der Anruf wurde angenommen, 0 — er wurde nicht angenommen
verimor_hangup_cause Code, der angibt, warum der Anruf beendet wurde
verimor_has_record 1 — eine Aufzeichnung existiert, 0 — keine Aufzeichnung existiert
verimor_record_link Link zur Anrufaufzeichnung nach dem Aufruf von verimor_get_record_link()

Codes für Anrufbeendigungsgründe

Die häufigsten Werte von verimor_hangup_cause sind:

Code Bedeutung
NORMAL_CLEARING Der Anruf wurde abgeschlossen und normal beendet
USER_BUSY Besetzt
NO_ANSWER Keine Antwort
ORIGINATOR_CANCEL Der Anrufer hat aufgelegt, bevor der Anruf angenommen wurde
CALL_REJECTED Der Anruf wurde abgelehnt
UNALLOCATED_NUMBER Ungültige Nummer
NO_USER_RESPONSE Der Teilnehmer ist nicht erreichbar
NOT_ALLOWED_BY_IYS Keine Berechtigung in İYS, dem türkischen Einwilligungsregister für kommerzielle Anrufe

Anrufaufzeichnungen

Die Anrufaufzeichnung muss in Ihren Verimor-Telefonanlageneinstellungen aktiviert sein. Aufzeichnungen werden in Ihrem Verimor-Konto gespeichert.

⏳ Aufzeichnungslinks bleiben 60 Minuten lang gültig ab dem Zeitpunkt der Anforderung. Danach funktionieren sie nicht mehr. Verimor erlaubt außerdem nicht mehr als fünf Aufzeichnungslink-Anfragen pro Minute pro API-Schlüssel.

Was das bedeutet:

  • Die Variable verimor_record_link wird nicht automatisch befüllt. Sie müssen zuerst verimor_get_record_link() aufrufen.
  • Rufen Sie in einem Szenario, das eine Aufzeichnung sendet, verimor_get_record_link() zum Zeitpunkt des Sendens der Aufzeichnung auf, nicht im Voraus.
  • Prüfen Sie zuerst verimor_has_record, um das Anfragelimit nicht für Anrufe ohne Aufzeichnung zu verschwenden.
  • Wenn Sie eine Aufzeichnung dauerhaft speichern möchten, speichern Sie die Datei sofort nach dem Anruf in Ihrem eigenen Speicher.
  • Das Aufzeichnungsarchiv bleibt im Verimor-Dashboard verfügbar, wo Aufzeichnungen später abgespielt und heruntergeladen werden können.

Die Anrufaufzeichnung ist gesetzlich geregelt. In der Türkei unterliegt sie den KVKK-Anforderungen: Der Kunde muss über die Aufzeichnung informiert werden, und die Speicherung personenbezogener Daten muss eine rechtliche Grundlage haben. Der Inhaber des Verimor-Kontos ist für die Einhaltung der geltenden Anforderungen verantwortlich.

Fehlerbehebung

Fehler Ursache / Lösung
Gecersiz anahtar Ungültiger API-Schlüssel. Holen Sie den aktuellen Schlüssel aus dem Abschnitt Santral Ayarlarım.
extension 1005 not found Die interne Durchwahl existiert nicht in Ihrer Telefonanlage. Stellen Sie sicher, dass die Mitarbeitereinstellungen eine vorhandene dahili enthalten.
"Verimor interne Durchwahl ist nicht angegeben" Die Mitarbeitereinstellungen sind leer oder enthalten eine Mobilfunknummer anstelle einer internen Durchwahl.
Anrufe funktionieren, aber keine Rückmeldungen erscheinen im Chat Die Benachrichtigungs-URL wurde nicht konfiguriert. Speichern Sie das Verbindungsformular erneut.
Anrufe funktionieren nach Änderung des API-Schlüssels nicht mehr Der Schlüssel wurde im Verimor-Dashboard neu generiert. Geben Sie den neuen Schlüssel im Verbindungsformular ein und speichern Sie es.
Aufzeichnungslink öffnet nicht Der Link ist abgelaufen. Fordern Sie einen neuen mit verimor_get_record_link() an oder öffnen Sie die Aufzeichnung im Verimor-Dashboard.
Aufzeichnungslink wird nicht zurückgegeben Das Limit von fünf Anfragen pro Minute wurde erreicht, oder der Anruf hat keine Aufzeichnung. Prüfen Sie verimor_has_record.