Registrati con Business Messages

Quando ti registri come partner con Business Messages, puoi attivare conversazioni tra utenti e brand creando agenti, ovvero entità di conversazione che rappresentano funzioni aziendali, come il supporto di siti web e sedi di brand.

Agente: una rappresentazione colloquiale di un brand, gestita da un partner. Include qualsiasi interfaccia con cui gli utenti interagiscono e qualsiasi codice o infrastruttura necessari per supportare l'interazione.

Quando un utente trova un brand che gestisci nella Ricerca Google o in Google Maps, i risultati di ricerca mostrano un'opzione Chat. Quando l'utente fa clic su Chat, può inviare messaggi all'agente del brand. L'agente ti consente di ricevere e rispondere ai messaggi dell'utente.

Registrati come partner

Registrandoti come partner a Business Messages, creando agenti per i brand e sfruttando le API su cui si basa il tuo agente, puoi attivare esperienze di messaggistica per l'assistenza clienti, le vendite e altre applicazioni aziendali.

1. Apri la Business Communications Developer Console.
2. Nella sezione Messaggi delle attività, fai clic su Crea account partner.

3. Inserisci i valori per le informazioni sul partner:

   Campo	Valore
   Nome	Il tuo nome completo
   Nome partner	Nome della tua organizzazione
   Sito web partner	Sito web della tua organizzazione
   Regione	La regione in cui vuoi ospitare il servizio Business Messages

Nota: per lanciare un agente di produzione con Business Messages, devi registrarti con un indirizzo email aziendale e non personale.

1. Leggi e accetta i Termini di servizio di Business Messages.

2. Fai clic su Crea.

Ora hai effettuato la registrazione come partner di Business Messages e hai accesso alle API Business Messages e Business Communications. L'API Business Messages invia messaggi agli utenti, mentre l'API Business Communications gestisce gli agenti.

Crea un account di servizio

Per autenticare in modo sicuro le chiamate API alle API Business Messages e Business Communications, hai bisogno di una chiave dell'account di servizio e dello strumento a riga di comando oauth2l.

1. Nella home page della Console per gli sviluppatori delle comunicazioni aziendali, fai clic su Impostazioni account partner.
2. Nel menu di navigazione a sinistra, fai clic su Account di servizio.

3. Fai clic su Crea chiave, quindi su Crea.

   Il browser scarica la chiave dell'account di servizio. Archivia la chiave del tuo account di servizio in un luogo sicuro e privato. Non condividere la chiave pubblicamente. Avrai bisogno di questa chiave in un secondo momento per accedere alle API Business Messages e Business Communication.

Nota: se sei un partner di Business Messages con il tuo account GCP, puoi accedere alle chiavi dell'account di servizio nella console Google Cloud.

Configura il tuo blocco note

Ora che hai abilitato Business Messages e Business Communications API, devi specificare l'URL webhook per iniziare a ricevere messaggi.

1. Apri le impostazioni dell'account in Business Communications Developer Console.
2. Assicurati che sia selezionato l'account partner corretto.
3. In URL webhook di Business Messages, fai clic su Configura.
4. In URL endpoint webhook, inserisci l'URL del tuo webhook, iniziando con "https://".
5. Prendi nota del tuo valore clientToken. Devi verificare che i messaggi che ricevi provengono da Google.

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

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

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

   il webhook deve confermare il valore clientToken e, se clientToken è corretto, restituire una risposta 200 OK con 0123456789 come corpo della risposta.

7. Nella console, fai clic su Verifica.

   Quando Business Messages verifica il webhook, la finestra di dialogo si chiude.

Consulta Esempio: aggiornamento dell'URL del webhook per scoprire come configurare il webhook con le API Business Communication.

Chiedi informazioni sul partner

Per ricevere le informazioni sul partner attuale, puoi eseguire una query sull'API Business Communications con il tuo ID partner.

Esegui questo comando. Sostituisci PARTNER_ID con il tuo ID partner.

# This code gets the partner.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/partners/get

# Replace the __PARTNER_ID__
# Make sure a service account key file exists at ./service_account_key.json

curl -X GET \
"https://businesscommunications.googleapis.com/v1/partners/__PARTNER_ID__" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)"
get-partner.sh

Aggiorna informazioni sul partner

Per aggiornare le informazioni del partner, puoi utilizzare la pagina Impostazioni account nella console per gli sviluppatori di Business Communications o eseguire questi comandi.

Sostituisci PARTNER_ID con il tuo ID partner(l'ID partner è disponibile nella Developer Console di Business Communications) e sostituisci UPDATED_FIELDS con i nomi dei campi aggiornati.

# This code updates the partner entity.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/partners/patch

# Replace the __PARTNER_ID__, __UPDATED_FIELDS__, __FIELD_NAME__, __FIELD_VALUE__
# Make sure a service account key file exists at ./service_account_key.json

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/partners/__PARTNER_ID__?updateMask=__UPDATED_FIELDS__" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "__FIELD_NAME__": "__FIELD_VALUE__"
}'
update-partner.sh

Per le opzioni di formattazione e valore, consulta partners.patch.

Esempio: aggiornare il nome visualizzato

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/12345/partners/67890?updateMask=displayName" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json /path/to/service/account/key businesscommunications)" \
-d "{
    'displayName': 'XYZ Messaging',
}"

Esempio: aggiornare l'URL del webhook

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/partners/12345?updateMask=productCapabilities" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json /path/to/service/account/key businesscommunications)" \
-d "{
  'productCapabilities': [
    {
      'product': 'BUSINESS_MESSAGES',
      'businessMessagesCapability': {
        'webhookUrl': 'https://xyz.messaging.com/webhook',
      },
    },
  ],
}"

Passaggi successivi

Ora che sei un partner registrato e hai attivato le API, puoi iniziare a sviluppare con Business Messages. Per iniziare rapidamente, consulta Creare il tuo primo agente.

In caso contrario, scopri come creare agenti per rappresentare i tuoi brand nelle conversazioni e configurare il webhook per ricevere messaggi dagli utenti.