Facebook

Visão geral

Facebook é uma plataforma de mídia social e publicidade utilizada por pessoas e empresas para se conectar, compartilhar conteúdo e promover produtos ou serviços. Esta integração suporta exclusivamente Páginas do Facebook — não funciona com perfis pessoais. Com a integração no SquadOS, seus agentes podem criar e agendar publicações, responder comentários, enviar mensagens pelo Messenger, gerenciar funções de colaboradores na Página e consultar métricas de engajamento e alcance, tudo de forma automatizada.

Site oficial: https://www.facebook.com/
Documentação na Composio: docs.composio.dev/toolkits/facebook

Autenticação

Esta ferramenta utiliza OAuth 2.0 (OAUTH2) para conectar.

Você vai precisar dos seguintes campos:

Campo	Obrigatório	Descrição
`access_token`	Sim	Token de acesso OAuth 2.0 obtido ao autorizar o aplicativo Meta na conta do Facebook. Gerenciado automaticamente pela Composio durante o fluxo de conexão.

Como obter a credencial

A autenticação é feita via OAuth 2.0 — você não precisa gerar tokens manualmente. O fluxo completo é descrito na página oficial da Composio para esta integração:

Acesse composio.dev/auth/facebook para o guia passo a passo de configuração de credenciais OAuth personalizadas para Meta (Facebook).
Crie um aplicativo Meta no Meta for Developers e configure as permissões necessárias (ex.: pages_manage_posts, pages_read_engagement, pages_messaging).
Na Composio, use o fluxo de conexão OAuth para autorizar o acesso — a Composio gerencia a obtenção e renovação do token automaticamente.

Como conectar no SquadOS

Acesse Ferramentas no menu lateral (/admin/tools).
Abra a aba Disponíveis e procure por Facebook.
Clique no card para abrir o modal de detalhes e em Conectar.
Você é levado para a página de conexão segura hospedada pela Composio, onde autoriza o acesso à sua conta Meta (OAuth 2.0).
Ao concluir, você volta para o SquadOS com a conta conectada e a ferramenta disponível para os agentes. (Detalhes do fluxo em Ferramentas da Organização.)

Perguntas frequentes

Como configuro credenciais OAuth personalizadas para Meta (Facebook)?

Para um guia passo a passo sobre como criar e configurar suas próprias credenciais OAuth para Meta (Facebook) na Composio, consulte Como criar credenciais OAuth para Meta (Facebook).

Ações disponíveis

Atribuir tarefa na Página

FACEBOOK_ASSIGN_PAGE_TASK

Atribui tarefas/funções a um usuário com escopo empresarial ou a um usuário de sistema para uma Página específica do Facebook. Importante: esta ação requer um ID de usuário com escopo empresarial ou ID de usuário de sistema do Facebook Business Manager. IDs de usuário comuns do Facebook não podem ser usados. A Página também deve ser gerenciada pelo Facebook Business Manager. Permissões necessárias: business_management, pages_manage_metadata.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`user`	string	Sim	O ID de usuário com escopo empresarial ou ID de usuário de sistema ao qual atribuir tarefas. Nota: IDs de usuário comuns do Facebook não são aceitos — somente IDs com escopo empresarial (do Business Manager) ou IDs de usuário de sistema.
`tasks`	array	Sim	Lista de tarefas a atribuir. Valores válidos: ‘MANAGE’, ‘CREATE_CONTENT’, ‘MODERATE’, ‘ADVERTISE’, ‘ANALYZE’, ‘MESSAGING’. Exemplo: [‘MANAGE’, ‘CREATE_CONTENT’].
`page_id`	string	Sim	O ID da Página do Facebook.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar comentário

FACEBOOK_CREATE_COMMENT

Cria um comentário em uma publicação do Facebook ou responde a um comentário existente.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`message`	string	Sim	O texto do comentário.
`object_id`	string	Sim	O ID da publicação ou comentário a comentar. Deve ser um ID numérico (ex.: ‘3071372469667482’) ou no formato composto ‘pageId_postId’ (ex.: ‘678465505624869_3071372469667482’). Não inclua prefixos como ‘post_’, ‘id_’ ou ‘p’.
`attachment_id`	string	Não	ID de uma foto não publicada para anexar ao comentário.
`attachment_url`	string	Não	URL de uma foto para anexar ao comentário.
`attachment_share_url`	string	Não	URL de um GIF para anexar ao comentário.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar álbum de fotos

FACEBOOK_CREATE_PHOTO_ALBUM

Cria um novo álbum de fotos em uma Página do Facebook. Nota: este endpoint requer a permissão pages_manage_posts ou permissões equivalentes no seu aplicativo Facebook. Esta ação é publicamente visível na Página; confirme com o usuário antes de executar.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`name`	string	Sim	Nome do álbum de fotos.
`message`	string	Não	Descrição do álbum.
`page_id`	string	Sim	O ID da Página do Facebook. Deve ser um ID de Página — IDs de perfil pessoal ou linha do tempo de usuário são inválidos.
`privacy`	object	Não	Configurações de privacidade do álbum (ex.: `{'value': 'EVERYONE'}`).
`location`	string	Não	Localização associada ao álbum.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar publicação com foto

FACEBOOK_CREATE_PHOTO_POST

