Como encontrar o ID de uma Página do Facebook e o que é um PSID
O ID de uma Página do Facebook é o ID numérico que identifica a Página na Graph API. O gestor da Página encontra-o no Facebook, em Transparência e política de privacidade, e uma app lê-o em /me/accounts, junto ao token da Página. Um PSID, ou ID de utilizador com âmbito de Página, é diferente: identifica uma pessoa, de forma única para cada par pessoa-Página.
A easyCoexistence lista cada Página ligada com o seu ID através de list_social_accounts e mantém os IDs consistentes entre ferramentas para o Claude, o ChatGPT ou o seu próprio código: account_id escolhe a Página, um PSID endereça uma resposta na Messenger, e um ID de comentário endereça a resposta a um comentário.
Onde o Centro de Ajuda do Facebook indica que o ID de uma Página aparece, depois de passar para a Página e abrir o seu perfil.
Devolve as Páginas sobre as quais uma pessoa pode executar tarefas, cada uma com o seu nome, ID, categoria, tarefas e um token de acesso à Página.
O que é único num ID de utilizador com âmbito de Página; as API de Páginas e os endpoints da Messenger Platform dependem dos PSIDs.
IDs de utilizador de integrações de Facebook Login, que a Meta diz que não funcionam com a Messenger Platform.
Como a referência de publicação de Página da Meta escreve o ID de uma publicação no seu exemplo de atualização, com o ID da Página primeiro.
Onde está o ID da Página no Facebook?
No perfil da própria Página, em detalhes de transparência. O Centro de Ajuda do Facebook indica estes passos, a partir da conta que gere a Página:
- Inicie sessão no Facebook e clique na sua foto de perfil, no canto superior direito.
- Clique em Ver todos os perfis e selecione a Página em que quer entrar.
- Clique no nome da Página no menu da esquerda para aceder a ela.
- Clique no nome da Página por baixo da foto de capa.
- Clique em Transparência e política de privacidade para encontrar o ID da Página.
Como é que uma app obtém um ID de Página?
A partir de /me/accounts, chamado com o token de acesso de utilizador de alguém que iniciou sessão com Facebook Login for Business. A visão geral da API de Páginas da Meta indica que a app guarde cada ID de Página devolvido com o respetivo token de acesso, e o exemplo de resposta da Meta lista o nome, o ID, a categoria de cada Página e as tarefas que a pessoa pode executar. O Graph API Explorer faz a mesma chamada para uma consulta rápida.
{
"data": [
{
"access_token": "<PAGE_ACCESS_TOKEN>",
"category": "Internet Company",
"name": "<PAGE_NAME>",
"id": "<PAGE_ID>",
"tasks": ["ANALYZE", "ADVERTISE", "MODERATE", "CREATE_CONTENT"]
}
]
}O que é um PSID?
Um ID de utilizador com âmbito de Página: o ID que uma Página vê para uma pessoa que interage com ela. A Meta torna os PSIDs únicos para cada par pessoa-Página, pelo que a mesma pessoa pode ter um ID diferente em cada Página, e a Messenger atribui um na primeira vez que a pessoa envia uma mensagem à Página. Uma resposta na Messenger é endereçada ao PSID, e a User Profile API da Meta pode convertê-lo em dados de perfil, como o nome e a foto de perfil.
Onde aparece cada ID?
Cada ID surge nos seus próprios sítios, e confundi-los é o motivo habitual de um ID ser recusado. Onde a documentação da Meta os mostra:
- ID da Página: id em /me/accounts, entry.id e recipient.id nos eventos da Messenger, e o {page-id} em edges de Página como /{page-id}/feed.
- PSID: sender.id nos eventos da Messenger, from.id nos comentários lidos através da API de Páginas, e os IDs que /{page-id}/roles lista.
- ID de utilizador com âmbito de app: o id que o /me de um token de utilizador devolve, e
user_idno signed request de um callback de eliminação de dados. - ID de publicação: o id que uma chamada de publicação devolve e
post_idnos webhooks de feed, escrito {page-id}_{post-id} na referência da Meta. - ID de comentário:
comment_idnos webhooks de feed, e o destinatário de uma resposta privada na Messenger.
O que é um ID de utilizador com âmbito de app?
O ID que uma app vê para uma pessoa que inicia sessão nela com o Facebook. A Meta cria-o no primeiro início de sessão da pessoa, é específico dessa app, e outras apps não o podem usar. O callback de eliminação de dados da Meta identifica a pessoa desta forma, e o guia da Send API da Meta avisa que estes IDs não funcionam com a Messenger Platform, que exige PSIDs.
Como identificar uma pessoa entre as apps de uma empresa?
Através da empresa que detém as apps. Depois de associadas à mesma empresa no Business Manager, o campo token_for_business no nó User devolve uma cadeia que se mantém igual para essa pessoa nessas apps, e o edge ids_for_business lista os seus IDs com âmbito de app nas apps em que iniciou sessão. A Meta refere que o valor é um token e não um ID, e que se altera se mudar a empresa titular.
Que IDs usam as ferramentas da easyCoexistence?
account_id, o ID da própria ligação, escolhe a Página nas ferramentas de publicação, comentários, Messenger e métricas, e list_social_accounts devolve-o junto ao external_id, o ID da Página. get_social_credentials entrega o ID da Página com a base da Graph API para chamadas diretas à Graph API, e os eventos reencaminhados trazem ambos. send_social_dm recebe o PSID da pessoa, o sender.id de um evento de mensagens, enquanto reply_to_comment e hide_comment recebem um ID de comentário.
Erros comuns
- Copiar o ID da Página da barra de endereço. O URL de uma Página pode conter o nome de utilizador, como facebook.com/platform, por isso leia o ID numérico na secção de transparência ou em /me/accounts.
- Responder na Messenger com um ID com âmbito de app. A Send API recebe o PSID do evento de mensagem; um ID de um início de sessão com Facebook Login não endereça uma conversa.
- Reutilizar um PSID noutra Página. Os PSIDs são únicos para cada par pessoa-Página, por isso guarde cada um com o ID da Página de onde veio.
- Tratar token_for_business como um ID de utilizador. A Meta diz que é um token e não um ID, e não pode ser usado diretamente na Graph API.
De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que acrescenta ligações, com os primeiros 3 dias grátis.
Perguntas frequentes
O ID da Página é o mesmo que o nome de utilizador da Página?
Não. O nome de utilizador é o alias da Página, como platform em facebook.com/platform, enquanto o ID da Página é o ID numérico que a Graph API usa para a Página.
Posso encontrar o ID de uma Página que não gero?
A pesquisa de Páginas da Meta devolve IDs de Páginas a apps aprovadas para a funcionalidade Page Public Content Access. /me/accounts lista apenas as Páginas sobre as quais a pessoa com sessão iniciada pode executar tarefas.
Como obtenho o nome de uma pessoa a partir de um PSID?
Com a User Profile API da Meta: GET /{psid}?fields=first_name,last_name,profile_pic e o token da Página. É preciso Advanced Access à funcionalidade Business Asset User Profile Access, e a pessoa tem de ter optado por isso, por exemplo ao enviar uma mensagem à Página.
Que ID envia o callback de eliminação de dados da Meta?
O ID de utilizador com âmbito de app da pessoa, como user_id dentro do signed request que a Meta envia para o callback.
Continue a ler
Ligue o seu primeiro canal em dois minutos.
Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorizado 24/7
Verificado em