ComposioHQ/Automação-Facebook

Automação do Facebook

Automatize operações de Páginas do Facebook — crie e agende postagens, envie vídeos, gerencie conversas do Messenger, obtenha insights da página e lide com conteúdo agendado — tudo orquestrado através da integração MCP do Composio.

Documentação do toolkit: composio.dev/toolkits/facebook

---

Configuração

1. Conecte sua conta do Facebook através do servidor MCP do Composio em https://rube.app/mcp
2. O agente solicitará um link de autenticação se não houver uma conexão ativa
3. Uma vez conectado, todas as ferramentas FACEBOOK_* ficam disponíveis para execução
4. Nota: Este toolkit suporta apenas Páginas do Facebook, não contas pessoais do Facebook

---

Fluxos de Trabalho Principais

1. Descobrir Páginas Gerenciadas

Liste todas as Páginas do Facebook que você gerencia para obter IDs de página e tokens de acesso para operações subsequentes.

Ferramenta: FACEBOOK_LIST_MANAGED_PAGES

Parâmetro	Tipo	Obrigatório	Descrição
fields	string	Não	Campos separados por vírgula (padrão: id,name,access_token,category,tasks,about,link,picture)
limit	integer	Não	Máximo de páginas por requisição (padrão: 25)
user_id	string	Não	ID do usuário (padrão: me)

Sempre execute isso primeiro para armazenar em cache os valores de page_id. Evite chamadas repetidas de descoberta — armazene os resultados em cache.

---

2. Criar e Agendar Postagens

Publique ou agende postagens de texto com links opcionais em uma Página do Facebook.

Ferramenta: FACEBOOK_CREATE_POST

Parâmetro	Tipo	Obrigatório	Descrição
page_id	string	Sim	ID numérico da Página obtido das páginas gerenciadas
message	string	Sim	Conteúdo de texto da postagem
published	boolean	Não	true para publicar imediatamente, false para rascunho/agendado (padrão: true)
scheduled_publish_time	integer	Não	Timestamp Unix UTC; deve ser pelo menos 10 minutos no futuro
link	string	Não	URL a ser incluída na postagem
targeting	object	Não	Especificações de segmentação de público

Ao agendar: Defina published=false e forneça scheduled_publish_time como um timestamp Unix UTC.

---

3. Criar e Agendar Postagens de Vídeo

Faça upload e agende conteúdo em vídeo em uma Página do Facebook.

Ferramenta: FACEBOOK_CREATE_VIDEO_POST

Parâmetro	Tipo	Obrigatório	Descrição
page_id	string	Sim	ID numérico da Página
file_url	string	Condicional	URL do arquivo de vídeo (forneça file_url ou video)
video	object	Condicional	Upload de arquivo local com name, mimetype, s3key
title	string	Não	Título do vídeo
description	string	Não	Descrição do vídeo
published	boolean	Não	Publicar imediatamente (padrão: true)
scheduled_publish_time	integer	Não	Timestamp Unix para publicação agendada

---

4. Gerenciar Postagens Agendadas

Revise, reagende, atualize ou publique conteúdo agendado.

Ferramentas:

• FACEBOOK_GET_SCHEDULED_POSTS — Lista postagens agendadas/não publicadas de uma página
  • page_id (obrigatório), fields, limit (máx. 100)
• FACEBOOK_RESCHEDULE_POST — Altera o horário de publicação agendado
• FACEBOOK_UPDATE_POST — Edita legenda/texto de uma postagem existente
• FACEBOOK_PUBLISH_SCHEDULED_POST — Publica uma postagem agendada imediatamente

---

5. Ler Conversas do Messenger da Página

Recupere conversas da caixa de entrada e threads de mensagens entre usuários e sua Página.

Ferramenta: FACEBOOK_GET_PAGE_CONVERSATIONS

Parâmetro	Tipo	Obrigatório	Descrição
page_id	string	Sim	O ID da Página do Facebook
fields	string	Não	Campos a retornar (padrão: participants,updated_time,id)
limit	integer	Não	Conversas a retornar, máx. 25

Em seguida, recupere as threads completas de mensagens:

