Witaj świecie

Wysyłanie i odbieranie wiadomości oraz zdarzeń to podstawowe aspekty komunikacji między agentem a użytkownikiem. Agenty wysyłają wiadomości, zdarzenia i prośby do użytkowników za pomocą interfejsu Business Messages API, ale otrzymywać wiadomości i zdarzenia utworzone przez użytkowników w swoich webhookach w formacie JSON.

Poniżej znajdziesz przykładowy przepływ rozmowy, w którym wykorzystano przykładowe dane, aby pokazać, jak wiadomości, zdarzenia i prośby mogą być przydatne i wartościowe.

W tym przykładzie użytkownik rozpoczyna rozmowę i wysyła wiadomość „Cześć, Jestem „Świat!”, a agent odpowiada „Hello, World”.

  1. Użytkownik rozpoczyna rozmowę z agentem.
  2. Gdy użytkownik rozpocznie wpisywanie odpowiedzi, wysyła zdarzenie pisania do funkcji .

    {
      "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. Użytkownik wysyła wiadomość „Hello, I'm World!”. jako wiadomość.

    {
      "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. Agent wysyła wiadomość „Hello, World” jako wiadomość.

    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. Po dostarczeniu wiadomości urządzenie użytkownika zwraca potwierdzenie jej dostarczenia.

    {
      "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",
    }