Updates: In den Versionshinweisen finden Sie Informationen zu neuen Funktionen und Produktupdates.

Diese Seite wurde von der Cloud Translation API übersetzt.

Partnerkonto einrichten

Sobald Sie sich als RBM-Partner registriert haben, haben Sie ein Partnerkonto. Wenn Sie auf die Einstellungen Ihres Partnerkontos zugreifen möchten, öffnen Sie die Business Communications Developer Console und klicken Sie auf Partnerkontoeinstellungen. Hier haben Sie folgende Möglichkeiten:

Informationen zum Partnerkonto aktualisieren

Auf der Seite Einstellungen können Sie Ihre Partner-ID aufrufen und die folgenden Informationen aktualisieren:

Feld	Beschreibung
Name des Partners	Name Ihres Partnerkontos
Anzeigename	Der Name wird in den RBM-Abrechnungsberichten angezeigt, die die Mobilfunkanbieter erhalten (im Feld `owner_name`). So können Mobilfunkanbieter Sie als vertrauenswürdigen Partner identifizieren und dafür sorgen, dass die korrekten Informationen für die Abrechnung Ihrer Nutzung von RBM zur Erreichung ihrer Abonnenten generiert werden. Der hier angegebene Name muss mit dem Namen übereinstimmen, der in Ihren Verträgen für Nachrichtenübermittlungen verwendet wird.
Technischer Ansprechpartner	Die Person, an die Google sich wenden soll, wenn technische Probleme mit Ihren Agents auftreten. Sie können die folgenden Informationen aktualisieren: Name Geschäftliche E-Mail-Adresse Telefonnummer
Webhook	Dies ist die URL Ihres Webhook-Endpunkts. Klicken Sie auf Konfigurieren, um sie zu aktualisieren. Wenn Sie den Webhook Ihres Partners konfigurieren, gilt er für alle Ihre Kundenservicemitarbeiter. Wenn Sie für einen einzelnen Kundenservicemitarbeiter einen anderen Webhook verwenden möchten, können Sie einen Webhook für Kundenservicemitarbeiter konfigurieren, der nur für diesen Mitarbeiter gilt.

Marken verwalten

Als RBM-Partner können Sie im Namen von Marken Kundenservicemitarbeiter erstellen.

Auf der Seite Marken in den Kontoeinstellungen können Sie Marken hinzufügen, bearbeiten und entfernen, die mit Ihrem Partnerkonto verknüpft sind.

Marke hinzufügen

Wenn Sie eine Marke hinzufügen möchten, geben Sie ihren Namen in das Eingabefeld ein und klicken Sie auf Hinzufügen.

Marke bearbeiten

So bearbeiten Sie eine Marke:

Klicken Sie auf das Kästchen neben dem Namen der Marke.
Klicken Sie auf die Schaltfläche und dann auf Namen bearbeiten.
Nehmen Sie die gewünschten Änderungen vor und klicken Sie auf Fertig.

Marke entfernen

Eine Marke kann nicht entfernt werden, wenn sie mit einem Kundenservicemitarbeiter verknüpft ist, auch wenn der Kundenservicemitarbeiter noch nicht gestartet wurde.

Wenn Sie eine Marke entfernen möchten, klicken Sie auf das Kästchen neben dem Namen der Marke und dann auf Löschen.

Nutzer verwalten

Auf der Seite Nutzer in den Kontoeinstellungen können Sie die Nutzer Ihres Partnerkontos verwalten. Der Nutzer, der das Partnerkonto erstellt hat, hat die Rolle „Inhaber“. Neue Nutzer können die Rolle „Administrator“ oder „Leser“ haben.

Manager können auf alle Funktionen der Entwicklerkonsole zugreifen, um alle Kundenservicemitarbeiter des Partnerkontos zu verwalten.
Leser haben Lesezugriff auf die Developer Console und können alle Kundenservicemitarbeiter aufrufen, die zum Partnerkonto gehören.

Nutzer hinzufügen

Wenn Sie einen Nutzer hinzufügen möchten, geben Sie seine E-Mail-Adresse in das Eingabefeld ein und wählen Sie seine Rolle aus.

Wenn Sie einen neuen Nutzer hinzufügen, erhält er eine E-Mail, in der er darüber informiert wird, dass er Zugriff auf das Partnerkonto hat.

Nutzer entfernen

So entfernen Sie Nutzer:

Suchen Sie den Nutzer, den Sie entfernen möchten, und klicken Sie in der entsprechenden Tabellenzeile auf die Schaltfläche .
Wählen Sie Nutzer entfernen aus.
Bestätigen Sie die Entfernung.

Der entfernte Nutzer wird per E-Mail darüber informiert, dass er keinen Zugriff mehr auf das Partnerkonto hat.

Nutzer mit der Rolle „Inhaber“ können nicht entfernt werden. Wenn Sie den Inhaber ändern oder entfernen möchten, wenden Sie sich an den Support.

Rolle eines Nutzers ändern

So aktualisieren Sie die Rolle eines Nutzers:

Suchen Sie den Nutzer, den Sie aktualisieren möchten, und klicken Sie in der entsprechenden Tabellenzeile auf die Schaltfläche .
Wählen Sie Rolle bearbeiten aus.
Wählen Sie im Drop-down-Menü eine neue Rolle aus.
Klicken Sie auf Speichern.

