Téléphonie Voys

Avec l'intégration Voys, Tillor voit qui appelle et affiche aussitôt les données du client. Les appels, enregistrements et transcriptions arrivent ensuite sous Appels téléphoniques. Voys est un fournisseur de téléphonie pour les entreprises.

Avant de commencer :

• Vous avez besoin d'un compte VoIP Voys actif et d'un accès aux réglages du plan d'appel dans Voys.
• Vous avez besoin du droit Gérer les intégrations.
• Le numéro de téléphone de l'appelant doit figurer sur la fiche client ou chez une personne de contact, sinon Tillor ne relie pas l'appel à un client.

Configurer VoysCopier le lien vers cette section

1. Allez dans Paramètres (barre latérale, sous Support)

2. Choisissez Intégrations et ouvrez Voys dans la liste
3. Sur la page de détail, saisissez vos données Voys (username, password, client_uuid, token) et cliquez sur Installer

Vous avez besoin d'un compte VoIP Voys actif.

Retrouver les URL pour VoysCopier le lien vers cette section

Tillor et Voys communiquent par des adresses (URL). À certaines étapes, Voys attend une réponse de Tillor, par exemple pour savoir si vous êtes ouvert. Cette réponse est ACK (oui, continuer) ou NAK (non, suivre l'autre chemin). Un webhook est une adresse que Voys appelle pendant un appel.

Pour les webhooks, la recherche du nom de l'appelant et les codes d'accès, vous utilisez les URL que Tillor génère pour vous.

1. Allez dans Paramètres > Intégrations et ouvrez Voys
2. Après l'installation, le bloc URLs à configurer se trouve sur la page de détail, sous Paramètres - copiez-y l'URL qui correspond à chaque usage

Vous y trouvez notamment :

• Notifications de conversation - URL de webhook pour les événements d'appel
• Webhook pour recherche d'appelant - URL pour la recherche du nom de l'appelant dans votre plan d'appel Voys
• XML Phonebook - URL permettant aux téléphones VoIP de récupérer l'annuaire
• Codes d'accès - URL pour commander le point d'accès (barrière, portail ou porte) via le plan d'appel
• Webhook des heures d'ouverture - ACK si Tillor est ouvert, NAK si Tillor est fermé
• Webhook appelant autorisé - ACK si l'appel peut être transféré, NAK si l'appelant doit aller à la messagerie vocale
• Webhook de routage - ACK avec une destination, NAK si aucune destination n'est définie

Dans le plan d'appel Voys, utilisez les mêmes variables que celles indiquées dans Tillor (comme {callerid}, {did}, {callername}, {callid} et {code}).

Configurer les notifications d'appel dans VoysCopier le lien vers cette section

1. Dans Voys, ouvrez le module Notifications d'appel
2. Cliquez sur Ajouter
3. Pour le package/service, choisissez Personnalisé
4. Collez l'URL Tillor depuis Notifications de conversation
5. Enregistrez

Documentation Voys :

• Notifications d'appel

Configurer les noms d'appelants (caller lookup) dans le plan d'appelCopier le lien vers cette section

Pour la recherche du nom de l'appelant, vous utilisez dans Voys une étape webhook du plan d'appel.

1. Dans Tillor, ouvrez l'URL Webhook pour recherche d'appelant (sur Paramètres > Intégrations > Voys, sous URLs à configurer) et copiez-la
2. Dans Voys, ouvrez le module Webhooks et créez un webhook avec ce modèle d'URL
3. Activez ce webhook dans votre plan d'appel via l'étape webhook
4. Dans le modèle d'URL, utilisez les variables prises en charge par Voys ({callerid}, {did}, {callername} et si nécessaire {code})
5. Dans le routage du webhook, définissez Variable nom de l'appelant pour que le nom renvoyé s'affiche sur les appareils

Les webhooks des heures d'ouverture et de routage ne recherchent pas le nom de l'appelant. Utilisez pour cela cette étape distincte.

Pour en savoir plus :

• Webhooks
• Que sont les notifications d'appel (différence avec les webhooks)

Heures d'ouverture et destinations dans le plan d'appelCopier le lien vers cette section

Tillor est la source pour les heures d'ouverture, les vacances et les exceptions des jours fériés. Voys n'a plus besoin de connaître ce calendrier.

1. Sur Paramètres > Intégrations > Voys, choisissez l'appareil Voys pour ouvert et, en option, pour fermé
2. Copiez Webhook des heures d'ouverture ou Webhook de routage depuis URLs à configurer
3. Dans Voys, créez un webhook avec ce modèle d'URL
4. Placez ce webhook comme étape du plan d'appel, au-dessus d'éventuels menus à choix
5. Laissez Utiliser le menu désactivé

Deux modèles :

• Webhook des heures d'ouverture - status=ACK suit le chemin HTTP et menu réussis (ouvert), status=NAK suit HTTP ou menu échoué (fermé). Si une destination d'ouverture est définie, elle est transmise avec ACK sous destination.
• Webhook de routage - Tillor choisit la destination. Dans l'étape réussie, définissez Variable destination finale. ACK + destination s'il y a une destination, sinon NAK.

En cas d'erreur ou de dépassement de délai, Voys prend le chemin d'échec. Considérez-le comme fermé.

Documentation Voys : Webhooks.

Envoyer automatiquement des appelants vers la messagerie vocaleCopier le lien vers cette section

Avec le Webhook appelant autorisé, vous laissez Voys décider, appelant par appelant, si un appel est transféré. Tillor vérifie si le numéro de l'appelant appartient à un client pour lequel la messagerie automatique est activée.

Commencez par configurer le plan d'appel :

1. Copiez Webhook appelant autorisé depuis URLs à configurer sur Paramètres > Intégrations > Voys
2. Dans Voys, créez un webhook avec ce modèle d'URL
3. Placez ce webhook comme étape du plan d'appel, au-dessus des étapes qui transfèrent l'appel
4. Laissez Utiliser le menu désactivé
5. Dirigez le chemin HTTP et menu réussis vers votre routage habituel et le chemin HTTP ou menu échoué vers la messagerie vocale
6. Sur Paramètres > Intégrations > Voys, sous Routage des appels, cochez Messagerie automatique dans Voys

Tant que cette option est désactivée, vous ne voyez pas Envoyer les appels vers la messagerie vocale sur la fiche client.

Activez ensuite la messagerie automatique client par client :

1. Ouvrez la fiche client et allez dans l'onglet Communication
2. Dans Paramètres de communication, cochez l'option Envoyer les appels vers la messagerie vocale
3. Cliquez sur Enregistrer

Voici comment fonctionne la réponse :

• ACK - l'appelant peut passer. C'est aussi le cas pour les numéros inconnus et pour les appelants au numéro masqué.
• NAK - le numéro appartient à un client avec messagerie automatique. Voys suit le chemin d'échec.

Tillor compare le numéro de l'appelant au numéro de téléphone de la fiche client, quels que soient les espaces ou la notation de l'indicatif du pays. Les numéros de téléphone des personnes de contact ne comptent pas.

Ce webhook ne tient pas compte des heures d'ouverture. Combinez-le avec le webhook des heures d'ouverture ou de routage en les plaçant comme étapes distinctes dans le plan d'appel.

Documentation Voys : Webhooks.

Routage fixe par appelantCopier le lien vers cette section

Le même Webhook de routage peut transférer directement un appelant vers un appareil Voys, un numéro interne ou un numéro de téléphone précis. Cela ne vaut que pour les clients pour lesquels vous avez choisi une destination, et seulement si Routage d'appel fixe dans Voys est activé.

1. Placez le Webhook de routage dans le plan d'appel, comme pour les heures d'ouverture
2. Dans l'étape réussie, définissez Variable destination finale
3. Sur Paramètres > Intégrations > Voys, sous Routage des appels, cochez Routage d'appel fixe dans Voys

Tant que cette option est désactivée, vous ne voyez pas Routage d'appel fixe sur la fiche client. Le webhook utilise alors uniquement l'appareil pour ouvert ou fermé.

Définissez ensuite la destination client par client :

1. Ouvrez la fiche client et allez dans l'onglet Communication
2. Sous Routage d'appel fixe, choisissez un appareil Voys, ou Autre pour un numéro de téléphone ou un numéro interne (par exemple 411)
3. Choisissez Aucun pour désactiver le routage fixe
4. Cliquez sur Enregistrer

Voici comment le webhook de routage choisit la destination :

• Si une destination fixe existe pour cet appelant, c'est destination.
• Sinon, destination est l'appareil Voys pour ouvert ou fermé.
• NAK - il n'y a pas de destination fixe ni d'appareil pour l'état actuel. C'est aussi le cas pour les numéros inconnus et les appelants au numéro masqué, tant qu'il n'y a pas d'appareil pour ouvert ou fermé.

Tillor compare le numéro de l'appelant au numéro de téléphone de la fiche client, quels que soient les espaces ou la notation de l'indicatif du pays. Les numéros de téléphone des personnes de contact ne comptent pas.

En cas d'erreur ou de dépassement de délai, Voys prend le chemin d'échec.

Documentation Voys : Webhooks.

Que se passe-t-il ensuite ?Copier le lien vers cette section

• Chaque appel qui arrive ou part figure dans CommunicationAppels téléphoniques, avec le client si le numéro correspond. Voir Appels téléphoniques.
• Lors d'un appel entrant, l'appelant apparaît sous forme de carte en bas à droite dans Tillor, avec les données du client.
• Les enregistrements et transcriptions arrivent dès que l'appel est terminé, si les enregistrements d'appels sont activés dans votre compte Voys.

Un problème ?Copier le lien vers cette section

Voir aussiCopier le lien vers cette section