Connessione con gli utenti nelle app e nei bot di Messenger
L'uso di più canali per la comunicazione con i clienti, ad es. un sito Web, un'app mobile e Messenger, è una prassi comune delle aziende. Quando un utente usa Facebook Login in un sito Web o in un'app mobile, viene creato un ID per l'app Facebook specifica, noto come ID per singola app. Quando un utente interagisce con un'azienda su Messenger, viene creato un ID per la Pagina specifica associata al bot su Messenger, noto come ID per singola Pagina. Ciò significa che, per lo stesso utente, gli ID dei vari canali di comunicazione sono diversi. Ricorda che gli ID per singola app vengono creati quando un utente accede con la tua app, quindi non visualizzerai gli ID per singola app per gli utenti che non hanno installato ed effettuato l'accesso con la tua app.
Un'azienda potrebbe voler offrire un'esperienza unica per gli utenti sui vari canali. Ad esempio, quando qualcuno comunica con un'azienda tramite un bot di Messenger, l'esperienza potrebbe essere più personalizzata se l'azienda stessa riconoscesse l'utente come un proprio cliente nell'app Facebook (ad es. un sito Web o un'app mobile con Facebook Login). Forniamo un'API per il recupero degli ID di un dato utente in tutte le app e i bot su Messenger appartenenti alla stessa azienda.
In primo luogo, devi informare Facebook sul fatto che le tue app e le Pagine associate al tuo bot su Messenger sono di proprietà della stessa azienda. A tale scopo, devi usare Business Manager di Facebook per:
A questo punto, puoi eseguire query nel segmento ids_for_apps o ids_for_pages per il nodo user allo scopo di recuperare gli ID.
La tua chiamata iniziale all'API potrebbe attivare un'analisi dell'app che potrebbe richiedere circa 48 ore.
Questo documento tratta gli argomenti seguenti:
Casi d'uso
Esistono alcuni casi d'uso principali per l'API:
Recupero degli ID per le app appartenenti a un account Business Manager a fronte di un dato ID utente per un bot su Messenger
- Nodo User: un ID assegnato alla Pagina a sua volta associata a un bot su Messenger.
- Segmento:
ids_for_apps - Requisiti: sono necessari un token d'accesso per la Pagina e un elemento appsecret_proof, i quali devono essere generati tramite l'app che gestisce la Pagina. Inoltre, l'app che gestisce la Pagina e le altre app da connettere devono appartenere allo stesso account Business Manager.
Esempi:
- Questo restituisce gli ID di tutte le app che appartengono allo stesso account Business Manager.
GET /{user-id}/ids_for_apps ?access_token=[page_access_token] &appsecret_proof=[appsecret_proof] - Questo restituisce l'ID dell'app specifica con ID app 10152368852405295.
GET /{user-id}/ids_for_apps ?app=10152368852405295 &access_token=[page_access_token] &appsecret_proof=[appsecret_proof]
Recupero degli ID per i bot su Messenger appartenenti a un account Business Manager a fronte di un dato ID utente per un'app
- Nodo User: un ID assegnato all'app.
- Segmento
ids_for_pages - Requisiti: sono necessari un token d'accesso per la Pagina e un elemento appsecret_proof, i quali devono essere generati tramite l'app che gestisce le Pagine e a cui è associato l'ID. Inoltre, l'app e le Pagine devono appartenere allo stesso account Business Manager.
Esempi:
- Questo restituisce gli ID per tutti i bot su Messenger la cui Pagina associata appartiene allo stesso account Business Manager.
GET /{user-id}/ids_for_pages ?access_token=[app_access_token] &appsecret_proof=[appsecret_proof] - Questo restituisce l'ID del bot specifico su Messenger la cui Pagina associata ha l'ID Pagina 380374449010653.
GET /{user-id}/ids_for_pages ?page=380374449010653 &access_token=[app_access_token] &appsecret_proof=[appsecret_proof]
Recupero degli ID per altre app appartenenti a un account Business Manager a fronte di un dato ID utente per un'app
- Nodo User: il nodo User è un ID associato all'app.
- Segmento:
ids_for_apps - Requisiti: è necessario un token d'accesso per l'app, generato tramite l'app a cui è assegnato l'ID. Inoltre, le app devono appartenere allo stesso account Business Manager.
Esempi:
- Questo restituisce gli ID di tutte le app che appartengono allo stesso account Business Manager.
GET /{user-id}/ids_for_apps ?access_token=[app_access_token] - Questo restituisce l'ID dell'app specifica con ID app 10152368852405295.
GET /{user-id}/ids_for_apps ?app=10152368852405295 &access_token=[app_access_token]
Recupero degli ID per altre Pagine appartenenti a un account Business Manager a fronte di un dato ID utente per una Pagina (associata a un bot)
- Nodo User: un ID assegnato alla Pagina a sua volta associata a un bot su Messenger.
- Segmento:
ids_for_pages - Requisiti: sono necessari un token d'accesso per la Pagina e un elemento appsecret_proof, i quali devono essere generati tramite l'app che gestisce la Pagina. Inoltre, le Pagine devono appartenere allo stesso account Business Manager.
Esempi:
- Questo restituisce gli ID di tutte le Pagine che appartengono allo stesso account Business Manager.
GET /{user-id}/ids_for_pages ?access_token=[page_access_token] &appsecret_proof=[appsecret_proof] - Questo restituisce l'ID della Pagina specifica con ID app 380374449010653.
GET /{user-id}/ids_for_pages ?app=380374449010653 &access_token=[page_access_token] &appsecret_proof=[appsecret_proof]
Esempi di query
Recupero degli ID associati da un ID per un'app
GET /{user-id}
?fields=name,age_range,ids_for_apps,ids_for_pages
&access_token=[app_access_token]Esempio di risposta:
{
"name": "John Smith",
"age_range": {
"min": 21
},
"ids_for_apps": {
"data": [
{
"id": "10152368852405295",
"app": {
"category": "Business",
"link": "https://www.facebook.com/games/?app_id=1419232575008550",
"name": "John's Game App",
"id": "1419232575008550"
}
},
{
"id": "645195294",
"app": {
"link": "https://apps.facebook.com/johnsmovieappns/",
"name": "JohnsMovieApp",
"namespace": "johnsmovieappns",
"id": "259773517400382"
}
}
],
"paging": ...
},
"ids_for_pages": {
"data": [
{
"id": "12345123", // The psid for the user for that page
"page": {
"category": "Musician",
"link": "https://www.facebook.com/Johns-Next-Great-Thing-380374449010653/",
"name": "John's Next Great Thing",
"id": "380374449010653"
}
}
],
"paging": ...
},
"id": "645195294"
}
Recupero degli ID associati da un ID per un bot su Messenger
GET /{user-id}
?fields=name,is_payment_enabled,ids_for_apps,ids_for_pages
&access_token=[page_access_token]
&appsecret_proof=[appsecrete_proof]Esempio di risposta:
{
"name": "John Smith",
"is_payment_enabled": true,
"ids_for_apps": {
"data": [
{
"id": "10152368852405295",
"app": {
"category": "Business",
"link": "https://www.facebook.com/games/?app_id=1419232575008550",
"name": "John's Game App",
"id": "1419232575008550"
}
},
{
"id": "645195294",
"app": {
"link": "https://apps.facebook.com/johnsmovieappns/",
"name": "JohnsMovieApp",
"namespace": "johnsmovieappns",
"id": "259773517400382"
}
}
],
"paging": ...
},
"ids_for_pages": {
"data": [
{
"id": "12345123", // The psid for the user for that page
"page": {
"category": "Musician",
"link": "https://www.facebook.com/Johns-Next-Great-Thing-380374449010653/",
"name": "John's Next Great Thing",
"id": "380374449010653"
}
}
],
"paging": ...
},
"id": "645195294"
}
Normativa
Le aziende possono usare l'API solo per connettere gli ID per la relativa app o Pagina a un'altra app o Pagina di proprietà o gestita per conto della stessa azienda. Ad esempio, i fornitori di servizi non possono usare l'API per fornire assistenza a più clienti.
Per verificare potenziali violazioni della normativa, le richieste API sono soggette ad analisi e restituiscono un messaggio di errore "(#200) Your business is currently going through review to access this API".