Dienstkonto zur Authentifizierung von API-Aufrufen einrichten

Wenn Sie Aufrufe an die RBM API senden, authentifizieren Sie sie mit einem Dienstkontoschlüssel. Mit diesem Schlüssel können Sie Marken und Kundenservicemitarbeiter erstellen und verwalten sowie als Kundenservicemitarbeiter Nachrichten und Anfragen senden. Ein Dienstkonto kann bis zu 10 Schlüssel haben.

Für die sichere Authentifizierung von API-Aufrufen benötigen Sie außerdem das Befehlszeilentool oauth2l.

So generieren Sie einen Dienstkontoschlüssel:

Rufen Sie in den Kontoeinstellungen die Seite Dienstkonto auf.
Klicken Sie auf Schlüssel erstellen und dann auf Erstellen. Der Browser lädt den Dienstkontoschlüssel herunter.

Bewahren Sie den Schlüssel für das Dienstkonto an einem sicheren, privaten Ort auf. Geben Sie Ihren Schlüssel nicht öffentlich bekannt. Diesen Schlüssel benötigen Sie später, um auf die RBM APIs zuzugreifen.

Partner-Webhook konfigurieren

Ein Webhook ist ein von einem Partner erstellter HTTPS-Callback, der angibt, wie Ihr Kundenservicemitarbeiter auf Nachrichten und Ereignisse reagieren soll. Nachdem Sie den Webhook konfiguriert haben, können Sie Nachrichten und Ereignisse empfangen.

Wenn Sie für einen Ihrer Kundenservicemitarbeiter einen anderen Webhook verwenden möchten, können Sie einen Webhook auf Agent-Ebene einrichten, der den Partner-Webhook überschreibt. Weitere Informationen finden Sie unter Webhook für Kundenservicemitarbeiter konfigurieren.

So konfigurierst du deinen Partner-Webhook:

Öffnen Sie die Business Communications Developer Console und melden Sie sich mit dem Google-Konto Ihres RBM-Partners an.
Öffnen Sie die Kontoeinstellungen.
Klicken Sie bei RCS Business Messaging webhook URL auf Konfigurieren.
Geben Sie unter Webhook-Endpunkt-URL die Webhook-URL ein, die mit „https://“ beginnt.
Notieren Sie sich den Wert von clientToken. Sie benötigen sie, um zu prüfen, ob die von Ihnen empfangenen Nachrichten von Google stammen.
Konfiguriere deinen Webhook so, dass er eine POST-Anfrage mit dem angegebenen clientToken-Parameter akzeptiert und eine 200 OK-Antwort mit dem Klartextwert des secret-Parameters als Antworttext sendet.

Angenommen, Ihr Webhook empfängt eine POST-Anfrage mit dem folgenden Inhalt:
```
{
  "clientToken":"SJENCPGJESMGUFPY",
  "secret":"1234567890"
}
```
sollte Ihr Webhook den Wert clientToken bestätigen und, falls clientToken korrekt ist, eine 200 OK-Antwort mit 1234567890 als Antworttext zurückgeben:
```
// 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);
});
```
Klicken Sie in der Developer Console auf Bestätigen. Wenn RBM Ihren Webhook bestätigt hat, wird das Dialogfeld geschlossen.

Informationen zum Umgang mit Webhook-Zustellungsfehlern und zur zuverlässigen Nachrichtenverarbeitung finden Sie unter Nachrichtenverarbeitung.

Eingehende Nachrichten prüfen

Da Webhooks Nachrichten von beliebigen Absendern empfangen können, sollten Sie vor der Verarbeitung des Nachrichteninhalts prüfen, ob die eingehenden Nachrichten von Google gesendet wurden.

So prüfen Sie, ob Google eine Nachricht gesendet hat, die Sie erhalten haben:

Extrahieren Sie die X-Goog-Signature-Kopfzeile der Nachricht. Dies ist eine gehashte, base64-codierte Kopie der Nutzlast des Nachrichtentexts.
Decodiere die RBM-Nutzlast im Element message.body der Anfrage mit Base64.
Erstelle mit dem Client-Token deines Webhooks (das du bei der Einrichtung des Webhooks angegeben hast) als Schlüssel einen SHA512-HMAC aus den Bytes der Base64-decodierten Nachrichtennutzlast und codiere das Ergebnis mit Base64.
Vergleichen Sie den X-Goog-Signature-Hash mit dem von Ihnen erstellten Hash.
- Wenn die Hash-Werte übereinstimmen, haben Sie bestätigt, dass Google die Nachricht gesendet hat.
- Wenn die Hash-Werte nicht übereinstimmen, prüfen Sie Ihren Hash-Prozess anhand einer fehlerfreien Nachricht.
  
  Wenn Ihr Hash-Verfahren ordnungsgemäß funktioniert und Sie eine Nachricht erhalten, die Ihrer Meinung nach betrügerisch an Sie gesendet wurde, kontaktieren Sie uns.

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);

Nächste Schritte

Ihr Partnerkonto ist jetzt eingerichtet. Jetzt können Sie Ihren ersten Kundenservicemitarbeiter erstellen.

Zurück

Als Partner registrieren

Weiter

Ersten Agent erstellen