BR
Contas pessoais

API do Facebook Messenger para conta pessoal: o que a Meta permite e como conectar uma

Procurando uma API do Facebook Messenger para conta pessoal? A Messenger Platform da Meta só atende Páginas do Facebook. Veja por que e como os seus usuários podem conectar a própria conta ao seu app.

Seu CRM Conectado
Tom ReyesFacebookAnna Lee, conta pessoal
Oi Anna, podemos passar nossa call para quinta?09:12
Webhook: message.new
Claro, quinta às 10h funciona. Vou mandar o convite.09:14 · Visto
POST api.unipile.com/v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send 200 OK
Resposta curta

A API oficial do Facebook Messenger não suporta contas pessoais. A Messenger Platform da Meta permite que uma Página do Facebook ou uma conta profissional do Instagram responda às pessoas, nunca um perfil pessoal. Para trabalhar com uma conta pessoal do Facebook, o dono da conta a conecta ao seu app por meio de uma API de terceiros, como a Unipile.

Os projetos open source que controlam o messenger.com a partir de um navegador são não oficiais, em grande parte sem manutenção e quebram sempre que a interface muda. Uma conta conectada passa por uma API mantida, com webhooks.

Para uma visão geral das APIs da Meta, veja como as APIs do Facebook se encaixam.

Com a Unipile

Mensagens de uma conta pessoal do Facebook em três etapas

  1. 1

    Conecte. O seu usuário conecta a própria conta do Facebook pelo Hosted Auth. Sem app da Meta, sem App Review.

  2. 2

    Envie. Chame a API V2 com o seu header X-API-KEY:POST/v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send

  3. 3

    Receba. As mensagens recebidas chegam ao seu webhook como eventos message.new.

A resposta

A API do Facebook Messenger funciona com uma conta pessoal?

A oficial, não. A Meta criou a Messenger Platform para empresas: ela permite que uma Página do Facebook ou uma conta profissional do Instagram responda às pessoas que escrevem para ela. Uma conta pessoal do Facebook só chega ao seu app quando o dono a conecta, por meio de uma API de terceiros que age em nome dele.

Messenger Platform da Meta
Facebook

Página do Facebook

  • O seu app da Meta age por uma Página com um Page access token.
  • A Página responde às pessoas que enviam mensagem primeiro.
  • Janela padrão de mensagens de 24 horas após a última mensagem da pessoa.
  • App Review antes de atender Páginas que não são suas.
Conta conectada com a Unipile
Facebook

Conta pessoal do Facebook

  • Cada usuário vincula a própria conta por autenticação hospedada.
  • O seu app lê e envia mensagens a partir dessa conta.
  • Uma única REST API e um único formato de webhook para todos os canais.
  • O usuário continua sujeito aos Termos da Meta.

Fonte: visão geral da Messenger Platform da Meta. Última verificação: novembro de 2026.

Modelo oficial

Por que a Messenger Platform da Meta para nas Páginas do Facebook

A Messenger Platform foi projetada em torno de uma Página, não de uma pessoa. Toda chamada age em nome de uma Página do Facebook, com um Page access token e a permissão pages_messaging, então não existe token que represente uma caixa de entrada pessoal.

1

App da Meta

Você registra um app no Meta for Developers com o caso de uso Messenger.

2

Facebook Login for Business

Um admin da Página concede permissões como pages_messaging.

3

Page access token

O seu app chama a Send API somente em nome dessa Página.

4

Webhook e janela de 24 horas

A Página recebe mensagens e responde dentro da janela padrão de mensagens.

As permissões são solicitadas pelo Facebook Login for Business, e business_management é uma dependência de pages_messaging. O App Review não é necessário se você apenas envia e recebe mensagens da sua própria Página; atender Páginas de outras empresas exige essa análise. A maioria das respostas precisa ser enviada em até 24 horas após a última mensagem da pessoa; a tag de mensagem HUMAN_AGENT estende as respostas manuais para 7 dias, após o App Review. Nenhuma dessas etapas da Graph API pode ter como alvo um perfil pessoal, e é por isso que as ferramentas criadas sobre a API oficial conectam apenas Páginas. O custo dessa configuração está detalhado no nosso guia de preços da API do Facebook Messenger.

Fontes: visão geral da Messenger Platform e referência da Send API da Meta. Última verificação: novembro de 2026.

