Configura il tuo account partner

Una volta registrato come partner RBM, avrai un account partner. Per accedere alle impostazioni dell'account partner, apri la Developer Console di Business Communications e fai clic su Impostazioni account partner. Da qui puoi:

• Aggiornare i dati dell'account partner
• Aggiungere, modificare e rimuovere i brand collegati al tuo account
• Gestire gli utenti dell'account
• Crea un account di servizio e una chiave per autenticare le chiamate API

Aggiornare i dati dell'account partner

Nella pagina Impostazioni puoi visualizzare il tuo ID partner e aggiornare le seguenti informazioni:

Campo	Descrizione
Nome partner	Nome dell'account partner
Nome visualizzato	Il nome verrà visualizzato nei report di fatturazione RBM che ricevono i fornitori di servizi di telefonia mobile (come campo owner_name). Gli operatori la utilizzeranno per identificarti come partner affidabile e per assicurarsi di generare le informazioni di fatturazione corrette per il tuo utilizzo della RBM per raggiungere i loro abbonati. Il nome fornito qui deve essere in linea con il nome utilizzato nei contratti di messaggistica dell'operatore.
Punto di contatto tecnico	La persona che Google contatterà in caso di problemi tecnici con i tuoi agenti. Puoi aggiornare i Nome Indirizzo email aziendale Numero di telefono
Webhook	Si tratta dell'URL dell'endpoint webhook. Fai clic su Configura per aggiornarlo. Quando configuri il webhook del partner, la configurazione viene applicata a tutti i tuoi agenti. Se vuoi utilizzare un webhook diverso per un singolo agente, puoi configurare un webhook agente che verrà applicato solo a quell'agente.

Gestire i brand

In qualità di partner RBM, puoi creare agenti per conto dei brand.

Brand Un'organizzazione o un gruppo rappresentato da uno o più agenti. Ad esempio, la società di servizi finanziari Growing Tree potrebbe creare un brand chiamato Growing Tree e un agente chiamato Growing Tree Bank per parlare ai clienti di servizi bancari.

Utilizza la pagina Brand in Impostazioni account per aggiungere, modificare e rimuovere i brand associati al tuo account partner.

Aggiungi un brand

Nota: per aggiungere un brand utilizzando l'API RBM Management, consulta la documentazione relativa alla creazione di un brand.

Per aggiungere un brand, inserisci il nome nel campo di immissione e fai clic su Aggiungi.

Modificare un brand

Nota: per modificare un brand utilizzando l'API RBM Management, consulta la documentazione relativa al cambio del nome di un brand.

Per modificare un brand:

1. Fai clic sulla casella di controllo accanto al nome del brand.
2. Fai clic sul pulsante e poi su Modifica nome.
3. Apporta le modifiche e fai clic su Fine.

Rimuovere un brand

Un brand non può essere rimosso se è associato a un agente, anche se l'agente non è stato lanciato.

Per rimuovere un brand, fai clic sulla casella di controllo accanto al nome del brand e poi su Elimina.

Gestisci utenti

Nella pagina Utenti delle Impostazioni account gestisci gli utenti del tuo account partner. L'utente che ha creato l'account partner ha il ruolo di proprietario. I nuovi utenti possono avere il ruolo di gestore o lettore.

• I gestori possono accedere a tutte le funzionalità della Console dello sviluppatore per gestire tutti gli agenti appartenenti all'account partner.
• I lettori hanno accesso di sola lettura alla Console per gli sviluppatori per visualizzare tutti gli agenti appartenenti all'account partner.

Aggiungere un utente

Per aggiungere un utente, inserisci il suo indirizzo email nel campo di immissione e seleziona il suo ruolo.

Quando aggiungi un nuovo utente, quest'ultimo riceve un'email che lo informa che ha accesso all'account partner.

Rimuovere un utente

Per rimuovere un utente:

1. Individua l'utente che vuoi rimuovere e fai clic sul pulsante nella riga della tabella corrispondente.
2. Seleziona Rimuovi utente.
3. Conferma la rimozione.

L'utente che hai rimosso riceve un'email che lo informa che non ha più accesso all'account partner.

Non puoi rimuovere un utente con il ruolo Proprietario. Per modificare o rimuovere il proprietario, devi rivolgerti all'assistenza.

