31 lipca 2024 r. wycofamy Google Business Messages. Więcej informacji znajdziesz tutaj.

Ta strona została przetłumaczona przez Cloud Translation API.

Dodawanie automatyzacji przy użyciu Dialogflow

. Dialogflow jest narzędzie do tłumaczenia języka (NLU), które przetwarza dane wejściowe użytkownika i odwzorowuje je na znane Twoje zamiary i odpowiednie odpowiedzi. Są 2 wersje. Dialogflow. Dzięki integracji agenta Business Messages z Dialogflow ES możesz łatwo utworzyć prostą automatyzację, aby przyspieszyć rozwój agenta. Według dzięki integracji z Dialogflow CX, możesz tworzyć zaawansowaną automatyzację, do bardziej skomplikowanych rozmów.

Agenty Business Messages obsługują bezpośrednią integrację z

Dialogflow ES: boty dopasowujące intencje i boty z najczęstszymi pytaniami
Dialogflow CX: dopasowywanie intencji i przekazanie agenta na żywo

Integracja agenta Business Messages z innymi funkcjami Dialogflow ES lub Dialogflow CX znajdziesz w dokumentacji poszczególnych usług.

Gdy użytkownik wysyła wiadomość do agenta z integracją Dialogflow, Business Messages przekazuje wiadomość użytkownika do Dialogflow i wysyła wiadomości Dialogflow odpowiedź na agenta w wiadomości dialogflowResponse. Agenty można skonfigurować tak, automatycznie wysyłać odpowiedź Dialogflow do użytkownika bez konieczności wykonywania żadnych działań Zobacz Automatyczne odpowiedzi .

Integracja Dialogflow

Zanim zaczniesz korzystać z automatyzacji opartej na Dialogflow w Business Messages, musisz włączyć integrację Dialogflow.

Wymagania wstępne

Aby rozpocząć, musisz mieć

aplikacja Business Messages agent
agent Dialogflow w regionie Global (Cały świat) z językiem głównym w języku angielskim, (ang.)

Jeśli nie masz agenta Dialogflow, utwórz go.

Dialogflow ES

Aby włączyć integrację Dialogflow ES, musisz mieć Identyfikator projektu agenta Dialogflow. Aby znaleźć identyfikator projektu:

Otwórz konsolę Dialogflow.
Wybierz agenta Dialogflow, którego chcesz połączyć z Business Messages, kliknij ikonę koła zębatego obok nazwy agenta.
W sekcji Google Project (Projekt Google) zwróć uwagę na wartość Identyfikator projektu.

Dialogflow CX

Aby włączyć integrację Dialogflow CX, musisz mieć identyfikator projektu i agenta Dialogflow; Aby je znaleźć,

Otwórz konsolę Dialogflow CX.
Wybierz projekt Dialogflow.
W selektorze agentów kliknij rozszerzone menu obok agenta Dialogflow.
Kliknij Skopiuj nazwę. Imię i nazwisko agenta zostaną skopiowane do pola w tym formacie: projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID
Zapisz wartości identyfikatora projektu i identyfikatora agenta.

Włącz integrację

W konsoli programisty usług komunikacji biznesowej otwórz Integrations (Integracje).
W sekcji Dialogflow kliknij Włącz integrację.
Kliknij Połącz obecny model.
W polu Dialogflow Edition wybierz wersję, którą chcesz włączyć.
Wpisz identyfikator projektu agenta Dialogflow.
Aby włączyć Dialogflow CX, wpisz też identyfikator agenta agenta Dialogflow.
Jeśli chcesz, aby aplikacja Business Messages automatycznie odpowiadała użytkownikom za pomocą: Odpowiedzi Dialogflow wybierz Włącz automatyczną odpowiedź.
Kliknij Dalej.
Skopiuj adres e-mail konta usługi. To konto łączy Business Messages i agenty Dialogflow.
W Google Cloud konsola, wybierz swój projekt Dialogflow.
Otwórz Uprawnienia. .
Kliknij Dodaj i wpisz adres e-mail konta usługi w polu Nowe podmioty zabezpieczeń.
W polu Wybierz rolę wybierz Edytujący agenty konsoli Dialogflow.
Kliknij Dodaj kolejną rolę i wybierz Klient Dialogflow API.
Kliknij Zapisz.
W konsoli programisty Business Communications kliknij Dalej.
Kliknij Start integration (Rozpocznij integrację).

