Crea il tuo primo agente

Agente Un'entità programmatica che invia messaggi agli utenti per conto di un brand. L'agente include qualsiasi interfaccia con cui gli utenti interagiscono e qualsiasi codice o infrastruttura necessaria per supportare l'interazione. Gli agenti possono offrire un'esperienza semplice unidirezionale, come l'invio di una notifica, oppure possono essere di tipo conversazionale e reagire alle risposte degli utenti in un dialogo.

Gli utenti interagiscono con gli agenti tramite un'app di messaggistica abilitata per RCS, come Google Messaggi, sui propri dispositivi. In questa guida rapida, creerai un agente RBM di base in grado di inviare un messaggio semplice a un dispositivo di test e di ricevere una risposta.

Prerequisiti

Prima di iniziare a utilizzare l'agente, devi disporre dei seguenti elementi:

• Il nome del brand che l'agente rappresenterà
• Agente
  • Nome
  • Regione in cui opererà l'agente
  • Categoria di fatturazione
  • Caso d'uso
• Un dispositivo Android con un numero di telefono attivo
• Una macchina di sviluppo in grado di eseguire codice di esempio

Configura il dispositivo di test

Per comunicare con un agente RBM non lanciato, un dispositivo di test deve supportare RCS, ma non tutti i dispositivi Android possono ricevere messaggi RCS per impostazione predefinita. Puoi controllare lo stato RCS del tuo dispositivo e, se necessario, attivare RCS configurando il dispositivo con le versioni pre-release delle app Messaggi e Servizi operatore.

Controllare lo stato RCS del dispositivo

1. Nell'app Messaggi, tocca il pulsante e poi Impostazioni.

2. Tocca Funzionalità di chat e trova il valore Stato.

   Se lo stato È connesso è visualizzato in Stato, significa che RCS è attivo sul tuo dispositivo.

Passaggi successivi

Se RCS è attivo sul tuo dispositivo, puoi configurare l'agente. Se il servizio RCS non è attivo sul tuo dispositivo, devi attivarlo prima di poter testare l'agente RBM.

Configurare l'agente

Gli agenti RBM utilizzano l'API RBM per inviare messaggi, eventi e altre richieste agli utenti. Quando crei un agente, attivi l'accesso all'API RBM e definisci le informazioni di base dell'agente.

Identifica la regione dell'agente

L'API RBM supporta tre endpoint regionali per aiutare le aziende a rispettare i requisiti regionali e aziendali. Gli agenti RBM possono trovarsi in una delle tre regioni seguenti:

• Nord America
• Europa
• Asia Pacifico

Quando crei l'agente, scegli la regione in base ai regolamenti, ai requisiti e alla vicinanza agli utenti finali vigenti. Tieni presente che la regione non è specifica per il paese. Identifica l'area in cui opera l'agente. Google utilizza queste informazioni per determinare dove archiviare i dati dei messaggi e come indirizzare il traffico dei messaggi in modo appropriato.

Nota: non puoi modificare la regione dell'agente dopo averlo creato.

Determinare la categoria di fatturazione dell'agente

Gli operatori che approvano i contenuti RBM sulle proprie reti fatturano anche l'invio di messaggi RBM ai propri abbonati utilizzando questo framework di fatturazione:

• Conversazione: un addebito per una conversazione composta da più messaggi A2P e P2A in un determinato periodo di tempo.
• Messaggio singolo: un addebito per un singolo messaggio contenente contenuti RBM avanzati (ad esempio un messaggio contenente una scheda o un carosello avanzati).
• Messaggio di base: un addebito per un messaggio in testo normale di massimo 160 caratteri.

Quando crei l'agente, scegli la categoria di fatturazione che corrisponde maggiormente al comportamento della logica dell'agente:

• Conversazione: questo agente interagisce con gli utenti in modo complesso, in quanto i messaggi vengono scambiati in entrambe le direzioni.

Le due categorie seguenti non creano mai eventi di fatturazione conversazionale. Gli operatori addebiteranno un prezzo per messaggio di base o per messaggio singolo per ogni messaggio, a seconda dei contenuti pubblicati.

• Messaggio singolo: in genere questo agente invia messaggi avanzati e raramente si aspetta di ricevere risposte.
• Messaggio di base: questo agente implementa l'upgrade degli SMS a RBM e raramente si aspetta di ricevere risposte. In genere, l'agente deve inviare messaggi di testo semplici di massimo 160 caratteri. Tuttavia, l'agente non è limitato: può inviare contenuti più completi se programmato in tal senso e verrà fatturato di conseguenza.

Puoi modificare la categoria di fatturazione dell'agente prima di lanciarlo. Contattaci per discutere della possibilità di passare a una categoria di fatturazione diversa.

