Fai l'onboarding delle sedi da Profilo dell'attività

Profilo dell'attività è uno strumento senza costi e facile da utilizzare che permette ad attività e organizzazioni di gestire la propria presenza online su Google, inclusi Ricerca e Maps.

L'API Google Business Profile fornisce un'interfaccia per la gestione delle informazioni relative alle sedi dell'attività su Google. Un'attività può concedere l'accesso tramite il consenso OAuth a un'altra attività per gestire il suo profilo per suo conto.

Le attività gestite in Profilo dell'attività sono già state verificate tramite la procedura di verifica di Profilo dell'attività. Puoi estendere il flusso di consenso OAuth di Profilo dell'attività per integrare queste attività in Business Messages e verificarle automaticamente per il lancio su Business Messages.

Questo è un metodo più scalabile e veloce per lanciare Business Messages ed è il flusso consigliato per attivare la messaggistica per una sede nel profilo dell'attività.

Prerequisiti

Devi essere un partner esistente di Profilo dell'attività con accesso alle API di Profilo dell'attività su Google. In caso contrario, segui i prerequisiti del profilo dell'attività per richiedere l'accesso.

Dopo aver ottenuto l'accesso all'API Profilo dell'attività su Google, segui le relative guide per la configurazione di base e la configurazione di OAuth prima di continuare.

Attiva Messaggi delle attività per una sede verificata del profilo dell'attività

Il seguente diagramma mostra in che modo il tuo servizio web può utilizzare la verifica della sede di un profilo dell'attività di un brand per un agente di Business Messages. Continua nella lettura per istruzioni dettagliate.

Diagramma di flusso per la verifica automatica degli agenti mediante la verifica del profilo dell'attività

  1. Nel flusso di consenso OAuth esistente in cui il proprietario di un account Profilo dell'attività ti concede l'accesso per chiamare le API di Profilo dell'attività su Google per suo conto, aggiorna gli ambiti API in modo che includano

    • https://www.googleapis.com/auth/business.manage
    • https://www.googleapis.com/auth/businesscommunications

    Entrambi gli ambiti sono obbligatori per verificare automaticamente l'agente e le sedi dell'attività commerciale.

  2. Crea un agente con un elemento displayName che corrisponda al nome di almeno una delle schede di Profilo dell'attività su Google di proprietà delle credenziali OAuth ottenute nel passaggio precedente. Cerca le località con l'API di Profilo dell'attività su Google per trovare i nomi delle attività.

    Per la corrispondenza del nome

    • Le maiuscole/minuscole non sono sensibili.
    • Il nome completo dell'agente deve corrispondere esattamente alla prima parola o alle prime parole incluse nel nome della sede nel profilo dell'attività. Ad esempio, un agente chiamato "Panetteria GBP" corrisponde a "Gbp Bakery Mountain View", "Gastronomia Gbp" e "gbp panificio sunnyvale", ma non corrisponde a "Bakery San Francisco".

  3. Per ogni sede in Profilo dell'attività, crea una sede con lo stesso placeId. La sede placeId di una sede di Profilo dell'attività è contenuta all'interno dell'oggetto LocationKey quando una sede viene recuperata dall'API di Profilo dell'attività su Google.

  4. Con l'agente che hai creato e il token OAuth ottenuto, richiedi la verifica dell'agente.

    La richiesta di verifica richiede i dati di contatto del brand. Tuttavia, il processo di verifica non invierà un'email al brand se il nome dell'agente corrisponde al nome del profilo dell'attività e se hai ottenuto il token OAuth con gli ambiti corretti.

    Se hai eseguito questa operazione correttamente, l'output della richiesta di verifica dovrebbe restituire immediatamente un verificationState di VERIFICATION_STATE_VERIFIED. Se verificationState restituisce un valore diverso, è probabile che tu non abbia utilizzato il token OAuth corretto quando è stata effettuata la richiesta oppure se non è stato possibile abbinare l'agente a una località del profilo dell'attività.

  5. Utilizzando lo stesso token OAuth, richiedi la verifica della sede per tutte le sedi di proprietà dell'attività su Profilo dell'attività.

    Come per la verifica dell'agente, se l'hai eseguita correttamente, l'output della richiesta di verifica dovrebbe restituire immediatamente un verificationState di VERIFICATION_STATE_VERIFIED. Se verificationState restituisce un valore diverso, è probabile che tu non abbia utilizzato il token OAuth corretto quando hai effettuato la richiesta o che la sede del profilo dell'attività non sia un'attività rivendicata e verificata.

  6. Avvia l'agente con il punto di ingresso LOCATION.

  7. Attiva i messaggi per località specifiche avviando le località che vuoi rendere disponibili tramite la Ricerca e Maps. Una volta iniziato il processo di lancio, i messaggi per ogni località lanciata saranno disponibili per gli utenti entro poche ore.

Una volta eseguiti questi passaggi, tutti i messaggi per i consumatori vengono pubblicati nel webhook di Business Messages registrato e dovrai inviare risposte ai consumatori con l'API Business Messages.