Configura il tuo account partner

Segui le istruzioni riportate in questa pagina se vuoi gestire il tuo account partner registrato utilizzando il modello RBM basato su partner. Queste istruzioni non si applicano ai partner che utilizzano il modello RBM precedente.

Per determinare quale modello stai utilizzando, apri la Business Communications Developer Console. Se nella home page sono visualizzate Impostazioni account partner, significa che stai utilizzando il modello RBM basato su partner. Se non hai accesso alle impostazioni dell'account partner, stai utilizzando il modello RBM precedente.

Dopo esserti registrato come partner RBM, avrai un account partner. Per accedere alle impostazioni dell'account partner, apri la Business Communications Developer Console e fai clic su Impostazioni account partner. Da qui puoi effettuare le seguenti operazioni:

• Aggiornare i dati dell'account partner
• Aggiungere, modificare e rimuovere i brand collegati al tuo account
• Gestire utenti con 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 ricevuti dagli operatori (sotto forma di campo owner_name). Gli operatori utilizzeranno questo indirizzo per identificarti come partner di fiducia e per assicurarsi che generino i dati di fatturazione corretti per l'utilizzo di RBM al fine di raggiungere i loro abbonati. Il nome fornito qui deve essere in linea con quello 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 il suo Nome Indirizzo email aziendale Numero di telefono
Webhook	Questo è l'URL dell'endpoint del webhook. Fai clic su **Configura** per aggiornarlo. Quando configuri il webhook partner, questo viene applicato a tutti gli agenti. Se vuoi utilizzare un webhook diverso per un singolo agente, puoi configurare un webhook dell'agente che verrà applicato solo a quell'agente.

Gestisci 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 dei servizi bancari.

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

Aggiungi un brand

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

Modificare 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, poi fai clic su Elimina.

Gestisci utenti

Nella pagina Utenti in Impostazioni account puoi gestire gli utenti dell'account partner. L'utente che ha creato l'account partner ha il ruolo di Proprietario. I nuovi utenti possono avere il ruolo Gestore o Lettore.

• I gestori possono accedere a tutte le funzionalità della Developer Console per gestire tutti gli agenti appartenenti all'account del partner.
• I Lettori hanno accesso di sola lettura alla Developer Console 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 Ruolo.

I nuovi utenti aggiunti ricevono una notifica via email che lo informa che hanno accesso all'account partner.

Rimuovere un utente

Per rimuovere un utente:

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

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

Non puoi rimuovere un utente con un ruolo di proprietario. Per modificare o rimuovere il proprietario, devi contattare l'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.
2. Seleziona Modifica ruolo.
3. Scegli un nuovo ruolo dal menu a discesa.
4. Fai clic su Salva.

Configura 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 consente di creare e gestire brand e agenti, nonché di inviare messaggi e richieste in qualità di agente.

Nota: per autenticare in modo sicuro le chiamate API, è necessario anche lo 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.

Conserva la chiave dell'account di servizio in una posizione sicura e privata. Non condividere la tua chiave pubblicamente. Avrai bisogno di questa chiave in un secondo momento per accedere alle API RBM.

Configura il webhook partner

Un webhook è un callback HTTPS creato da un partner che specifica in che modo l'agente deve rispondere a messaggi ed eventi. Dopo aver configurato il webhook, puoi iniziare a ricevere messaggi ed eventi.

Nota: se vuoi utilizzare un webhook diverso per uno qualsiasi dei tuoi agenti, puoi impostare un webhook a livello di agente che sostituirà il webhook partner. Per ulteriori informazioni, consulta Configurare un webhook agente.

Per configurare il webhook partner:

1. Apri la Console per gli sviluppatori di Business Communications e accedi con il tuo Account Google del partner RBM.

2. Apri le Impostazioni account.

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

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

5. Prendi nota del tuo valore di clientToken. È necessario per verificare che i messaggi ricevuti provengano da Google.

6. Configura il webhook per accettare una richiesta POST con il parametro clientToken specificato e invia una risposta 200 OK con il valore in testo normale del parametro secret come corpo della risposta.

   Ad esempio, se il webhook riceve una richiesta POST con i seguenti contenuti del corpo

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

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

Verifica i messaggi in arrivo

Poiché i webhook possono ricevere messaggi da qualsiasi mittente, devi verificare che Google abbia inviato 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. Questa è una copia sottoposta ad hashing e codificata in Base64 del payload del corpo del messaggio.
2. Decodifica in base 64 il payload RBM nell'elemento message.body della richiesta.
3. Utilizzando il token client del webhook (che hai specificato quando hai configurato il webhook) come chiave, crea un HMAC SHA512 dei byte del payload dei messaggi decodificato in base-64 e codifica il risultato in base64.
4. Confronta l'hash X-Goog-Signature con l'hash che hai creato.
   • Se gli hash corrispondono, significa che Google ha inviato il messaggio.

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

     Se la procedura di hashing funziona correttamente e ricevi un messaggio che a tuo parere ti è stato inviato in modo fraudolento, 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.