Skonfiguruj konto partnera

Po zarejestrowaniu się jako partner RBM otrzymasz konto partnera. Aby uzyskać dostęp do ustawień konta partnera, otwórz konsolę programisty komunikacji biznesowej i kliknij Ustawienia konta partnera. W tym miejscu możesz wykonać te czynności:

Zaktualizuj informacje o koncie partnera

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

Pole Opis
Nazwa partnera Nazwa konta partnera
Wyświetlana nazwa Nazwa pojawi się w raportach rozliczeniowych RBM otrzymywanych przez operatorów (w polu owner_name). Operatorzy będą wykorzystali te informacje, aby potwierdzić, że jesteś zaufanym partnerem, i upewnić się, że wygenerują prawidłowe informacje do fakturowania, aby umożliwić Ci kontakt z subskrybentami za pomocą RBM. Podana tutaj nazwa powinna być zgodna z nazwą używaną w Twoich umowach z operatorem przesyłania wiadomości.
Osoba kontaktowa do spraw technicznych

Osoba, z którą Google będzie kontaktować się w razie problemów technicznych z agentami. Możesz zaktualizować ich

  • Nazwa
  • Firmowy adres e-mail
  • Numer telefonu
Webhook To jest adres URL punktu końcowego webhooka. Kliknij **Skonfiguruj**, aby ją zaktualizować. Gdy skonfigurujesz webhooka partnera, będzie on stosowany do wszystkich agentów. Jeśli chcesz użyć innego webhooka dla pojedynczego agenta, możesz skonfigurować webhooka agenta, który będzie stosowany tylko do tego agenta.

Zarządzaj markami

Jako partner RBM 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ę

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

Edytowanie 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

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, a następnie kliknij Usuń.

Zarządzanie kontami użytkowników

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żer lub Odczytujący.

  • Menedżerowie mają dostęp do wszystkich funkcji Developer Console, dzięki czemu mogą zarządzać wszystkimi agentami należącymi do konta partnera.
  • Czytelnicy mają dostęp tylko do odczytu do Konsoli programisty, dzięki którym mogą wyświetlać wszystkich agentów należących do konta partnera.

Dodaj 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, że ma dostęp do konta partnera.

Usuwanie użytkowników

Aby usunąć użytkownika:

  1. Znajdź 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, ż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 kliknij przycisk w wierszu tabeli.
  2. Wybierz Edytuj rolę.
  3. Wybierz nową rolę z menu.
  4. Kliknij Zapisz.

Skonfiguruj konto usługi, aby uwierzytelnić wywołania interfejsu API

Podczas wywoływania interfejsu API RBM uwierzytelniasz wywołania za pomocą klucza konta usługi. Umożliwia on tworzenie marek i agentów oraz zarządzanie nimi, a także wysyłanie wiadomości i żądań jako agent.

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

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

Przechowuj klucz konta usługi w bezpiecznej, prywatnej lokalizacji. Nie udostępniaj swojego klucza publicznie. Będzie on potrzebny później do uzyskania dostępu do interfejsów API RBM.

Skonfiguruj webhooka partnera

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

Aby skonfigurować webhooka partnera, wykonaj te czynności:

  1. Otwórz konsolę programisty komunikacji biznesowej i zaloguj się na konto Google partnera RBM.

  2. Otwórz Ustawienia konta.

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

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

  5. Zapisz wartość clientToken. Jest on potrzebny do weryfikowania, czy odbierane przez Ciebie wiadomości pochodzą od Google.

  6. Skonfiguruj webhooka, aby akceptował żądanie POST z określonym parametrem clientToken i wysłał odpowiedź 200 OK zawierającą zwykły tekst wartości parametru secret jako treść odpowiedzi.

    Jeśli na przykład webhook otrzyma żądanie POST z tą treścią główną

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

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

    // 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 zweryfikuje webhooka, okno się zamknie.

Weryfikowanie wiadomości przychodzących

Webhooki mogą odbierać wiadomości od dowolnych nadawców, dlatego przed przetworzeniem ich treści musisz sprawdzić, czy Google wysłał wiadomości przychodzące.

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

  1. Wyodrębnij nagłówek X-Goog-Signature wiadomości. Jest to zaszyfrowana kopia ładunku treści wiadomości zakodowana w formacie base64.
  2. Dekodowanie ładunku RBM w standardzie Base-64 w elemencie message.body żądania.
  3. Korzystając z tokena klienta webhooka (określonego podczas konfigurowania webhooka) jako klucza, utwórz SHA512 HMAC bajtów ładunku zdekodowanego w formacie base-64 i zakoduj wynik w standardzie base64.
  4. Porównaj hasz funkcji X-Goog-Signature z utworzonym przez siebie haszem.
    • Jeśli hasze są zgodne, oznacza to, że wiadomość została wysłana przez Google.

    • Jeśli hasze nie są zgodne, sprawdź swój proces haszowania w przypadku dobrze znanej wiadomości.

      Jeśli proces haszowania działa prawidłowo i otrzymujesz 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

Skoro konto partnera jest już skonfigurowane, czas utworzyć pierwszego agenta.