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
| 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. |
| media | array | Sim | Lista de mídias, em ordem. Cada item tem type e url. |
| media.type | string | Sim | Tipo da mídia: image, video ou document (documento só no LinkedIn). |
| media.url | string | Sim | URL 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}.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
