Conectando-se com as pessoas em aplicativos e bots no Messenger
É comum uma empresa usar vários canais para se comunicar com seus clientes, por exemplo, um site, um aplicativo móvel e o Messenger. Quando uma pessoa usa o Login do Facebook em um site ou em um aplicativo móvel, é criada uma identificação para o aplicativo específico do Facebook, chamada de ID no escopo do aplicativo. Quando uma pessoa interage com uma empresa pelo Messenger, uma identificação é criada para a Página específica associada ao bot no Messenger. Essa identificação é chamada de ID no escopo da Página. Isso significa que, para a mesma pessoa, os IDs em canais de comunicação distintos são diferentes. Lembre-se de que os IDs no escopo do aplicativo são criados quando um usuário faz login com seu aplicativo, de forma que você não verá IDs no escopo do aplicativo de usuários que não instalaram ou que não entraram com seu aplicativo.
Uma empresa pode querer fornecer uma experiência perfeita para as pessoas em canais diferentes. Por exemplo, quando alguém está se comunicando com uma empresa por meio de um bot no Messenger, a experiência poderá ser mais personalizada se essa empresa reconhecer que a pessoa é um cliente existente em seu aplicativo do Facebook (por exemplo, um site ou um aplicativo móvel com um Login do Facebook). Fornecemos uma API para recuperar identificações da mesma pessoa em vários aplicativos e bots no Messenger que pertencem à mesma empresa.
Em primeiro lugar, você deve informar ao Facebook que os seus aplicativos e as Páginas associadas ao seu bot no Messenger pertencem à mesma entidade de negócios. Para fazer isso, você precisará usar o Gerenciador de Negócios do Facebook para:
Em seguida, você pode consultar a borda ids_for_apps ou a borda ids_for_pages em busca do nó de usuário para recuperar identificações.
Sua chamada inicial para a API pode acionar uma análise do aplicativo que pode levar aproximadamente 48 horas para ser concluída.
Este documento abrange o seguinte:
Casos de uso
Existem alguns casos de uso principais para essa API:
De acordo com um número de identificação do usuário para um bot no Messenger, recuperar as identificações para aplicativos que pertencem à mesma empresa
- Nó do usuário: Uma identificação com escopo definido para a Página associada a um bot no Messenger.
- Borda:
ids_for_apps - Requisitos: Isso requer um token de acesso de página e um appsecret_proof, ambos os quais precisam ser gerados usando o aplicativo que gerencia a Página. Além disso, o aplicativo que gerencia a página e os outros aplicativo para conexão devem pertencer à mesma empresa.
Exemplos:
- Isso retorna as identificações para todos os aplicativos que pertencem à mesma empresa
GET /{user-id}/ids_for_apps ?access_token=[page_access_token] &appsecret_proof=[appsecret_proof] - Isso retorna a identificação para o aplicativo específico com a ID do aplicativo 10152368852405295
GET /{user-id}/ids_for_apps ?app=10152368852405295 &access_token=[page_access_token] &appsecret_proof=[appsecret_proof]
De acordo com um número de identificação do usuário para um aplicativo, recuperar as identificações para bots no Messenger que pertencem à mesma empresa
- Nó do usuário: Uma ID com escopo definido para o aplicativo.
- Borda:
ids_for_pages - Requisitos: Isso requer um token de acesso à Página e uma appsecret_proof, que precisam ser gerados usando o aplicativo que gerencia a Página, e para o qual o escopo de identificação está definido. Além disso, o aplicativo e as Páginas devem pertencer à mesma empresa.
Exemplos:
- Isso retorna identificações para todos os bots do Messenger cuja Página associada pertence à mesma empresa
GET /{user-id}/ids_for_pages ?access_token=[app_access_token] &appsecret_proof=[appsecret_proof] - Isso retorna a identificação do bot específico do Messenger cuja Página associada tem a ID de página 380374449010653
GET /{user-id}/ids_for_pages ?page=380374449010653 &access_token=[app_access_token] &appsecret_proof=[appsecret_proof]
De acordo com um número de identificação do usuário para um aplicativo, recuperar as identificações para outros aplicativos que pertencem à mesma empresa
- Nó do usuário: O nó de usuário é uma identificação com escopo para o aplicativo.
- Borda:
ids_for_apps - Requisitos: Isso requer um token de acesso do aplicativo, que é gerado usando o aplicativo para o qual o escopo de identificação está definido. Além disso, os aplicativos devem pertencer à mesma empresa.
Exemplos:
- Isso retorna as identificações para todos os aplicativos que pertencem à mesma empresa
GET /{user-id}/ids_for_apps ?access_token=[app_access_token] - Isso retorna a identificação para o aplicativo específico com a ID do aplicativo 10152368852405295
GET /{user-id}/ids_for_apps ?app=10152368852405295 &access_token=[app_access_token]
De acordo com um número de identificação do usuário para uma Página (associada a um bot), recuperar as identificações para outras Páginas que pertencem à mesma empresa
- Nó do usuário: Uma identificação com escopo definido para a Página associada a um bot no Messenger.
- Borda:
ids_for_pages - Requisitos: Isso requer um token de acesso de página e um appsecret_proof, ambos os quais precisam ser gerados usando o aplicativo que gerencia a Página. Além disso, as Páginas devem pertencer à mesma empresa.
Exemplos:
- Isso retorna as identificações para todas as Páginas que pertencem à mesma empresa
GET /{user-id}/ids_for_pages ?access_token=[page_access_token] &appsecret_proof=[appsecret_proof] - Isso retorna a identificação para a Página específica com a ID do aplicativo 380374449010653
GET /{user-id}/ids_for_pages ?app=380374449010653 &access_token=[page_access_token] &appsecret_proof=[appsecret_proof]
Consultas de exemplo
Recuperar identificações associadas de uma ID de aplicativo
GET /{user-id}
?fields=name,age_range,ids_for_apps,ids_for_pages
&access_token=[app_access_token]Exemplo de resposta:
{
"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"
}
Recuperar identificações associadas de uma ID de bot no Messenger
GET /{user-id}
?fields=name,is_payment_enabled,ids_for_apps,ids_for_pages
&access_token=[page_access_token]
&appsecret_proof=[appsecrete_proof]Exemplo de resposta:
{
"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"
}
Política
A API só pode ser usada por uma empresa para conectar as IDs do aplicativo ou da Página dessa empresa a outro aplicativo ou Página que pertence à mesma empresa ou que é mantido por ela. Por exemplo, provedores de serviços não podem usar a API para oferecer suporte a vários clientes.
Para possíveis violações dessa política, suas solicitações de API estarão sujeitas a uma revisão e retornarão uma mensagem de erro "(#200) Sua empresa está passando por uma revisão para acessar esta API."