Business Messages udostępnia interfejs internetowy o nazwie Business Communications Developer Console. W tej konsoli możesz tworzyć i uruchamiać agenty oraz nimi zarządzać.
Konsola programisty usług komunikacji biznesowej różni się od Google Cloud Platform. (GCP) Konsola Business Communications służy do zarządzania agentami Business Messages, a konsola GCP do zarządzania ustawieniami związanymi z GCP (na przykład rozliczeniami i interfejsami API) oraz innymi zasobami GCP.
Chociaż do tworzenia agentów i zarządzania nimi możesz używać Business Communications Developer Console, możesz używać Business Communications API do tworzenia agentów i zarządzania nimi w zaawansowanych scenariuszach, takich jak integracja z własną usługą.
Krótki przewodnik i instrukcje krok po kroku pokazują, jak korzystać z konsoli i interfejsów API. Ta strona zawiera ogólne podsumowanie układu interfejsu i jego przeznaczenia.
Jak jest używana konsola
Konsola służy do tworzenia, aktualizowania, weryfikowania i uruchamiania agentów oraz zarządzania nimi. Dzięki niemu możesz:
- Skonfiguruj webhooka i inne ustawienia konta partnera.
- Możesz tworzyć agenty zawierające wszystkie właściwości i dane definiujące konwersacyjną reprezentację marki i nią zarządzać.
- Skonfiguruj ustawienia agenta nielokalnego i dostępność wiadomości.
- Możesz tworzyć lokalizacje, które reprezentują fizyczną lokalizację firmy i nią zarządzają.
- Pobierz testowe adresy URL agenta i lokalizacji, aby sprawdzić, jak wygląda rozmowa z agentem.
- Integracja z Dialogflow w celu odpowiedzi na najczęstsze pytania.
- Potwierdź agenta i lokalizacje.
- Uruchom agenta i lokalizacje.
Ekran główny konsoli
Po pierwszym wczytaniu konsoli zobaczysz ekran wyboru agenta. Link do ustawień konta partnera na tej stronie prowadzi do ustawień konta partnera.
Dodatkowo ekran główny umożliwia:
- Wybierz istniejącego agenta.
- Utwórz nowe agenty.
- Sortuj agenty.
- Filtruj agentów według konta partnera.
Domyślnie agenty są wyświetlane w widoku kart. Agenty są uporządkowane według daty ostatniej aktualizacji. Aby przełączyć się na widok listy, użyj opcji Wyświetl jako po prawej stronie. W widoku listy agenty można sortować według nazwy, typu, stanu i daty ostatniej aktualizacji.
Jeśli masz wiele kont partnerów, możesz skorzystać z menu wyboru konta partnera, które umożliwia filtrowanie wyboru agentów według konta partnera.
Ustawienia konta
Na stronie Ustawienia możesz:
- Nazwa firmy
- Wyświetlana nazwa
- Osoba kontaktowa do spraw technicznych
- Webhook
W bocznym panelu użytkownika masz dostęp do zarządzania marką i użytkownikami, a także do kont usługi.
Zarządzanie marką
Marka to firma, organizacja lub grupa. Agent to konwersacyjna reprezentacja marki.
Na tej stronie możesz dodawać, edytować i usuwać marki. Usunięcie marki powoduje też usunięcie wszystkich powiązanych agentów. Marki nie można usunąć, jeśli jest powiązana z uruchomionym agentem.
Zarządzanie użytkownikami
Na tej stronie możesz dodawać i usuwać dostęp do zarejestrowanych kont partnerów. Aby przełączyć konta, użyj menu na górnym pasku nawigacyjnym.
Dodaj użytkownika
Aby dodać użytkownika, wpisz jego adres e-mail w polu wpisywania adresu e-mail i wybierz rolę.
Nowi użytkownicy mogą mieć przypisane role Menedżer lub Odczytujący. Rola zarządcy ma dostęp do wszystkich funkcji konsoli, a rola odczytu umożliwia dostęp tylko do odczytu do informacji o agencie i lokalizacji.
Gdy dodasz nowego użytkownika, otrzyma on e-maila z powiadomieniem, że ma już dostęp do konta partnera.
Adres e-mail zarejestrowany pierwotnie na koncie partnera ma rolę Właściciel.
Usuwanie użytkowników
Aby usunąć użytkownika:
- Znajdź na liście użytkownika, którego chcesz usunąć.
- Kliknij przycisk .
- Kliknij Usuń użytkownika.
- Potwierdź usunięcie.
Usunięty użytkownik otrzyma e-maila z powiadomieniem, że nie ma już dostępu do konta.
Nie możesz usunąć użytkownika z rolą właściciela. Aby zmienić lub usunąć właściciela, musisz skontaktować się z zespołem pomocy.
Zmienianie roli użytkownika
Aby zaktualizować rolę użytkownika:
- Znajdź użytkownika, którego chcesz zaktualizować.
- Kliknij przycisk .
- Wybierz Edytuj rolę.
- Wybierz nową rolę z menu.
- Kliknij Zapisz.
Konta usługi
Wykonując wywołania interfejsów Business Communications i Business Messages API, uwierzytelniasz połączenia za pomocą klucza konta usługi. Klucze konta usługi umożliwiają tworzenie marek, agentów i lokalizacji oraz zarządzanie nimi, a także wysyłanie wiadomości i próśb jako agent.
Aby wygenerować klucz konta usługi, wybierz w bocznym panelu nawigacyjnym Konta usługi. Otworzy się konsola GCP dla projektu GCP powiązanego z aktualnie wybranym kontem partnera.
Aby utworzyć konto usługi i klucz:
- Kliknij Utwórz konto usługi.
- W polu Nazwa konta usługi wpisz nazwę agenta, a następnie kliknij Utwórz.
- Kliknij Gotowe.
- Znajdź w tabeli nowe konto usługi, a następnie kliknij > Utwórz klucz.
- Wybierz JSON i kliknij Utwórz.
Twoja przeglądarka pobiera klucz konta usługi.
Wybór agenta
Po wybraniu agenta otworzy się strona Przegląd dla wybranego agenta.
Przegląd obejmuje:
- Nazwa marki
- Nazwa agenta
- Konto partnera, na którym utworzono agenta
- Identyfikator marki
- Identyfikator agenta.
- Testowe adresy URL agenta pozwalają sprawdzić, jak rozmowa z tym agentem jest widoczna dla użytkowników, oraz zweryfikować infrastrukturę wiadomości.
- Stan weryfikacji agenta
- Podgląd agenta
- Lokalizacje powiązane z agentem
- Linki do odpowiednich dokumentów
Nawigacja po lewej stronie zapewnia dostęp do tych funkcji:
- Informacje o agencie
- Lokalizacje
- Integracje
- Pytania ankiety
- Dzienniki debugowania
- Weryfikacja
- Uruchomienie kampanii
- Panel danych
- Linki do odpowiednich dokumentów
Informacje o agencie
Na stronie informacji o agencie możesz zaktualizować właściwości agenta.
Strona jest podzielona na 2 kolumny. Pola do wprowadzania danych w lewej kolumnie służą do aktualizowania pól agenta, takich jak nazwa agenta, logo, wiadomość powitalna, rozpoczęcie rozmowy i właściwości dotyczące lokalizacji oraz nielokalnych punktów wejścia. Po uruchomieniu agenta nie możesz aktualizować niektórych pól, takich jak Nazwa agenta i Logo.
W prawej kolumnie znajdziesz testowe adresy URL agenta, których podgląd możesz zobaczyć na urządzeniu użytkownika.
Zarządzanie lokalizacją
Na tej stronie możesz dodawać lokalizacje, pobierać testowe adresy URL lokalizacji firmy i potwierdzać lokalizacje po zweryfikowaniu agenta.
Integracje
Na tej stronie możesz zintegrować platformę Dialogflow i skonfigurować bota, który będzie udzielał odpowiedzi na najczęstsze pytania.
Ankiety
Na tej stronie możesz dostosowywać ankietę dla agenta.
Logi
Na tej stronie możesz debugować problemy z dostarczaniem wiadomości. Logi są dostępne przez 14 dni. Aby znaleźć dzienniki dotyczące problemów użytkowników, przefiltruj je według identyfikatora rozmowy, identyfikatora wiadomości, sygnatury czasowej, kierunku lub stanu. Możesz też zajrzeć na tę stronę, by sprawdzić, czy nie wysyłasz celowo nieprawidłowych wiadomości.
Dzienniki zawierają ładunki wiadomości z wyjątkiem usuniętych pól poufnych, takich jak treść wiadomości. Dodatkowe wiadomości o błędach i odrzuconych wiadomościach mają dodatkowe szczegóły, które mogą pomóc w debugowaniu.
Niektóre zdarzenia, np. wskaźniki pisania, nie mają rachunków z dostawą, a ich stan to „Wysłane”.
Weryfikacja
Na tej stronie możesz przesłać agenta do weryfikacji.
Uruchom
Na tej stronie możesz uruchomić agenta na potrzeby lokalizacji i nielokalnych punktów wejścia, a także uruchamiać poszczególne lokalizacje.
