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 semplice messaggio 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 di 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, RCS è attivo sul tuo dispositivo.

Passaggi successivi

Se RCS è attivo sul tuo dispositivo, puoi configurare l'agente. Se 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

Gli agenti RBM possono esistere in una delle tre regioni: Nord America, Europa e Asia Pacific. L'API RBM supporta tre endpoint regionali per aiutare le aziende a rispettare i requisiti regionali e aziendali.

Quando crei l'agente, scegli la regione in base ai regolamenti, ai requisiti e alla vicinanza agli utenti finali. Questa regione determina da dove opera l'agente e dove archivia i suoi dati.

Se tu o gli utenti previsti non rientrate in queste regioni, scegli la regione più vicina a te per ridurre al minimo la latenza. Ad esempio:

• Se ti trovi in America Latina, scegli la regione Nord America.
• Se ti trovi in Africa, scegli la regione Europa.
• Se ti trovi in Australia, scegli la regione Asia Pacifico.

Non scegliere la regione dell'agente in base agli operatori di destinazione. Tutte le regioni hanno accesso uguale agli operatori in tutto il mondo.

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

Determinare la categoria di fatturazione dell'agente

Quando crei un agente RBM, devi specificare la relativa categoria di fatturazione in base a come l'agente interagirà con gli utenti. Scegli la categoria che corrisponde maggiormente al comportamento previsto dell'agente:

• Conversazione: per gli agenti che intrattengono conversazioni multi-turno con gli utenti.
• Messaggio di base o Messaggio singolo: per gli agenti che inviano messaggi senza aspettarsi risposte frequenti.

Nota: le due categorie di fatturazione non conversazionali, Messaggio di base e Messaggio singolo, funzionano esattamente allo stesso modo. Si tratta di una stranezza storica che stiamo cercando di semplificare. Per il momento, puoi utilizzare una delle due categorie per i messaggi non conversazionali, che si tratti di testo normale o di schede avanzate. Ti verrà addebitato il tasso standard per le chiamate non conversazionali. Per ulteriori informazioni, vedi Categorie di fatturazione degli agenti.

Puoi modificare la categoria di fatturazione dell'agente solo prima del lancio. Invia un'email all'indirizzo [e-mail] se devi modificare la categoria di fatturazione dopo il lancio.

Per ulteriori informazioni sul modello di fatturazione RBM, consulta le Domande frequenti sulla fatturazione RBM.

Identificare il caso d'uso dell'agente

Ogni agente RBM deve avere un caso d'uso predefinito. In questo modo, puoi classificare il tuo agente e applicare le regole aziendali giuste per un'esperienza utente ottimale. RBM supporta quattro casi d'uso:

• OTP: password uniche necessarie per autenticare in modo sicuro un account o confermare una transazione.
• Transazionali: notifiche, aggiornamenti o avvisi che condividono 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: conversazioni che combinano messaggi transazionali e promozionali, ad esempio l'invio di una notifica dell'account seguita da un'offerta di sconto o l'upgrade a un nuovo prodotto o servizio.

Ogni caso d'uso ha regole diverse su cosa puoi inviare. Per scoprire di più su ciascun caso d'uso e trovare la soluzione più adatta per il tuo agente, consulta Scegliere il caso d'uso giusto per l'agente.

Una volta inviato l'agente per il lancio, non puoi modificare il caso d'uso. Controlla i casi d'uso e le regole aziendali del tuo paese prima di inviare l'agente.

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.

Per creare un agente:

1. Vai alla Developer Console di Business Communications e accedi con il tuo Account Google partner RBM.
2. Nella home page, fai clic su + Crea agente.
3. Nella finestra Nuovo agente RCS Business Messaging, specifica le seguenti informazioni:
   • Brand rappresentato dall'agente
   • Nome agente
   • Regione dell'hosting
   • Categoria di fatturazione
   • Caso d'uso
4. Fai clic su Crea agente.

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

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, ad esempio 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 invia e ricevono i messaggi.