Cette page a été traduite par l'API Cloud Translation.
Switch to English

Intégration de Hangouts à Dialogflow

L'intégration de Hangouts à Dialogflow vous permet de créer des bots que vous pouvez inclure dans des discussions à deux, ainsi que dans des salons de discussion. Pour en savoir plus, consultez la documentation de l'API Hangouts Chat.

Configuration

Pour configurer et activer l'intégration de Hangouts Chat, procédez comme suit :

  1. Cliquez sur Intégrations dans le menu de gauche.
  2. Cliquez sur Hangouts Chat.
  3. Sélectionnez une option d'accès.
  4. [Facultatif] Sélectionnez un environnement pour l'agent.
  5. Cliquez sur Démarrer.

Configurer votre bot

Une fois le bot Hangouts Chat créé, vous pouvez en modifier les détails en cliquant sur le bouton CONFIGURER LES DÉTAILS DU BOT dans la fenêtre pop-up d'intégration. Cela vous amènera à la page Google Cloud Console dédiée à l'API Hangouts Chat.

Configurez et publiez votre bot en suivant les instructions du guide de publication de bots de l'API Hangouts Chat.

Activer et configurer l'intégration à l'aide de Cloud Console

Vous pouvez également activer l'intégration de Hangouts via Google Cloud Console en procédant comme suit :

  1. Dans Cloud Console, cliquez sur l'icône de menu dans l'angle supérieur gauche.
  2. Cliquez sur API et services, puis sur Tableau de bord.
  3. Cliquez sur ACTIVER DES API ET DES SERVICES.
  4. Recherchez "Hangouts Chat".
  5. Cliquez sur l'icône de l'API Hangouts Chat.
  6. Cliquez sur Activer.
  7. Cliquez sur Configuration dans le menu de la barre latérale gauche.
  8. Configurez et publiez votre bot en suivant les instructions du guide de publication de bots de l'API Hangouts Chat.

Test

Avant de tester votre bot, assurez-vous de l'avoir démarré. (Consultez la section Configurer).

Pour tester votre bot, procédez comme suit :

  1. Accédez à Hangouts Chat.
  2. Cliquez dans le champ Rechercher.
  3. Sélectionnez Rechercher un bot.
  4. Sélectionnez le nom de votre bot.
  5. Cliquez sur Message.

Dépannage

Erreur Solution
Votre administrateur a bloqué les interactions avec les bots dans les messages privés. Demandez à votre administrateur Google Workspace d'autoriser les utilisateurs à installer des bots.

Messages de réponses enrichies

Cette intégration traduit certains messages de réponses enrichies aux formats de messages Hangouts Chat.

Réponses textuelles

Les réponses textuelles sont envoyées à Hangouts au format SimpleText. Avec cette mise en forme, vous pouvez mettre le texte en gras ou en italique en l'encapsulant dans certains symboles (réduction claire).

La réponse SimpleText se présente visuellement comme la réponse textuelle par défaut dans la console Dialogflow. Cependant, la réponse de l'API brute sera légèrement différente. Elle définit également la configuration de la plateforme sur GOOGLE_HANGOUTS, ce qui peut être utile pour créer des agents pour plusieurs intégrations.

"fulfillmentMessages": [
{
   "text": {
   "text": [
        "This is a test."
   ]
},
  "platform": "GOOGLE_HANGOUTS"
},

Images

Les réponses sous forme d'images sont envoyées à Hangouts en tant que Widgets d'image Hangouts.

Fiches

Les réponses aux fiches sont envoyées à Hangouts sous forme de cartes Hangouts.

Charge utile personnalisée

Pour envoyer d'autres types de messages Hangouts, vous pouvez utiliser une charge utile personnalisée.

La charge utile personnalisée de Hangouts vous permet de créer des cartes plus avancées. Une fiche peut comporter une ou plusieurs sections. Chaque section peut avoir un en-tête. Vous pouvez consulter le guide de référence sur les fiches de formats de messages Hangouts pour découvrir certaines des combinaisons que vous pouvez créer avec ce produit. Cependant, si vous utilisez des charges utiles personnalisées, vous devrez fournir le format JSON.

Voici un exemple concret :

{
  "hangouts": {
    "header": {
      "title": "Pizza Bot Customer Support",
      "subtitle": "pizzabot@example.com",
      "imageUrl": "https://goo.gl/aeDtrS"
    },
    "sections": [{
      "widgets": [{
        "keyValue": {
          "icon": "TRAIN",
          "topLabel": "Order No.",
          "content": "12345"
        }
      },
      {
        "keyValue": {
          "topLabel": "Status",
          "content": "In Delivery"
        }
      }]
    },
    {
      "header": "Location",
      "widgets": [{
        "image": {
          "imageUrl": "https://dummyimage.com/600x400/000/fff"
        }
      }]
    },
    {
      "header": "Buttons - i could leave the header out",
      "widgets": [{
        "buttons": [{
          "textButton": {
            "text": "OPEN ORDER",
            "onClick": {
              "openLink": {
                "url": "https://example.com/orders/..."
              }
            }
          }
        }]
      }]
    }]
  }
}