Voys Telefonie

Mit der Voys-Integration sieht Tillor, wer anruft, und zeigt sofort die Kundendaten an. Anrufe, Aufnahmen und Transkriptionen landen anschließend unter Telefonanrufe. Voys ist ein Telefonanbieter für Unternehmen.

Bevor Sie beginnen:

• Sie benötigen ein aktives Voys-VoIP-Konto und Zugriff auf die Einstellungen des Anrufplans in Voys.
• Sie benötigen die Berechtigung Integrationen verwalten.
• Die Telefonnummer des Anrufers muss im Kundenprofil oder bei einer Kontaktperson stehen, sonst verknüpft Tillor den Anruf nicht mit einem Kunden.

Voys einrichtenLink zu diesem Abschnitt kopieren

1. Gehen Sie zu Einstellungen (Seitenleiste unter Support)

2. Wählen Sie Integrationen und öffnen Sie Voys in der Liste
3. Tragen Sie auf der Detailseite Ihre Voys-Zugangsdaten ein (username, password, client_uuid, token) und klicken Sie auf Installieren

Sie benötigen ein aktives Voys-VoIP-Konto.

URLs für Voys wiederfindenLink zu diesem Abschnitt kopieren

Tillor und Voys kommunizieren über Adressen (URLs). Bei manchen Schritten erwartet Voys eine Antwort von Tillor, zum Beispiel ob Sie geöffnet haben. Diese Antwort lautet ACK (ja, weiter) oder NAK (nein, den anderen Pfad nehmen). Ein Webhook ist eine Adresse, die Voys während eines Anrufs aufruft.

Für Webhooks, Anrufernamen-Suche und Zugangscodes verwenden Sie die URLs, die Tillor für Sie erzeugt.

1. Gehen Sie zu Einstellungen > Integrationen und öffnen Sie Voys
2. Nach der Installation steht auf der Detailseite unter Einstellungen der Block Zu konfigurierende URLs - kopieren Sie dort die passende URL für den jeweiligen Zweck

Unter anderem finden Sie hier:

• Gesprächsbenachrichtigungen - Webhook-URL für Anrufereignisse
• Webhook für Anrufer-Suche - URL für die Anrufernamen-Suche (Caller Name Lookup) in Ihrem Voys-Anrufplan
• XML-Telefonbuch - URL, über die VoIP-Telefone das Telefonbuch abrufen
• Zugangscodes - URL zur Bedienung des Zugangspunkts (Schranke, Tor oder Tür) über den Anrufplan
• Webhook für Öffnungszeiten - ACK, wenn Tillor geöffnet ist, NAK, wenn Tillor geschlossen ist
• Webhook Anrufer erlaubt - ACK, wenn der Anrufer durchgestellt werden darf, NAK, wenn der Anrufer auf die Mailbox soll
• Routing-Webhook - ACK mit einem Ziel, NAK, wenn kein Ziel eingestellt ist

Verwenden Sie im Voys-Anrufplan dieselben Variablen, die in Tillor angegeben sind (wie {callerid}, {did}, {callername}, {callid} und {code}).

Gesprächsbenachrichtigungen in Voys konfigurierenLink zu diesem Abschnitt kopieren

1. Öffnen Sie in Voys das Modul Gesprächsbenachrichtigungen
2. Klicken Sie auf Hinzufügen
3. Wählen Sie bei Paket/Service die Option Benutzerdefiniert
4. Fügen Sie die Tillor-URL aus Gesprächsbenachrichtigungen ein
5. Speichern Sie

Voys-Dokumentation:

• Gesprächsbenachrichtigungen

Anrufernamen (Caller Lookup) im Anrufplan konfigurierenLink zu diesem Abschnitt kopieren

Für die Anrufernamen-Suche verwenden Sie in Voys einen Webhook-Schritt im Anrufplan.