Ferramenta: FACEBOOK_GET_CONVERSATION_MESSAGES

Parâmetro	Tipo	Obrigatório	Descrição
page_id	string	Sim	ID da Página proprietária da conversa
conversation_id	string	Sim	ID da conversa no formato t_ (ex.: t_3638640842939952)
fields	string	Não	Padrão: id,created_time,from,to,message
limit	integer	Não	Mensagens a retornar, máx. 25

---

6. Enviar Mensagens e Marcar como Lidas

Responda a usuários via Messenger e marque mensagens como lidas.

Ferramentas:

• FACEBOOK_SEND_MESSAGE — Envia uma mensagem de texto da Página para um usuário via Messenger
• FACEBOOK_MARK_MESSAGE_SEEN — Marca a mensagem de um usuário como lida pela Página

Aviso: Ambas as ferramentas causam efeitos colaterais visíveis ao usuário. Chame apenas após confirmação explícita.

---

Armadilhas Conhecidas

Armadilha	Detalhes
Agendamento muito próximo do agora	FACEBOOK_CREATE_POST com scheduled_publish_time com menos de ~10 minutos no futuro retorna HTTP 400 — mantenha uma margem maior para execuções em lote
Timestamps Unix UTC obrigatórios	scheduled_publish_time deve ser Unix UTC — erros de conversão de fuso horário causam agendamento incorreto ou falhas de validação
Paginação baseada em cursor	FACEBOOK_GET_SCHEDULED_POSTS e FACEBOOK_GET_PAGE_CONVERSATIONS retornam subconjuntos — siga os cursores de paginação para obter dados completos
Payloads grandes de conversas	Solicitar mensagens incorporadas em conversas cria payloads enormes — use FACEBOOK_GET_CONVERSATION_MESSAGES para threads completas
Atrasos no processamento de vídeo	Vídeos enviados podem permanecer em estado de processamento — agende apenas via FACEBOOK_CREATE_VIDEO_POST após o upload estar utilizável
Armazenar IDs de página em cache	Repetir chamadas FACEBOOK_LIST_MANAGED_PAGES adiciona latência — armazene page_id em cache por workspace/execução
Apenas Páginas	Este toolkit não suporta contas pessoais do Facebook — apenas Páginas do Facebook
Operações de escrita precisam de confirmação	FACEBOOK_SEND_MESSAGE e FACEBOOK_MARK_MESSAGE_SEEN causam efeitos colaterais visíveis ao usuário — chame apenas após confirmação explícita do usuário

---

Referência Rápida

Slug da Ferramenta	Propósito
FACEBOOK_LIST_MANAGED_PAGES	Listar Páginas que você gerencia com tokens de acesso
FACEBOOK_GET_PAGE_DETAILS	Obter informações detalhadas de uma Página específica
FACEBOOK_CREATE_POST	Criar ou agendar uma postagem de texto/link
FACEBOOK_CREATE_VIDEO_POST	Criar ou agendar uma postagem de vídeo
FACEBOOK_GET_SCHEDULED_POSTS	Listar postagens agendadas/não publicadas
FACEBOOK_RESCHEDULE_POST	Alterar horário de publicação agendado
FACEBOOK_UPDATE_POST	Editar uma postagem existente
FACEBOOK_PUBLISH_SCHEDULED_POST	Publicar uma postagem agendada imediatamente
FACEBOOK_UPLOAD_VIDEO	Fazer upload de um arquivo de vídeo para uma Página
FACEBOOK_GET_PAGE_CONVERSATIONS	Listar conversas da caixa de entrada do Messenger
FACEBOOK_GET_CONVERSATION_MESSAGES	Recuperar mensagens de uma conversa
FACEBOOK_SEND_MESSAGE	Enviar uma mensagem do Messenger a partir da Página
FACEBOOK_MARK_MESSAGE_SEEN	Marcar uma mensagem como lida
FACEBOOK_GET_PAGE_POSTS	Recuperar postagens do feed de uma Página
FACEBOOK_GET_USER_PAGES	Listar Páginas com tarefas e tokens

---

Desenvolvido por Composio