
Guias de integração
Guia da API do LinkedIn
Guia da API de e-mail
Guia da API do WhatsApp
Fale com vendas
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.
api.unipile.com/v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send
200 OK
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.
Mensagens de uma conta pessoal do Facebook em três etapas
Conecte. O seu usuário conecta a própria conta do Facebook pelo Hosted Auth. Sem app da Meta, sem App Review.
Envie. Chame a API V2 com o seu header X-API-KEY:POST/v2/
Receba. As mensagens recebidas chegam ao seu webhook como eventos message.new.
Detalhes no fluxo de conexão e exemplos de código abaixo, ou no quickstart do Facebook.
Comece seu teste gratuito de 7 diasA 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.
Fonte: visão geral da Messenger Platform da Meta. Última verificação: novembro de 2026.
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.
Você registra um app no Meta for Developers com o caso de uso Messenger.
Um admin da Página concede permissões como pages_messaging.
O seu app chama a Send API somente em nome dessa Página.
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.
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.
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.
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.
O usuário clica em "Conectar o Facebook" e chega ao Hosted Auth.
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.
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.
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.
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.
| Tema | Página via Messenger Platform | Conta pessoal via Unipile |
|---|---|---|
| Conta | Uma Página do Facebook ou conta profissional do Instagram | A conta pessoal do Facebook do próprio usuário |
| Quem conecta | Um admin da Página, pelo Facebook Login for Business | O dono da conta, pelo Hosted Auth ou Custom Auth |
| O que o seu app guarda | Um Page access token | A sua chave de API da Unipile e o account_id do usuário |
| App da Meta e App Review | Um app da Meta, mais App Review para atender Páginas que não são suas | Nenhum app da Meta e nenhum App Review do seu lado |
| Quem escreve primeiro | A pessoa envia mensagem para a Página | O usuário pode responder ou iniciar uma nova conversa |
| Eventos em tempo real | Webhooks do Messenger no seu app da Meta | Mensagens novas, editadas e excluídas, confirmações de leitura e de entrega, reações, atualizações de chat |
account_id do usuárioA 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.
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."},
)
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.
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.
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.
O Messenger fica na mesma inbox que LinkedIn, WhatsApp, Instagram e Telegram, com um único modelo de dados.
Um agente redige uma resposta a partir do histórico da conversa, e o usuário a revisa antes do envio.
Um consultor ou corretor acompanha os clientes com quem já conversa no Messenger.
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.
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ção | Graph API com um user access token | Conta pessoal conectada via Unipile |
|---|---|---|
| Ler as mensagens do Messenger do usuário | Não, nenhuma permissão de usuário cobre a caixa de entrada | Sim, chats, mensagens e anexos |
| Publicar no perfil do usuário | Não, publish_actions foi removida em 2018 | Sim, criar, editar e excluir posts |
| Responder a mensagens | Não, a Messenger Platform atende Páginas | Sim, responder ou iniciar uma conversa |
publish_actions foi removida em 2018Fontes: 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.
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
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.
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