Posts
Publicar reels no Instagram pela API
Com format reels e um vídeo em media, o Connect publica um reel na conta Instagram conectada pelo seu cliente. Uma só chamada serve para todas as contas, sem app review e sem guardar tokens.
A chamada
POST /api/posts?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>
{
"external_reference": "reel-310",
"format": "reels",
"caption": "Bastidores da campanha #reels",
"media": [
{
"type": "video",
"url": "https://cdn.example.com/reel.mp4"
}
],
"instagram": {
"share_to_feed": true,
"cover_url": "https://cdn.example.com/capa.jpg",
"first_comment": "Qual parte você mais gostou?"
}
}O que dá para fazer
- Publicar um reel a partir de uma URL de vídeo https:// pública.
- Escolher uma imagem de capa com instagram.cover_url.
- Decidir se o reel também aparece no grid do perfil com instagram.share_to_feed.
- Usar um áudio do Instagram com audio_id e ajustar audio_volume e video_volume.
- Adicionar colaboradores, local, primeiro comentário e desativar comentários.
Regras e limites
- Reels aceita exatamente 1 vídeo.
- A legenda vai até 2200 caracteres, com no máximo 30 hashtags e 20 menções.
- share_to_feed vale true por padrão.
- audio_volume e video_volume exigem audio_id.
- A resposta é 202: a publicação roda em segundo plano e você acompanha pelo GET /posts/{uuid}.
- external_reference é obrigatório (409 se já existir publicação igual) e Idempotency-Key, de até 255 caracteres, devolve o post já gravado com 200 no replay.
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 | Legenda. No Instagram, até 2200 caracteres, 30 hashtags e 20 menções. 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). |
| instagram.share_to_feed | boolean | Não | Se o reel também aparece no grid do perfil. Só em reels. |
| instagram.cover_url | string | Não | URL https:// da imagem de capa do reel. Só em reels. |
| instagram.audio_id | string | Não | Id de um áudio do Instagram para o reel. Só em reels. |
Para quem
Ferramenta de vídeo curto
Seu editor exporta o vídeo e publica o reel direto na conta do usuário, com capa e legenda definidas na hora.
Agência com muitos clientes
Um único fluxo publica o mesmo reel em dezenas de contas Instagram conectadas, cada uma com seu customer_integration.
Agente de IA de social media
Um agente gera o vídeo, escolhe a capa e publica o reel, deixando o primeiro comentário já pronto.
Funciona com
Instagram Business
Instagram
Perguntas frequentes
Posso publicar um vídeo sozinho como feed?
Não. Um vídeo sozinho deve ir como reels; feed é para 1 imagem ou carrossel de 2 a 10 mídias.
O reel aparece no grid do perfil?
Por padrão sim, porque share_to_feed vale true. Envie instagram.share_to_feed como false para não aparecer.
Funciona com contas instagram e instagram_business?
Sim. As duas conexões aceitam o mesmo POST /posts e o mesmo bloco instagram.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