O que aconteceu com a Facebook Chat API?

A Meta desativou a antiga Facebook Chat API (XMPP, chat.facebook.com) em 2015, com o fim da Graph API v1.0 e da permissão xmpp_login. Não existe API oficial para a caixa de entrada de um perfil pessoal do Facebook: a Messenger Platform, que a substituiu para as mensagens comerciais, só age em nome de Páginas. As bibliotecas não oficiais publicadas no npm desde então entram no messenger.com com a própria sessão do usuário. Elas não têm suporte da Meta, e o projeto open source original diz que está em modo de manutenção.

  • Sem cronograma de versões. Elas param de funcionar quando o Facebook muda a interface.
  • Credenciais no seu app. O seu app armazena e reutiliza a sessão ou a senha do usuário.
  • Risco para a conta. O Facebook pode restringir uma conta cujo uso viole os seus Termos, e esse risco recai sobre o usuário final.

Para enviar mensagens de uma Página que você gerencia, use a Messenger Platform e envie uma mensagem do Messenger via API. Para a própria conta do usuário, use uma API mantida: o usuário se conecta pelo Hosted Auth, então o seu app nunca lida com a senha dele, e você recebe um account_id, webhooks e uma equipe de suporte (veja como uma conta pessoal se conecta). Os Termos da Meta continuam valendo para essa conta.

Conexão

Como uma conta pessoal do Facebook se conecta ao seu app

O próprio dono da conta faz a conexão. O seu app abre uma página de Hosted Auth da Unipile (ou a sua própria tela com Custom Auth), o usuário entra no Facebook e valida a autenticação em dois fatores, e o seu app recebe um account_id para chamar a API.

1Seu app

Abrir o Hosted Auth

O usuário clica em "Conectar o Facebook" e chega ao Hosted Auth.

2O usuário

Entrar e confirmar

Nome de usuário, e-mail ou telefone com senha, cookies do navegador ou a extensão UniLogin, depois 2FA por SMS, app autenticador, WhatsApp, aprovação no app ou código de uso único.

3Unipile

Receber um account_id

A conta conectada aparece no seu dashboard e toda chamada usa o account_id dela.

Não há tela de OAuth da Meta nem QR code nesse fluxo, e você não cria um app da Meta nem passa pelo App Review do seu lado. Os métodos de cada provedor estão listados na tabela de recursos por provedor, e a visão geral do produto fica na página da API do Facebook Messenger.

Conformidade

Cada usuário conecta a própria conta

A Unipile não é um produto da Meta. Ela não é Meta Partner e não é endossada pela Meta. Cada usuário conecta a própria conta, a Unipile age em nome desse usuário autenticado, e o usuário continua sujeito aos Termos da Meta.

Escopo

API do Facebook para conta pessoal: o que uma conta conectada pode fazer

Na prática, uma integração da API do Facebook Messenger com conta pessoal expõe a caixa de entrada do Messenger do próprio usuário pela API da Unipile: chats, mensagens, anexos, reações e confirmações, além de webhooks em tempo real, comparados abaixo com o modelo oficial de Páginas.

TemaPágina via Messenger PlatformConta pessoal via Unipile
ContaUma Página do Facebook ou conta profissional do InstagramA conta pessoal do Facebook do próprio usuário
Quem conectaUm admin da Página, pelo Facebook Login for BusinessO dono da conta, pelo Hosted Auth ou Custom Auth
O que o seu app guardaUm Page access tokenA sua chave de API da Unipile e o account_id do usuário
App da Meta e App ReviewUm app da Meta, mais App Review para atender Páginas que não são suasNenhum app da Meta e nenhum App Review do seu lado
Quem escreve primeiroA pessoa envia mensagem para a PáginaO usuário pode responder ou iniciar uma nova conversa
Eventos em tempo realWebhooks do Messenger no seu app da MetaMensagens novas, editadas e excluídas, confirmações de leitura e de entrega, reações, atualizações de chat
Conta
PáginaUma Página do Facebook ou conta profissional do Instagram
Conta pessoalA conta pessoal do Facebook do próprio usuário
Quem conecta
PáginaUm admin da Página, pelo Facebook Login for Business
Conta pessoalO dono da conta, pelo Hosted Auth ou Custom Auth
O que o seu app guarda
PáginaUm Page access token
Conta pessoalA sua chave de API da Unipile e o account_id do usuário
App da Meta e App Review
PáginaUm app da Meta, mais App Review para atender Páginas que não são suas
Conta pessoalNenhum app da Meta e nenhum App Review do seu lado
Quem escreve primeiro
PáginaA pessoa envia mensagem para a Página
Conta pessoalO usuário pode responder ou iniciar uma nova conversa
Eventos em tempo real
PáginaWebhooks do Messenger no seu app da Meta
Conta pessoalMensagens novas, editadas e excluídas, confirmações de leitura e de entrega, reações, atualizações de chat