Cria uma publicação com foto em uma Página do Facebook. Requer que uma imagem seja fornecida via url (URL de imagem publicamente acessível) ou photo (upload de arquivo de imagem local). Esta ação é especificamente para publicar imagens com legendas opcionais, não para publicações somente de texto. Retorna um post_id composto (PageID_PostID); use este ID em operações subsequentes, não o ID da foto/mídia isolado.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`url`	string	Não	URL de uma imagem publicamente acessível para upload. Suporta links de imagem diretos com ou sem extensão de arquivo. O host da imagem não deve bloquear requisições do Facebook. Não pode ser uma URL do Facebook. Pelo menos um de ‘url’, ‘photo’ ou ‘media’ é obrigatório. A URL deve retornar um MIME type de imagem diretamente — redirecionamentos ou páginas HTML causam falha no upload.
`media`	object	Não	Alias para ‘photo’. Para upload de arquivo de imagem local (ex.: .jpg, .png, .gif). Pelo menos um de ‘media’, ‘photo’ ou ‘url’ é obrigatório.
`photo`	object	Não	Para upload de arquivo de imagem local (ex.: .jpg, .png, .gif). Pelo menos um de ‘photo’, ‘url’ ou ‘media’ é obrigatório.
`message`	string	Não	Texto de legenda para a foto. Pode também ser fornecido como ‘caption’.
`page_id`	string	Sim	O ID numérico da Página do Facebook para publicar. Pode ser fornecido como string ou número.
`published`	boolean	Não	Defina como `true` para publicar imediatamente, `false` para salvar como não publicada.
`backdated_time`	integer	Não	Timestamp Unix para retrodatar a publicação.
`scheduled_publish_time`	integer	Não	Timestamp Unix para publicações agendadas (obrigatório se `published=false`). Deve ser um epoch UTC futuro. Fornecer este campo com `published=true` gera erro de validação 400.
`backdated_time_granularity`	string	Não	Granularidade do tempo retroatado: year, month, day, hour ou min.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar publicação de texto

FACEBOOK_CREATE_POST

Cria uma nova publicação de texto ou com link em uma Página do Facebook. Requer a permissão pages_manage_posts e acesso de gerenciamento na Página de destino. Para publicações com imagem use FACEBOOK_CREATE_PHOTO_POST; para vídeos use FACEBOOK_CREATE_VIDEO_POST — campos de mídia não são suportados aqui. Retorna um ID composto no formato PageID_PostID, necessário para recuperar a publicação com FACEBOOK_GET_POST.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`link`	string	Não	URL a incluir na publicação.
`message`	string	Sim	O texto da publicação. Pelo menos um de `message` ou `link` deve ser preenchido; omitir ambos causa erro de validação.
`page_id`	string	Sim	O ID numérico da Página do Facebook para publicar. É uma string numérica (ex.: ‘123456789012345’). Para obter um `page_id` válido, use ‘Get User Pages’ ou ‘List Managed Pages’.
`published`	boolean	Não	Defina como `true` para publicar imediatamente, `false` para salvar como rascunho ou agendar.
`targeting`	object	Não	Especificações de segmentação de público.
`scheduled_publish_time`	integer	Não	Timestamp Unix de quando a publicação deve ser publicada. Deve ser pelo menos 10 minutos no futuro. Quando fornecido, `published` deve ser `false` (será definido automaticamente como `false` se estiver como `true`). Deve ser epoch Unix UTC; discrepâncias de fuso horário causam falhas de validação.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar publicação de vídeo

FACEBOOK_CREATE_VIDEO_POST

Cria uma publicação de vídeo em uma Página do Facebook. Requer um token de acesso de Página com escopo pages_manage_posts e permissões de gerenciamento na página de destino.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`title`	string	Não	Título do vídeo.
`video`	object	Não	Arquivo de vídeo local para upload. Pelo menos um de ‘video’ ou ‘file_url’ deve ser fornecido.
`page_id`	string	Sim	O ID da Página do Facebook. Deve ser um ID de Página (não de perfil pessoal); o token autenticado deve ter acesso de gerenciamento.
`file_url`	string	Não	URL do arquivo de vídeo para upload. Pelo menos um de ‘file_url’ ou ‘video’ deve ser fornecido. Deve ser uma URL de download direto (ex.: link MP4 direto), não uma URL de visualização/compartilhamento. Use MP4 com codificação H.264/AAC; formatos não suportados ou arquivos muito grandes podem falhar.
`published`	boolean	Não	Se deve publicar imediatamente.
`targeting`	object	Não	Especificações de segmentação de público.
`description`	string	Não	Descrição do vídeo.
`scheduled_publish_time`	integer	Não	Timestamp Unix para agendar a publicação. Requer `published=false`; deve ser um epoch Unix UTC pelo menos ~10 minutos no futuro. Combinar com `published=true` ou omitir quando `published=false` causa erros 400.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Excluir comentário

FACEBOOK_DELETE_COMMENT

Exclui um comentário do Facebook. Requer um Token de Acesso de Página com as permissões apropriadas para comentários em conteúdo de propriedade da Página. O parâmetro page_id ajuda a garantir que o token correto da página seja usado na autenticação.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`page_id`	string	Não	Opcional: O ID da Página do Facebook proprietária da publicação que contém o comentário. Se não fornecido, a ação usará a primeira página gerenciada disponível. Fornecer o `page_id` correto garante autenticação adequada.
`comment_id`	string	Sim	O ID do comentário a excluir. Pode estar no formato ‘parentId_commentId’ (ex.: ‘122157027176937815_1371138271476143’) ou apenas o ID do comentário.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Excluir publicação

FACEBOOK_DELETE_POST

Exclui permanentemente uma publicação de uma Página do Facebook. A exclusão é irreversível — publicações excluídas não podem ser recuperadas. Para exclusões em massa, mantenha a taxa em ~1 exclusão/segundo para evitar limites de taxa da Graph API.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`post_id`	string	Sim	O ID da publicação a excluir. O token deve ter permissões de exclusão em nível de Página para esta publicação. Publicações criadas por outros usuários ou que requerem funções elevadas na Página podem não ser excluídas.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter comentário

