Partnerkonto einrichten

Nach der Registrierung als RCS for Business-Partner haben Sie ein Partnerkonto. Wenn Sie auf die Einstellungen Ihres Partnerkontos zugreifen möchten, öffnen Sie die RCS for Business Developer Console und klicken Sie auf Partner account settings (Einstellungen des Partnerkontos). Hier haben Sie folgende Möglichkeiten:

• Informationen zum Partnerkonto aktualisieren
• Mit Ihrem Konto verknüpfte Marken hinzufügen, bearbeiten und entfernen
• Kontonutzer verwalten
• Dienstkonto und Schlüssel zur Authentifizierung von API-Aufrufen erstellen

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 Abrechnungsberichten angezeigt, die Mobilfunkanbieter erhalten (als Feld owner_name). Mobilfunkanbieter verwenden diese Informationen, um Sie als vertrauenswürdigen Partner zu identifizieren und die korrekten Abrechnungsinformationen für Ihre Nutzung von RCS for Business zur Kontaktaufnahme mit ihren Abonnenten zu generieren. Der hier angegebene Name sollte mit dem Namen in Ihren Messaging-Verträgen mit Mobilfunkanbietern übereinstimmen.
Technischer Ansprechpartner	Die Person, an die Google sich wendet, wenn technische Probleme mit Ihren Agents auftreten. Sie können die Name Geschäftliche E-Mail-Adresse Telefonnummer
Webhook	Das 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 Agents. Wenn Sie für einen einzelnen Agent einen anderen Webhook verwenden möchten, können Sie einen Agent-Webhook konfigurieren, der nur für diesen Agent gilt.

Marken verwalten

Als RCS for Business-Partner können Sie Agents im Namen von Marken erstellen.

Marke Eine Organisation oder Gruppe, die von einem oder mehreren Kundenservicemitarbeitern vertreten wird. Das Finanzdienstleistungsunternehmen Growing Tree könnte beispielsweise eine Marke namens Growing Tree und einen Agenten namens Growing Tree Bank erstellen, um mit Kunden über Bankdienstleistungen zu sprechen.

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

Marke hinzufügen

Hinweis :Informationen zum Hinzufügen einer Marke über die RBM Management API finden Sie in der Dokumentation Marke erstellen.

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

Marke bearbeiten

Hinweis: Informationen zum Bearbeiten einer Marke mit der RBM Management API finden Sie in der Dokumentation zum Umbenennen einer Marke.

So bearbeiten Sie eine Marke:

1. Klicken Sie auf das Kästchen neben dem Namen der Marke.
2. Klicken Sie auf das -Symbol und dann auf Namen bearbeiten.
3. Nehmen Sie die gewünschten Änderungen vor und klicken Sie auf Fertig.

Marke entfernen

Eine Marke kann nicht entfernt werden, wenn sie einem Agent zugeordnet ist, auch wenn der Agent nicht aktiviert ist.

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 „Manager“ oder „Leser“ haben.

• Manager können auf alle Funktionen der Developer Console zugreifen, um alle Agents zu verwalten, die zum Partnerkonto gehören.
• Leser haben Lesezugriff auf die Developer Console, um alle Agents des Partnerkontos anzusehen.

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 dieser eine E-Mail, in der er darüber informiert wird, dass er Zugriff auf das Partnerkonto hat.

Nutzer entfernen

So entfernen Sie Nutzer:

1. Suchen Sie nach dem Nutzer, den Sie entfernen möchten, und klicken Sie in seiner Tabellenzeile auf das Dreipunkt-Menü .
2. Wählen Sie Nutzer entfernen aus.
3. Bestätigen Sie die Entfernung.

Der Nutzer, den Sie entfernt haben, erhält eine E‑Mail, in der er darüber informiert wird, 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:

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

Dienstkonto zum Authentifizieren von API-Aufrufen einrichten

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

Zur sicheren Authentifizierung von API-Aufrufen benötigen Sie außerdem das Befehlszeilentool oauth2l.

So generieren Sie einen Dienstkontoschlüssel:

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

Bewahren Sie den Dienstkontoschlüssel an einem sicheren, privaten Ort auf. Geben Sie Ihren Schlüssel nicht öffentlich weiter. Sie benötigen diesen Schlüssel später, um auf die RBM APIs zuzugreifen.

Partner-Webhook konfigurieren

Informationen zum Konfigurieren Ihres Partner-Webhooks finden Sie im Leitfaden Webhooks.

Informationen zum asynchronen Verarbeiten von Webhooks, um Zustellungsfehler zu vermeiden, finden Sie unter Nachrichtenverarbeitung.

Eingehende Nachrichten überprüfen

Da Webhooks Nachrichten von beliebigen Absendern empfangen können, sollten Sie vor der Verarbeitung von Nachrichteninhalten überprüfen, ob eingehende Nachrichten von Google gesendet wurden.

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

1. Extrahieren Sie den X-Goog-Signature-Header der Nachricht. Dies ist eine gehashte, base64-codierte Kopie der Nutzlast des Nachrichtentexts.
2. Base64-Dekodierung der RBM-Nutzlast im Element message.body der Anfrage.
3. Erstellen Sie mit dem Client-Token Ihres Webhooks (das Sie bei der Einrichtung Ihres Webhooks angegeben haben) als Schlüssel einen SHA512-HMAC der Byte der Base64-decodierten Nachrichtennutzlast und Base64-codieren Sie das Ergebnis.
4. Vergleichen Sie den X-Goog-Signature-Hash mit dem von Ihnen erstellten Hash.
   • Wenn die Hashes übereinstimmen, haben Sie bestätigt, dass die Nachricht von Google gesendet wurde.

   • Wenn die Hashes nicht übereinstimmen, prüfen Sie den Hashing-Prozess anhand einer bekannten Nachricht.

     Wenn Ihr Hashing-Prozess korrekt 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
    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);
  

Nächste Schritte

Nachdem Sie Ihr Partnerkonto eingerichtet haben, können Sie Ihren ersten Agenten erstellen.