EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Como achar o ID de uma Página do Facebook e o que é um PSID

Um ID de Página do Facebook é o ID numérico que identifica a Página na Graph API. Um gestor da Página o encontra no Facebook, em Transparência e política de privacidade da Página, e um app o lê em /me/accounts, ao lado do token da Página. Um PSID, ou ID de usuário com escopo de Página, é diferente: identifica uma pessoa, de forma única para cada par pessoa e Página.

O easyCoexistence lista cada Página conectada com seu ID de Página por meio de list_social_accounts e mantém os IDs consistentes entre as ferramentas para Claude, ChatGPT ou seu próprio código: account_id escolhe a Página, um PSID endereça uma resposta no Messenger e um ID de comentário, uma resposta a um comentário.

Transparency and privacy policy

Onde a Central de Ajuda do Facebook diz que o ID de uma Página aparece, depois de trocar para a Página e abrir o perfil dela.

/me/accounts

Retorna as Páginas nas quais uma pessoa pode executar tarefas, cada uma com nome, ID, categoria, tarefas e um token de acesso à Página.

User-Page pair

A que é único um ID de usuário com escopo de Página; as APIs de Páginas e os endpoints da Messenger Platform dependem de PSIDs.

App-scoped

IDs de usuário de integrações de Facebook Login, que a Meta diz que não funcionam com a Messenger Platform.

{page-id}_{post-id}

Como a referência de post de Página da Meta escreve o ID de um post no exemplo de atualização, com o ID da Página primeiro.

Onde fica o ID da Página no Facebook?

No próprio perfil da Página, em seus detalhes de transparência. A Central de Ajuda do Facebook indica estes passos, começando pela conta que gerencia a Página:

  • Entre no Facebook e clique na sua foto de perfil, no canto superior direito.
  • Clique em Ver todos os perfis e selecione a Página para a qual quer trocar.
  • Clique no nome da Página no menu à esquerda para acessá-la.
  • Clique no nome da Página abaixo da foto de capa.
  • Clique em Transparência e política de privacidade para encontrar o ID da Página.

Como um app obtém o ID de uma Página?

A partir de /me/accounts, chamado com o token de acesso de usuário de alguém que entrou com o Facebook Login for Business. A visão geral da API de Páginas da Meta orienta o app a guardar cada ID de Página retornado junto com o token de acesso da Página, e o exemplo de resposta da Meta lista o nome, o ID e a categoria de cada Página, além das tarefas que a pessoa pode executar. O Graph API Explorer faz a mesma chamada para uma consulta rápida.

GET /me/accounts, trimmed from Meta's example
{
  "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 usuário com escopo 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 e Página, então a mesma pessoa pode ter um ID diferente em cada Página, e o Messenger atribui um na primeira vez que a pessoa envia mensagem à Página. Uma resposta no Messenger é endereçada ao PSID, e a User Profile API da Meta pode transformá-lo em dados de perfil, como nome e foto de perfil.

Onde cada ID aparece?

Cada ID aparece em lugares próprios, e confundi-los é o motivo mais comum 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 em eventos do Messenger, e o {page-id} em edges de Página como /{page-id}/feed.
  • PSID: sender.id em eventos do Messenger, from.id em comentários lidos pela API de Páginas, e os IDs listados por /{page-id}/roles.
  • ID de usuário com escopo de app: o id retornado pelo /me de um token de usuário, e user_id na requisição assinada de um callback de exclusão de dados.
  • ID do post: o id retornado por uma chamada de publicação e post_id em webhooks de feed, escrito {page-id}_{post-id} na referência da Meta.
  • ID do comentário: comment_id em webhooks de feed, e o destinatário de uma resposta privada no Messenger.

O que é um ID de usuário com escopo de app?

O ID que um app vê para uma pessoa que entra nele com o Facebook. A Meta o cria no primeiro login da pessoa, ele é específico daquele app, e outros apps não podem usá-lo. O callback de exclusão de dados da Meta identifica a pessoa dessa forma, e o guia da Send API da Meta avisa que esses IDs não funcionam com a Messenger Platform, que usa PSIDs.

Como identificar uma mesma pessoa entre os apps de uma empresa?

Pelo negócio que é dono dos apps. Depois que eles são associados ao mesmo negócio no Gerenciador de Negócios, o campo token_for_business no nó User retorna uma string que permanece a mesma para essa pessoa nesses apps, e a edge ids_for_business lista os IDs com escopo de app dela nos apps em que entrou. A Meta observa que o valor é um token e não um ID, e que muda se o negócio proprietário mudar.

Quais IDs as ferramentas do easyCoexistence usam?

account_id, o próprio ID da conexão, escolhe a Página nas ferramentas de publicação, comentário, Messenger e insights, e list_social_accounts o retorna junto com 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 encaminhados trazem os dois. 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. A URL de uma Página pode trazer o nome de usuário dela, como acontece com facebook.com/platform, então leia o ID numérico na seção de transparência ou em /me/accounts.
  • Responder no Messenger com um ID de usuário com escopo de app. A Send API recebe o PSID do evento de mensagem; um ID vindo de um login com Facebook Login não endereça uma conversa.
  • Reutilizar um PSID em outra Página. PSIDs são únicos para cada par pessoa e Página, então guarde cada um junto com o ID da Página de origem.
  • Tratar token_for_business como um ID de usuário. A Meta diz que é um token, não um ID, e ele não pode ser usado diretamente contra a Graph API.
Fazendo isso com o EasyCoexistence

De US$ 9 a US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com os primeiros 3 dias grátis.

O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.

Perguntas frequentes

O ID da Página é o mesmo que o nome de usuário da Página?

Não. O nome de usuário é o apelido 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 gerencio?

A busca de Páginas da Meta retorna IDs de Páginas apenas para apps aprovados para o recurso Page Public Content Access. /me/accounts lista somente as Páginas nas quais a pessoa conectada 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. Ela exige Acesso Avançado ao recurso Business Asset User Profile Access, e a pessoa precisa ter aceitado receber mensagens, por exemplo ao enviar uma mensagem à Página.

Qual ID o callback de exclusão de dados da Meta envia?

O ID de usuário com escopo de app da pessoa, como user_id dentro da requisição assinada que a Meta envia ao callback.

Continue lendo

Conecte seu primeiro canal em dois minutos.

Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorado 24/7

Verificado em