Modificare il ruolo di un utente

Per aggiornare il ruolo di un utente:

1. Trova l'utente che vuoi aggiornare e fai clic sul pulsante nella riga della tabella corrispondente.
2. Seleziona Modifica ruolo.
3. Scegli un nuovo ruolo dal menu a discesa.
4. Fai clic su Salva.

Configurare l'account di servizio per autenticare le chiamate API

Quando effettui chiamate all'API RBM, autentichi le chiamate con una chiave dell'account di servizio. Questa chiave ti consente di creare e gestire brand e agenti, nonché di inviare messaggi e richieste come agente. Un account di servizio può avere fino a 10 chiavi.

Per autenticare in modo sicuro le chiamate API, devi disporre anche dello strumento a riga di comando oauth2l.

Per generare una chiave dell'account di servizio:

1. In Impostazioni account, vai alla pagina Account di servizio.
2. Fai clic su Crea chiave, quindi su Crea. Il browser scarica la chiave dell'account di servizio.

Memorizza la chiave dell'account di servizio in una posizione privata e sicura. Non condividere la chiave pubblicamente. Ti servirà questa chiave in un secondo momento per accedere alle API RBM.

Configura il webhook del partner

Nota: per configurare l'webhook del partner utilizzando l'API, consulta la documentazione relativa alla creazione di un'integrazione webhook.

Un webhook è un callback HTTPS creato da un partner che specifica come deve rispondere l'agente a messaggi ed eventi. Una volta configurato l'webhook, puoi iniziare a ricevere messaggi e eventi.

Se vuoi utilizzare un webhook diverso per uno dei tuoi agenti, puoi configurare un webhook a livello di agente che sostituirà quello del partner. Per ulteriori informazioni, consulta la pagina Configurare un webhook dell'agente.

Per configurare l'webhook del partner:

1. Apri la Developer Console di Business Communications e accedi con il tuo Account Google partner RBM.

2. Apri le Impostazioni account.

3. In URL webhook RCS Business Messaging, fai clic su Configura.

4. In URL endpoint webhook, inserisci l'URL webhook che inizia con "https://".

5. Prendi nota del valore di clientToken. Ti serve per verificare che i messaggi che ricevi provengano da Google.

6. Configura il tuo webhook in modo che accetti una richiesta POST con il parametro clientToken specificato e invii una risposta 200 OK con il valore in testo normale del parametro secret come corpo della risposta.

   Ad esempio, se il tuo webhook riceve una richiesta POST con il seguente testo del corpo

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

   in questo caso, l'webhook deve confermare il valore clientToken e, se clientToken è corretto, restituire una risposta 200 OK con 1234567890 come corpo della risposta:

   // 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. In Developers Console, fai clic su Verifica. Quando RBM verifica il webhook, la finestra di dialogo si chiude.

Per gestire gli errori di invio dei webhook e garantire un'elaborazione affidabile dei messaggi, consulta Gestione dei messaggi.

Verificare i messaggi in arrivo

Poiché gli webhook possono ricevere messaggi da qualsiasi mittente, devi verificare che Google abbia inviato i messaggi in arrivo prima di elaborare i contenuti dei messaggi.

Per verificare che Google abbia inviato un messaggio che hai ricevuto, segui questi passaggi:

1. Estrai l'intestazione X-Goog-Signature del messaggio. Si tratta di una copia con hash e codifica in base64 del payload del corpo del messaggio.
2. Decodifica il payload RBM in base 64 nell'elemento message.body della richiesta.
3. Utilizzando il token client del webhook (specificato durante la configurazione del webhook) come chiave, crea un HMAC SHA512 dei byte del payload del messaggio decodificato in base64 e codifica il risultato in base64.
4. Confronta l'hash X-Goog-Signature con quello che hai creato.
   • Se gli hash corrispondono, hai confermato che il messaggio è stato inviato da Google.

   • Se gli hash non corrispondono, controlla la procedura di hashing su un messaggio di cui conosci la correttezza.

     Se la procedura di hashing funziona correttamente e ricevi un messaggio che ritieni ti sia stato inviato fraudolentemente, contattaci.

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

Passaggi successivi

Ora che il tuo account partner è configurato, è il momento di creare il tuo primo agente.