Telefonie Voys
Asociați apelurile telefonice primite cu profilurile clienților prin integrarea Voys
Ultima actualizare la
Cu integrarea Voys, Tillor vede cine sună și afișează imediat datele clientului. Apelurile, înregistrările și transcrierile ajung apoi la Apeluri telefonice. Voys este un furnizor de telefonie pentru companii.
Înainte de a începe:
- Aveți nevoie de un cont Voys VoIP activ și de acces la setările planului de apel din Voys.
- Aveți nevoie de dreptul Gestionați integrările.
- Numărul de telefon al apelantului trebuie să fie trecut în profilul clientului sau la o persoană de contact, altfel Tillor nu asociază apelul cu un client.
Configurarea Voys
- Mergeți la Setări (în bara laterală, sub Asistență)
- Alegeți Integrări și deschideți Voys din listă
- Pe pagina de detalii, completați datele dumneavoastră Voys (
username,password,client_uuid,token) și faceți clic pe Instalați
Aveți nevoie de un cont Voys VoIP activ.
După instalare și configurare, Tillor asociază automat apelurile cu clienții când numărul de telefon corespunde unui client sau unui contact.
Găsirea URL-urilor pentru Voys
Tillor și Voys comunică între ele prin adrese (URL-uri). La unii pași, Voys cere un răspuns de la Tillor, de exemplu dacă sunteți deschis. Răspunsul este ACK (da, continuă) sau NAK (nu, urmează celălalt traseu). Un webhook este o astfel de adresă pe care Voys o apelează în timpul unui apel.
Pentru webhook-uri, căutarea numelui apelantului și codurile de acces folosiți URL-urile pe care Tillor le generează pentru dumneavoastră.
- Mergeți la Setări > Integrări și deschideți Voys
- După instalare, pe pagina de detalii, la Setări, se află blocul URL-uri de configurat - copiați de acolo URL-ul potrivit pentru fiecare scop
Aici găsiți, printre altele:
- Notificări conversații - URL de webhook pentru evenimentele apelurilor
- Webhook pentru identificarea apelantului - URL pentru căutarea numelui apelantului în planul de apel Voys
- Agendă XML - URL prin care telefoanele VoIP preiau agenda telefonică
- Coduri de acces - URL pentru comanda punctului de acces (barieră, poartă sau ușă) prin planul de apel
- Webhook program de funcționare - ACK dacă Tillor este deschis, NAK dacă Tillor este închis
- Webhook apelant permis - ACK dacă apelantul poate fi conectat, NAK dacă apelantul trebuie trimis la mesageria vocală
- Webhook de rutare - ACK cu o destinație, NAK dacă nu este setată nicio destinație
În planul de apel Voys folosiți aceleași variabile care sunt indicate în Tillor (precum {callerid}, {did}, {callername}, {callid} și {code}).
Configurarea notificărilor de apel în Voys
- În Voys, deschideți modulul Notificări conversații
- Faceți clic pe Adăugați
- La package/service alegeți Aangepast
- Lipiți URL-ul Tillor de la Notificări conversații
- Salvați
Documentația Voys:
Configurarea numelor apelanților (caller lookup) în planul de apel
Pentru căutarea numelui apelantului folosiți în Voys un pas de tip webhook în planul de apel.
- În Tillor, deschideți URL-ul Webhook pentru identificarea apelantului (la Setări > Integrări > Voys, sub URL-uri de configurat) și copiați-l
- În Voys, deschideți modulul Webhooks și creați un webhook cu acest șablon de URL
- Activați acel webhook în planul de apel prin pasul de webhook
- În șablonul de URL folosiți variabilele acceptate de Voys (
{callerid},{did},{callername}și, la nevoie,{code}) - În rutarea webhook-ului setați Variabele bellernaam, pentru ca numele returnat să fie afișat pe aparate
Webhook-urile pentru programul de funcționare și pentru rutare nu caută nume de apelanți. Pentru aceasta folosiți acest pas separat.
Mai multe informații:
Programul de funcționare și destinațiile în planul de apel
Tillor este sursa pentru programul de funcționare, vacanțe și excepțiile de sărbători legale. Voys nu mai trebuie să cunoască singur acel calendar.
- La Setări > Integrări > Voys, alegeți aparatul Voys pentru deschis și, opțional, pentru închis
- Copiați Webhook program de funcționare sau Webhook de rutare din URL-uri de configurat
- În Voys, creați un webhook cu acel șablon de URL
- Puneți webhook-ul ca pas în planul de apel, deasupra eventualelor meniuri de opțiuni
- Lăsați Menu gebruiken dezactivat
Două modele:
- Webhook program de funcționare -
status=ACKurmează traseul HTTP en menu gelukt (deschis),status=NAKurmează HTTP of menu mislukt (închis). Dacă este setată o destinație pentru deschis, aceasta se află la ACK cadestination. - Webhook de rutare - Tillor alege destinația. Setați în pasul reușit Variabele eindbestemming. ACK +
destinationdacă există o destinație, altfel NAK.
La o eroare sau la un timeout, Voys urmează traseul eșuat. Tratați acest caz ca fiind închis.
Documentația Voys: Webhooks.
Trimiterea automată a apelanților la mesageria vocală
Cu Webhook apelant permis, lăsați Voys să decidă pentru fiecare apelant dacă apelul este conectat. Tillor verifică dacă numărul apelantului aparține unui client care are mesageria vocală automată activată.
Mai întâi configurați planul de apel:
- Copiați Webhook apelant permis din URL-uri de configurat la Setări > Integrări > Voys
- În Voys, creați un webhook cu acel șablon de URL
- Puneți webhook-ul ca pas în planul de apel, deasupra pașilor care conectează apelul
- Lăsați Menu gebruiken dezactivat
- Direcționați traseul HTTP en menu gelukt către rutarea normală și traseul HTTP of menu mislukt către mesageria vocală
- La Setări > Integrări > Voys, sub Dirijare apeluri, bifați Mesagerie vocală automată în Voys
Cât timp această opțiune este dezactivată, nu vedeți Trimite apelurile la mesageria vocală în profilul clientului.
Apoi activați mesageria vocală automată pentru fiecare client:
- Deschideți profilul clientului și mergeți la fila Comunicare
- La Setări de comunicare, bifați opțiunea Trimite apelurile la mesageria vocală
- Faceți clic pe Salvați
Iată cum funcționează răspunsul:
- ACK - apelantul poate trece. Aceasta se aplică și numerelor necunoscute și apelanților cu număr ascuns.
- NAK - numărul aparține unui client cu mesagerie vocală automată. Voys urmează traseul eșuat.
Tillor compară numărul apelantului cu numărul de telefon din profilul clientului, indiferent de spații sau de notația prefixului de țară. Numerele de telefon ale persoanelor de contact nu contează.
La o eroare sau la un timeout, Voys urmează tot traseul eșuat. Atunci toți apelanții ajung temporar la mesageria vocală, nu doar cei blocați. Folosiți, așadar, o destinație de mesagerie vocală ale cărei mesaje le verificați regulat.
Acest webhook nu ține cont de programul de funcționare. Combinați-l cu webhook-ul pentru programul de funcționare sau cu cel de rutare, punând ambele ca pași separați în planul de apel.
Documentația Voys: Webhooks.
Rutare fixă pentru fiecare apelant
Același Webhook de rutare poate trimite imediat un apelant către un aparat Voys propriu, un număr de interior sau un număr de telefon. Aceasta se aplică doar clienților pentru care ați ales o destinație și doar dacă Rutare fixă în Voys este activată.
- Puneți Webhook de rutare în planul de apel, ca la programul de funcționare
- Setați în pasul reușit Variabele eindbestemming
- La Setări > Integrări > Voys, sub Dirijare apeluri, bifați Rutare fixă în Voys
Cât timp această opțiune este dezactivată, nu vedeți Rutare fixă a apelurilor în profilul clientului. Webhook-ul folosește atunci doar aparatul pentru deschis sau închis.
Apoi setați destinația pentru fiecare client:
- Deschideți profilul clientului și mergeți la fila Comunicare
- La Rutare fixă a apelurilor, alegeți un aparat Voys sau Altele pentru un număr de telefon sau un număr de interior (de exemplu 411)
- Alegeți Niciuna pentru a dezactiva rutarea fixă
- Faceți clic pe Salvați
Iată cum alege webhook-ul de rutare destinația:
- Dacă pentru acest apelant există o destinație fixă, aceasta este
destination. - Altfel,
destinationeste aparatul Voys pentru deschis sau închis. - NAK - nu există nicio destinație fixă și nici vreun aparat pentru starea curentă. Aceasta se aplică și numerelor necunoscute și apelanților cu număr ascuns, cât timp nu există un aparat pentru deschis sau închis.
Tillor compară numărul apelantului cu numărul de telefon din profilul clientului, indiferent de spații sau de notația prefixului de țară. Numerele de telefon ale persoanelor de contact nu contează.
La o eroare sau la un timeout, Voys urmează traseul eșuat.
Documentația Voys: Webhooks.
Ce se întâmplă după aceea?
- Fiecare apel care intră sau iese apare în ComunicareApeluri telefonice, cu clientul alături dacă numărul corespunde. Vezi Apeluri telefonice.
- La un apel primit, apelantul apare ca un card în dreapta jos în Tillor, cu datele clientului.
- Înregistrările și transcrierile vin odată cu terminarea apelului, dacă înregistrarea apelurilor este activată în contul dumneavoastră Voys.