Posts

Publicar stories na Página do Facebook pela API

Com format story e integration_slug facebook, o Connect publica a mídia como story na Página que o seu cliente conectou, com a mesma chamada POST /posts dos outros formatos.

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-story-23",
  "format": "story",
  "media": [
    {
      "type": "image",
      "url": "https://cdn.example.com/story.jpg"
    }
  ]
}

O que dá para fazer

  • Publicar um story a partir de uma URL https:// pública de imagem ou vídeo.
  • Usar a Página pela conexão (customer_integration) ou por integration_slug e source_name.
  • Repetir a chamada com segurança usando Idempotency-Key.

Regras e limites

  • Stories não aceitam legenda: não envie caption.
  • O formato story não tem opções no bloco facebook.
  • Até 10 mídias por chamada, cada uma vira um story, publicadas em ordem. Todos os arquivos são verificados pela rede antes do primeiro sair, então um arquivo com problema não deixa a sequência pela metade.
  • A resposta é 202: a publicação roda em segundo plano. Acompanhe pelo GET /posts/{uuid}.
  • external_reference é obrigatório e evita publicar duas vezes a mesma referência na conta (409).

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.
mediaarraySimLista de mídias, em ordem. Cada item tem type e url.
media.typestringSimTipo da mídia: image, video ou document (documento só no LinkedIn).
media.urlstringSimURL https:// pública que a rede consegue baixar (até 2048 caracteres).

Para quem

  • Avisos rápidos

    O SaaS publica um story de promoção do dia na Página do cliente com um clique do usuário.

  • Rede de lojas

    Publique a mesma arte vertical como story nas Páginas de várias unidades.

  • Agente de IA

    Um agente transforma um lançamento em imagem vertical e publica como story.

Funciona com

  • Facebook

Perguntas frequentes

Posso colocar legenda no story?

Não. Stories não carregam legenda.

Há opções extras do bloco facebook?

Não para story. O bloco facebook tem link no feed e título e capa no reels.

Como acompanho a publicação?

O POST /posts responde 202. Consulte GET /posts/{uuid}.

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.