Crea il tuo primo agente

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

Il flusso di un messaggio in una conversazione abilitata a RBM

Prerequisiti

Prima di iniziare a utilizzare l'agente, ti serviranno i seguenti elementi:

Configurare il dispositivo di test

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

Controllare lo stato di RCS del dispositivo

  1. Nell'app Messaggi, tocca il pulsante , quindi tocca Impostazioni.

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

    Se lo Stato è Connesso, RCS è attivo sul tuo dispositivo.

Passaggi successivi

Se RCS è attivo sul tuo dispositivo, puoi configurare l'agente. Se RCS è inattivo sul tuo dispositivo, devi attivare RCS sul dispositivo prima di poter testare l'agente RCS for Business.

Configura il tuo agente

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

Identificare la regione dell'agente

Gli agenti RCS for Business possono esistere in una delle tre regioni: Nord America, Europa e Asia Pacifico. 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 vigenti, 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 i tuoi 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 decidere la regione dell'agente in base agli operatori di destinazione. Tutte le regioni hanno pari accesso agli operatori in tutto il mondo.

Determina la categoria di fatturazione dell'agente

Quando crei un agente RCS for Business, devi specificarne la categoria di fatturazione in base al modo in cui l'agente interagirà con gli utenti. Scegli la categoria che corrisponde meglio al comportamento previsto del tuo agente:

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

Puoi modificare la categoria di fatturazione dell'agente solo prima di lanciarlo. Se devi modificare la categoria di fatturazione dopo il lancio, contatta il team di assistenza RCS for Business.

Per ulteriori informazioni sul modello di fatturazione standard RCS o Business, consulta le domande frequenti sulla fatturazione.

Identificare il caso d'uso dell'agente

Ogni agente RCS for Business deve avere un caso d'uso predefinito. In questo modo, l'agente viene classificato e vengono applicate le regole aziendali corrette per una buona esperienza utente. RCS for Business 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 che condividono informazioni direttamente pertinenti 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 l'awareness, 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 ciò che puoi inviare. Per scoprire di più su ogni caso d'uso e trovare quello più adatto al tuo agente, consulta Scegliere il caso d'uso giusto per il tuo agente.

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

Crea l'agente

Segui queste istruzioni per creare l'agente nella console per sviluppatori RCS for Business.

Per creare un agente:

  1. Vai alla console per sviluppatori RCS for Business e accedi con il tuo Account Google partner RCS for Business.
  2. Nella home page, fai clic su + Crea agente.
  3. Nella finestra Nuovo agente RCS for Business, specifica le seguenti informazioni:
  4. Fai clic su Crea agente.

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

Invita il dispositivo di test

Ora che hai un agente e il tuo dispositivo di test è abilitato a 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 di tester per il tuo agente.

Se non ricevi un invito sul tuo dispositivo di test, verifica che RCS sia abilitato sul tuo dispositivo.

Invia un messaggio

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

Per autenticare in modo sicuro le chiamate API, è necessaria una chiave del service account. Se non hai ancora creato una chiave del service account per il tuo account partner, è il momento di farlo.

In un terminale sulla macchina di sviluppo, esegui questo 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!"
  },
  "messageTrafficType": "PROMOTION"
}'
  • Sostituisci REGION con asia, europe o us, a seconda della regione del tuo agente.
  • Sostituisci PHONE_NUMBER con il numero di telefono del tuo dispositivo di test. Includi il codice paese, il prefisso e un + iniziale, ma non includere separatori. Ad esempio: +14155555555.
  • Sostituisci AGENT ID con l'ID agente, che si trova nella pagina Informazioni agente nella Developer Console di RCS for Business.
  • Sostituisci PATH_TO_SERVICE_ACCOUNT_KEY con il percorso della chiave che hai creato in precedenza.

Dovresti ricevere un messaggio "Hello, world!" dal tuo agente sul dispositivo di test. 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, vedi 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à. Scarica un agente di esempio nella lingua che preferisci e segui le istruzioni nel file README dell'esempio.

Una volta configurato l'agente di esempio, esamina le best practice di RCS for Business e scopri come gli agenti inviano e ricevono messaggi.

Indietro
Configura il tuo account partner