Połączenie Business Messages i Dialogflow trwa około 2 minut.

Zaktualizuj integrację

W konsoli programisty usług komunikacji biznesowej otwórz Integrations (Integracje).
Kliknij ikonę koła zębatego . obok Dialogflow.
Przełącz opcję Włącz automatyczną odpowiedź, jeśli chcesz. Business Messages, które pozwalają automatycznie odpowiadać użytkownikom za pomocą odpowiedzi Dialogflow.

Przełączanie się między wersjami Dialogflow

Agent Business Messages może obsługiwać tylko jedną integrację Dialogflow naraz. Aby przejść z jednej wersji Dialogflow na inną, musisz wyłączyć przed włączeniem nowej.

Wyłącz integrację

W konsoli programisty usług komunikacji biznesowej otwórz Integrations (Integracje).
Kliknij ikonę koła zębatego . obok Dialogflow.
Kliknij Wyłącz integrację.
Kliknij Wyłącz.

Wyłączenie istniejącej integracji Dialogflow może potrwać około minuty.

Włącz nową integrację Dialogflow, wykonując te czynności.

Dopasowywanie intencji

Po włączeniu integracji Dialogflow dla agenta Business Messages może użyć skonfigurowanych intencji w projekcie Dialogflow, aby przeanalizować odpowiadanie na pytania użytkowników bez konieczności pisania kodu. Aby dowiedzieć się więcej o: zapoznaj się z dokumentacją Dialogflow ES. i Dialogflow CX.

Skonfiguruj intencje Dialogflow dla każdej opcji konwersacji, którą chcesz do ich obsługiwania dzięki automatyzacji. Agenty Business Messages używają Dialogflow rozumieją przekaz użytkowników.

Wywołując interfejsy Dialogflow API, Business Messages przekazuje ładunek wiadomości użytkownika do intencji i webhooka realizacji. Gdy wiadomość do użytkownika zostanie dopasowana z intencją, możesz uzyskać dostęp do tego ładunku w formacie Struct w sekcji business_messages_payload w polu QueryParameters.

Ładunek zawiera wszystkie pola z wiadomości użytkownika oprócz pola DialogflowResponse.

W przypadku Dialogflow CX Business Messages przekazuje też parametr sesji o nazwie channel z wartością google_business_messages do intencji i możesz się do niego odwołać w agencie za pomocą tego formatu: $session.params.channel.

Za pomocą tego parametru możesz dodawać warunki do realizacji Dialogflow w celu obsługi wielu kanałów w tym samym agencie Dialogflow.

Więcej informacji o parametrach zapytania znajdziesz w materiałach dotyczących Dialogflow ES i Dialogflow CX.

Wymagania wstępne

Podczas tworzenia modeli NLU w Dialogflow możesz skonfigurować typów odpowiedzi na potrzeby intencji. Business Messages obsługuje odpowiedź domyślną, które mogą obejmować:

Tekst
Ładunek niestandardowy
Przekazywanie na żywo agenta (tylko w Dialogflow CX)

Ładunek niestandardowy musi pasować do prawidłowej odpowiedzi na wiadomość Business Messages w formacie JSON . Gdy konfigurujesz odpowiedzi ładunku niestandardowego dla intencji, Business Messages ignoruje następujące pola:

name
messageId
representative

Poniżej znajdziesz przykładowe odpowiedzi.

Tekst z sugestiami

{
  "text": "Hello World!",
  "fallback": "Hello World!\n\nReply with \"Hello\" or \"Hi!\"",
  "suggestions": [
    {
      "reply": {
        "text": "Hello",
        "postbackData": "hello-formal"
      }
    },
    {
      "reply": {
        "text": "Hi!",
        "postbackData": "hello-informal"
      }
    }
  ]
}

Karta informacyjna