Endpoints de mensagens

  • Listar chats e mensagens, incluindo conversas em grupo
  • Iniciar uma conversa, enviar mensagens e anexos
  • Editar, excluir e encaminhar mensagens
  • Adicionar e remover reações, marcar como lida, confirmações de leitura
  • Silenciar e arquivar chats

Não suportado

  • Fixar uma mensagem
  • Stories

A mesma conta conectada também expõe seus posts, comentários e reações. Esses endpoints estão resumidos no guia da API do Facebook.

Código

Ler chats e enviar uma mensagem a partir de uma conta pessoal

Duas chamadas cobrem o fluxo básico: listar os chats da conta conectada e depois enviar uma mensagem em um deles. As requisições vão para https://api.unipile.com com a sua chave de API no header X-API-KEY.

# 1. List the chats of the connected personal account
curl --request GET \
  --url "https://api.unipile.com/v2/{ACCOUNT_ID}/chats" \
  --header "X-API-KEY: {YOUR_API_KEY}"

# 2. Send a message in one of those chats
curl --request POST \
  --url "https://api.unipile.com/v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send" \
  --header "X-API-KEY: {YOUR_API_KEY}" \
  --header "content-type: application/json" \
  --data '{ "text": "Thursday 10am works for me." }'
const base = "https://api.unipile.com/v2/{ACCOUNT_ID}";
const headers = { "X-API-KEY": process.env.UNIPILE_API_KEY };

// 1. List the chats of the connected personal account
const chats = await (await fetch(`${base}/chats`, { headers })).json();

// 2. Send a message in one of those chats
await fetch(`${base}/chats/{CHAT_ID}/messages/send`, {
  method: "POST",
  headers: { ...headers, "content-type": "application/json" },
  body: JSON.stringify({ text: "Thursday 10am works for me." }),
});
import os, requests

base = "https://api.unipile.com/v2/{ACCOUNT_ID}"
headers = {"X-API-KEY": os.environ["UNIPILE_API_KEY"]}

# 1. List the chats of the connected personal account
chats = requests.get(f"{base}/chats", headers=headers).json()

# 2. Send a message in one of those chats
requests.post(
    f"{base}/chats/{{CHAT_ID}}/messages/send",
    headers=headers,
    json={"text": "Thursday 10am works for me."},
)
200 OK · mensagem enviada da própria conta do usuário

As mensagens recebidas chegam ao seu webhook como eventos message.new, então você não precisa fazer polling. O SDK Node.js encapsula as mesmas chamadas como getChatsList e sendMessage. Configuração completa no quickstart do Facebook. Mais linguagens, anexos e respostas de Página em enviar mensagem com a API do Facebook Messenger.

Como as duas chamadas aparecem no seu app

1Listar os chatsGET/chats
Seu app Conectado
FacebookAnna Lee, conta pessoal
Tom ReyesOi, Anna, podemos passar a nossa call para quinta?
Maya ChenAté sábado na feira
Sam PatelObrigado pelas fotos
Chat selecionado
chat_id
{CHAT_ID}
name
Tom Reyes
last message
Oi, Anna, podemos passar…
timestamp
09:12
2Enviar a respostaPOST/messages/send
Seu app Conectado
Tom ReyesFacebookAnna Lee, conta pessoal
Oi, Anna, podemos passar a nossa call para quinta?09:12
Quinta às 10h funciona para mim.09:14 · Visto
Requisição
chat_id
{CHAT_ID}
text
Quinta às 10h funciona…
response
200 OK
Casos de uso

Casos de uso legítimos e as regras da Meta que os seus usuários continuam seguindo

Uma conta pessoal conectada se encaixa em produtos nos quais um profissional conversa com os próprios contatos a partir da própria conta: CRMs, helpdesks, assistentes de IA que redigem respostas aprovadas pelo usuário e ferramentas para consultores. Ela não foi feita para prospecção a frio nem para bots totalmente automatizados.

