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
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| external_reference | string | Sim | O id do post no seu sistema (até 100 caracteres). Impede publicar o mesmo post duas vezes na mesma conta. |
| format | string | Sim | Formato do post. No Instagram: feed, reels ou story. No Facebook: feed, reels ou story. |
| caption | string | Não | Texto do post. Até 2200 caracteres. Stories não levam legenda. |
| media | array | Sim | Lista de mídias, em ordem. Cada item tem type e url. |
| media.url | string | Sim | URL https:// pública que a rede consegue baixar (até 2048 caracteres). |
| facebook.link | string | Não | Link 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.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