{
  "fallback": "Hello, world!\nSent with Business Messages\n\nReply with \"Suggestion #1\" or \"Suggestion #2\"",
  "richCard": {
    "standaloneCard": {
      "cardContent": {
        "title": "Hello, world!",
        "description": "Sent with Business Messages.",
        "media": {
          "height": "TALL",
          "contentInfo":{
            "altText": "Google logo",
            "fileUrl": "https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png",
            "forceRefresh": "false"
          }
        },
        "suggestions": [
          {
            "reply": {
              "text": "Suggestion #1",
              "postbackData": "suggestion_1"
            }
          },
          {
            "reply": {
              "text": "Suggestion #2",
              "postbackData": "suggestion_2"
            }
          }
        ]
      }
    }
  }
}

Karuzela kart informacyjnych

{
  "fallback": "Card #1\nThe description for card #1\n\nCard #2\nThe description for card #2\n\nReply with \"Card #1\" or \"Card #2\"",
  "richCard": {
    "carouselCard": {
      "cardWidth": "MEDIUM",
      "cardContents": [
        {
          "title": "Card #1",
          "description": "The description for card #1",
          "suggestions": [
            {
              "reply": {
                "text": "Card #1",
                "postbackData": "card_1"
              }
            }
          ],
          "media": {
            "height": "MEDIUM",
            "contentInfo": {
              "fileUrl": "https://my.files/cute-dog.jpg",
              "forceRefresh": false
            }
          }
        },
        {
          "title": "Card #2",
          "description": "The description for card #2",
          "suggestions": [
            {
              "reply": {
                "text": "Card #2",
                "postbackData": "card_2"
              }
            }
          ],
          "media": {
            "height": "MEDIUM",
            "contentInfo": {
              "fileUrl": "https://my.files/elephant.jpg",
              "forceRefresh": false
            }
          }
        }
      ]
    }
  }
}

Przekazywanie na żywo pracownikowi obsługi klienta

{
  "metadata": {}
}

Boty typu FAQ

Po włączeniu integracji Dialogflow ES dla agenta Business Messages: może utworzyć bota FAQ. Gdy podasz pytania i odpowiedzi jako za pomocą obsługiwanego dokumentu wiedzy, Business Messages i Dialogflow, niezbędną infrastrukturę do rozumienia pytań użytkowników i odpowiadania na nie bez co nie wymaga pisania kodu.

Aby zobaczyć, jak działa bot z najczęstszymi pytaniami, porozmawiaj na czacie z najczęstszymi pytaniami dotyczącymi funkcji Business Messages Bot.

Wymagania wstępne

Zanim utworzysz bota z najczęstszymi pytaniami, musisz mieć dostępne pytania i odpowiedzi dokument wiedzy (maks. 50 MB): dostępny publicznie plik HTML lub CSV.

Ogólnie rzecz biorąc,

Może zawierać w odpowiedzi ograniczony tekst Markdown, zgodnie z opisem w sekcji Reklamy z elementami rozszerzonymi tekst.
Maksymalny rozmiar to 50 MB.
Nie może przekraczać 2000 par pytań i odpowiedzi.
Nie pozwalaj na duplikowanie pytań z różnymi odpowiedziami.

W przypadku plików HTML

Pliki z publicznych adresów URL muszą zostać zindeksowane przez indeks wyszukiwarki Google dzięki czemu będą one uwzględnione w indeksie wyszukiwania. Możesz to sprawdzić w Google Search Console. Pamiętaj, że narzędzie indeksujące nie dba o aktualność treści. Musisz wyraźnie aktualizowanie dokumentu po zmianie jego treści źródłowej.
Podczas tworzenia odpowiedzi Dialogflow usuwa tagi HTML z treści. Ponieważ w tym celu najlepiej unikać tagów HTML i w miarę możliwości używać zwykłego tekstu.
Pliki z jedną parą pytania i odpowiedzi nie są obsługiwane.

W przypadku plików CSV

Pliki muszą zawierać pytania w pierwszej kolumnie i odpowiedzi w drugiej bez nagłówka.
Pliki muszą zawierać przecinki jako separatory.

Utwórz bota z najczęstszymi pytaniami