FACEBOOK_GET_COMMENT

Recupera os detalhes de um comentário específico do Facebook.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`fields`	string	Não	Lista de campos a retornar, separados por vírgula.
`comment_id`	string	Sim	O ID do comentário a recuperar.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter comentários

FACEBOOK_GET_COMMENTS

Recupera comentários de uma publicação ou comentário do Facebook (para respostas). Este endpoint requer permissões apropriadas: para publicações de uma Página, um Token de Acesso de Página com permissão pages_read_engagement. A API troca automaticamente tokens de usuário por tokens de página quando disponíveis. Versão da API: v23.0 (lançada em maio de 2025).

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`limit`	integer	Não	Número de comentários a retornar (máx. 100).
`order`	string	Não	Ordem dos comentários: ‘chronological’ (mais antigos primeiro) ou ‘reverse_chronological’ (mais recentes primeiro, padrão).
`fields`	string	Não	Lista de campos a retornar para cada comentário, separados por vírgula. Campos disponíveis: id, message, created_time, from, attachment, comment_count, like_count, is_hidden, user_likes, can_comment, can_remove, can_hide, permalink_url, parent, comments (para respostas aninhadas). Nota: o campo ‘from’ requer um Token de Página para acessar informações do usuário (desde Graph API v2.11).
`filter`	string	Não	Filtra comentários por tipo: ‘stream’ retorna todos os comentários incluindo respostas em lista plana (padrão), ‘toplevel’ retorna somente comentários de nível superior sem respostas.
`object_id`	string	Sim	O ID da publicação ou comentário do qual obter comentários. Deve estar no formato completo ‘pageId_postId’ para publicações (ex.: ‘123456789_987654321’). Para comentários, use o ID do comentário diretamente.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter mensagens de conversa

FACEBOOK_GET_CONVERSATION_MESSAGES

Recupera mensagens de uma conversa específica.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`limit`	integer	Não	Número de mensagens a retornar (máx. 25). Para recuperar históricos completos, pagine usando `paging.cursors.after` ou a URL `next` da resposta.
`fields`	string	Não	Lista de campos a retornar para cada mensagem, separados por vírgula. Campos disponíveis: id, created_time, from, to, message, attachments, sticker, shares, tags.
`page_id`	string	Sim	O ID da Página do Facebook proprietária da conversa. Necessário para obter o token de acesso correto da página. Obtenha via ação List Managed Pages.
`conversation_id`	string	Sim	O ID da conversa no formato ‘t_’ seguido de um ID numérico (ex.: ‘t_3638640842939952’). Obtenha IDs de conversa válidos via ação Get Page Conversations. Se um ID somente numérico for fornecido, o prefixo ‘t_’ será adicionado automaticamente.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter usuário atual

FACEBOOK_GET_CURRENT_USER

Valida o token de acesso e recupera o perfil do usuário autenticado via /me. Não é possível buscar usuários arbitrários por nome ou ID.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`fields`	string	Não	Lista de campos a retornar para o usuário atual, separados por vírgula. Campos são silenciosamente omitidos ou retornam `null` se o token de acesso não tiver as permissões do Facebook necessárias — incluindo padrões como `email`. Trate campos ausentes de forma defensiva.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter detalhes de mensagem

FACEBOOK_GET_MESSAGE_DETAILS

Recupera detalhes de uma mensagem específica enviada ou recebida pela Página.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`fields`	string	Não	Lista de campos a retornar, separados por vírgula.
`message_id`	string	Sim	O ID da mensagem cujos detalhes devem ser recuperados.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter conversas da Página

FACEBOOK_GET_PAGE_CONVERSATIONS

Recupera uma lista de conversas entre usuários e a Página.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`limit`	integer	Não	Número de conversas a retornar (máx. 25). Use `paging.cursors.after` ou `paging.next` da resposta para paginar além da primeira página.
`fields`	string	Não	Lista de campos a retornar para cada conversa, separados por vírgula. Evite solicitar campos aninhados pesados (ex.: mensagens embutidas) para evitar payloads grandes.
`page_id`	string	Sim	O ID da Página do Facebook. IDs numéricos são aceitos e serão convertidos para string.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter detalhes da Página

FACEBOOK_GET_PAGE_DETAILS

Busca detalhes sobre uma Página específica do Facebook.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`fields`	string	Não	Lista de campos válidos a retornar para a Página, separados por vírgula. Campos comuns: id, name, about, category, description, fan_count, followers_count, website, link, username, is_published, access_token, emails, phone, location, hours, cover, picture, engagement, verification_status. IMPORTANTE: os campos ‘tasks’ e ‘created_time’ não são válidos para consultas diretas de Página e serão filtrados automaticamente. Para uma lista completa, consulte a referência da Graph API para o nó Page.
`page_id`	string	Sim	O ID numérico único da Página do Facebook. Deve ser um ID de Página válido que o usuário autenticado tenha acesso para visualizar. IDs de Página do Facebook são strings numéricas tipicamente com 15-16 dígitos (ex.: ‘678594635343968’). Para encontrar IDs válidos, use `FACEBOOK_LIST_MANAGED_PAGES` ou `FACEBOOK_GET_USER_PAGES`.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter insights da Página

FACEBOOK_GET_PAGE_INSIGHTS