Identificare il caso d'uso dell'agente

Ogni agente RBM deve avere un caso d'uso predefinito che rifletta la natura delle conversazioni che intende avere con gli utenti finali e aiuti le attività a rispettare le regole aziendali. RBM supporta quattro casi d'uso:

• OTP: password monouso necessarie per autenticare in modo sicuro un account o confermare una transazione
• Transazionali: notifiche, aggiornamenti o avvisi per condividere informazioni pertinenti direttamente ai servizi o ai prodotti esistenti di un cliente, ad esempio avvisi per attività sospette dell'account, conferme di acquisto e notifiche di spedizione.
• Promozionali: messaggi di vendita, marketing e promozionali per clienti nuovi o esistenti, con l'obiettivo di aumentare la notorietà, il coinvolgimento e le vendite.
• Multiuso: flussi di conversazione che combinano casi d'uso transazionali e promozionali, ad esempio l'invio di una notifica dell'account e poi l'offerta di uno sconto o di un upgrade per un nuovo prodotto e servizio.

Per una descrizione più approfondita su quando utilizzare ciascun caso d'uso, consulta Scegliere il caso d'uso giusto.

Non puoi modificare il caso d'uso dopo che l'agente è stato inviato per il lancio. Prima di inviare l'agente, assicurati di esaminare i casi d'uso e le regole aziendali per il tuo paese.

Crea l'agente

Segui queste istruzioni per creare l'agente nella Developers Console di Business Communications.

Nota: per creare un agente utilizzando l'API di gestione RBM, consulta la documentazione relativa alla gestione degli agenti.

1. Apri la Developer Console di Business Communications e accedi con il tuo Account Google partner RBM.
2. Fai clic su Crea agente.
3. In Tipo di agente, seleziona RCS Business Messaging.
4. In Brand, seleziona il brand che l'agente rappresenterà oppure fai clic su Aggiungi nuovo brand e inserisci il nome.
5. Inserisci il nome dell'agente, seleziona la regione, la categoria di fatturazione e il caso d'uso. Quindi, fai clic su Crea agente.
6. Quando l'agente è disponibile, fai clic sul suo nome.

Una volta che l'agente sarà disponibile, potrai aggiungere le informazioni sull'attività e sul branding. Consulta la sezione Agenti.

Invitare il dispositivo di test

Ora che hai un agente e il tuo dispositivo di test è compatibile con RCS, puoi invitare il tuo dispositivo a testare l'agente.

1. Nel riquadro di navigazione a sinistra, fai clic su Dispositivi.
2. Per Aggiungi dispositivi di test, inserisci il numero di telefono del dispositivo e fai clic su Aggiungi.
3. Sul dispositivo di test, accetta la richiesta del tester per il tuo agente.

Se non ricevi un invito sul dispositivo di test, verifica che la funzionalità RCS sia attivata sul dispositivo.

Invia un messaggio

Con un dispositivo di test registrato, il tuo agente ora può inviare messaggi.

Per autenticare in modo sicuro le chiamate API, devi disporre di una chiave dell'account di servizio. Se non hai ancora creato una chiave dell'account di servizio per il tuo account partner, è arrivato il momento di farlo.

In un terminale sulla tua macchina di sviluppo, esegui il seguente comando:

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d "{
  'contentMessage': {
    'text': 'Hello, world!'
  }
}"

• Sostituisci REGION con asia, europe o us, a seconda della regione del tuo agente.
• Sostituisci PHONE_NUMBER con il numero di telefono del dispositivo di test. Includi il codice paese, il prefisso e un + iniziale, ma non i separatori. Ad esempio: [phone].
• Sostituisci AGENT ID con il tuo ID agente, che si trova nella pagina Informazioni agente nella Developer Console di Business Communications.
• Sostituisci PATH_TO_SERVICE_ACCOUNT_KEY con il percorso della chiave che hai creato in precedenza.

Sul dispositivo di test dovresti ricevere un messaggio "Hello, world!" dall'agente. Se non ricevi un messaggio sul dispositivo di test, verifica di aver inserito e formattato correttamente il numero di telefono e il percorso della chiave dell'account di servizio nel comando.

Per inviare diversi tipi di messaggi, come risposte suggerite e schede avanzate, consulta Inviare messaggi.

Passaggi successivi

Ora che il tuo agente può inviare messaggi a un dispositivo di test, è il momento di creare qualcosa che soddisfi le esigenze della tua attività. Ottieni un agente di esempio nella lingua che preferisci e segui le istruzioni riportate nel file README dell'esempio.

Dopo aver configurato l'agente di esempio, consulta le best practice di RBM e scopri come gli agenti inviano e ricevono messaggi.