Um VoIPstudio-Telefonie in Mavibot zu nutzen, müssen Sie in Ihrem VoIPstudio-Konto einen API-Schlüssel erstellen, ihn in den Integrationseinstellungen eingeben und die Ereigniszustellung an die URL konfigurieren, die Mavibot nach dem Verbinden der Integration anzeigt.

VoIPstudio ist eine Cloud-TK-Anlage mit Telefonnummern in über 70 Ländern. Im Gegensatz zu einem traditionellen Telekommunikationsanbieter unterstützt es interne Benutzer, Rufgruppen, Warteschlangen und IVR-Menüs, während der Bot auf dieser TK-Anlage arbeitet.

Der Bot kann Anrufe an Kunden im Namen von Mitarbeitern initiieren, Anrufe durchstellen und beenden, Aufzeichnungen speichern und Anrufereignisse an die Konversation senden.

Abrufen der erforderlichen Informationen

  1. Registrieren Sie sich bei voipstudio.com und kaufen Sie eine Telefonnummer im gewünschten Land.
  2. Erstellen Sie Benutzer in der TK-Anlage – einen für jeden Mitarbeiter, der Anrufe empfangen soll. Anrufe werden an alle Geräte zugestellt, die einem Benutzer zugeordnet sind. Sie müssen also keine separate Telefonnummer für jeden Mitarbeiter angeben.
  3. Gehen Sie zu Einstellungen → API, erstellen Sie einen API-Schlüssel und kopieren Sie ihn.

Verbinden der Integration

Wählen Sie in den Telefonieeinstellungen VoIPstudio aus und geben Sie Folgendes ein:

  • API-Schlüssel – den Schlüssel aus Ihrem VoIPstudio-Konto.

Die Integration ist jetzt verbunden. Zum Trennen leeren Sie das Feld API-Schlüssel und speichern die Einstellungen.

Nach dem Speichern erscheint auf der Seite eine Benachrichtigungs-URL. Kopieren Sie sie:

https://chatter.mavibot.ai/voipstudio_webhook/

Veröffentlichen Sie diese URL nicht und teilen Sie sie mit niemandem. Wenn Sie die Integration trennen und wieder verbinden, bleibt der Schlüssel derselbe, sodass Sie die Benachrichtigungen nicht erneut konfigurieren müssen.

Gehen Sie dann in Ihrem VoIPstudio-Konto zu Integrationen → Webhooks → Aktivieren → Webhook hinzufügen, fügen Sie die kopierte URL ein und wählen Sie die folgenden Ereignisse aus:

  • Anrufstatusänderung – oder wählen Sie einzeln Anruf klingelt, Anruf verbunden, Anruf beendet und Anruf verpasst;
  • Anrufaufzeichnung bereit – falls Sie Anrufaufzeichnungen benötigen.

Ohne diese Konfiguration funktionieren ausgehende Anrufe weiterhin, aber Anrufereignisse erscheinen nicht in der Konversation.

Mitarbeiter

Füllen Sie in den Mitarbeitereinstellungen das Feld VoIPstudio-Benutzer-ID aus – die numerische Kennung des Benutzers in Ihrer TK-Anlage, z. B. 10002.

Geben Sie die Benutzer-ID der TK-Anlage ein, nicht eine Telefonnummer. Sie finden die ID in der Benutzerliste in Ihrem VoIPstudio-Konto. Ohne sie funktioniert die Anrufschaltfläche in der Kundenkarte für diesen Mitarbeiter nicht.

Anrufen über die Kundenkarte

Neben der Telefonnummer des Kunden in der Konversationskarte erscheint eine Anrufschaltfläche.

VoIPstudio ruft zuerst den Mitarbeiter auf allen seinen registrierten Geräten gleichzeitig an. Sobald der Mitarbeiter antwortet, ruft VoIPstudio den Kunden an und verbindet die beiden Parteien.

Wenn der Mitarbeiter nicht antwortet, wird der Kunde nicht angerufen.

Rechnerfunktionen

Mitarbeiter-zu-Kunde-Anruf

voipstudio_employee_call(client_phone, employee_user_id, caller_id)

Parameter:

  • client_phone – die Telefonnummer des Kunden. Erforderlich.
  • employee_user_id – die VoIPstudio-Benutzer-ID des Mitarbeiters, der den ersten Anruf erhalten soll. Erforderlich.
  • caller_id – die Telefonnummer, die dem Kunden angezeigt wird. Optional. Sie können anonymous übergeben, um die Anruferkennung zu verbergen.

Anruf durchstellen

voipstudio_transfer_call(phone, call_id)

Stellt einen aktiven Anruf an eine andere Telefonnummer durch.

Parameter:

  • phone – die Telefonnummer, an die der Anruf durchgestellt werden soll. Erforderlich und muss der erste Parameter sein.
  • call_id – die Anrufkennung. Optional. Wenn sie weggelassen wird, wird der aktuelle Anruf des Kunden aus der Variable voipstudio_call_id übernommen.

Anruf beenden

voipstudio_hangup_call(call_id)

Beendet einen aktiven Anruf.

Parameter:

  • call_id – die Anrufkennung. Optional. Wenn sie weggelassen wird, wird der aktuelle Anruf des Kunden verwendet.

voipstudio_get_record_link(call_id)