Recupera análises e insights de uma Página do Facebook. Retorna métricas como impressões, visualizações de página, contagem de fãs e dados de engajamento. Objetos vazios ({}) nos resultados indicam dados ausentes, não valores zero. Chamadas de alto volume arriscam limites de taxa da Graph API (códigos de erro 4/613).

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`since`	string	Não	Início do intervalo de datas como timestamp Unix (ex.: ‘1704067200’), datetime ISO 8601 (ex.: ‘2024-10-01T00:00:00+0000’) ou string compatível com strtotime (ex.: ‘yesterday’, ‘-7 days’). O intervalo máximo é de 90 dias combinado com ‘until’.
`until`	string	Não	Fim do intervalo de datas como timestamp Unix, datetime ISO 8601 ou string strtotime (ex.: ‘now’, ‘-1 day’). O intervalo máximo é de 90 dias combinado com ‘since’.
`period`	string	Não	Período para as métricas: day, week, days_28, month, lifetime. Usar `lifetime` com intervalos delimitados de `since`/`until` produz resultados enganosos ou vazios. Padronize todas as entradas de data para UTC.
`metrics`	string	Não	Lista de métricas a recuperar, separadas por vírgula. MÉTRICAS VÁLIDAS: page_follows, page_daily_follows_unique, page_daily_unfollows_unique, page_media_view, page_post_engagements, page_video_views, page_total_actions, page_actions_post_reactions_total. DEPRECIADAS (serão substituídas automaticamente): page_impressions, page_fans, page_engaged_users, page_fan_adds. Nem todas as combinações de métrica/período são válidas; combinações incompatíveis retornam dados vazios.
`page_id`	string	Sim	O ID da Página do Facebook. Deve ser um ID de Página numérico; nomes de página, URLs e IDs de perfil pessoal são inválidos.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter fotos da Página

FACEBOOK_GET_PAGE_PHOTOS

Recupera fotos de uma Página do Facebook. URLs baseadas em CDN (incluindo source) têm tempo limitado e expiram; baixe e persista as imagens prontamente se precisar de acesso de longo prazo.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`type`	string	Não	Filtra por tipo de foto: uploaded, tagged.
`limit`	integer	Não	Número de fotos a retornar (máx. 100). Use cursores de paginação da resposta para iterar por bibliotecas grandes; limit=100 não garante que todas as fotos sejam retornadas em uma chamada.
`fields`	string	Não	Lista de campos de Foto válidos a retornar, separados por vírgula. Campos válidos: id, created_time, updated_time, name, images, height, width, picture, link, icon, from, album, backdated_time, place, page_story_id, target, event, can_delete, can_tag, webp_images. NOTA: ‘reactions’ e ‘comments’ NÃO são campos válidos — são arestas que devem ser acessadas via chamadas de API separadas.
`page_id`	string	Sim	O ID numérico da Página do Facebook (ex.: ‘678594635343968’). Obtenha IDs de página usando a ação `FACEBOOK_LIST_MANAGED_PAGES`. NÃO passe strings de data, timestamps ou valores de data — somente IDs válidos de Página do Facebook.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter publicações da Página

FACEBOOK_GET_PAGE_POSTS

Recupera publicações de uma Página do Facebook. Usa /{page_id}/feed em vez de /posts ou /published_posts porque /feed retorna todo o conteúdo na linha do tempo da Página (publicações da Página + publicações de visitantes + publicações marcadas). Paginação: siga paging.cursors.after ou paging.next em várias chamadas até não existir mais cursor. Versão da API: v23.0 (lançada em maio de 2025).

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`limit`	integer	Não	Número de publicações a retornar (máx. 100).
`since`	string	Não	Filtra publicações atualizadas após este horário. Aceita: timestamp Unix, valores strtotime (ex.: ‘yesterday’, ‘7 days ago’) ou strings de datetime (ex.: ‘2024-01-15’). Strings de datetime são convertidas automaticamente para timestamps Unix.
`until`	string	Não	Filtra publicações atualizadas antes deste horário. Aceita: timestamp Unix, valores strtotime ou strings de datetime.
`fields`	string	Não	Lista de campos a retornar para cada publicação, separados por vírgula. Campos suportados: id, message, created_time, updated_time, permalink_url, attachments, story, from, status_type, full_picture, shares, reactions, comments, is_hidden, is_published. Para contagens de resumo, use a sintaxe ‘.summary(true)’ (ex.: ‘reactions.summary(true)’). Nota: ‘type’, ‘link’, ‘source’, ‘picture’, ‘name’, ‘caption’, ‘description’ e ‘icon’ estão depreciados desde Graph API v3.3.
`page_id`	string	Sim	O ID da Página do Facebook. Pode ser fornecido como string ou número. Deve ser um ID de Página do Facebook, não um perfil pessoal — use `FACEBOOK_GET_USER_PAGES` para obter um ID de Página válido.
`removed_deprecated_fields`	array	Não	Campo interno para rastrear campos depreciados removidos automaticamente.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter funções da Página

FACEBOOK_GET_PAGE_ROLES

Recupera uma lista de pessoas e suas tarefas/funções em uma Página do Facebook. A conta conectada deve ter acesso de gerenciamento à Página de destino; caso contrário, a resposta pode estar vazia ou incompleta. Tipos de função retornados incluem MANAGE e CREATE_CONTENT — verifique-os antes de chamar ferramentas como FACEBOOK_UPDATE_PAGE_SETTINGS. Funções alteradas recentemente podem levar algum tempo para se propagar; tente novamente se os dados de função parecerem desatualizados após uma atualização.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`after`	string	Não	String de cursor para paginação para frente. Use o cursor ‘after’ de `paging.cursors.after` de uma resposta anterior para recuperar a próxima página.
`limit`	integer	Não	Número máximo de funções a retornar por requisição.
`before`	string	Não	String de cursor para paginação para trás. Use o cursor ‘before’ de `paging.cursors.before` de uma resposta anterior.
`page_id`	string	Sim	O ID da Página do Facebook.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter publicações em que a Página foi marcada

FACEBOOK_GET_PAGE_TAGGED_POSTS

