Hello World

L'envoi et la réception de messages et d'événements sont les aspects essentiels de la communication entre un agent et un utilisateur. Les agents envoient des messages, des événements et des requêtes aux utilisateurs via l'API Business Messages, mais recevoir les messages et événements créés par les utilisateurs au niveau de leurs webhooks, au format JSON.

Vous trouverez ci-dessous un exemple de flux de conversation qui utilise des exemples de données pour illustrer les messages, les événements et les requêtes peuvent créer des interactions utiles et significatives.

Dans cet exemple, l'utilisateur démarre une conversation et envoie le message "Hello, I'm World!", puis l'agent répond "Hello, World".

1. L'utilisateur entame la conversation avec l'agent.

2. Dès que l'utilisateur commence à saisir une réponse, il envoie un événement de saisie au un agent.

   {
     "agent": "brands/1111/agents/2222",
     "conversationId": "3333",
     "customAgentId": "hello-world-bot",
     "requestId": "1234567890",
     "userStatus": {
       "isTyping": "true",
       "createTime": "2020-10-02T15:01:23.045123456Z",
     },
     "sendTime": "2020-10-02T15:01:24.045123456Z",
   }
   

3. L'utilisateur envoie "Hello, I'm World!" sous forme de message.

   {
     "agent": "brands/1111/agents/2222",
     "conversationId": "3333",
     "customAgentId": "hello-world-bot",
     "requestId": "123123123",
     "message": {
       "messageId": "4444",
       "name": "conversations/12345/messages/67890",
       "text": "Hello! I'm World!",
       "createTime": "2020-10-02T15:05:23.045123456Z",
     },
     "context": {
       "entryPoint": "PLACESHEET",
       "userInfo": {
         "displayName": "Michael",
         "userDeviceLocale": "en",
       },
       "resolvedLocale": "en",
     }
     "sendTime": "2020-10-02T15:05:24.045123456Z",
   }
   

4. L'agent envoie "Hello, World". sous forme de message.

   curl -X POST "https://businessmessages.googleapis.com/v1/conversations/3333/messages" \
   -H "Content-Type: application/json" \
   -H "`oauth2l header --json path/to/service/account/key.json businessmessages`" \
   -d "{
       'messageId': '5555',
       'text': 'Hello, World',
       'representative': {
         'avatarImage': 'https://hello.world/avatar.jpg',
         'displayName': 'Hello World Agent',
         'representativeType': 'BOT'
     }
   }"
   

5. Lors de la distribution du message, l'appareil de l'utilisateur renvoie un accusé de réception.

   {
     "agent": "brands/1111/agents/2222",
     "conversationId": "3333",
     "customAgentId": "hello-world-bot",
     "receipts" : {
       "receipts": [
         {
           "message": "conversations/3333/messages/5555",
           "receiptType": "DELIVERED",
         }
       ],
       "createTime": "2020-10-02T16:01:23.045123456Z",
     },
     "sendTime": "2020-10-02T16:01:24.045123456Z",
   }