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

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.titlestringNãoTítulo do reel, até 255 caracteres. Só em reels.
facebook.cover_urlstringNãoURL 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.

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.