Recupera publicações em que uma Página do Facebook foi marcada ou mencionada. Use ao monitorar menções de marca ou rastrear publicações que marcam sua Página mas não aparecem no feed próprio da Página.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`limit`	integer	Não	Número de publicações a retornar (máx. 100).
`since`	string	Não	Filtra publicações atualizadas após este horário. Aceita: timestamp Unix, valores strtotime ou strings de datetime.
`until`	string	Não	Filtra publicações atualizadas antes deste horário. Aceita: timestamp Unix, valores strtotime ou strings de datetime.
`fields`	string	Não	Lista de campos a retornar para cada publicação, separados por vírgula.
`page_id`	string	Sim	O ID da Página do Facebook. Pode ser fornecido como string ou número.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter vídeos da Página

FACEBOOK_GET_PAGE_VIDEOS

Recupera vídeos de uma Página do Facebook.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`type`	string	Não	Filtra por tipo de vídeo: uploaded, tagged.
`limit`	integer	Não	Número de vídeos a retornar (máx. 100). Controla somente o primeiro lote; itere pelos cursores de paginação (`paging.cursors.after`) até não haver mais página `next` para recuperar todos os vídeos.
`fields`	string	Não	Lista de campos a retornar para cada vídeo, separados por vírgula. O campo `source` retorna URLs com tempo limitado; baixe ou processe prontamente em vez de armazenar para uso posterior.
`page_id`	string	Sim	O ID numérico da Página do Facebook. É uma string numérica (ex.: ‘123456789012345’). Para obter um `page_id` válido, use ‘Get User Pages’ ou ‘List Managed Pages’.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter publicação

FACEBOOK_GET_POST

Recupera detalhes de uma publicação específica do Facebook.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`fields`	string	Não	Lista de campos a retornar, separados por vírgula. Campos comuns: id, message, created_time, updated_time, permalink_url, from, attachments, shares, story, picture, full_picture, place, privacy, status_type. Para métricas de engajamento com contagens, use a sintaxe `edge.summary(true)`. CORRETO: `likes.summary(true)`, `comments.summary(true)`. ERRADO: `likes.summary(total_count)`. Campos legados (name, link, description, type) estão depreciados; use a aresta ‘attachments’.
`post_id`	string	Sim	O ID da publicação a recuperar. Deve estar no formato completo: ‘pageId_postId’ onde ambos são numéricos (ex.: ‘123456789_987654321’). IDs com escopo de página (strings alfanuméricas como ‘1ANtnBaCHX’) não são suportados. Use `FACEBOOK_GET_PAGE_POSTS` para obter IDs válidos.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter insights de publicação

FACEBOOK_GET_POST_INSIGHTS

Recupera análises e insights de uma publicação específica do Facebook. Retorna métricas como impressões, cliques e dados de engajamento. Publicações muito recentes podem retornar valores vazios; aguarde um breve intervalo antes de consultar e trate campos ausentes como dados parciais.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`period`	string	Não	Período para as métricas (aplicável apenas para algumas métricas): lifetime. Suporta parâmetros since/until em UTC; converta do fuso horário do usuário para evitar agregados enganosos.
`metrics`	string	Não	Lista de métricas a recuperar, separadas por vírgula. Métrica válida: `post_media_view` (número de vezes que a publicação entrou na tela de uma pessoa). Nota: métricas mais antigas como post_impressions, post_impressions_unique, post_clicks, post_engagements foram depreciadas pelo Facebook em 15 de novembro de 2025 e não são mais suportadas.
`post_id`	string	Sim	O ID da publicação para obter insights.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter reações de publicação

FACEBOOK_GET_POST_REACTIONS

Recupera reações (curtir, amar, uau, etc.) de uma publicação do Facebook. Publicações muito recentes podem retornar dados de reações vazios ou parciais; trate campos ausentes como cobertura incompleta, não como erro.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`type`	string	Não	Filtra por tipo de reação: LIKE, LOVE, WOW, HAHA, SAD, ANGRY, THANKFUL.
`limit`	integer	Não	Número de reações a retornar (máx. 100).
`post_id`	string	Sim	O ID da publicação para obter reações.
`summary`	boolean	Não	Inclui resumo com contagem total por tipo de reação.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter publicações agendadas

FACEBOOK_GET_SCHEDULED_POSTS

Recupera publicações agendadas e não publicadas de uma Página do Facebook. Os resultados são paginados por cursor; siga os cursores de paginação para recuperar todos os resultados além do limite. Ao buscar publicações próximas a um horário específico, filtre para uma janela estreita (~±5 minutos). Use esta ferramenta para verificar entradas existentes antes de agendar novas publicações para evitar duplicatas.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`limit`	integer	Não	Número de publicações a retornar (máx. 100).
`fields`	string	Não	Lista de campos a retornar para cada publicação, separados por vírgula.
`page_id`	string	Sim	O ID da Página do Facebook.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter páginas do usuário (Depreciado)

FACEBOOK_GET_USER_PAGES

DEPRECIADO: Use FACEBOOK_LIST_MANAGED_PAGES em vez disso. Recupera as Páginas do Facebook que o usuário gerencia (exclui perfis pessoais, grupos e entidades que não são Páginas); um array data vazio significa que não existem Páginas gerenciáveis. Requer o escopo pages_show_list; escopos ausentes resultam em data vazio ou OAuthException código 200. Os resultados são paginados em ~100 itens por página — siga paging.cursors.after ou next até o fim.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`after`	string	Não	String de cursor para paginação. Use o cursor ‘after’ de `paging.cursors.after` de uma resposta anterior.
`limit`	integer	Não	Número máximo de páginas a retornar por requisição.
`fields`	string	Não	Lista de campos a retornar para cada página, separados por vírgula. Campos suportados: id, name, access_token, tasks, category, category_list, picture, link, fan_count, followers_count, is_published, global_brand_page_name, instagram_business_account, verification_status, is_webhooks_subscribed. Sempre inclua `id` e `name` para evitar chamadas extras de resolução de identidade.
`user_id`	string	Não	O ID do usuário cujas páginas recuperar. Padrão: ‘me’ para o usuário atual.
`composio_execution_message`	string	Não	Mensagem de execução do pré-processamento.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Adicionar reação