W konsoli programisty usług komunikacji biznesowej otwórz Integrations (Integracje).
W sekcji Baza wiedzy kliknij Utwórz bazę wiedzy.
Wpisz nazwę bazy wiedzy, a następnie kliknij Dalej.
Wybierz Typ MIME.
Dodaj dokument wiedzy.
- Jeśli wybierzesz HTML jako typ MIME, wpisz nazwę publicznie dostępną Adres URL do najczęstszych pytań w adresie URL.
- Jeśli wybierzesz CSV jako Typ MIME, kliknij Prześlij i wybierz CSV.
Kliknij Dodaj i zakończ.

Aby dodać kolejne dokumenty do bota z najczęstszymi pytaniami, kliknij przycisk Dodaj dokumenty.

Gdy wykonasz te czynności, Business Messages będzie zawierać dialogflowResponse w komunikatach użytkownika wysyłanych do agenta. Jeśli włączysz automatyczną odpowiedź, Business Messages będzie odpowiadać użytkownikowi. z parą pytania/odpowiedzi o najwyższym wyniku matchConfidence, gdy: w porównaniu z wiadomością użytkownika.

Automatyczne odpowiedzi

Jeśli podczas integracji Dialogflow włączysz automatyczną odpowiedź, Wiadomości automatycznie odpowiadają użytkownikowi przy użyciu Dialogflow. Twoja firma Agent Wiadomości odpowiada zgodnie z najwyższym poziomem ufności. Dzięki integrację Dialogflow ES, jeśli odpowiedzi zawierają odpowiedzi na najczęstsze pytania oraz niestandardowi odbiorcy o podobnych zamiarach, Business Messages odpowiada dopasowaniem o największym poziom ufności.

Business Messages oznacza wszystkie wiadomości, na które odpowiedziano automatycznie, jako pochodzące z domeny BOT przedstawicielom. Jeśli Twój agent obsługuje agenty działające na żywo, Business Messages zawiesi automatyczne odpowiedzi po REPRESENTATIVE_JOINED wydarzenia i wznawia automatyczne odpowiedzi po REPRESENTATIVE_LEFT zdarzeniach. Zobacz Handoff z bota na agenta.

Automatyczne wysyłanie odpowiedzi na najczęstsze pytania

Dzięki integracji z Dialogflow ES, jeśli odpowiedź na najczęstsze pytania jest najpewniejsza Business Messages przypisze odpowiedź na SMS-a. Jeśli występuje jest powiązana, ale jest inna, ale wyświetla się komunikat „Wyświetl inną odpowiedź”. odpowiedź” sugestii. W przeciwnym razie wiadomość będzie zawierać pytanie i sugerowane odpowiedzi odpowiada na pytanie, czy wiadomość spełniła żądanie użytkownika.

Automatyczna odpowiedź z zamiarem użytkownika

Odpowiedzi dotyczące zamiarów mogą zawierać jedną lub więcej z poniższych odpowiedzi.

Dialogflow ES: Tekst, Ładunek niestandardowy
Dialogflow CX: Tekst, ładunek niestandardowy, Przekazywanie informacji o pracowniku obsługi klienta

Jeśli odpowiedź dotycząca intencji ma najwyższy poziom ufności, następujące warunki: ma zastosowanie.

Jeśli odpowiedź zawiera co najmniej 1 wartość tekstową, Business Messages mapuje ją do wiadomości tekstowej.
Jeśli odpowiedź zawiera co najmniej jeden ładunek niestandardowy z prawidłową wartością Business Struktura obiektu JSON Wiadomości, Business Messages tworzy wiadomość za pomocą podany obiekt JSON.
Jeśli odpowiedź zawiera co najmniej 1 odpowiedź na czacie na żywo z obsługi klienta, zapoznaj się z artykułem Automatyczna odpowiedź na prośbę pracownika obsługi klienta

Dialogflow może zawierać wiele odpowiedzi w ramach 1 dopasowania intencji, Business Messages wysyła każdą wiadomość tekstową, ładunek niestandardowy lub przekazanie na żywo agenta. jako oddzielną wiadomość. Jeśli intencja zawiera wiele wiadomości pasują, ale niektóre z nich mają nieprawidłowy format. Business Messages wysyła tylko prawidłowe jako automatyczne odpowiedzi.

