Zoho Sales IQ

Vous pouvez intégrer le service Agent dans Zoho Sales IQ, permettant ainsi aux utilisateurs de Zoho Sales IQ de communiquer avec l'Agent via Zoho Sales IQ.

Préparation

Avant l'intégration, vous devez configurer certains paramètres dans Zoho, qui seront utilisés lors du processus d'intégration avec GPTBots.

Créer un identifiant client

1. Connectez-vous à la Console API Zoho

   Remarque : Si votre compte n'est pas basé aux États-Unis, vous devez changer de domaine. Pour plus de détails, veuillez vous référer à :

2. Si vous disposez déjà d'une application disponible, accédez à l'application concernée, cliquez sur Secret client, puis copiez l'identifiant client et le secret client correspondants. Ceux-ci seront utilisés dans la configuration de l'intégration GPTBots.

3. Si vous n'avez pas d'application disponible, cliquez sur AJOUTER UN CLIENT en haut à droite et créez un client approprié selon le type d'application.

4. Si vous créez une nouvelle application, renseignez le nom de domaine du service actuel dans l'URL de la page d'accueil, et dans les URI de redirection autorisées, indiquez le nom de domaine du service actuel + /api/console/bot/zoho/salesiq/redirect. Cliquez sur CRÉER. Après la création réussie, le système générera un identifiant client et un secret client. Copiez l'identifiant client et le secret client correspondants, qui seront utilisés dans la configuration de l'intégration GPTBots.

Remarque : Un identifiant client peut être autorisé avec succès jusqu'à 20 fois simultanément. Si ce nombre est dépassé, l'autorisation Zoho du premier bot autorisé deviendra invalide.

Configuration de l'intégration

1. Connectez-vous à GPTBots.

2. Accédez à l'organisation, sélectionnez l'Agent concerné, enregistrez la version et cliquez sur Publier. Après la publication réussie, cliquez sur Intégrations.

3. Sélectionnez Zoho Sales IQ comme méthode d'intégration.

4. Renseignez les paramètres suivants :

   • Identifiant client et secret client : Obligatoires, obtenus lors de la phase de préparation ;
   • Nom d'écran : Obligatoire, issu de la page du compte connecté. Vous devez prendre la première chaîne du chemin après le nom de domaine. Par exemple, dans l'adresse https://salesiq.zoho.com/gptbots/mychats/000000000000003, le nom d'écran est gptbots ;
   • E-mail : Obligatoire, l'e-mail lié au profil du compte Zoho ;
   • Région du serveur : Sélectionnez la région du compte Zoho ;
   • Clé publique : Optionnelle, si vous activez la sécurisation de votre webhook dans la configuration webhook suivante, cliquez d'abord sur Intégration puis revenez pour la renseigner. Si non activé, ce n'est pas nécessaire.

5. Après avoir cliqué sur Intégration, une fenêtre contextuelle d'état d'autorisation apparaîtra. Cliquez sur Accepter.

6. Après autorisation réussie, GPTBots générera une adresse URL de Webhook. À ce stade, vous devez vous rendre sur la page Paramètres.

7. Cliquez sur Webhooks, sélectionnez Modifications de données puis cliquez sur Ajouter.

8. Renseignez le contenu du webhook :

   • Marque : Sélectionnez la marque qui recevra le Webhook ;
   • URL à appeler : Indiquez l'URL du Webhook obtenue lors de la configuration de l'intégration GPTBots ;
   • Événements : Sélectionnez conversation.created, conversation.visitor.replied. Après avoir renseigné, cliquez sur Créer le webhook.

9. Sécurisez votre webhook : étape optionnelle. Vous pouvez choisir de vérifier la sécurité du webhook (s'il provient de la source officielle et non d'une requête usurpée). Après activation, cliquez pour générer une clé publique, copiez la clé publique marquée comme En cours d'utilisation, puis renseignez-la sur la page de configuration de l'intégration GPTBots.

Communiquer avec le bot dans Zoho Sales IQ

Après une configuration d'intégration réussie, vous pouvez dialoguer avec le bot dans le service Zoho.