Partnerkonto einrichten

Nachdem Sie sich als RCS for Business-Partner registriert haben, haben Sie ein Partnerkonto. Um auf die Einstellungen Ihres Partnerkontos zuzugreifen, öffnen Sie die RCS for Business Developer Console und klicken Sie auf Partnerkontoeinstellungen. 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 Verträgen für die Nachrichtenübermittlung 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 Ihre Webhook-Endpunkt-URL. Klicken Sie auf Konfigurieren, um sie zu aktualisieren. Wenn Sie Ihren Partner-Webhook konfigurieren, gilt er für alle Ihre Agenten. 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.

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 :Wenn Sie eine Marke mit der RBM Management API hinzufügen möchten, lesen Sie die Dokumentation unter 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 :Wenn Sie eine Marke mit der RBM Management API bearbeiten möchten, lesen Sie die Dokumentation unter Marke umbenennen.

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 Agenten zugeordnet ist, auch wenn der Agent noch 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 Entwicklerkonsole zugreifen, um alle Agents zu verwalten, die zum Partnerkonto gehören.
• Leser haben Lesezugriff auf die Developer Console, um alle Agenten 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 mit der Benachrichtigung, dass er Zugriff auf das Partnerkonto hat.

Nutzerinnen und Nutzer entfernen

So entfernen Sie Nutzer:

1. Suchen Sie nach dem Nutzer, den Sie entfernen möchten, und klicken Sie in seiner Tabellenzeile auf die Schaltfläche .
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.

Sie können keinen Nutzer mit der Rolle „Inhaber“ entfernen. 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 die RBM API aufrufen, 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 Dienstkontoschlüssel wird in Ihrem Browser heruntergeladen.

Speichern Sie Ihren Dienstkontoschlüssel an einem sicheren, privaten Ort. 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 zur asynchronen Verarbeitung von Webhooks, um Zustellungsfehler zu vermeiden, finden Sie unter Nachrichtenverarbeitung.

Eingehende Nachrichten prü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 beim Einrichten Ihres Webhooks angegeben haben) als Schlüssel einen SHA512-HMAC der Bytes 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, ist es an der Zeit, Ihren ersten Agenten zu erstellen.