Skonfiguruj konto partnera

Po zarejestrowaniu się jako partner RCS dla firm otrzymasz konto partnera. Aby otworzyć ustawienia konta partnera, otwórz Konsolę dewelopera RCS dla firm i kliknij Ustawienia konta partnera. Możesz tu wykonać te czynności:

• Aktualizowanie informacji o koncie partnera
• Dodawanie, edytowanie i usuwanie marek połączonych z Twoim kontem
• Zarządzanie użytkownikami konta
• Utwórz konto usługi i klucz do uwierzytelniania wywołań interfejsu API

Aktualizowanie informacji o koncie partnera

Na stronie Ustawienia możesz wyświetlić identyfikator partnera i zaktualizować te informacje:

Pole	Opis
Nazwa partnera	Nazwa konta partnera
Wyświetlana nazwa	Nazwa będzie widoczna w  raportach rozliczeniowych, które otrzymują operatorzy (w polu owner_name). Operatorzy wykorzystają te informacje, aby zidentyfikować Cię jako zaufanego partnera i wygenerować prawidłowe informacje rozliczeniowe dotyczące korzystania przez Ciebie z RCS dla firm w celu docierania do ich subskrybentów. Podana tu nazwa powinna być zgodna z nazwą używaną w umowach dotyczących wiadomości operatora.
Osoba kontaktowa do spraw technicznych	Osoba, z którą ma kontaktować się Google w przypadku problemów technicznych z agentami. Możesz zaktualizować Nazwa Firmowy adres e-mail Numer telefonu
Webhook	To adres URL punktu końcowego webhooka. Aby ją zaktualizować, kliknij Skonfiguruj. Gdy skonfigurujesz webhooka partnera, będzie on obowiązywać w przypadku wszystkich Twoich pracowników obsługi klienta. Jeśli chcesz użyć innego webhooka dla poszczególnych agentów, możesz skonfigurować webhooka agenta, który będzie dotyczył tylko tego agenta.

Zarządzanie markami

Jako partner RCS dla firm możesz tworzyć agentów w imieniu marek.

Na stronie Marki w Ustawieniach konta możesz dodawać, edytować i usuwać marki powiązane z kontem partnera.

Dodaj markę

Uwaga: aby dodać markę za pomocą interfejsu RBM Management API, zapoznaj się z dokumentacją tworzenia marki.

Aby dodać markę, wpisz jej nazwę w polu do wprowadzania danych i kliknij Dodaj.

Edytowanie marki

Uwaga: aby edytować markę za pomocą interfejsu RBM Management API, zapoznaj się z dokumentacją na temat zmiany nazwy marki.

Aby edytować markę:

1. Kliknij pole wyboru obok nazwy marki.
2. Kliknij przycisk  i wybierz Edytuj nazwę.
3. Wprowadź zmiany i kliknij Gotowe.

Usuwanie marki

Marki nie można usunąć, jeśli jest powiązana z agentem, nawet jeśli agent nie jest uruchomiony.

Aby usunąć markę, kliknij pole wyboru obok jej nazwy, a następnie kliknij Usuń.

Zarządzanie użytkownikami

Na stronie Użytkownicy w sekcji Ustawienia konta możesz zarządzać użytkownikami konta partnera. Użytkownik, który utworzył konto partnera, ma rolę właściciela. Nowi użytkownicy mogą mieć rolę Menedżer lub Czytelnik.

• Menedżerowie mają dostęp do wszystkich funkcji Konsoli programisty, dzięki czemu mogą zarządzać wszystkimi agentami należącymi do konta partnera.
• Użytkownicy z dostępem do odczytu mają dostęp tylko do odczytu do konsoli programisty, aby wyświetlać wszystkich agentów należących do konta partnera.

Dodawanie użytkownika

Aby dodać użytkownika, wpisz jego adres e-mail w polu do wprowadzania danych i wybierz jego rolę.

Gdy dodasz nowego użytkownika, otrzyma on e-maila z powiadomieniem o tym, że ma dostęp do konta partnera.

usuwać użytkowników,

Aby usunąć użytkownika:

1. Znajdź użytkownika, którego chcesz usunąć, i kliknij przycisk w wierszu tabeli tego użytkownika.
2. Kliknij Usuń użytkownika.
3. Potwierdź usunięcie.