1. Öffnen Sie in Tillor die URL Webhook für Anrufer-Suche (unter Einstellungen > Integrationen > Voys, bei Zu konfigurierende URLs) und kopieren Sie diese URL
2. Öffnen Sie in Voys das Modul Webhooks und legen Sie einen Webhook mit dieser URL-Vorlage an
3. Aktivieren Sie diesen Webhook über den Webhook-Schritt in Ihrem Anrufplan
4. Verwenden Sie in der URL-Vorlage die Variablen, die Voys unterstützt ({callerid}, {did}, {callername} und bei Bedarf {code})
5. Stellen Sie im Webhook-Routing Variabele bellernaam ein, damit der zurückgegebene Name auf den Geräten angezeigt wird

Die Webhooks für Öffnungszeiten und Routing führen keine Anrufernamen-Suche durch. Verwenden Sie dafür diesen separaten Schritt.

Mehr Hintergrund:

• Webhooks
• Was sind Gesprächsbenachrichtigungen (Unterschied zu Webhooks)

Öffnungszeiten und Ziele im AnrufplanLink zu diesem Abschnitt kopieren

Tillor ist die Quelle für Öffnungszeiten, Urlaubszeiten und Feiertagsausnahmen. Voys muss diesen Kalender nicht mehr selbst kennen.

1. Wählen Sie unter Einstellungen > Integrationen > Voys das Voys-Gerät für geöffnet und optional für geschlossen
2. Kopieren Sie Webhook für Öffnungszeiten oder Routing-Webhook aus Zu konfigurierende URLs
3. Legen Sie in Voys einen Webhook mit dieser URL-Vorlage an
4. Setzen Sie diesen Webhook als Schritt in den Anrufplan, oberhalb etwaiger Auswahlmenüs
5. Lassen Sie Menu gebruiken ausgeschaltet

Zwei Muster:

• Webhook für Öffnungszeiten - status=ACK folgt dem Pfad HTTP und Menü erfolgreich (geöffnet), status=NAK folgt HTTP oder Menü fehlgeschlagen (geschlossen). Ist ein Ziel für geöffnet eingestellt, steht es bei ACK als destination dabei.
• Routing-Webhook - Tillor wählt das Ziel. Setzen Sie im erfolgreichen Schritt Variabele eindbestemming. ACK + destination, wenn es ein Ziel gibt, sonst NAK.

Bei einem Fehler oder Timeout nimmt Voys den fehlgeschlagenen Pfad. Behandeln Sie das wie geschlossen.

Voys-Dokumentation: Webhooks.

Anrufer automatisch auf die Mailbox leitenLink zu diesem Abschnitt kopieren

Mit dem Webhook Anrufer erlaubt lassen Sie Voys pro Anrufer entscheiden, ob ein Anruf durchgestellt wird. Tillor prüft, ob die Nummer des Anrufers zu einem Kunden gehört, bei dem die automatische Mailbox aktiviert ist.

Richten Sie zuerst den Anrufplan ein:

1. Kopieren Sie Webhook Anrufer erlaubt aus Zu konfigurierende URLs unter Einstellungen > Integrationen > Voys
2. Legen Sie in Voys einen Webhook mit dieser URL-Vorlage an
3. Setzen Sie diesen Webhook als Schritt in den Anrufplan, oberhalb der Schritte, die den Anruf durchstellen
4. Lassen Sie Menu gebruiken ausgeschaltet
5. Leiten Sie den Pfad HTTP und Menü erfolgreich an Ihr normales Routing weiter und den Pfad HTTP oder Menü fehlgeschlagen an die Mailbox
6. Aktivieren Sie unter Einstellungen > Integrationen > Voys bei Anrufweiterleitung die Option Automatische Mailbox in Voys

Solange diese Option ausgeschaltet ist, sehen Sie Anrufe an die Mailbox weiterleiten nicht im Kundenprofil.

Aktivieren Sie die automatische Mailbox anschließend pro Kunde:

1. Öffnen Sie das Kundenprofil und gehen Sie zum Tab Kommunikation
2. Aktivieren Sie in den Kommunikationseinstellungen die Option Anrufe an die Mailbox weiterleiten
3. Klicken Sie auf Speichern

