Voys Telefonie

Met de Voys-integratie koppelt Tillor telefoongesprekken aan klantprofielen en synchroniseert gespreksgegevens, opnames en transcripties. Zo zie je direct wie belt en heb je klantgegevens bij de hand.

Voys instellenLink naar deze sectie kopiëren

1. Ga naar Instellingen (sidebar onder Ondersteuning)

2. Kies Integraties en open Voys in de lijst
3. Vul op de detailpagina je Voys-gegevens in (username, password, client_uuid, token) en klik op Installeren

Je hebt een actief Voys VoIP-account nodig.

URLs voor Voys terugvindenLink naar deze sectie kopiëren

Voor webhooks, bellernaam-lookup en toegangscodes gebruik je de URLs die Tillor voor je genereert.

1. Ga naar Instellingen > Integraties en open Voys
2. Na installatie staat onder Instellingen op de detailpagina het blok Te configureren URLs - kopieer daar de juiste URL per doel

Je vindt hier onder andere:

• Gespreksnotificaties - webhook-URL voor gesprekgebeurtenissen
• Webhook voor Beller Lookup - URL voor caller name lookup in je Voys call plan
• XML Phonebook - URL voor VoIP-telefoons om het telefoonboek op te halen
• Toegangscodes - URL voor bediening van de toegangspunt (slagboom, hek of deur) via call plan
• Openingsuren-webhook - ACK als Tillor open is, NAK als Tillor gesloten is
• Beller-toegestaan-webhook - ACK als de beller doorgezet mag worden, NAK als de beller naar voicemail moet
• Routering-webhook - ACK met een bestemming, NAK als er geen bestemming is ingesteld

Gebruik in Voys call plan dezelfde variabelen als in Tillor vermeld staan (zoals {callerid}, {did}, {callername}, {callid} en {code}).

Gespreksnotificaties in Voys configurerenLink naar deze sectie kopiëren

1. Open in Voys de module Gespreksnotificaties
2. Klik op Toevoegen
3. Kies bij package/service voor Aangepast
4. Plak de Tillor-URL uit Gespreksnotificaties
5. Sla op

Voys-documentatie:

• Gespreksnotificaties

Bellernamen (caller lookup) in call plan configurerenLink naar deze sectie kopiëren

Voor bellernaam-lookup gebruik je in Voys een webhook-stap in het belplan.

1. Open in Tillor de URL Webhook voor Beller Lookup (op Instellingen > Integraties > Voys, onder Te configureren URLs) en kopieer die URL
2. Open in Voys de module Webhooks en maak een webhook met deze URL-template
3. Activeer die webhook in je belplan via de webhook-stap
4. Gebruik in het URL-template de variabelen die Voys ondersteunt ({callerid}, {did}, {callername} en indien nodig {code})
5. Stel in de webhook-routering Variabele bellernaam in zodat de geretourneerde naam getoond wordt op toestellen

Openingsuren- en routering-webhooks doen geen bellernaam-lookup. Gebruik daarvoor deze aparte stap.

Meer achtergrond:

• Webhooks
• Wat zijn gespreksnotificaties (verschil met webhooks)

Openingsuren en bestemmingen in het belplanLink naar deze sectie kopiëren

Tillor is de bron voor openingsuren, vakanties en feestdag-uitzonderingen. Voys hoeft die kalender niet meer zelf te kennen.

1. Kies op Instellingen > Integraties > Voys het Voys-toestel voor open en optioneel voor gesloten
2. Kopieer Openingsuren-webhook of Routering-webhook uit Te configureren URLs
3. Maak in Voys een webhook met die URL-template
4. Zet die webhook als stap in het belplan, boven eventuele keuzemenu's
5. Laat Menu gebruiken uit

Twee patronen:

• Openingsuren-webhook - status=ACK volgt het pad HTTP en menu gelukt (open), status=NAK volgt HTTP of menu mislukt (gesloten). Als er een open bestemming is ingesteld, zit die bij ACK als destination.
• Routering-webhook - Tillor kiest de bestemming. Zet in de gelukte stap Variabele eindbestemming. ACK + destination als er een bestemming is, anders NAK.

Bij een fout of timeout neemt Voys het mislukte pad. Behandel dat als gesloten.

Voys-documentatie: Webhooks.

Bellers automatisch naar voicemail sturenLink naar deze sectie kopiëren

Met de Beller-toegestaan-webhook laat je Voys per beller beslissen of een gesprek wordt doorgezet. Tillor kijkt of het nummer van de beller hoort bij een klant die automatische voicemail heeft ingeschakeld.

Stel eerst het belplan in:

