Paylayer Logo
Paylayer
← Back to Docs

Meta Carousel 4:5 Direct Publisher (Instagram & Facebook Graph API v20.0)

Overview / Visão Geral

The Meta Carousel 4:5 Direct Publisher in Paylayer.app (`/studio` → Carrossel Meta 4:5) enables creators, agencies, and digital businesses to generate, host, and simultaneously publish high-impact 4:5 vertical carousels (1080 × 1350 px) directly to Instagram and Facebook Pages using the official Meta Graph API v20.0.

O Publicador Simultâneo de Carrosséis Meta 4:5 permite criar lâminas persuasivas com IA, renderizar automaticamente as imagens na proporção oficial de maior retenção do feed (4:5 — 1080 × 1350 px), hospedar em URLs públicas e disparar o post simultaneamente no Instagram e no Facebook em 1 único clique.

Como Usar no Paylayer Studio (Passo a Passo para Clientes)

  • Passo 1 (Gerar Lâminas com IA): Acesse a aba Carrossel Meta 4:5 (IG & FB Direct) no Studio, digite o tema da sua campanha e clique em Gerar Lâminas com IA. O Gemini Argon 4 criará a estrutura de 4 a 10 lâminas (Hook, Problema, Solução e CTA) + a legenda unificada com hashtags.
  • Passo 2 (Renderizar e Hospedar em 4:5 - 1080×1350 px): Clique em Gerar & Hospedar URLs 4:5 (1080×1350) (ou suba suas próprias artes). O Paylayer renderiza cada lâmina em alta definição e gera as URLs públicas exigidas pela Meta.
  • Passo 3 (Conectar Credenciais Meta): Informe seu Instagram Business Account ID (`instagram_account_id`), Facebook Page ID (`page_id`) e Long-Lived Page Access Token (`access_token`). Os dados ficam salvos com segurança no seu navegador para os próximos disparos.
  • Passo 4 (Publicação Simultânea): Clique em Publicar Simultaneamente no Instagram & Facebook. O servidor executa os dois fluxos em paralelo e retorna o ID da publicação de cada rede.

Arquitetura Técnica no Backend (`POST /api/studio/publish-meta`)

  • Fluxo A — Instagram Graph API (Container Pattern): Cria um contêiner filho (`is_carousel_item: true`) para cada lâmina em `POST /v20.0/{instagram_account_id}/media`, agrupa os IDs no contêiner pai (`media_type: "CAROUSEL"`) com a legenda unificada e finaliza a publicação em `POST /v20.0/{instagram_account_id}/media_publish`.
  • Fluxo B — Facebook Page Graph API (Multi-Photo Feed Post): Faz o upload de cada lâmina como foto não publicada (`published: false`) em `POST /v20.0/{page_id}/photos` e publica o álbum completo no feed da página via `POST /v20.0/{page_id}/feed` com `attached_media`.

Permissões Necessárias no Meta App Dashboard

  • pages_show_list: Lista as Páginas do Facebook administradas pelo usuário.
  • pages_read_engagement & pages_manage_posts: Permite criar posts e álbuns multi-foto na Página do Facebook.
  • instagram_basic: Identifica a conta profissional (Criador ou Comercial) do Instagram vinculada à Página.
  • instagram_content_publish: Cria os contêineres de mídia e publica carrosséis diretamente no feed do Instagram.