Ce guide explique comment configurer un répondeur par défaut par canal via un appel API sur Sunshine Conversations.
Remarque : Ce guide utilise Postman. Si vous ne disposez pas d’un compte Postman, vous pouvez en créer un sur le site Web de Postman et télécharger l’application.
Importer le modèle d’API
- Ouvrez le fichier postman_ensemble.json. La collection est au format JSON et n’est pas très lisible pour des humains.
- Sélectionnez la totalité du texte et copiez-le.
3. Ouvrez Postman et cliquez sur Importer.
4. Collez le contenu du fichier de collection dans le champ Coller cURL, Texte brut ou URL.
La collection API Sunshine Conversations s’affiche dans l’interface Postman.
Sélectionnez l’appel API PATCH dans la liste des ensembles.
- Dans Postman, depuis la collection API Sunshine Conversations , sélectionnez Integration > Mettez à jour l’intégration.
- Suivez les étapes décrites dans Obtenir une liste des ID d’intégration à partir de la messagerie pour récupérer la liste complète de vos ID d’intégration et l’ID de répondeur par défaut pour les agents IA.
L’ID du répondeur par défaut est le même pour toutes les intégrations.
- Pour l’appel API PATCH, remplacez le point de terminaison par défaut avec l’ID de l’application de la clé API Zendesk (la même que celle utilisée pour la connexion aux agents IA - avancé) et l’ID de l’intégration que vous souhaitez modifier. Dans cet exemple, nous allons cibler l’intégration iOS afin qu’elle puisse être lancée sur le Web sans le SDK de l’application.
- Cliquez sur l’onglet Authentification et sélectionnez Authentification de base. Saisissez votre identifiant de clé et votre clé secrète, qui proviennent tous deux de la même API de Zendesk.
- Dans l’onglet Corps, configurez manuellement l’intégration (iOS) pour qu’elle utilise les agents IA en utilisant l’ID de répondeur par défaut des agents IA (même s’il est déjà défini).
Supprimez tout le contenu du corps à l’exception de « defaultResponderId » et ajoutez l’identifiant obtenu de l’appel API de liste d’intégration. N’oubliez pas d’éliminer les virgules superflues.
- Exécutez l’appel API PATCH, puis suivez l’appel API GET de liste des intégrations pour vérifier que la mise à jour a réussi.
Une fois la modification effectuée, le canal iOS continue d’utiliser les agents IA. Cependant, le champ « hérité » est désormais configuré sur faux, ce qui indique qu’il ne passera pas automatiquement à Agents IA - avancé quand Agents IA - avancé est connecté.
- Connectez Agents IA - avancé à l'environnement de production ZD. Vous remarquerez que seuls les canaux marqués avec « herited = true » l’utiliseront.
- Une fois que le client a décidé de transférer des canaux supplémentaires vers Agents IA - avancé, envoyez la valeur « null » (sans guillemets) à l’ID d’intégration du canal souhaité. Cette action rétablit le comportement par défaut du canal, en alternant entre Agents IA - avancé et Zendesk, en fonction du statut de connexion d’Agents IA - avancé.
La liste montre désormais que le canal iOS utilise désormais Agents IA - avancé.
Désormais, chaque fois que vous déconnectez Agents IA - avancé, tous les canaux marqués avec un statut hérité retourneront à l’agent IA, et vice versa. Tous les canaux qui ont été configurés manuellement pour l'agent IA restent sur l'agent IA.
Attention : évitez de configurer manuellement un canal sur Agents IA - avancé avec la propriété héritée configurée sur faux. Vous risqueriez d’éviter la déconnexion d’Agents IA - avancé de Zendesk. En cas de problèmes avec Agents IA - avancé, le répondeur par défaut reste sur agents IA - avancé et les chats risquent de rester sans réponse.