Automatyczna odpowiedź na zaproszenie na żywo od pracownika obsługi klienta

Dialogflow CX obsługuje przekazywanie agenta na żywo. . Jest to sygnał, że rozmowę należy przekazać człowiekowi. i pozwala przekazać niestandardowe metadane . Jeśli odpowiedź dotycząca intencji ma najwyższy poziom ufności i to obejmuje przekazanie na żywo od pracownika obsługi klienta, Business Messages wysyła wydarzenie dla pracownika obsługi klienta transmisji na żywo do webhooka. Aby obsługiwać to zdarzenie, zobacz Przekazywanie z bota do pracownika obsługi klienta.

Automatyczna odpowiedź z komunikatem zastępczym

Jeśli Dialogflow nie uzyska wysokiej ufności, Business Messages wysyła w odpowiedzi kreacji zastępczej. Kreacje zastępcze są obsługiwane inaczej w Dialogflow ES i Dialogflow CX,

Dialogflow ES

Jeśli nie uda się znaleźć odpowiedzi na najczęstsze pytania botów, Business Messages wysyła że nie może znaleźć odpowiedzi.

Jeśli w przypadku skonfigurowanych intencji nie ma dopasowania do odpowiedzi dotyczącej intencji, wartość Business Wiadomości wysyłają odpowiedź intencji zastępczej. Możesz użyć tekstu zastępczego dostarczonego przez Dialogflow lub skonfigurować z dodatkowym tekstem i ładunkami niestandardowymi.

Oto przykładowa odpowiedź intencji zastępczej, którą Twój webhook może otrzymywać:

{
  "intentResponses": [
    {
      "intentName": "projects/df-integration/agent/intents/12345",
      "intentDisplayName": "Default Fallback Intent",
      "intentDetectionConfidence": "1.0",
      "fulfillmentMessages": [
        {
          "text": "One more time?"
        }
      ]
    }
  ]
}

Dialogflow wstępnie wypełnia pola intent_name i intent_display_name.

Dialogflow CX

Dialogflow CX obsługuje odpowiedzi intencji zastępczej jako wbudowanych zdarzeń. Jeśli nie uda się dopasować odpowiedzi do intencji, Business Messages wyśle z domyślnego zdarzenia braku dopasowania w Dialogflow. Dostępne opcje użyj tekstu zastępczego dostarczonego przez Dialogflow lub skonfiguruj kreację zastępczą z dodatkowym tekstem, ładunkami niestandardowymi i opcjami przekazywania na żywo agenta.

Oto przykład odpowiedzi intencji zastępczej, webhook może otrzymywać:

{
  "intentResponses": [
    {
      "intentName": "sys.no-match-default",
      "intentDisplayName": "Default Fallback Intent",
      "intentDetectionConfidence": "0.3",
      "fulfillmentMessages": [
        {
          "text": "I missed that, say that again?"
        }
      ]
    }
  ]
}

Business Messages koduje na stałe intent_name i intent_display_name.

Pola dotyczące Dialogflow

Po włączeniu integracji Dialogflow użytkownik będzie wysyłać wiadomości do agenta otrzymuje zastosuj dialogflowResponse. obiektu. Webhook otrzymuje ładunki dla wszystkich wiadomości użytkownika niezależnie od tego, czy Business Messages automatycznie odpowiedział na wiadomość na Twoim w imieniu Google. Aby sprawdzić automatyczną odpowiedź, sprawdź wartość autoResponded i zdecyduj, czy chcesz odpowiedzieć użytkownikowi.

Dialogflow ES

