Utilisez les points d'extension pour personnaliser le click-to-dial

Note: Cet article s’applique à Genesys Cloud for Salesforce. Cet article sur la personnalisation avancée s'adresse aux développeurs qui connaissent bien Salesforce.

Vous pouvez utiliser les points d’extension pour personnaliser le comportement de numérotation en un clic dans Genesys Cloud for Salesforce. Les points d'extension utilisent le langage de programmation Salesforce Apex.

Conditions préalables

  • Une version du package géré qui inclut la section Paramètres du point d’extension. Pour plus d’informations, voir Configurer la journalisation des interactions.

Dans Salesforce, créez un seul fichier Apex avec une classe Apex qui implémente le purecloud.CTIExtension.ClickToDial interface. Définissez la classe Apex comme globale afin que le code puisse être appelé par l'intégration.

interface purecloud.CTIExtension.ClickToDial

Contient une signature de méthode que vous pouvez définir pour personnaliser la fonctionnalité numérotation en un clic dans Genesys Cloud for Salesforce.

Utilisation

Pour définir le fonctionnement de la fonctionnalité click-to-dial, utilisez la signature de la méthode dans l'interface purecloud.CTIExtension.ClickToDial.

méthode onClickToDial

Lance un appel téléphonique ou un message SMS. 

Lorsque Salesforce alerte le client d'un événement click-to-dial, le client effectue l'événement click-to-dial en fonction des paramètres de votre code Apex. La méthode peut renvoyer des données qui modifient le comportement par défaut du clic pour composer.

Si le code Apex déclenche une exception, l'intégration exécute le comportement click-to-dial par défaut. Si aucune valeur n'est renvoyée, l'intégration supprime le comportement de numérotation par clic.

Propriété d’entrée

Les propriétés suivantes sont incluses dans les données JSON transmises à la méthode.

Nom Type de données Description Notes
numéro Chaîne Numéro de téléphone que l'intégration appelle.
objet Chaîne Type d'objet tel qu'un contact ou un compte dans Salesforce.
objectId Chaîne ID d’un objet pertinent, tel qu’un contact ou un compte, à associer automatiquement à une activité. objetId est seulement pour un seul enregistrement. 
objectName Chaîne Nom de l'enregistrement dans Salesforce.

Propriété de sortie

Les propriétés suivantes sont prises en charge dans les données JSON renvoyées par la méthode.

Nom Type de données Description Notes
numéro Chaîne Voir Propriétés d'entrée table.
objet Chaîne Voir Propriétés d'entrée table.
objectId Chaîne Voir Propriétés d'entrée table.
objectName Chaîne Voir Propriétés d'entrée table.
attributs Objet Paires d’attributs clé-valeur à ajouter à l’interaction.
queueId Chaîne ID de la file d'attente pour passer un appel au nom de.
autoPlace Booléen L'intégration passe automatiquement un appel (vrai) ou l'intégration remplit la zone Nom ou Numéro avec le numéro de téléphone (faux).
type Chaîne Type d’interaction.

Valeurs valides : appelez, sms. 

Sinon taper est fourni, appelle par défaut. 
callerIdName Chaîne Nom affiché aux destinataires de vos appels téléphoniques.
identification de l’appelant Chaîne Numéro de téléphone affiché aux destinataires de vos appels téléphoniques.
les associations Tableau Liste des enregistrements Salesforce à ajouter à la zone Nom ou Associé à dans le client.
utilizationLabelId Chaîne Catégorise la conversation. Les paramètres d'utilisation maximale peuvent être configurés au niveau de chaque étiquette. L'agent doit être en file d'attente ou le champ queueId doit être renseigné pour que l'étiquette s'affiche.

Pour plus d’informations, voir Passer un coup de téléphone, Configurez cliquez pour appeler, et Créer cliquez pour appeler sur des pages Visualforce personnalisées. 

Exemple

Important :
  • Définissez la classe Apex comme globale afin que le code puisse être appelé par l'intégration.
  • Si vous implémentez plusieurs points d'extension (ou interfaces), placez-les tous dans le même fichier Apex.
global class MyCTIExtensions implements purecloud.CTIExtension.ClickToDial {
public String onClickToDial(String data) {
// Example: Specify On Behalf of Queue, Caller ID, Utilization Label, and Name for click-to-dial.
Map<String, Object> clickToDialData = (Map<String, Object>) JSON.deserializeUntyped(data);
clickToDialData.put('queueId', '04a183b6-de9e-4c01-9e88-eabxxxxxad0d');
clickToDialData.put('callerIdName', 'John Smith');
clickToDialData.put('callerId', '+13175550123');
clickToDialData.put('utilizationLabelId', '62f1e0d5-cb8e-4cf7-9049-53dfb00d1983');
return JSON.serialize(clickToDialData);
    }
}

Pour plus d’informations, consultez Points d’extension dans Genesys Cloud for Salesforce.

Pour plus d’informations sur l’intégration, consultezÀ propos de Genesys Cloud for Salesforce.