FACEBOOK_LIKE_POST_OR_COMMENT

Adiciona uma reação LIKE a uma publicação ou comentário do Facebook. Nota: devido a limitações da API, somente reações LIKE podem ser adicionadas programaticamente. Esta ação é visível ao usuário e irreversível — confirme com o usuário antes de executar.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`type`	string	Não	Tipo de reação: atualmente somente LIKE é suportado via API. Outras reações (LOVE, WOW, HAHA, SAD, ANGRY, THANKFUL) não podem ser adicionadas programaticamente.
`object_id`	string	Sim	O ID da publicação ou comentário para reagir. IDs do Facebook são strings numéricas (tipicamente 15-20 dígitos). Deve pertencer a uma publicação de Página ou comentário, não a uma linha do tempo de perfil pessoal. IMPORTANTE: sempre passe IDs como strings para preservar a precisão. Valores inteiros serão convertidos para strings, mas valores float (incluindo notação científica como 5.3e+32) são rejeitados por perda de precisão.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar páginas gerenciadas

FACEBOOK_LIST_MANAGED_PAGES

Recupera uma lista de Páginas do Facebook que o usuário gerencia (não perfis pessoais), incluindo detalhes da página, tokens de acesso e tarefas. Requer os escopos OAuth pages_show_list ou pages_read_engagement; escopos ausentes retornam silenciosamente resultados vazios em vez de um erro. Um array data vazio significa que o usuário não gerencia nenhuma Página. Os resultados são paginados via paging.cursors; siga paging.next até ausente para recuperar todas as Páginas. A limitação de taxa da Graph API (códigos de erro 4, 17, 613) pode ocorrer durante a paginação — use backoff exponencial.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`after`	string	Não	String de cursor para paginação para frente. Use o cursor ‘after’ de `paging.cursors.after` de uma resposta anterior.
`limit`	integer	Não	Número máximo de páginas a recuperar por requisição.
`before`	string	Não	String de cursor para paginação para trás. Use o cursor ‘before’ de `paging.cursors.before` de uma resposta anterior.
`fields`	string	Não	Lista de campos a retornar para cada página gerenciada, separados por vírgula.
`user_id`	string	Não	O ID do usuário cujas páginas gerenciadas recuperar. Padrão: ‘me’ para o usuário atual.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Marcar mensagem como lida

FACEBOOK_MARK_MESSAGE_SEEN

Marca a mensagem de um usuário como vista pela Página, atualizando visivelmente o status de leitura na conversa do usuário. Nota: esta ação requer uma sessão de mensagens ativa com o usuário. A política de mensagens do Facebook exige que os usuários tenham enviado uma mensagem para a Página nas últimas 24 horas para que as ações do remetente funcionem.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`page_id`	string	Sim	O ID da Página do Facebook.
`recipient_id`	string	Sim	O ID do usuário cuja mensagem deve ser marcada como vista.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Publicar post agendado

FACEBOOK_PUBLISH_SCHEDULED_POST

Publica imediatamente uma publicação do Facebook previamente agendada ou não publicada, definindo is_published como true. A publicação deve ter sido criada com published=false ou com scheduled_publish_time. Requisitos: a publicação deve existir e estar no estado não publicado/agendado; o usuário deve ter acesso de administrador à página proprietária; o aplicativo deve ter a permissão pages_manage_posts.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`page_id`	string	Não	Opcional: O ID da Página do Facebook proprietária da publicação. Se não fornecido, será extraído do `post_id` (a parte antes do underscore).
`post_id`	string	Sim	O ID da publicação agendada/não publicada a publicar. Formato tipicamente ‘pageId_postId’ (ex.: ‘123456789_987654321’). Use a ação ‘Get Scheduled Posts’ para encontrar IDs de publicações agendadas.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Remover tarefa da Página

FACEBOOK_REMOVE_PAGE_TASK

Remove as tarefas/acesso de um usuário de uma Página específica do Facebook. O chamador deve ter direitos de nível administrativo na Página. Opera em um page_id por vez; repita para cada página se remover de múltiplas páginas. Acesso parcial pode permanecer se apenas algumas tarefas forem revogadas.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`user`	string	Sim	O ID ou nome de usuário do usuário a remover. Verifique se corresponde ao colaborador pretendido antes de executar; um ID incorreto revoga o acesso da conta errada.
`page_id`	string	Sim	O ID da Página do Facebook.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Reagendar publicação

FACEBOOK_RESCHEDULE_POST

Altera o horário de publicação agendado de uma publicação não publicada do Facebook. Atualiza o scheduled_publish_time de uma publicação previamente agendada. A publicação deve ter sido criada com published=false e um scheduled_publish_time.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`post_id`	string	Sim	O ID da publicação agendada a reagendar. Formato tipicamente ‘pageId_postId’ (ex.: ‘123456789_987654321’).
`scheduled_publish_time`	integer	Sim	Novo timestamp Unix para quando publicar. Deve ser pelo menos 10 minutos no futuro e no máximo 6 meses à frente.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Pesquisar páginas

FACEBOOK_SEARCH_PAGES