...
"dialogflowResponse": {
  "queryText": "TEXT",
  "intentResponse": {
    "intentName": "INTENT_ID",
    "intentDisplayName": "INTENT_NAME",
    "intentDetectionConfidence": "CONFIDENCE_NUMERIC",
    "fulfillmentMessages": [{
      "text": "FULFILLMENT_TEXT",
      "jsonPayload": "JSON",
      "error": "ERROR_STATUS",
    }],
  "faqResponse": {
    "userQuestion": "USER_QUESTION",
    "answers": [{
      "faqQuestion": "FAQ_QUESTION",
      "faqAnswer": "FAQ_ANSWER",
      "matchConfidenceLevel": "CONFIDENCE_LEVEL",
      "matchConfidence": "CONFIDENCE_NUMERIC",
    }],
  },
  "autoResponded": "BOOLEAN",
  "autoRespondedMessages": [{
    "message": "MESSAGE_JSON",
    "responseSource": "SOURCE",
  }],
},
...

Pole	Opis
`queryText`	Oryginalny tekst zapytania konwersacyjnego. Jeśli automatyczna pisownia poprawka jest włączona w modelu Dialogflow, `queryText` zawiera poprawione dane wejściowe użytkownika.
`intentName`	Unikalny identyfikator dopasowanej intencji.
`intentDisplayName`	Nazwa dopasowanej intencji.
`intentDetectionConfidence`	Liczbowa ocena ufności dopasowania od `queryText` do `intentName`.
`text`	Odpowiedź tekstowa.
`jsonPayload`	Odpowiedź z ładunkiem niestandardowym. Ten ciąg jest zgodny z ciągiem niestandardowym ładunek zdefiniowanego w Dialogflow. Jeśli ładunek nie ma prawidłowego pliku JSON Business Messages struktury obiektu, `error` opisuje problem.
`error`	Opis błędu z komunikatem o zrealizowaniu intencji.
`userQuestion`	Pytanie zadane przez użytkownika przetworzone przez Dialogflow.
`faqQuestion`	Pytanie z Dialogflow zostało dopasowane do pytania użytkownika.
`faqAnswer`	Odpowiedź z Dialogflow pasuje do pytania użytkownika.
`matchConfidenceLevel`	Poziom pewności dopasowania między `userQuestion` i `faqQuestion`.
`matchConfidence`	Liczbowa ocena ufności w zakresie dopasowania między `userQuestion` i `faqQuestion`.
`autoResponded`	czy Business Messages automatycznie odpowiedział(a) na użytkownik z odpowiedzią z Dialogflow.
`message`	Ładunek automatycznej odpowiedzi.
`responseSource`	Źródło automatycznej odpowiedzi. Zobacz `ResponseSource`

Dialogflow CX

...
"dialogflowResponse": {
  "queryText": "TEXT",
  "intentResponse": {
    "intentName": "INTENT_ID",
    "intentDisplayName": "INTENT_NAME",
    "intentDetectionConfidence": "CONFIDENCE_NUMERIC",
    "fulfillmentMessages": [{
      "text": "FULFILLMENT_TEXT",
      "jsonPayload": "JSON",
      "error": "ERROR_STATUS",
      "liveAgentHandoff": {
        "metadata": {}
      }
    }],
  "autoResponded": "BOOLEAN",
  "autoRespondedMessages": [{
    "message": "MESSAGE_JSON",
    "responseSource": "SOURCE",
  }],
},
...

Pole	Opis
`queryText`	Oryginalny tekst zapytania konwersacyjnego. Jeśli automatyczna pisownia poprawka jest włączona w modelu Dialogflow, `queryText` zawiera poprawione dane wejściowe użytkownika.
`intentName`	Unikalny identyfikator dopasowanej intencji.
`intentDisplayName`	Nazwa dopasowanej intencji.
`intentDetectionConfidence`	Liczbowa ocena ufności dopasowania od `queryText` do `intentName`.
`text`	Odpowiedź tekstowa.
`jsonPayload`	Odpowiedź z ładunkiem niestandardowym. Ten ciąg jest zgodny z ciągiem niestandardowym ładunek zdefiniowanego w Dialogflow. Jeśli ładunek nie ma prawidłowego pliku JSON Business Messages struktury obiektu, `error` opisuje problem.
`error`	Opis błędu z komunikatem o zrealizowaniu intencji.
`liveAgentHandoff`	Niestandardowe metadane procedury przekazania klienta na żywo.
`autoResponded`	czy Business Messages automatycznie odpowiedział(a) na użytkownik z odpowiedzią z Dialogflow.
`message`	Ładunek automatycznej odpowiedzi.
`responseSource`	Źródło automatycznej odpowiedzi. Zobacz `ResponseSource`