Skonfiguruj konto partnera

Po zarejestrowaniu się jako partner RBM uzyskujesz dostęp do konta partnera. Aby uzyskać dostęp do ustawień konta partnera, otwórz Konsolę dewelopera w usłudze Business Communications i kliknij Ustawienia konta partnera. Tutaj możesz:

• Aktualizowanie informacji o koncie partnera
• Dodawanie, edytowanie i usuwanie marek połączonych z kontem
• Zarządzanie użytkownikami konta
• Tworzenie konta usługi i klucza 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 pojawi się w  raportach płatności RBM, które otrzymują operatorzy (jako pole owner_name). Operatorzy będą używać tych informacji, aby zidentyfikować Cię jako zaufanego partnera i zapewnić, że generują prawidłowe informacje do fakturowania w przypadku korzystania przez Ciebie z usługi RBM w celu dotarcia do subskrybentów. Podana tutaj nazwa powinna być zgodna z nazwą używaną w umowach dotyczących przesyłania wiadomości przez 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 jest adres URL punktu końcowego webhooka. Aby zaktualizować ustawienie, kliknij Skonfiguruj. Gdy skonfigurujesz webhook partnera, będzie on obowiązywał wszystkich Twoich agentów. Jeśli chcesz użyć innego webhooka dla konkretnego agenta, możesz skonfigurować webhook, który będzie dotyczyć tylko tego agenta.

Zarządzanie markami

Jako partner RBM możesz tworzyć agentów w imieniu marek.

Marka Organizacja lub grupa reprezentowana przez co najmniej 1 agenta. Na przykład firma oferująca usługi finansowe Growing Tree może utworzyć markę Growing Tree i udzielić klientom informacji o usługach bankowych za pomocą agenta o nazwie Growing Tree Bank.

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

Dodaj markę

Uwaga: aby dodać markę za pomocą interfejsu RBM Management API, zapoznaj się z dokumentacją Tworzenie 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ą Zmiana nazwy marki.

Aby edytować markę:

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

Usuwanie marki

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

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

Zarządzaj użytkownikami

Na stronie Użytkownicy w sekcji Ustawienia konta możesz zarządzać użytkownikami swojego 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 dewelopera, aby zarządzać wszystkimi agentami należącymi do konta partnera.
• Użytkownicy z rolą „czytelnika” mają dostęp tylko do odczytu do konsoli programisty, aby wyświetlać wszystkie elementy i 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 rolę.

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

usuwać użytkowników,

Aby usunąć użytkownika:

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

Użytkownik, którego usunęliśmy, 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, skontaktuj się z zespołem pomocy.

Zmiana roli użytkownika

Aby zaktualizować rolę użytkownika:

1. Znajdź użytkownika, którego dane chcesz zaktualizować, i w wierszu jego konta w tabeli kliknij przycisk .
2. Wybierz 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, uwierzytelniam 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 zapytań jako agent. Konto usługi może mieć maksymalnie 10 kluczy.

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

Aby wygenerować klucz konta usługi:

1. W sekcji Ustawienia konta otwórz stronę Konto usługi.
2. Kliknij kolejno Utwórz klucz i Utwórz. Przeglądarka pobierze klucz konta usługi.

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

Konfigurowanie webhooka partnera

Uwaga: aby skonfigurować webhook partnera za pomocą interfejsu API, zapoznaj się z dokumentacją Tworzenie integracji webhooka.

Webhook to wywołanie zwrotne HTTPS utworzone przez partnera, które określa, jak Twój agent powinien reagować na wiadomości i zdarzenia. Po skonfigurowaniu webhooka możesz otrzymywać wiadomości i zdarzenia.

Jeśli chcesz użyć innego webhooka dla któregokolwiek z Twoich agentów, możesz skonfigurować webhooka na poziomie agenta, który zastąpi webhooka partnera. Więcej informacji znajdziesz w artykule Konfigurowanie webhooka agenta.

Aby skonfigurować webhook partnera:

1. Otwórz konsolę programistów Business Communications i zaloguj się na konto Google powiązane z Twoim partnerem RBM.

2. Otwórz Ustawienia konta.

3. W polu URL webhooka RCS Business Messaging kliknij Skonfiguruj.

4. W polu URL punktu końcowego webhooka wpisz adres URL webhooka rozpoczynający się od „https://”.

5. Zanotuj wartość clientToken. Potrzebujesz go, aby potwierdzić, że otrzymywane wiadomości pochodzą od Google.

6. Skonfiguruj webhooka tak, aby akceptował żądanie POST z określonym parametrem clientToken, i wysyłaj odpowiedź 200 OK z wartością w postaci zwykłego tekstu parametru secret jako treść odpowiedzi.

   Jeśli np. webhook otrzyma żądanie POST z treścią w polu body

   {
     "clientToken":"SJENCPGJESMGUFPY",
     "secret":"1234567890"
   }
   

   webhook powinien potwierdzić wartość clientToken i, jeśli clientToken jest prawidłowa, zwrócić odpowiedź 200 OK z wartością 1234567890 w treści odpowiedzi:

   // clientToken from Configure
   const myClientToken = "SJENCPGJESMGUFPY";
   
   // Example endpoint
   app.post("/rbm-webhook", (req, res) => {
     const msg = req.body;
     if (msg.clientToken === myClientToken) {
         res.status(200).send(msg.secret);
         return;
     }
     res.send(400);
   });
   

7. W Konsoli programisty kliknij Zweryfikuj. Gdy RBM potwierdzi Twój webhook, okno zamknie się.

Informacje o rozwiązywaniu problemów z dostarczaniem wywołania zwrotnego i zapewnianiu niezawodnego przetwarzania wiadomości znajdziesz w artykule Postępowanie z wiadomościami.

Sprawdzanie wiadomości przychodzących

Ponieważ webhooki mogą otrzymywać wiadomości od dowolnych nadawców, przed przetworzeniem treści wiadomości sprawdź, czy Google wysłał przychodzące wiadomości.

Aby sprawdzić, czy Google wysłało otrzymaną wiadomość:

1. Wyodrębnij nagłówek X-Goog-Signature wiadomości. Jest to skrót szyfrowania szyfrowania base64 treści komunikatu.
2. Zdekoduj dane RBM w elementach message.body żądania.
3. Użyj tokena klienta webhooka (który został określony podczas konfigurowania webhooka) jako klucza, aby utworzyć HMAC SHA512 z bajtów dekodowanych za pomocą base64 z ładunku wiadomości i zakodować wynik w formacie base64.
4. Porównaj hasz X-Goog-Signature z utworzoną przez siebie wartością.
   • Jeśli hasze są zgodne, oznacza to, że wiadomość została wysłana przez Google.

   • Jeśli hasze nie pasują, sprawdź proces haszowania na wiadomości, która działa prawidłowo.

     Jeśli proces szyfrowania działa prawidłowo, a otrzymasz wiadomość, która Twoim zdaniem została wysłana w wyniku oszustwa, 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
    let userEventString = Buffer.from(requestBody.message.data, 'base64');
    let hmac = crypto.createHmac('sha512', CLIENT_TOKEN);
    let data = hmac.update(userEventString);
    let genHash = data.digest('base64');
    let headerHash = req.header('X-Goog-Signature');

    if (headerHash === genHash) {
      let userEvent = JSON.parse(userEventString);

      console.log('userEventString: ' + userEventString);
      handleMessage(userEvent);
    } else {
      console.log('hash mismatch - ignoring message');
    }
  }

  res.sendStatus(200);
  

Dalsze kroki

Gdy już skonfigurujesz konto partnera, możesz utworzyć pierwszego agenta.