1. Kopieer Beller-toegestaan-webhook uit Te configureren URLs op Instellingen > Integraties > Voys
2. Maak in Voys een webhook met die URL-template
3. Zet die webhook als stap in het belplan, boven de stappen die het gesprek doorzetten
4. Laat Menu gebruiken uit
5. Stuur het pad HTTP en menu gelukt door naar je normale routering en het pad HTTP of menu mislukt naar de voicemail
6. Vink op Instellingen > Integraties > Voys, onder Gespreksroutering, Automatische voicemail in Voys aan

Zolang dat uit staat, zie je Gesprekken naar voicemail sturen niet op het klantprofiel.

Zet automatische voicemail daarna per klant aan:

1. Open het klantprofiel en ga naar het tabblad Communicatie
2. Vink in Communicatie-instellingen de optie Gesprekken naar voicemail sturen aan
3. Klik op Opslaan

Zo werkt het antwoord:

• ACK - de beller mag door. Dit geldt ook voor onbekende nummers en voor bellers met een verborgen nummer.
• NAK - het nummer hoort bij een klant met automatische voicemail. Voys volgt het mislukte pad.

Tillor vergelijkt het nummer van de beller met het telefoonnummer op het klantprofiel, ongeacht spaties of landcode-notatie. Telefoonnummers van contactpersonen tellen niet mee.

Deze webhook kijkt niet naar openingsuren. Combineer hem met de openingsuren- of routering-webhook door beide als aparte stappen in het belplan te zetten.

Voys-documentatie: Webhooks.

Vaste routering per bellerLink naar deze sectie kopiëren

Dezelfde Routering-webhook kan een beller meteen doorsturen naar een eigen Voys-toestel, toestelnummer of telefoonnummer. Dat geldt alleen voor klanten waarvoor je een bestemming hebt gekozen, en alleen als Vaste gespreksroutering in Voys aanstaat.

1. Zet de Routering-webhook in het belplan, zoals bij openingsuren
2. Zet in de gelukte stap Variabele eindbestemming
3. Vink op Instellingen > Integraties > Voys, onder Gespreksroutering, Vaste gespreksroutering in Voys aan

Zolang dat uit staat, zie je Vaste gespreksroutering niet op het klantprofiel. De webhook gebruikt dan alleen het toestel voor open of gesloten.

Stel de bestemming daarna per klant in:

1. Open het klantprofiel en ga naar het tabblad Communicatie
2. Kies bij Vaste gespreksroutering een Voys-toestel, of Andere voor een telefoonnummer of toestelnummer (bijvoorbeeld 411)
3. Kies Geen om de vaste routering uit te zetten
4. Klik op Opslaan

Zo kiest de routering-webhook de bestemming:

• Staat er voor deze beller een vaste bestemming, dan is dat destination.
• Anders is destination het Voys-toestel voor open of gesloten.
• NAK - er is geen vaste bestemming en ook geen toestel voor de huidige staat. Dit geldt ook voor onbekende nummers en voor bellers met een verborgen nummer, zolang er geen open of gesloten toestel is.

Tillor vergelijkt het nummer van de beller met het telefoonnummer op het klantprofiel, ongeacht spaties of landcode-notatie. Telefoonnummers van contactpersonen tellen niet mee.

Bij een fout of timeout neemt Voys het mislukte pad.

Voys-documentatie: Webhooks.

Gesprekken bekijkenLink naar deze sectie kopiëren

Ga naar Communicatie > Telefoongesprekken voor een overzicht van alle geregistreerde telefoongesprekken.

In de tabel Alle gesprekken zie je onder andere:

• Gestart op - datum en tijdstip
• Van / Naar - telefoonnummer (afhankelijk van richting)
• Duurtijd - lengte van het gesprek (na afloop)
• Klant - gekoppelde klant, of een door Voys doorgegeven naam (niet geverifieerd) als er geen match is

Als het nummer nog niet bij een klant hoort, voeg je het telefoonnummer toe aan het klantprofiel of aan een contact. Tillor koppelt daarna (nieuwe) gesprekken automatisch op basis van dat nummer.

GespreksopnamesLink naar deze sectie kopiëren

Als gespreksopnames zijn ingeschakeld in je Voys-account, kun je deze terugluisteren vanuit Tillor:

1. Ga naar Communicatie > Telefoongesprekken
2. Klik bij het gewenste gesprek op Transcriptie (opent Gespreksdetails)
3. Open het tabblad Opname - de opname wordt in de browser afgespeeld

GesprekstranscriptiesLink naar deze sectie kopiëren

Na afloop van een gesprek kan Tillor (indien er een opname beschikbaar is) automatisch een Transcriptie en een Samenvatting genereren. Klik op Transcriptie bij het gesprek en bekijk de tabbladen Transcriptie en Samenvatting.

Zie ookLink naar deze sectie kopiëren