Click-to-Call
Click-to-Call permet à vos contacts
The person interacting with an agent, IVR, or bot in your contact center. d'appeler un agent en direct en un seul clic. À partir de ce bouton sur votre site, les visiteurs peuvent lancer un appel direct à un agent. Cela peut vous aider à réduire ou éliminer ce qui suit :
-
Étapes supplémentaires pour joindre une équipe commerciale ou d’assistance.
-
Les frais généraux, tels que les frais de numéro de service et les surcharges sur appareils mobiles.
Click-to-Call fonctionne par le biais d’un kit de développement logiciel (ou SDK) écrit en JavaScript. Pour le configurer, vous devez demander à un développeur d’implémenter le SDK sur votre site Web. Vous devez également travailler avec un représentant de compte qui peut fournir des identifiants spécifiques.
Points à retenir sur clé Click-to-Call
-
Click-to-Call est pris en charge dans les navigateurs pour postes de travail. Il n'est actuellement pas pris en charge pour les appareils mobiles.
-
Click-to-Call est actuellement pris en charge dans les régions suivantes :
-
Canada
-
Allemagne
-
Japon
-
Royaume-uni
-
États-unis
-
-
Informations clés concernant le SDK Click-to-Call :
-
Télécharger le SDK : Contactez votre représentant commercial
-
Langue du SDK : JavaScript (utilisant le SDK AudioCodes WebRTC)
-
Navigateurs pris en charge : GoogleChrome, Microsoft Edge et Firefox
-
Autorisation d'accès au microphone : les Contacts
The person interacting with an agent, IVR, or bot in your contact center. doivent autoriser leur navigateur à utiliser leur microphone
-
-
Le SDK comprend un seul fichier clicktocall.js. Celui-ci doit être inclus ou référencé sur chaque page web sur laquelle vous souhaitez que le bouton Click-to-Call s'affiche. Vous devez aussi implémenter vos propres composants d’interface utilisateur, comme le bouton Click-to-Call et les commandes d’appel. Le bouton Click-to-Call doit invoquer la fonction makeCall du SDK, qui initie un appel WebRTC. Si la demande d’appel est authentifiée par NiCE CXone, l’appel est passé.
-
Le SDK propose une option permettant de transmettre des données utilisateur, des métadonnées de site Web et des données de routage dans le cadre de la demande d'invitation SIP à l'aide d'en-têtes X. Vous devez configurer votre script Studio associé auClick-to-Call point de contact
The entry point that an inbound contact uses to initiate an interaction, such as a phone number or email address. Click-to-Call pour obtenir les données et les utiliser comme nécessaire. Cela peut inclure l'affichage des données utilisateur dans une fenêtre contextuelle pour les agents ou l'utilisation des données de routage pour prendre des décisions de routage.Cette disposition est en option et vous ne devez la configurer que si vous en avez besoin. Si vous n'en avez pas besoin, vous pouvez configurer la fonction makeCall() sans transmettre de données.
La collecte et la transmission des données relèvent de votre responsabilité. Le SDK fournit uniquement le mécanisme permettant de transmettre les données. Il ne génère, ne valide ni ne gère les données.
-
Pour les mises à jour du SDK Click-to-Call :
-
Les modifications, y compris les améliorations, les nouvelles fonctionnalités et les mises à jour de compatibilité, ne surviennent pas selon un calendrier fixe.
-
Le SDK est livré sous la forme d'un unique fichier JavaScript. Lorsqu'une mise à jour est disponible, NiCE vous fournit la dernière version. Vous devez ensuite remplacer le fichier existant dans votre implémentation.
-
Le SDK assure une compatibilité ascendante afin que les versions existantes continuent de fonctionner sans interruption. Toutefois, en cas de changement majeur, vous pourriez être tenu de passer à la dernière version.
-
Prérequis d'intégration
Pour préparer l'intégration de Click-to-Call à votre site, vous devez :
-
Obtenez un Id client auprès de votre représentant de compte.
-
Travaillez avec votre représentant de compte pour approvisionner des numéros de téléphone spécifiques à Click-to-Call.
-
Implémenter une API POST sur votre propre serveur. Cette API doit générer un jeton JWT pour l’authentification. Ce jeton valide la légitimité des demandes d’appel.
En savoir plus sur JWT
L’authentification dans Click-to-Call repose sur un jeton JWT. Vous devez générer une paire de clés asymétriques RSA d'une taille de 2 048 bits. Le premier est une clé privée que vous utilisez pour générer votre JWT (JWT1). Le JWT doit être signé à l'aide de l'algorithme RS256. La seconde est une clé publique, que vous devez fournir à NiCE.
Vous pouvez générer la paire de clés requise au format PEM à l'aide de ces commandes OpenSSL :
# Generate a 2048-bit RSA private key in PEM format openssl genpkey -algorithm RSA -out private.pem -pkeyopt rsa_keygen_bits:2048 # Extract the corresponding public key in PEM format openssl rsa -pubout -in private.pem -out public.pemLors de l’initialisation d’un appel téléphonique, le JWT1 doit être inclus dans la demande. NiCE CXone valide le JWT1 dans la demande entrante avec la clé publique que vous avez fournie. Assurez-vous que le délai d’expiration du jeton JWT1 ne dépasse pas 20 secondes.
Vous devez générer le JWT1 avec une API POST. Vous devez implémenter cette API sur votre propre serveur. Le SDK attend que cette API accepte le point de contact
The entry point that an inbound contact uses to initiate an interaction, such as a phone number or email address. (adresse du contact) et le ClientID dans le corps de la demande. Il doit alors renvoyer le jeton JTW avec les réclamations ContactAddress et ClientId.Vous pouvez trouver des exemples de snippets de code dans le répertoire IntegrationHelpers/Templates du package SDK. Ils sont rédigés en .NET et Java. Ils fournissent un exemple de référence pour la mise en œuvre de l'API POST requise.
Exemple de terminal d'API :
POST /generate-jwt1-token Content-Type: application/json { "ContactAddress": "<CONTACT_ADDRESS>", "ClientId": "<CLIENT_ID>" } // API response: "GENERATED_JWT1_TOKEN"Exemple d’URL de terminaison de l’API pour le jeton JWT1 :
let getJWT1TokenURL = '<YOUR_TOKEN_ENDPOINT_URL>';//This is where you enter the URL for the POST API you implement. -
Fournissez la clé publique à votre représentant commercial à des fins d'authentification.
-
Tenez compte de votre conception de l'interface utilisateur. Vous devez développer votre propre interface du côté contact de l’appel, notamment les boutons des commandes d’appel, pour couper le son ou terminer l’appel, par exemple. Le SDK inclut les exemples de composants React et Angular que les développeurs peuvent utiliser comme référence. Le côté agent de l'appel est géré dans son application Agent, par conséquent le développement de l'interface utilisateur n'est nécessaire que pour le côté contact.
Configuration de NiCE CXone
Outre l’ajout de la fonctionnalité Click-to-Call à votre site Web, vous devez veiller à configurer vos composants de routage dans NiCE CXone. Votre administrateur NiCE CXone peut configurer les composants nécessaires.
Veillez à avoir les éléments suivants :
-
Une compétence voix entrante ACD skill créée avec les agents nécessaires qui lui sont attribués.
-
points of contact (Pda) configurés pour les appels vocaux. Il doit s’agit des POC de téléphone pour chaque numéro d’appel Click-to-Call. Le développeur qui implémente Click-to-Call sur votre site doit s’en servir pour contactAddress dans le fichier JavaScript.
-
Un script Studio permettant d'acheminer les appels vers un agent.
Selon la configuration de votre NiCE CXone, vous pourrez peut-être utiliser des composants de routage existants, ou vous devrez peut-être en créer et configurer de nouveaux.
Intégration du SDK
Veillez à accomplir ou préparer les éléments indiqués dans la section des prérequis.
-
Incorporez le fichier clicktocall.js dans votre page Web comme vous le souhaitez.
-
Dans le fichier clicktocall.js, définissez l’URL de terminaison de votre API POST.
let getJWT1TokenURL = '<YOUR_TOKEN_ENDPOINT_URL>'; -
Ajoutez les composants d’interface utilisateur suivants à votre site Web. Veillez à attribuer à chaque composant un identifiant unique. Le package SDK inclut des exemples pour les composants d’interface utilisateur React et Angular. Vous les trouverez dans le répertoire IntegrationHelpers/UIComponents.
-
Bouton pour lancer l’appel vocal.
-
Bouton pour raccrocher ou déconnecter l’appel.
-
Bouton pour couper ou rétablir le son de l’appel.
-
Bouton permettant d'afficher un clavier pour les Entrées dtmf.
-
Une balise <div> pour afficher les touches du clavier.
-
Un libellé permettant d’afficher les messages de réussite ou d’erreur de l’appel.
-
Une balise <audio> pour lires des sons, comme les tonalités de numérotation ou de connexion de l’appel.
-
-
Mettez à jour le fichier clicktocall.js avec les références des composants d’interface utilisateur que vous venez d’ajouter.
let clickToCallButtonId = '<YOUR_CLICK_TO_CALL_BUTTON_ID>'; let hangUpButtonId = '<YOUR_HANG_UP_BUTTON_ID>'; let muteAudioButtonId = '<YOUR_MUTE_AUDIO_BUTTON_ID>'; let keypadButtonId = '<YOUR_KEYPAD_BUTTON_ID>'; let dtmfKeyDivId = '<YOUR_DTMF_KEY_DIV_ID>'; let callStatusMessageLabelId = '<YOUR_CALL_STATUS_MESSAGE_LABEL_ID>'; let remoteAudioId = '<YOUR_AUDIO_CONTROL_ID>'; -
Définissez vos préférences dans la section des configurations du fichier clicktocall.js. Cette section contient plusieurs variables de configuration qui contrôlent certains types de comportements.
-
Définissez le nombre de tentatives avec retryCount. En cas de déconnexion de l’appel, il s’agit du nombre de tentatives de reconnexion qui seront effectuées par le système. La valeur par défaut est 3.
-
Définissez la valeur POCREnvironmentXHeaderValue sur PROD.
-
Définissez les paramètres de configuration du serveur téléphonique dans phoneServerConfig et clientId.
let phoneServerConfig = { domain: '<Domain of the SIP server>', //Set value of this configuration to 'cxonevoice.com' addresses: [], //Keep this array empty iceServers: [], //Keep this array empty userName: '<username>', //This configuration is a human-readable string used to identify the sender in a more friendly way. In agent applications like CXone Agent, this might be displayed on the screen during a call. Tthis value should not contain any spaces and should not exceed 20 characters. displayName: '', // This is an optional field and its value can be kept the same as userName password: '' //Keep this field empty } let clientID = '<YOUR_CLIENT_ID>'; //Set the value of this configuration as provided by CXone
-
-
Si vous souhaitez personnaliser les notifications côté contact concernant les appels qui échouent ou sont déconnectés, modifiez les chaînes de texte des variables suivantes dans clicktocall.js.
-
callFailedToConnectErrorMessage
-
uiErrorMessage
-
contactSupportTeamMessage
let callFailedToConnectErrorMessage = 'Call failed to connect. Service not available!'; let uiErrorMessage = { 'Default': 'Error occurred. Please try again!', 'Terminated': 'Call ended successfully!', 'Canceled': 'Call cancelled. Please try again!', 'Failed': callFailedToConnectErrorMessage, 'login failed': callFailedToConnectErrorMessage, 'disconnected': callFailedToConnectErrorMessage, 'logout': callFailedToConnectErrorMessage, 'SIP Failure Code': callFailedToConnectErrorMessage, 'RTP Timeout': 'RTP Timeout': 'The call ended unexpectedly due to network issues. Please ensure your internet is stable and try placing the call again!', 'Token Claims': 'An error occurred during the call attempt. Please retry!' } let contactSupportTeamMessage = "We're sorry, could not connect the call. Please try again later or contact our support team!"; -
-
Configurez les ressources basées sur l'emplacement si vous souhaitez allouer les ressources les plus proches pour traiter les demandes Click-to-Call. Pour ce faire, procédez comme suit dans clicktocall.js :
-
Utilisez la fonction getAvailableLocations() pour renvoyer une liste des emplacements où les ressources requises, telles que les Session Border Controllers (SBC), sont déployées. Ces emplacements permettent de déterminer la meilleure ressource pour le traitement des demandes Click-to-Call.
-
Intégrez la sélection de l'emplacement dans l'interface utilisateur. Vous pouvez procéder de deux façons :
-
Contrôle sélectionnable par l'utilisateur : fournissez un élément sélectionnable, comme une liste déroulante ou un bouton radio, qui permet aux contacts de sélectionner l'emplacement le plus proche parmi les Options proposées par la fonction getAvailableLocations().
-
Mappage automatique : si le système peut déterminer l'emplacement du contact, mappez-le à l'un des emplacements exposés par la fonction getAvailableLocations() et transmettez-le à la fonction makeCall().
-
-
Configurez l'emplacement par défaut. Pour ce faire, définissez la variable defaultLocation sur l'emplacement depuis lequel vos contacts appellent le plus souvent. L'emplacement par défaut doit être l'un des emplacements renvoyés par la fonction getAvailableLocations().
// Variable to store default location let defaultLocation = "US";
-
-
Ajoutez la méthode makeCall(contactAddress, [location], [userData], [routingData]) au bouton Click-to-Call. Les paramètres location, userData et routingData sont en option.
Les paramètres userData et routingData transmettent des données utilisateur et de routage destinées à être utilisées dans les décisions de routage ou à être affichées dans Agent Workspace (Agent). Cette opération est effectuée dans le cadre de la demande d'invitation SIP à l'aide des en-têtes X. Vous pouvez ensuite traiter les données dans le script Studio utilisé pour le point de contact.
- userData : Affiche les informations relatives à l'utilisateur.
-
routingData : Affiche les données utilisées pour les décisions de routage.
Ces paramètres doivent être fournis sous forme d'objets contenant des paires clé-valeur. Le SDK convertit les deux objets en chaînes à l'aide de JSON.stringify() et les transmet en tant qu'en-têtes X dans la demande d'invitation SIP :
-
Contient l'objet userData.
-
Contient l'objet routingData.
userData et routingData sont des objets distincts, ce qui vous permet de séparer les données si nécessaire. Toutefois, vous pouvez transmettre toutes les données requises dans un seul des paramètres si vous le préférez. Vous pouvez également transmettre toutes les données au sein d'un seul en-tête X si votre script Studio est configuré en conséquence.
En raison des limitations relatives à la taille des données pouvant être transmises dans les en-têtes X, la longueur en caractères de chaque objet userData et routingData ne doit pas dépasser 1 000 caractères (1 Ko) après Conversion en chaîne.
Reportez-vous aux exemples suivants pour le configurer selon votre cas d'utilisation particulier :
-
Sans transmettre aucun paramètre :
makeCall(contactAddress); -
Transmission de location uniquement :
makeCall(contactAddress, "US"); -
Passing location, userData, et routingData :
makeCall(contactAddress, "US", { name: "Elizabeth Bennet", age: 20 }, { skill: "sales" }); -
Transfert de userData uniquement :
makeCall(contactAddress, undefined, { name: "John Doe", age: 30 }, undefined);
-
Si vous avez configuré la méthode makeCall() pour utiliser les objets userData ou routingData, vous devez traiter les données d'en-tête X dans le script Studio associé auClick-to-Call point de contact
The entry point that an inbound contact uses to initiate an interaction, such as a phone number or email address. Click-to-Call à l'aide de ces actions :-
SIPGetHeader action : lit les données des en-têtes X.
-
RunApp action : affiche les données sous forme de screen pop
A pop-up window with information about the contact that appears on an agent's screen after an event such as connecting to a contact. dans Agent Workspace (Agent) lorsque l'appel est connecté. -
Snippet action : analyse les données de l'en-tête X et achemine les appels en fonction de ces données.
-
-
Pour envoyer des tonalités DTMF
Signaling tones that are generated when a contact presses a key on the telephone keypad., appelez la fonction guiSendDTMF(digit) lorsqu'un bouton DTMF est cliqué. -
Testez votre configuration afin de vérifier qu'elle peut lancer et acheminer des appels avec succès.