Usunięty użytkownik otrzyma e-maila z powiadomieniem, że nie ma już dostępu do konta partnera.

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.

Zmiana roli użytkownika

Aby zaktualizować rolę użytkownika:

1. Znajdź użytkownika, którego chcesz zaktualizować, i w wierszu tabeli kliknij przycisk .
2. Kliknij Edytuj rolę.
3. Wybierz nową rolę z menu.
4. Kliknij Zapisz.

Konfigurowanie konta usługi do uwierzytelniania wywołań interfejsu API

Gdy wywołujesz RBM API, uwierzytelniasz wywołania za pomocą klucza konta usługi. Ten klucz umożliwia tworzenie marek i agentów oraz zarządzanie nimi, a także wysyłanie wiadomości i próśb jako agent. Konto usługi może mieć maksymalnie 10 kluczy.

Aby bezpiecznie uwierzytelniać wywołania interfejsu API, potrzebujesz też narzędzia wiersza poleceń oauth2l.

Aby wygenerować klucz konta usługi, wykonaj te czynności:

1. W Ustawieniach konta otwórz stronę Konto usługi.
2. Kliknij Utwórz klucz, a następnie Utwórz. Przeglądarka pobierze klucz konta usługi.

Przechowuj klucz konta usługi w bezpiecznym, prywatnym miejscu. Nie udostępniaj klucza publicznie. Ten klucz będzie Ci później potrzebny do uzyskania dostępu do interfejsów RBM API.

Konfigurowanie webhooka partnera

Informacje o konfigurowaniu webhooka partnera znajdziesz w przewodniku Webhooks.

Wskazówki dotyczące asynchronicznego przetwarzania webhooków, aby zapobiec niepowodzeniom dostarczania, znajdziesz w sekcji Obsługa wiadomości.

Weryfikowanie wiadomości przychodzących

Webhooki mogą odbierać wiadomości od dowolnych nadawców, dlatego przed przetworzeniem treści wiadomości należy sprawdzić, czy zostały one wysłane przez Google.

Aby sprawdzić, czy wiadomość została wysłana przez Google, wykonaj te czynności:

1. Wyodrębnij X-Goog-Signaturenagłówek wiadomości. Jest to zaszyfrowana i zakodowana w base64 kopia treści wiadomości.
2. Zdekoduj ładunek RBM w formacie Base64 w elemencie message.body żądania.
3. Używając tokena klienta webhooka (który został określony podczas konfigurowania webhooka) jako klucza, utwórz SHA512 HMAC z bajtów ładunku wiadomości zdekodowanego w base64 i zakoduj wynik w base64.
4. Porównaj hash X-Goog-Signature z utworzonym przez siebie hashem.
   • Jeśli hasze są zgodne, oznacza to, że wiadomość została wysłana przez Google.

   • Jeśli zahaszowane adresy nie pasują do Twoich wyników, sprawdź proces haszowania na znanym, prawidłowym komunikacie.

     Jeśli proces haszowania działa prawidłowo, a otrzymasz wiadomość, która Twoim zdaniem została wysłana w sposób nieuczciwy, skontaktuj się z nami.

Node.js

  if ((requestBody.hasOwnProperty('message')) && (requestBody.message.hasOwnProperty('data'))) {
    // Validate the received hash to ensure the message came from Google RBM
    const headerHash = req.header('X-Goog-Signature');
    const userEventString = Buffer.from(requestBody.message.data, 'base64');
    const hmac = crypto.createHmac('sha512', myClientToken);
    const genHash = hmac.update(userEventString).digest('base64');

    if (headerHash === genHash) {
      const userEvent = JSON.parse(userEventString);
      const webhookType = req.header('X-Goog-Webhook-Type');

      // Route based on the header type
      if (webhookType === 'message_callback') {
        handleMessage(userEvent);
      } else if (webhookType === 'agent_callback') {
        handleAgentEvent(userEvent);
      }
    } else {
      console.log('Hash mismatch - ignoring message');
      res.sendStatus(401);
      return;
    }
  }

  res.sendStatus(200);
  

Dalsze kroki

Po skonfigurowaniu konta partnera możesz utworzyć pierwszego agenta.