Gibt einen Link zur Anrufaufzeichnung zurück. Der Link wird normalerweise automatisch gespeichert, wenn das Ereignis "Aufzeichnung bereit" empfangen wird. Diese Funktion ist nützlich, wenn dieses Ereignis nicht empfangen wurde.

Parameter:

  • call_id – die Anrufkennung. Optional. Wenn sie weggelassen wird, wird der aktuelle Anruf des Kunden verwendet.

Die Funktion durchsucht die 100 neuesten Aufzeichnungen im Konto. Bei einem älteren Anruf auf einer stark ausgelasteten TK-Anlage kann es sein, dass die Aufzeichnung nicht gefunden wird. In diesem Fall rufen Sie die Aufzeichnung direkt aus Ihrem VoIPstudio-Konto ab.

Rückrufe während eines Anrufs

Während des Anrufverlaufs werden Rückrufe im folgenden Format an die Konversation gesendet:

voipstudio_call_event call.hangup

Der Ereignisname wird genau so übergeben, wie er von VoIPstudio empfangen wurde, z. B. call.ringing, call.connected, call.hangup und andere. Die verfügbaren Ereignisse hängen davon ab, welche Ereignisse Sie bei der Konfiguration der Benachrichtigungen ausgewählt haben.

Wenn kein Ereignisname angegeben ist, wird stattdessen der Anrufstatus verwendet:

INITIAL, RINGING, CONNECTED, ON_HOLD, HANGUP.

Ein separater Rückruf wird gesendet, wenn die Aufzeichnung bereit ist:

voipstudio_call_event recording

Warten Sie auf den recording-Rückruf, bevor Sie den Aufzeichnungslink verwenden. Die Aufzeichnung wird nach dem Ende des Anrufs verarbeitet, daher ist die Variable voipstudio_record_link beim Empfang von call.hangup noch leer.

Wenn zwei Mitarbeiter innerhalb Ihrer eigenen TK-Anlage miteinander sprechen, werden keine Rückrufe an die Konversation gesendet und keine Kundenkarte erstellt.

Kundenvariablen nach einem Anruf

Variable Wert
voipstudio_call_id Anruf-ID in VoIPstudio
voipstudio_call_state Anrufstatus: INITIAL, RINGING, CONNECTED, ON_HOLD, HANGUP
voipstudio_call_duration Anrufdauer in Sekunden
voipstudio_call_cause Grund für das Ende des Anrufs
voipstudio_terminated_by Wer den Anruf beendet hat: caller oder callee
voipstudio_record_link Link zur Anrufaufzeichnung
voipstudio_record_id Aufzeichnungs-ID in VoIPstudio

Anrufaufzeichnungen

Die Anrufaufzeichnung wird in den VoIPstudio-Einstellungen aktiviert und von der TK-Anlage selbst verwaltet. Wenn Sie Aufzeichnungen benötigen, aktivieren Sie die Anrufaufzeichnung in Ihrem VoIPstudio-Konto und wählen Sie das Ereignis Anrufaufzeichnung bereit bei der Konfiguration der Benachrichtigungen aus.

Die voipstudio_record_link-URL ist durch einen Zugriffsschlüssel geschützt. Sie kann nicht direkt in einem Browser geöffnet oder mit einem Kunden geteilt werden. Sie können die Aufzeichnung aus Ihrem VoIPstudio-Konto im Bereich Anrufverlauf herunterladen.

Die Anrufaufzeichnung unterliegt den geltenden Gesetzen. In Deutschland, Frankreich, Spanien und den meisten US-Bundesstaaten kann die Zustimmung beider Parteien erforderlich sein, und in einigen Rechtsgebieten kann auch ein gesprochener Hinweis zu Beginn des Anrufs notwendig sein. Der Inhaber des VoIPstudio-Kontos ist für die Einhaltung dieser Anforderungen verantwortlich.

Fehlerbehebung

Fehler Ursache
Autorisierungsfehler beim Erstellen eines Anrufs Der API-Schlüssel ist falsch oder abgelaufen. Stellen Sie sicher, dass der Schlüssel unter Einstellungen → API erstellt wurde und nicht über eine login-Anfrage erhalten wurde.
Anrufe funktionieren, aber keine Rückrufe erscheinen in der Konversation In VoIPstudio wurde kein Webhook erstellt, der Aktivieren-Schalter ist aus oder die falsche URL wurde eingegeben. Kopieren Sie die gesamte URL von der Integrationsseite, einschließlich des Schlüssels am Ende.
Der Anruf kann nicht erstellt werden oder die Geräte des Mitarbeiters klingeln nicht Es wurde eine Telefonnummer anstelle der VoIPstudio-Benutzer-ID eingegeben, oder der Benutzer hat keine registrierten Geräte.
Der recording-Rückruf wird nicht empfangen Die Anrufaufzeichnung ist in VoIPstudio nicht aktiviert, oder das Ereignis Anrufaufzeichnung bereit wurde nicht ausgewählt.

VoIPstudio wird direkt von VoIPstudio abgerechnet: Es gibt eine Abonnementgebühr für jeden TK-Benutzer sowie Anrufgebühren. Dies unterscheidet sich von Anbietern, die pro Minute ohne wiederkehrendes Abonnement abrechnen. Berücksichtigen Sie bei der Kostenschätzung die Anzahl der konfigurierten Benutzer, nicht nur das Anrufvolumen.