Pesquisa Páginas do Facebook com base em uma string de consulta. AVISO DE DEPRECIAÇÃO: o endpoint /pages/search foi depreciado pelo Facebook em 2019 e agora está disponível SOMENTE para aplicativos Workplace by Meta. Aplicativos Facebook padrão receberão Erro #10 (erro de permissão) independentemente das permissões concedidas. Para aplicativos Workplace — requer um de: permissão pages_read_engagement, recurso ‘Page Public Content Access’ ou recurso ‘Page Public Metadata Access’. Aplicativos Facebook padrão devem usar métodos alternativos para descobrir páginas, como busca direta por ID de página via /{page-id} ou páginas gerenciadas do usuário via endpoint /me/accounts.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`limit`	integer	Não	Número máximo de resultados a retornar (máx. 100). Uma página-alvo específica pode não aparecer em uma única resposta; refine a string de consulta se a página desejada estiver ausente.
`query`	string	Sim	Consulta de pesquisa para encontrar páginas (ex.: nome de empresa, tópico, etc.).
`fields`	string	Não	Lista de campos a recuperar para cada página, separados por vírgula. Dados de campo retornados (ex.: fan_count, location) podem ser esparsos ou desatualizados; evite depender de um único campo para lógica de seleção.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Enviar mensagem de mídia

FACEBOOK_SEND_MEDIA_MESSAGE

Envia uma mensagem de mídia (imagem, vídeo, áudio ou arquivo) da Página para um usuário.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`tag`	string	Não	Tag de mensagem necessária quando `messaging_type` é MESSAGE_TAG. Tags válidas: CONFIRMED_EVENT_UPDATE, POST_PURCHASE_UPDATE, ACCOUNT_UPDATE, HUMAN_AGENT.
`page_id`	string	Sim	O ID da Página do Facebook que envia a mensagem.
`media_url`	string	Sim	URL da mídia a enviar.
`media_type`	string	Sim	Tipo de mídia: image, video, audio ou file.
`is_reusable`	boolean	Não	Se o anexo é reutilizável.
`recipient_id`	string	Sim	O ID do destinatário da mensagem (ID do usuário ou PSID).
`messaging_type`	string	Não	Tipo de mensagem: RESPONSE, UPDATE ou MESSAGE_TAG.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Enviar mensagem

FACEBOOK_SEND_MESSAGE

Envia uma mensagem de texto de uma Página do Facebook (não perfis pessoais) para um usuário via Messenger. Requer confirmação explícita do usuário antes de executar, pois esta ação entrega uma mensagem a um usuário final real.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`tag`	string	Não	Obrigatório quando `messaging_type` é MESSAGE_TAG. Tags válidas: HUMAN_AGENT (dentro de 7 dias da última mensagem do usuário), CONFIRMED_EVENT_UPDATE (para atualizações de eventos registrados), POST_PURCHASE_UPDATE (para atualizações relacionadas a compras), ACCOUNT_UPDATE (para alterações não recorrentes de conta).
`page_id`	string	Sim	O ID da Página do Facebook que envia a mensagem. Deve ser um ID numérico de página, não um nome de usuário ou alias.
`message_text`	string	Sim	O conteúdo de texto da mensagem a enviar.
`recipient_id`	string	Sim	O ID do destinatário (ID do usuário ou PSID). Deve ser um PSID numérico, não um nome de usuário ou nome de exibição.
`messaging_type`	string	Não	Tipo de mensagem: RESPONSE, UPDATE ou MESSAGE_TAG. Use RESPONSE dentro de 24 horas da última mensagem do usuário. Use MESSAGE_TAG com um parâmetro de tag para enviar fora da janela de 24 horas.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Alternar indicador de digitação

FACEBOOK_TOGGLE_TYPING_INDICATOR

Exibe ou oculta o indicador de digitação para um usuário no Messenger.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`page_id`	string	Sim	O ID da Página do Facebook.
`typing_on`	boolean	Sim	`true` para exibir o indicador de digitação, `false` para ocultá-lo.
`recipient_id`	string	Sim	O Page-Scoped ID (PSID) do usuário para exibir/ocultar o indicador de digitação.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Remover curtida de publicação ou comentário

FACEBOOK_UNLIKE_POST_OR_COMMENT

Remove uma curtida de uma publicação ou comentário do Facebook.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`object_id`	string	Sim	O ID da publicação ou comentário para remover a curtida. IDs do Facebook são strings numéricas (tipicamente 15-20 dígitos). IMPORTANTE: sempre passe IDs como strings para preservar a precisão. Valores inteiros serão convertidos para strings, mas valores float (incluindo notação científica como 5.3e+32) são rejeitados por perda de precisão.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Atualizar comentário

FACEBOOK_UPDATE_COMMENT

Atualiza um comentário existente do Facebook. IMPORTANTE: esta ação requer um Token de Acesso de Página. O comentário deve pertencer a uma publicação em uma Página que você gerencia. Use o parâmetro page_id para garantir que o token correto da página seja usado, especialmente se você gerencia múltiplas páginas.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`message`	string	Sim	O novo conteúdo de texto do comentário.
`page_id`	string	Não	O ID da Página do Facebook proprietária do comentário. Necessário para garantir que o token de acesso correto seja usado. Se não fornecido, a ação tentará usar o token da primeira página disponível, o que pode falhar se você gerencia múltiplas páginas.
`is_hidden`	boolean	Não	Se deve ocultar ou exibir o comentário.
`comment_id`	string	Sim	O ID do comentário a atualizar. Formato tipicamente ‘objectId_commentId’ (ex.: ‘122157027176937815_1371138271476143’).

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Atualizar configurações da Página

FACEBOOK_UPDATE_PAGE_SETTINGS