So funktioniert die Antwort:

• ACK - der Anrufer darf durch. Das gilt auch für unbekannte Nummern und für Anrufer mit unterdrückter Nummer.
• NAK - die Nummer gehört zu einem Kunden mit automatischer Mailbox. Voys folgt dem fehlgeschlagenen Pfad.

Tillor vergleicht die Nummer des Anrufers mit der Telefonnummer im Kundenprofil, unabhängig von Leerzeichen oder der Schreibweise der Landesvorwahl. Telefonnummern von Kontaktpersonen zählen nicht.

Dieser Webhook berücksichtigt keine Öffnungszeiten. Kombinieren Sie ihn mit dem Webhook für Öffnungszeiten oder dem Routing-Webhook, indem Sie beide als getrennte Schritte in den Anrufplan setzen.

Voys-Dokumentation: Webhooks.

Feste Weiterleitung pro AnruferLink zu diesem Abschnitt kopieren

Derselbe Routing-Webhook kann einen Anrufer sofort an ein eigenes Voys-Gerät, eine Durchwahl oder eine Telefonnummer weiterleiten. Das gilt nur für Kunden, für die Sie ein Ziel gewählt haben, und nur, wenn Feste Anrufweiterleitung in Voys aktiviert ist.

1. Setzen Sie den Routing-Webhook in den Anrufplan, wie bei den Öffnungszeiten
2. Setzen Sie im erfolgreichen Schritt Variabele eindbestemming
3. Aktivieren Sie unter Einstellungen > Integrationen > Voys bei Anrufweiterleitung die Option Feste Anrufweiterleitung in Voys

Solange diese Option ausgeschaltet ist, sehen Sie Feste Anrufweiterleitung nicht im Kundenprofil. Der Webhook verwendet dann nur das Gerät für geöffnet oder geschlossen.

Stellen Sie das Ziel anschließend pro Kunde ein:

1. Öffnen Sie das Kundenprofil und gehen Sie zum Tab Kommunikation
2. Wählen Sie bei Feste Anrufweiterleitung ein Voys-Gerät oder Andere für eine Telefonnummer oder Durchwahl (zum Beispiel 411)
3. Wählen Sie Keine, um die feste Weiterleitung auszuschalten
4. Klicken Sie auf Speichern

So wählt der Routing-Webhook das Ziel:

• Gibt es für diesen Anrufer ein festes Ziel, ist das die destination.
• Sonst ist destination das Voys-Gerät für geöffnet oder geschlossen.
• NAK - es gibt kein festes Ziel und auch kein Gerät für den aktuellen Zustand. Das gilt auch für unbekannte Nummern und für Anrufer mit unterdrückter Nummer, solange es kein Gerät für geöffnet oder geschlossen gibt.

Tillor vergleicht die Nummer des Anrufers mit der Telefonnummer im Kundenprofil, unabhängig von Leerzeichen oder der Schreibweise der Landesvorwahl. Telefonnummern von Kontaktpersonen zählen nicht.

Bei einem Fehler oder Timeout nimmt Voys den fehlgeschlagenen Pfad.

Voys-Dokumentation: Webhooks.

Was passiert danach?Link zu diesem Abschnitt kopieren

• Jeder eingehende oder ausgehende Anruf steht unter KommunikationTelefonanrufe, mit dem Kunden dabei, wenn die Nummer übereinstimmt. Siehe Telefonanrufe.
• Bei einem eingehenden Anruf erscheint der Anrufer als Karte unten rechts in Tillor, mit den Kundendaten dabei.
• Aufnahmen und Transkriptionen kommen mit, sobald der Anruf beendet ist, wenn Gesprächsaufnahmen in Ihrem Voys-Konto aktiviert sind.

Probleme?Link zu diesem Abschnitt kopieren

Siehe auchLink zu diesem Abschnitt kopieren