initializeNewConversation

Omnicanal pour Customer Service contient une suite de capacités qui étendent la puissance de Dynamics 365 Customer Service Enterprise pour permettre aux organisations de se connecter et d’interagir instantanément avec leurs clients sur les canaux de messagerie numérique. Une licence supplémentaire est requise pour accéder à Omnichannel pour Customer Service. Pour plus d’informations, voir les pages Vue d’ensemble de la tarification de Dynamics 365 Customer Service et Plan de tarification de Dynamics 365 Customer Service.

Cette méthode doit être implémentée dans les ressources web. Il est appelé une seule fois, dès qu’une nouvelle invitation à une conversation est acceptée ou qu’une conversation existante est ouverte à partir du tableau de bord de l’agent.

1. Vous pouvez choisir de désactiver ou d’activer la traduction pour une conversation particulière sous certaines conditions. Par exemple, vous souhaitez activer la traduction si les langues de l’agent et du client sont différentes.
2. Vous pouvez également remplacer la langue de l’agent à utiliser dans la traduction de la conversation.
3. Il vous fournit des informations sur la conversation pour prendre certaines décisions, par exemple, le moteur API de traduction qui doit être utilisé pour une conversation.

Important

Pour plus d’informations sur l’implémentation de l’API, consultez cet initializeNewConversation.

Syntaxe

function (conversationConfig): Object

Paramètres

Nom	Obligatoire	Type	Descriptif
conversationConfig	Oui	Objet JavaScript	Fournit des détails sur la conversation. Tels que l’identifiant de la conversation, la langue d’entrée par défaut de l’agent (à partir de la configuration de l’administrateur de traduction en temps réel), etc. Plus de détails sont disponibles dans les paragraphes suivants.

Voici la structure du conversationConfig paramètre.

interface InviteParams {// Parameters received on a conversation invite 
        inviteLocale: string;  //Language locale of the channel from where conversation is received. This contains locale ID, example- "1033" for english.
        channelType: string;   //The type of the channel, example- "lcw" for chat widget, "facebook" for facebook.
} 


interface conversationConfig { 
        conversationId: string,  // Unique Id for conversation in Omnichannel for Customer Service
        c1Language: string;      // Default agent input language (From Real time translation administrator configuration)
        inviteParams: InviteParams;  // Implements InviteParams interface, Represents the parameters received on a conversation invite  
}

Le inviteLocale paramètre dans InviteParams interface représente un ID de paramètres régionaux. Pour plus d’informations : ID de paramètres régionaux.

Le channelType paramètre dans l’interface InviteParams représente un canal pris en charge dans Omnicanal pour Customer Service. Les chaînes sont répertoriées comme suit.

Nom	Descriptif
"lcw"	Pour le canal de widget de chat en direct
"sms"	Pour le canal SMS
"facebook"	Pour le canal Facebook
"twitter"	Pour le compte Twitter
"custom"	Pour canal sur mesure
"wechat"	Pour le canal WeChat
"whatsapp"	Pour le canal WhatsApp
"msteams"	Pour le canal Microsoft Teams
"line"	Pour le canal Line
"phonecall"	Pour le canal d’appel téléphonique

Voici un exemple du conversationConfig paramètre.

conversationConfig = {
  "conversationId": "2f67af9e-c05a-4784-aaea-916d6938fcea",
  "c1Language": "1033",
  "inviteParams": {
    "inviteLocale": "3082",
    "channelType": "lcw"
  }
}

Valeur de retour

Renvoie une promesse qui se résout en l’objet JavaScript suivant.

{
        keepTranslationOn: boolean;// mandatory field, if true the translation would be turned on for the conversation and vice-versa
        c1Language?: string;// optional field, return the agent's language if input param conversationConfig.c1Language needs to be overriden for the conversation
}

Le c1Language paramètre de l’objet JavaScript résolu représente un ID de paramètres régionaux uniquement de la liste suivante.

ID de paramètres régionaux	Language
"1033"	English
"1025"	Arabe
"1069"	Basque
"1027"	Catalan
"1026"	Bulgare
"1050"	Croate
"1029"	Tchèque
"1030"	Danois
"1043"	Néerlandais
"1061"	Estonien
"1035"	Finnois
"1036"	French
"1110"	Galicien
"1031"	German
"1032"	Grec
"1037"	Hébreu
"1081"	hindi
"1038"	Hongrois
"1040"	Italian
"1057"	Indonésien
"1041"	Japanese
"1087"	Kazakh
"1042"	Korean
"1062"	Letton
"1063"	Lituanien
"1086"	Malais
"1044"	Bokmal norvégien
"1045"	Polonais
"1046"	Portugais - Brésil
"2070"	Portugais - Portugal
"1048"	Roumain
"1049"	Russian
"3098"	Serbe (cyrillique)
"2074"	Serbe (latin)
"1051"	Slovaque
"1060"	Slovène
"3082"	Spanish
"1053"	Suédois
"1054"	Thaï
"1055"	Turc
"1058"	Ukrainien
"1066"	Vietnamien
"2052"	Chinois - Chine
"3076"	Chinois - RAS de Hong Kong

Exemple de réponse attendue

{

  "keepTranslationOn": true,
  "c1Language": "1033"

}

Informations supplémentaires

• En cas d’exception dans cette méthode ou de valeurs de retour non valides, Omnicanal pour Customer Service ne transmettra pas la traduction pour la conversation. Par exemple : si l’objet JavaScript résolu à partir de la promesse renvoyée ne contient keepTranslationOn pas de champ ou c1Language si le champ contient une valeur qui ne provient pas de la liste des ID de paramètres régionaux, la conversation commencera avec la traduction désactivée.

• Envisagez d’inclure un traitement minimal dans cette fonction, car cela fait attendre l’interface utilisateur avant le rendu. Si la durée d’exécution de cette fonction dépasse 30 secondes, la conversation démarre avec la traduction désactivée, quelles que soient les valeurs de la promesse renvoyée.

• Si cette méthode n’est pas implémentée, l’erreur suivante s’affichera à l’agent.

Informations connexes

Ajouter une ressource web pour la traduction en temps réel