Posts

Publicar na Página do Facebook pela API

Com format feed e integration_slug facebook, o Connect publica na Página que o seu cliente conectou. A mesma chamada POST /posts serve para texto, link ou fotos.

A chamada

POST /api/posts?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>

{
  "external_reference": "fb-post-901",
  "format": "feed",
  "caption": "Conheça a novidade da semana",
  "media": [
    {
      "type": "image",
      "url": "https://cdn.example.com/foto1.jpg"
    },
    {
      "type": "image",
      "url": "https://cdn.example.com/foto2.jpg"
    }
  ]
}

O que dá para fazer

  • Publicar um post só de texto.
  • Compartilhar um link com facebook.link.
  • Publicar até 10 fotos em um único post.
  • Usar a Página pela conexão (customer_integration) ou por integration_slug e source_name.

Regras e limites

  • O feed precisa de pelo menos legenda, link ou mídia.
  • A legenda vai até 2200 caracteres.
  • Post com link não aceita mídia.
  • Vídeo no feed é recusado: vídeo de Página vai como reels.
  • A resposta é 202: a publicação roda em segundo plano. Acompanhe pelo GET /posts/{uuid}.
  • external_reference é obrigatório (409 se já houver publicação igual) e Idempotency-Key evita duplicar.

Campos principais

CampoTipoObrigatórioDescrição
external_referencestringSimO id do post no seu sistema (até 100 caracteres). Impede publicar o mesmo post duas vezes na mesma conta.
formatstringSimFormato do post. No Instagram: feed, reels ou story. No Facebook: feed, reels ou story.
captionstringNãoTexto do post. Até 2200 caracteres. Stories não levam legenda.
mediaarraySimLista de mídias, em ordem. Cada item tem type e url.
media.urlstringSimURL https:// pública que a rede consegue baixar (até 2048 caracteres).
facebook.linkstringNãoLink compartilhado no post (até 2048 caracteres). Só em feed. Post com link não leva mídia.

Para quem

  • Gerenciador de redes sociais

    O usuário escreve o post no seu SaaS e ele sai na Página do Facebook que ele conectou.

  • Comunicados de lojas

    Uma rede de lojas publica o mesmo comunicado, com fotos, em dezenas de Páginas.

  • Agente de IA

    Um agente resume uma notícia e publica o texto com o link na Página do cliente.

Funciona com

  • Facebook

Perguntas frequentes

Posso publicar vídeo no feed da Página?

Não. Vídeo vai como reels. O feed aceita texto, link ou fotos.

Quantas fotos cabem em um post?

Até 10. Post com link não leva mídia.

Publica em perfil pessoal?

Não. O formato descrito é para Páginas do Facebook, com integration_slug facebook.

Relacionadas

Ver tudo que dá para fazer em Posts

Veja o Connect aplicado ao seu produto.

Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.