Posts
Publicar reels na Página do Facebook pela API
Com format reels e integration_slug facebook, o Connect publica um reel na Página que o seu cliente conectou. Vídeo de Página no Facebook vai por esse formato.
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-reel-55",
"format": "reels",
"caption": "Bastidores da loja",
"media": [
{
"type": "video",
"url": "https://cdn.example.com/reel.mp4"
}
],
"facebook": {
"title": "Bastidores",
"cover_url": "https://cdn.example.com/capa.jpg"
}
}O que dá para fazer
- Publicar um reel a partir de uma URL de vídeo https:// pública.
- Definir o título com facebook.title.
- Escolher a capa com facebook.cover_url.
- Usar a Página pela conexão ou por integration_slug e source_name.
Regras e limites
- Reels aceita exatamente 1 vídeo.
- O título vai até 255 caracteres.
- Se a rede recusar a imagem de cover_url, o reel sai com a capa que ela escolher.
- A resposta é 202: a publicação roda em segundo plano. Acompanhe pelo GET /posts/{uuid}.
- external_reference é obrigatório e Idempotency-Key evita duplicar a publicação.
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.title | string | Não | Título do reel, até 255 caracteres. Só em reels. |
| facebook.cover_url | string | Não | URL https:// da capa do reel. Se a rede recusar a imagem, o reel sai com a capa que ela escolher. Só em reels. |
Para quem
Ferramenta de vídeo
Seu SaaS publica o vídeo curto exportado direto na Página do cliente, com título e capa.
Agência
Publique o mesmo reel nas Páginas de vários clientes com uma chamada por conexão.
Agente de IA
Um agente gera o vídeo, define o título e publica o reel sem intervenção.
Funciona com
Facebook
Perguntas frequentes
Por que não posso enviar vídeo no feed?
O feed da Página recusa vídeo: vídeo de Página vai como reels.
Posso escolher a capa?
Sim, com facebook.cover_url. Se a rede recusar a imagem, o reel sai com a capa escolhida por ela.
Quantos vídeos por reel?
Exatamente 1.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