Atualiza configurações de uma Página específica do Facebook. Requer que o usuário autenticado tenha as tarefas MANAGE e CREATE_CONTENT para a página de destino; verifique as funções via FACEBOOK_GET_PAGE_ROLES. Nem todos os campos (about, description, general_info, etc.) estão disponíveis para todas as categorias de Página.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`about`	string	Não	Seção “sobre” atualizada para a página.
`phone`	string	Não	Número de telefone atualizado.
`emails`	array	Não	Endereços de e-mail atualizados.
`page_id`	string	Sim	O ID da Página do Facebook a atualizar.
`website`	string	Não	URL do site atualizado.
`description`	string	Não	Descrição atualizada para a página.
`general_info`	string	Não	Informações gerais atualizadas.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Atualizar publicação

FACEBOOK_UPDATE_POST

Atualiza uma publicação existente em uma Página do Facebook.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`message`	string	Não	Conteúdo de texto atualizado da publicação.
`post_id`	string	Sim	O ID da publicação a atualizar.
`og_phrase`	string	Não	Frase Open Graph.
`og_icon_id`	string	Não	ID do ícone Open Graph.
`og_object_id`	string	Não	ID do objeto Open Graph.
`og_action_type_id`	string	Não	ID do tipo de ação Open Graph.
`og_suggestion_mechanism`	string	Não	Mecanismo de sugestão Open Graph.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Enviar foto (Depreciado)

FACEBOOK_UPLOAD_PHOTO

DEPRECIADO: Use FACEBOOK_CREATE_PHOTO_POST em vez disso. Faz upload de um arquivo de foto diretamente para uma Página do Facebook. Suporta upload de arquivo local até 10MB.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`url`	string	Não	URL pública da foto (deve ser acessível pelos servidores do Facebook). Alternativa a ‘photo’. Use para imagens hospedadas em servidores externos. Deve ser um endpoint HTTPS direto retornando um MIME type de imagem; redirecionamentos, páginas HTML e URLs não HTTPS falham na validação.
`tags`	array	Não	Lista de tags de usuários no formato `[{'tag_uid': 'USER_ID', 'x': 50, 'y': 50}]`.
`photo`	object	Não	Arquivo de foto para upload (máx. 10MB). Alternativa a ‘url’. Se uma string de URL for passada incorretamente aqui, será convertida automaticamente para usar o parâmetro ‘url’.
`caption`	string	Não	Legenda para a foto.
`page_id`	string	Sim	O ID da Página do Facebook. Pode ser fornecido como string ou número. Deve ser um ID de Página; IDs de perfil pessoal/linha do tempo de usuário não são válidos.
`published`	boolean	Não	Se deve publicar a foto imediatamente.
`targeting`	object	Não	Especificações de segmentação de público.
`scheduled_publish_time`	integer	Não	Timestamp Unix para agendar a publicação. Requer `published=false`; o valor deve ser um epoch UTC futuro em segundos. Usar `published=true` com este campo causa erros de validação.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Enviar fotos em lote

FACEBOOK_UPLOAD_PHOTOS_BATCH

Faz upload de múltiplos arquivos de foto em lote para uma Página ou Álbum do Facebook. Usa a API de lote do Facebook para upload eficiente de múltiplas fotos. Máximo de 50 fotos por lote.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`photos`	array	Não	Lista de arquivos de foto para upload (máx. 50 fotos).
`page_id`	string	Sim	O ID da Página do Facebook.
`album_id`	string	Não	ID do álbum para adicionar as fotos. Se não fornecido, as fotos serão enviadas para a linha do tempo.
`published`	boolean	Não	Se deve publicar as fotos imediatamente. Para agendar, defina como `false` e inclua `scheduled_publish_time` como timestamp Unix UTC; combinações incompatíveis disparam erros 400.
`photo_urls`	array	Não	Lista de URLs de fotos para upload (alternativa a ‘photos’). Devem ser URLs HTTPS diretas e publicamente acessíveis — sem redirecionamentos, URLs privadas ou HTTP.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.

Enviar vídeo (Depreciado)

FACEBOOK_UPLOAD_VIDEO

DEPRECIADO: Use FACEBOOK_CREATE_VIDEO_POST em vez disso. Faz upload de um arquivo de vídeo diretamente para uma Página do Facebook. Suporta upload de arquivo local. Para vídeos grandes (acima de 100MB), usa upload retomável. Após o upload, o vídeo entra em estado de processamento/pendente; não o referencie ou agende até que o processamento seja concluído.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
`title`	string	Não	Título do vídeo.
`video`	object	Não	Arquivo de vídeo para upload (máx. 10GB, recomendado abaixo de 1GB). ‘video’ ou ‘file_url’ deve ser fornecido. Use MP4 com vídeo H.264 e áudio AAC para evitar falhas de upload.
`page_id`	string	Sim	O ID da Página do Facebook.
`file_url`	string	Não	URL de um arquivo de vídeo publicamente acessível para upload. ‘file_url’ ou ‘video’ deve ser fornecido. Esta é uma alternativa ao upload de arquivo local.
`published`	boolean	Não	Se deve publicar imediatamente.
`targeting`	object	Não	Especificações de segmentação de público.
`description`	string	Não	Descrição do vídeo.
`content_tags`	array	Não	Lista de tags de conteúdo.
`custom_labels`	array	Não	Etiquetas personalizadas para o vídeo.
`scheduled_publish_time`	integer	Não	Timestamp Unix para agendar a publicação. Requer `published=false`; combinar com `published=true` gera erro de validação 400.

Saída

Nome	Tipo	Obrigatório	Descrição
`data`	string	Sim	Dados retornados pela execução da ação.
`error`	string	Não	Mensagem de erro caso a execução tenha falhado.
`successful`	boolean	Sim	Indica se a ação foi executada com sucesso.