CRM

Um vendedor encontra as suas conversas do Messenger no registro do contato certo, ao lado de e-mails e ligações. Veja a integração com CRM.

Helpdesk e inbox multicanal

O Messenger fica na mesma inbox que LinkedIn, WhatsApp, Instagram e Telegram, com um único modelo de dados.

Assistente de IA

Um agente redige uma resposta a partir do histórico da conversa, e o usuário a revisa antes do envio.

Acompanhamento de consultores

Um consultor ou corretor acompanha os clientes com quem já conversa no Messenger.

Os Termos da Meta continuam valendo

Uma conta conectada continua sujeita aos Termos de Serviço da Meta. Desenvolva para as conversas que o usuário teria de qualquer forma: mensagens não solicitadas e automação não autorizada podem levar a Meta a restringir a conta.

Criando uma inbox única para várias redes? Veja como funciona uma API de mensagens unificada.

Graph API

API do Facebook para contas pessoais: o que a Graph API ainda permite

Uma integração de conta pessoal com a API do Facebook pela Graph API da Meta é limitada. Ela consegue identificar a pessoa e ler alguns campos do perfil, mas não consegue abrir a caixa de entrada do Messenger nem publicar em nome dela.

A identificação continua funcionando. Com o Facebook Login, a pessoa concede ao seu app um user access token. A permissão public_profile lê os campos públicos padrão do perfil e email lê o endereço de e-mail principal. Outras permissões de usuário, como user_posts para os posts que o usuário fez na própria linha do tempo, são restritas pela Meta a uma lista curta de usos aprovados. Nenhuma permissão de usuário dá acesso às conversas do Messenger da pessoa. A forma como esses tokens são emitidos é explicada no nosso guia sobre o token de acesso da API do Facebook.

A publicação em perfis acabou em 2018. A Meta removeu a permissão publish_actions em 24 de abril de 2018, e os apps já aprovados para ela puderam continuar a usá-la até 1º de agosto de 2018. Desde então, os apps criados com a Graph API publicam apenas em Páginas, e é por isso que as ferramentas de agendamento deixaram de oferecer perfis pessoais.

Uma conta conectada cobre os dois lados. Quando o dono conecta a conta pessoal pela Unipile, o seu app lê e envia as mensagens do Messenger dessa conta, e cria, edita e exclui os posts, comentários e reações dela. A parte de publicação está detalhada no nosso guia da API de posts do Facebook.

AçãoGraph API com um user access tokenConta pessoal conectada via Unipile
Ler as mensagens do Messenger do usuárioNão, nenhuma permissão de usuário cobre a caixa de entradaSim, chats, mensagens e anexos
Publicar no perfil do usuárioNão, publish_actions foi removida em 2018Sim, criar, editar e excluir posts
Responder a mensagensNão, a Messenger Platform atende PáginasSim, responder ou iniciar uma conversa
Ler as mensagens do Messenger do usuário
Graph APINão, nenhuma permissão de usuário cobre a caixa de entrada
Conta conectadaSim, chats, mensagens e anexos
Publicar no perfil do usuário
Graph APINão, publish_actions foi removida em 2018
Conta conectadaSim, criar, editar e excluir posts
Responder a mensagens
Graph APINão, a Messenger Platform atende Páginas
Conta conectadaSim, responder ou iniciar uma conversa

Fontes: referência de permissões da Meta e changelog da Graph API de 24 de abril de 2018. Última verificação: 17 de novembro de 2026.

Conecte contas pessoais do Facebook ao seu produto

A Messenger Platform da Meta continua sendo a ferramenta certa para uma empresa que responde às pessoas na própria Página. Quando o seu produto precisa de uma API do Facebook Messenger que inclua contas pessoais, deixe os seus usuários conectarem a própria conta do Facebook e use uma única API para o Facebook e os seus outros canais.

Comissão Europeia
Regulamentado pela UE Digital Markets Act (DMA)

Cada usuário conecta a própria conta, sem armazenamento de perfis. A Unipile não é Meta Partner. Leia a nossa página sobre o Digital Markets Act

Referência de endpoints

Todos os endpoints da API do Facebook em um só lugar

