Utilisation de la messagerie dans le Web SDK

Une fois la messagerie activée, vous pouvez configurer l’aspect et d’autres paramètres du Web SDK dans le Centre d’administration, puis incorporer Zendesk à votre site Web. Si vous avez plusieurs marques, vous pouvez choisir celle avec laquelle utiliser le SDK, afin d’essayer la nouvelle expérience avec un impact minimal sur vos visiteurs.

Si une marque a un Web Widget existant, vous pouvez le convertir en Web SDK. Si une marque n’utilise pas de Web Widget, vous pouvez créer un Web SDK de zéro.

Cet article aborde les sujets suivants :

• Activation de la messagerie pour un site Web ou un Centre d’aide
• Création d’un nouveau Web SDK
• Personnalisation et configuration du Web SDK
• Passage du Web Widget classique au Web SDK
• À propos de l’historique des conversations

Vous pouvez aussi activer la messagerie pour un SDK Android ou iOS.

Activation de la messagerie pour un site Web ou un Centre d’aide

Vous pouvez activer la messagerie pour votre site Web ou votre centre d’aide en créant un Web SDK. Vous devez activer la messagerie pour chaque marque qui utilise un Web SDK. Toutes les marques pour lesquelles la messagerie n’est pas activée continueront d’utiliser le Web Widget classique s’il avait été préalablement activé. Si vous activez la messagerie pour une marque sans Web Widget préalablement activé, vous devez créer un Web SDK de zéro.

Pour activer la messagerie pour un site Web ou un centre d’aide

1. Dans le Centre d’administration, cliquez sur l’icône Canaux () dans la barre latérale gauche. Vos canaux actifs s’affichent.
2. Cliquez sur la marque à activer.
3. À la page de modification du Web SDK de la marque, cochez Activer la messagerie pour ce Web SDK.
4. Personnalisez le Web SDK ou si vous voulez le faire plus tard, cliquez sur Enregistrer les paramètres.
5. Répétez ces étapes pour chaque marque active pour laquelle vous voulez utiliser un Web SDK.

Création d’un nouveau Web SDK

Si vous voulez ajouter un nouveau Web SDK, vous devez créer un canal et l’affecter à la marque avant de pouvoir le personnaliser et le configurer.

Pour créer un nouveau SDK

1. Dans le Centre d’administration, cliquez sur l’icône Canaux () dans la barre latérale gauche.
2. Cliquez sur le bouton Ajouter un canal, puis sélectionnez Web.
3. À la page d’ajout du Web SDK, configurez chacune de ces sections :
   • Configuration élémentaire : saisissez un nom de canal, puis sélectionnez une marque dans le menu déroulant. Seules les marques sans Web Widget ni Web SDK existant s’affichent dans la liste.
   • Personnalisation de l’aspect : cliquez sur les couleurs principales, du message et d’action, puis saisissez une valeur hexadécimale ou utilisez le sélecteur de couleur pour faire votre choix.
   • Installation sur vos sites : choisissez où installer le Web SDK. Consultez L’onglet Installation pour en savoir plus au sujet de l’ajout du SDK à votre site Web ou centre d’aide.
4. Cliquez sur Terminer. La page Modifiez le Web SDK s’ouvre et vous pouvez continuer de configurer le Web SDK ou le laisser tel quel.

Si vous désactivez la messagerie pour une marque, le Web SDK est converti en Web Widget classique.

Personnalisation et configuration du Web SDK

Comme le Web Widget classique, le Web SDK inclut de nombreux composants que vous pouvez personnaliser pour qu’il reflète au mieux votre marque. Vérifiez que vous avez bien activé le Web SDK avant de commencer le processus de personnalisation.

Pour configurer le Web SDK

1. Dans le Centre d’administration, cliquez sur l’icône Canaux () dans la barre latérale gauche.
2. Placez votre curseur sur la marque que vous voulez mettre à jour, cliquez sur l’icône du menu des options (), puis sur Modifier.
3. Cliquez sur l’onglet où se trouvent les composants que vous voulez personnaliser. Cliquez sur les liens ci-dessous pour en savoir plus au sujet des options de chaque onglet :
   • Infos de base (nom et workflow du canal)
   • Style (aspect du Web SDK)
   • Préférences (paramètres de l’historique des conversations)
   • Installation (incorporation du snippet de code et du centre d’aide)

L’onglet Infos de base

L’onglet Infos de base inclut un champ Nom du canal modifiable et un lien vers la page de configuration du Créateur de workflow du SDK.

Le champ Nom du canal est automatiquement rempli avec le nom de la marque. Pour qu’il soit plus facile à trouver dans votre liste de canaux, il peut être judicieux de lui donner un nom unique.

Pour mettre le nom du canal à jour

1. Dans le champ Nom du canal, supprimez le texte que vous voulez modifier.
2. Saisissez un nouveau nom pour le SDK, puis cliquez sur le bouton Enregistrer.

