Registrati a Business Messages

Quando ti registri come partner a Business Messages, puoi attivare le conversazioni tra utenti e brand creando agenti, entità che rappresentano funzioni aziendali, come l'assistenza ai siti web e il brand luoghi.

Agente: una rappresentazione colloquiale di un brand, gestita da un partner. Include qualsiasi dell'interfaccia utente con cui interagiscono e qualsiasi codice o infrastruttura necessario l'interazione.

Quando un utente trova un brand che gestisci nella Ricerca Google o su Google Maps, nei risultati di ricerca viene visualizzata l'opzione Chat. Quando l'utente fa clic su Chat, possono 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 che supportano il tuo agente, puoi abilitare la messaggistica per servizi ai clienti, vendite e altre applicazioni aziendali.

1. Apri la Console per gli sviluppatori di Business Communications.
2. In Business Messages, fai clic su Crea account partner.

3. Inserisci i valori per le informazioni sul partner:

   Campo	Valore
   Il tuo 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

di Gemini Advanced.

Nota: per avviare un agente di produzione con Business Messages, devi registrarti con un'email aziendale, non personale.

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

2. Fai clic su Crea.

Hai effettuato la registrazione come partner Business Messages e hai accesso alle API Business Messages e Business Communications. L'API Business Messages invia i 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, sono necessari una chiave dell'account di servizio e oauth2l.

1. Nella home page di Business Communications Developer Console, 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 dell'account di servizio in un luogo sicuro e privato. Azioni sconsigliate condividi la chiave pubblicamente. Avrai bisogno di questa chiave in un secondo momento per accedere alle API Business Message e Business Communication.

di Gemini Advanced.

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

Imposta il tuo Webook

Ora che le API Business Messages e Business Communications sono abilitate, puoi devi specificare l'URL webhook per iniziare la ricezione di messaggi.

1. Apri le Impostazioni account nella Developer Console di Business Communications.
2. Assicurati che sia selezionato l'account partner corretto.
3. Per URL webhook di Business Messages, fai clic su Configura.
4. In URL endpoint webhook, inserisci l'URL del webhook, che inizia con "https://".
5. Prendi nota del tuo valore di clientToken. È necessario per verificare che i messaggi ricevi provengono Google.

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

   Ad esempio, se il webhook riceve una richiesta POST con quanto segue contenuto del corpo

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

   il webhook deve confermare il valore clientToken e, se clientToken è è corretto, restituisci 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 webhook per vedere come configurare il webhook con le API Business Communication.

Ottieni informazioni sul partner

Per ottenere le informazioni attuali sul tuo partner, puoi inviare una query all'attività API 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 le informazioni sul partner

Per aggiornare le informazioni sul partner, puoi utilizzare la pagina Impostazioni account della Developer Console di Business Communications oppure eseguire i comandi riportati di seguito.

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 che aggiorni.

# 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 abilitato le API, puoi iniziare sviluppare con Business Messages. Per iniziare rapidamente, consulta Crea il tuo primo agente.

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