As mensagens são só uma parte do panorama. Explore todos os endpoints do Facebook disponíveis com a Unipile, de chats a posts, ou leia o guia completo da API do Facebook para comparar as APIs oficiais da Meta com as contas conectadas.

FAQ da API para conta pessoal do Facebook

Respostas rápidas sobre perfis, histórico de mensagens, primeiras mensagens, reações, Páginas, chatbots, a Graph API e bibliotecas não oficiais.

A Messenger Platform da Meta não: ela atende Páginas do Facebook e contas profissionais do Instagram. Um perfil pessoal pode ser usado quando o dono o conecta ao seu app pela autenticação hospedada da Unipile, e o dono continua sujeito aos Termos da Meta.

Sim, depois que a conta estiver conectada. A API lista os chats e as mensagens da conta pessoal conectada, incluindo conversas em grupo e anexos, e os webhooks enviam ao seu app as mensagens novas, editadas e excluídas.

Sim. Uma conta pessoal conectada pode iniciar uma nova conversa, além de responder. Limite-se a pessoas que o usuário conhece ou com quem trabalha: mensagens não solicitadas violam os Termos da Meta e podem levar à restrição da conta.

Sim. Você pode listar, adicionar e remover reações nas mensagens, e as novas reações chegam ao seu app pelo evento de webhook message.reaction.new.

Sim, para as Páginas que o usuário conectado gerencia. O seu app pode ler e responder às mensagens da Página e publicar como a Página. Uma Página não pode iniciar uma conversa nem excluir as suas mensagens, então as conversas da Página sempre começam com a pessoa escrevendo primeiro.

A Messenger Platform da Meta, e os criadores de chatbot que dependem dela, funcionam apenas com Páginas. Com uma conta pessoal conectada, mantenha uma pessoa no processo: uma IA redige a resposta e o usuário a aprova. Mensagens totalmente automatizadas ou não solicitadas podem levar à restrição da conta.

Em parte. A Graph API da Meta ainda aceita um perfil pessoal para o Facebook Login e algumas permissões de leitura, mas não consegue abrir a caixa de entrada do Messenger da pessoa e não publica em perfis desde que a publish_actions foi removida em 2018. Para uma integração de conta pessoal com a API do Facebook que cubra mensagens e posts, o dono conecta a conta pela Unipile e o seu app trabalha com uma única API REST.

Sim. Existem bibliotecas open source que entram no messenger.com com a própria sessão do usuário, mas elas não são oficiais e não têm suporte da Meta. Elas podem parar de funcionar quando o Facebook muda a interface, e a conta que as usa pode ser restringida segundo os Termos da Meta. Para um app em produção, use a Messenger Platform para as Páginas que você gerencia, ou uma API mantida em que o usuário conecta a própria conta e continua sujeito aos Termos da Meta.

Não pelas integrações com o Facebook Messenger deles: elas dependem da Messenger Platform da Meta, que atende apenas Páginas. Com uma conta pessoal conectada pela Unipile, a mensagem é enviada a partir do seu próprio fluxo, por exemplo uma etapa HTTP que chama o endpoint de envio de mensagem dessa conta.

Não. A Unipile é uma empresa independente: ela não é um Meta Partner e não é endossada, patrocinada nem aprovada pela Meta. Conectar uma conta pessoal do Messenger pela Unipile não é uma integração oficial da Messenger Platform. Facebook e Messenger são marcas registradas da Meta Platforms, Inc.

Não. O dono da conta faz login pela autenticação hospedada da Unipile, então você não registra um app da Meta, não solicita pages_messaging nem passa pelo App Review do seu lado. O mesmo vale para as Páginas que esse usuário gerencia.

A Unipile foi projetada no espírito do Digital Markets Act. Cada pessoa conecta a própria conta do Facebook, as mensagens são lidas e enviadas em nome dela, e a Unipile não armazena perfis de usuários. Detalhes na nossa página sobre o Digital Markets Act.

Sim. Uma conta pessoal conectada continua sendo uma conta do Facebook sujeita aos Termos da Meta. Limite-se a usos legítimos, como responder a clientes, sincronizar conversas com um CRM ou ajudar um usuário a gerenciar a própria caixa de entrada; mensagens em massa ou não solicitadas podem levar à restrição da conta.

Ainda tem dúvidas? Nossa equipe está aqui para ajudar.

Fale com um especialista