L’onglet Style

L’onglet Style inclut les composants liés à l’aspect du Web SDK.

Dans la section Cadre, vous pouvez mettre les éléments suivants à jour :

• Couleur principale, la couleur principale du bouton de lancement et de l’en-tête du SDK. Saisissez un nombre hexadécimal ou cliquez sur l’échantillon de couleur pour ouvrir un sélecteur de couleur. La couleur par défaut est migrée depuis les paramètres du Web Widget classique de la marque.
• Couleur du message, la couleur de la bulle autour des messages des clients. Saisissez un nombre hexadécimal ou cliquez sur l’échantillon de couleur pour ouvrir un sélecteur de couleur.
• Couleur d’action, la couleur des boutons ou des actions des clients (par ex. une option sélectionnée). Saisissez un nombre hexadécimal ou cliquez sur l’échantillon de couleur pour ouvrir un sélecteur de couleur.
• Logo (facultatif), un fichier JPG ou PNG qui s’affiche en haut du cadre du SDK. Cliquez sur Télécharger une image, puis naviguez jusqu’à l’image que vous voulez ajouter.
• Titre, le texte qui s’affiche en haut du cadre du SDK, généralement un appel à l’action (« Contactez-nous ») ou le nom de votre entreprise.
• Description (facultatif) un court texte sous le titre. Il peut s’agir d’informations que vous voulez partager, un slogan par exemple. Saisissez la description dans le champ de texte.

Faites défiler la page jusqu’à la section Bouton de lancement, où vous pouvez mettre les éléments suivants à jour :

• Position, l’endroit où le bouton de lancement s’affiche dans votre fenêtre de navigateur. Choisissez En bas à droite ou En bas à gauche avec les boutons.
• Texte (facultatif), le texte qui s’affiche à côté du bouton de lancement.

L’onglet Préférences

C’est dans l’onglet Préférences que vous pouvez configurer les options de votre historique des conversations. Consultez À propos de l’historique des conversations.

L’onglet Installation

C’est dans l’onglet Installation que vous ajoutez le Web SDK à votre site Web ou votre centre d’aide.

Remarque – Si vous avez déjà ajouté le Web Widget classique de la marque à votre site Web ou votre centre d’aide, vous n’avez rien à faire. Le Web SDK remplace le widget classique à l’activation de la messagerie Zendesk.

Pour ajouter le Web SDK à votre site Web

1. Cliquez sur l’onglet Installation, puis sur l’icône Copier () en bas du cadre du snippet de code.
2. Si vous voulez ajouter le widget à votre site Web, allez à la page Web à laquelle vous voulez ajouter le widget, puis collez le code avant la balise HTML

de fermeture. Ajoutez le code à chaque page Web sur laquelle vous voulez que s’affiche le widget.

Vérifiez que votre pare-feu est configuré pour autoriser le Web Widget à s’afficher.

Pour ajouter le Web SDK à votre centre d’aide

• Cliquez sur l’onglet Installation, puis cochez la case Incorporer automatiquement le Web SDK à votre centre d’aide.

Passage du Web Widget classique au Web SDK

Quand vous activez la messagerie dans le Web SDK pour une marque avec un Web Widget existant, pour faire simple, vous passez du Web Widget classique au nouveau widget de messagerie. La migration d’un grand nombre des paramètres de configuration du widget classique vers les paramètres du Web SDK se fait automatiquement, notamment :

• Position du widget : le widget et le bouton de lancement s’affichent là où vous les avez placés dans votre centre d’aide ou sur votre page Web.
• Couleur du thème : les paramètres de couleur pour le bouton de lancement, le bouton de contact et l’en-tête sont appliqués au cadre du Web SDK.
• Texte du bouton du Web Widget : pendant la migration, il devient le texte du bouton de lancement. Comme dans le Web Widget, c’est le texte qui s’affiche sur le bouton de lancement.
• Snippet du Web Widget : le Web SDK et le Web Widget (classique) utilisent le même snippet, il est donc inutile de le mettre à jour.
• Activation dans le centre d’aide : si vous avez activé le Web Widget dans un centre d’aide, le Web SDK le remplace.

Certaines fonctionnalités du Web Widget ne sont pas disponibles dans le Web SDK pour l’instant :

• Talk n’est pas activé dans le Web SDK. Vous pouvez malgré tout continuer à recevoir des appels dans l’espace de travail d’agent.
• Le code d’API Javascript peut ne pas être pris en charge . Nous vous conseillons de tester tout code API qui n’est pas documenté comme pris en charge par le Web SDK et de nous signaler tout problème.

À propos de l’historique des conversations

Si vous choisissez d’activer la fonctionnalité d’historique des conversations pour vos clients, quand un utilisateur final revient dans le Web SDK ou dans un canal de messagerie sociale dans lequel il a déjà eu des conversations avec votre entreprise, il peut toujours voir l’intégralité de ces conversations.