Puoi utilizzare l'API Google Profilo dell'attività (GBP) per aggiungere o aggiornare gli attributi degli URL di WhatsApp e di messaggistica per una località specifica.
Implementando questi attributi, le attività consentono ai clienti di contattarle tramite WhatsApp o SMS. In questo modo, i commercianti possono aprire canali di comunicazione diretta con gli utenti su GBP, con l'obiettivo di migliorare il coinvolgimento e l'assistenza dei clienti.
Qui ti mostriamo come aggiungere, aggiornare o eliminare gli attributi URL.
Prerequisiti
Prima di procedere, assicurati di avere
- Un account e una sede del Profilo dell'attività su Google
- Le credenziali di autorizzazione necessarie per apportare modifiche alla sede del profilo dell'attività su Google
Verifica l'esito positivo
Per aggiungere, aggiornare o eliminare gli attributi, dovrai inviare richieste PATCH. Una richiesta PATCH riuscita restituisce un codice di stato HTTP 200 OK.
Richiesta di aggiunta o aggiornamento di un attributo
Questo approccio si applica sia a WhatsApp sia ai messaggi.
Per aggiungere o aggiornare un singolo attributo, utilizza una richiesta PATCH HTTP inviata all'endpoint dell'API Google Business Profile per location.updateattributes.
Specifica l'attributo che scegli come target utilizzando il parametro di query attributeMask nell'URL. Il corpo della richiesta conterrà i dati degli attributi aggiornati.
Per WhatsApp
La richiesta è simile alla seguente.
PATCH
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}/attributes?attributeMask=attributes/url_whatsapp
Nell'implementazione, sostituisci {locationId} con l'ID effettivo della sede del tuo profilo dell'attività su Google.
Il corpo della richiesta (application/JSON) avrà il seguente aspetto.
{
"name": "locations/17826990302864573181/attributes",
"attributes": [
{
"name":"attributes/url_whatsapp",
"values":[],
"uriValues": [
{
"uri": "https://wa.me/55555555"
}
]
}
]
}
Sostituisci l'esempio 55555555 con il numero di telefono WhatsApp dell'attività utilizzando il formato internazionale.
Per i messaggi
La richiesta sarà la seguente.
PATCH
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}/attributes?attributeMask=attributes/url_text_messaging
Nell'implementazione, sostituisci {locationId} con l'ID effettivo della sede del tuo profilo dell'attività su Google.
Il corpo della richiesta (application/JSON) avrà il seguente aspetto.
{
"name": "locations/17826990302864573181/attributes",
"attributes": [
{
"name":"attributes/url_text_messaging",
"values":[],
"uriValues": [
{
"uri": "sms:5555555555"
}
]
}
]
}
Sostituisci l'esempio sms:5555555555 con il numero di telefono dell'attività per i messaggi.
Per eliminare attributi:
Puoi eliminare entrambi gli attributi in una richiesta DELETE includendoattributes/url_whatsapp o attributes/url_text_messaging nel parametro di queryattributeMask. Il corpo della richiesta conterrà un array di oggetti attributo, uno per ogni attributo che vuoi aggiornare o eliminare.
La richiesta è simile alla seguente.
DELETE
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}/attributes?attributeMask=attributes/url_whatsapp,attributes/url_text_messaging3
Nell'implementazione, sostituisci {locationId} con l'ID effettivo della sede del tuo profilo dell'attività su Google.
Il corpo della richiesta (application/JSON) avrà il seguente aspetto.
{
"name": "locations/17826990302864573181/attributes",
"attributes": [
{
"name":"attributes/url_whatsapp",
"values":[],
"uriValues": []
}
]
}
Sostituisci l'esempio uriValues con parentesi vuote. Il valore viene reimpostato e
rimosso dal GBP.