Skonfiguruj konto partnera

Po zarejestrowaniu się jako partner RCS dla firm masz konto partnera. Aby uzyskać dostęp do ustawień konta partnera, otwórz Konsolę programisty RCS dla firm i kliknij Ustawienia konta partnera. W tym miejscu możesz wykonać te czynności:

• zaktualizować informacje o koncie partnera,
• dodawać, edytować i usuwać marki powiązane z kontem,
• zarządzać użytkownikami konta,
• utworzyć 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	Ta nazwa będzie się wyświetlać w raportach rozliczeniowych otrzymywanych przez operatorów (w polu owner_name ). Operatorzy będą jej używać, aby zidentyfikować Cię jako zaufanego partnera i wygenerować prawidłowe informacje do faktury za korzystanie z RCS dla firm w celu dotarcia do swoich subskrybentów. Podana tu nazwa powinna być zgodna z nazwą używaną w umowach z operatorami dotyczących przesyłania wiadomości.
Osoba kontaktowa do spraw technicznych	Osoba, z którą Google skontaktuje się w przypadku problemów technicznych z Twoimi agentami. Możesz zaktualizować jej imię i nazwisko, firmowy adres e-mail, numer telefonu.
Webhook	To jest adres URL punktu końcowego webhooka. Aby go zaktualizować, kliknij Skonfiguruj. Gdy skonfigurujesz webhooka partnera, będzie on obowiązywać w przypadku wszystkich Twoich agentów. Jeśli chcesz używać innego webhooka w przypadku poszczególnych agentów, możesz skonfigurować webhooka agenta, który będzie obowiązywać tylko w przypadku tego agenta.

Zarządzanie markami

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

Marka to organizacja lub grupa reprezentowana przez co najmniej jednego agenta. Na przykład firma świadcząca usługi finansowe Pod Dębem może utworzyć markę o nazwie Pod Dębem i agenta o nazwie Bank Pod Dębem, aby rozmawiać z klientami o usługach bankowych.

Aby dodawać, edytować i usuwać marki powiązane z kontem partnera, użyj strony Marki w Ustawieniach konta.

Dodawanie marki

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

Aby dodać markę, wpisz jej nazwę w polu tekstowym i kliknij Dodaj.

Edytowanie marki

Uwaga: aby edytować markę za pomocą interfejsu RBM Management API, zapoznaj się z dokumentacją dotyczącą 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

Nie można usunąć marki, jeśli jest ona powiązana z agentem, nawet jeśli agent nie został uruchomiony.

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

Zarządzanie użytkownikami

Na stronie Użytkownicy w Ustawieniach 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żera lub czytelnika.

• Menedżerowie mają dostęp do wszystkich funkcji Konsoli programisty i mogą zarządzać wszystkimi agentami należącymi do konta partnera.
• Czytelnicy mają dostęp tylko do odczytu w Konsoli programisty i mogą wyświetlać wszystkich agentów należących do konta partnera.

Dodawanie użytkownika

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

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

Usuwanie użytkownika

Aby usunąć użytkownika:

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

Usunięty użytkownik otrzyma e-maila z powiadomieniem o tym, ż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. Odszukaj użytkownika, którego chcesz zaktualizować, i kliknij przycisk w wierszu tabeli.
2. Kliknij Edytuj rolę.
3. W menu wybierz nową rolę.
4. Kliknij Zapisz.

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

Gdy wykonujesz wywołania interfejsu RBM API, uwierzytelniasz je 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 żądań 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:

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

Przechowuj klucz konta usługi w bezpiecznym, prywatnym miejscu. Nie udostępniaj klucza publicznie. Będziesz go potrzebować później, aby uzyskać dostęp do interfejsów RBM API.

Konfigurowanie webhooka partnera

Aby dowiedzieć się, jak skonfigurować webhooka partnera, zapoznaj się z przewodnikiem po webhookach.

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

Weryfikowanie wiadomości przychodzących

Webhooki mogą otrzymywać 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 otrzymana wiadomość została wysłana przez Google:

1. Wyodrębnij nagłówek X-Goog-Signature wiadomości. Jest to skrócona, zakodowana w base64 kopia ładunku treści wiadomości.
2. Zdekoduj ładunek RBM w 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 HMAC SHA512 bajtów ładunku wiadomości zdekodowanego w base64 i zakoduj wynik w base64.
4. Porównaj skrót X-Goog-Signature ze skrótem, który został utworzony.
   • Jeśli skróty są zgodne, oznacza to, że wiadomość została wysłana przez Google.

   • Jeśli skróty nie są zgodne, sprawdź proces tworzenia skrótu w przypadku znanej, prawidłowej wiadomości.

     Jeśli proces tworzenia skrótu działa prawidłowo i 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 .