Platforms

Configurações por Plataforma

Opções de configuração específicas por plataforma para publicar com precisão no YouTube, TikTok, Pinterest, Instagram, Facebook, LinkedIn e Perfil da Empresa no Google.

Cada plataforma tem recursos e configurações únicos. Use os objetos de configuração abaixo ao criar publicações para personalizar o comportamento por plataforma.

TikTok

Parâmetro	Tipo	Descrição
`connectionId`OBRIGATÓRIO	`string`	O id da conta de /social-accounts a que esta configuração se aplica
`title`	`string`	Título do vídeo (máx. 90 caracteres)
`caption`	`string`	Texto da legenda do vídeo (máx. 2200 caracteres)
`privacyLevel`OBRIGATÓRIO	`string`	PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR, SELF_ONLY
`allowComments`	`boolean`	Permitir comentários no vídeo
`allowDuet`	`boolean`	Permitir duetos
`allowStitch`	`boolean`	Permitir stitches
`sendAsDraft`	`boolean`	Enviar como rascunho para o aplicativo do TikTok
`aiGenerated`	`boolean`	Marcar como conteúdo gerado por IA
`autoAddMusic`	`boolean`	Adicionar música automaticamente ao vídeo
`brandedContent`	`boolean`	Marcar como conteúdo de marca
`brandedContentOwnBrand`	`boolean`	Marcar como promoção da própria marca

Exemplo

{
  "tiktokConfigs": [{
    "connectionId": "conn_tiktok_001",
    "title": "Product Demo",
    "privacyLevel": "PUBLIC_TO_EVERYONE",
    "allowComments": true,
    "allowDuet": false,
    "aiGenerated": false
  }]
}

YouTube

Parâmetro	Tipo	Descrição
`connectionId`OBRIGATÓRIO	`string`	O id da conta de /social-accounts a que esta configuração se aplica
`postType`	`string`	VIDEO ou SHORTS
`videoTitle`	`string`	Título do vídeo (máx. 100 caracteres)
`tags`	`string[]`	Tags do vídeo para descoberta (máx. 20)
`privacyStatus`	`string`	public, unlisted ou private
`categoryId`	`string`	ID da categoria do YouTube
`playlistId`	`string`	Adicionar a uma playlist após o envio
`notifySubscribers`	`boolean`	Notificar inscritos (padrão: true)
`allowEmbedding`	`boolean`	Permitir incorporação em outros sites
`madeForKids`	`boolean`	Marcar como feito para crianças
`aiGenerated`	`boolean`	Declara conteúdo alterado ou sintético, como uma voz de IA, um avatar de IA ou imagens realistas que foram geradas ou editadas. O YouTube mostra o rótulo "Conteúdo alterado ou sintético" no vídeo. Define status.containsSyntheticMedia. Funciona em vídeos e Shorts. Omita ou envie false para não mostrar o rótulo.
`license`	`string`	youtube ou creativeCommon

Exemplo

{
  "youtubeConfigs": [{
    "connectionId": "conn_yt_001",
    "postType": "VIDEO",
    "videoTitle": "Weekly Product Update",
    "tags": ["product", "update", "tech"],
    "privacyStatus": "PUBLIC",
    "notifySubscribers": true,
    "allowEmbedding": true,
    "madeForKids": false
  }]
}

Escolha o quadro com boardId ou boardName. GET /api/v1/social-accounts/:id/pinterest-boards (veja Contas sociais) lista o id e o nome de cada quadro. Um quadro pertence a uma única conta do Pinterest, então liste os quadros de cada conta em que você publica. Um boardName é procurado entre os quadros da conta dessa configuração quando a requisição é processada, e o post guarda o id do quadro encontrado; o nome em si não é guardado nem retornado. Um nome que não corresponde a nenhum quadro, ou a mais de um, retorna 400, e o pin nunca vai para outro quadro no lugar. Em uma requisição em lote, só esse item falha. Sem boardId nem boardName, o pin vai para um quadro público chamado AdaptlyPost, que o AdaptlyPost cria na conta do Pinterest na primeira vez em que é necessário.

Parâmetro	Tipo	Descrição
`connectionId`OBRIGATÓRIO	`string`	O id da conta de /social-accounts a que esta configuração se aplica
`boardId`	`string`	ID do quadro do Pinterest onde fixar. Passe boardId ou boardName, não os dois. Sem nenhum deles, o pin vai para um quadro público chamado AdaptlyPost
`boardName`	`string`	Nome do quadro onde fixar, no lugar de boardId. Até 180 caracteres. Uma correspondência exata vence; sem ela, é usada uma única correspondência sem diferenciar maiúsculas e minúsculas. Um nome que não corresponde a nenhum quadro ou corresponde a vários retorna 400
`title`	`string`	Título do pin (máx. 100 caracteres)
`link`	`string`	URL de destino ao clicar no pin

Exemplo

{
  "pinterestConfigs": [{
    "connectionId": "conn_pin_001",
    "boardId": "board_123",
    "title": "Summer Collection 2026",
    "link": "https://example.com/summer-collection"
  }]
}

Instagram

Parâmetro	Tipo	Descrição
`connectionId`OBRIGATÓRIO	`string`	O id da conta de /social-accounts a que esta configuração se aplica
`postType`	`string`	FEED, REEL ou STORY. FEED aceita qualquer tipo de conteúdo, REEL exige VIDEO e STORY exige IMAGE, VIDEO ou CAROUSEL; um story CAROUSEL publica cada item como um story próprio, em ordem. Qualquer outra combinação devolve 400. Vídeos do feed e Reels podem ter até 15 minutos
`shareToStory`	`boolean`	Publica também a mesma mídia como story ao lado da publicação FEED ou REEL. O story é uma entrada própria em platforms com postType STORY, então é publicado, falha e é repetido por conta própria. Ele não leva legenda, primeiro comentário, capa, colaboradores, teste nem áudio, exige IMAGE, VIDEO ou CAROUSEL, e um vídeo pode ter no máximo 60 segundos. Ignorado quando postType é STORY
`trialGraduation`	`string`	Publica o reel como reel de teste, mostrado primeiro para quem não segue você. MANUAL: você compartilha com seus seguidores no app do Instagram. SS_PERFORMANCE: o Instagram compartilha se tiver bom desempenho. Apenas reels de vídeo; omita para um reel normal
`collaborators`	`string[]`	Até 3 nomes de usuário do Instagram convidados como colaboradores (Instagram Collab). O @ inicial é removido. Funciona em imagens do feed, carrosséis e reels, não em stories nem reels de teste. Cada colaborador aceita o convite no Instagram antes de a publicação aparecer no perfil dele.
`userTags`	`object[]`	Até 20 contas públicas do Instagram marcadas na mídia, cada uma { username, x, y }. Funciona em uma única imagem, um único vídeo (Reel) ou um único story, não em carrosséis. x e y vão de 0 a 1 sobre a imagem, a partir do canto superior esquerdo, e cada marcação em uma imagem do feed precisa dos dois. Um story pode omiti-los, e um vídeo os ignora porque a pessoa é marcada no vídeo inteiro. O @ inicial é removido. Se o Instagram recusar uma marcação porque a conta é privada ou não existe, a publicação sai sem marcações e instagramUntaggedUsernames lista os usuários recusados.
`aiGenerated`	`boolean`	Indica que a publicação foi criada ou editada com IA. O Instagram mostra o rótulo "Informações de IA" na publicação. Funciona em imagens, carrosséis, reels e stories, e o story criado com shareToStory também recebe o rótulo.
`audio`	`InstagramAudio`	Música ou um som original adicionado ao Reel. Exige contentType VIDEO, um postType diferente de STORY e uma conta com supportsInstagramAudio: true. Veja Áudio do Instagram abaixo

Exemplo

{
  "contentType": "VIDEO",
  "instagramConfigs": [{
    "connectionId": "conn_ig_001",
    "postType": "REEL",
    "shareToStory": true,
    "collaborators": ["@partnerbrand"],
    "audio": {
      "audioId": "1234567890123456",
      "title": "Summer Nights",
      "artist": "The Example Band",
      "audioVolume": 60,
      "videoVolume": 100
    }
  }]
}

Áudio do Instagram

Encontre um audioId com GET /api/v1/social-accounts/:id/instagram-audio (veja Contas sociais) e passe em instagramConfigs[].audio.

Parâmetro	Tipo	Descrição
`audioId`OBRIGATÓRIO	`string`	O audioId da busca de áudio
`title`	`string`	Título da faixa, salvo só para exibição (máx. 255 caracteres)
`artist`	`string`	Artista ou criador, salvo só para exibição (máx. 255 caracteres)
`audioVolume`	`number`	Volume do áudio adicionado, de 1 a 100 (padrão 100)
`videoVolume`	`number`	Volume do som original do vídeo, de 1 a 100 (padrão 100)

Facebook

Parâmetro	Tipo	Descrição
`pageId`OBRIGATÓRIO	`string`	A página do Facebook a que esta configuração se aplica, tal como enviada em pageIds
`postType`	`string`	FEED, REEL ou STORY. FEED aceita qualquer tipo de conteúdo, REEL exige VIDEO e STORY exige IMAGE, VIDEO ou CAROUSEL; um story CAROUSEL publica cada item como um story próprio, em ordem. Qualquer outra combinação devolve 400
`shareToStory`	`boolean`	Publica também a mesma mídia como story ao lado da publicação FEED ou REEL. O story é uma entrada própria em platforms com postType STORY, então é publicado, falha e é repetido por conta própria. Ele não leva legenda, título do vídeo nem fundo de texto, exige IMAGE, VIDEO ou CAROUSEL, e um vídeo pode ter no máximo 60 segundos. Ignorado quando postType é STORY
`videoTitle`	`string`	Título para publicações de vídeo (máx. 255 caracteres)
`textFormatPresetId`	`string`	Fundo do Facebook para uma publicação de texto, como o ID numérico do Facebook (106018623298955 é roxo sólido). Apenas publicações TEXT, sem mídia e com até 130 caracteres; qualquer outra coisa retorna 400. Links aparecem sem pré-visualização e, se o Facebook recusar o fundo, a publicação sai como texto simples
`imageLayout`	`string`	GRID (padrão) mostra várias imagens como grade de fotos. CAROUSEL mostra como cartões deslizáveis, cada um com seu próprio link. Um carrossel precisa de 2 a 5 imagens, nenhum vídeo, postType FEED e uma entrada de carouselCards por imagem; qualquer outra coisa retorna 400
`carouselCards`	`array`	Um cartão por imagem, na mesma ordem da mídia, usado quando imageLayout é CAROUSEL. Cada cartão tem link (obrigatório, http ou https), title (até 100 caracteres) e description (até 200). O Facebook só mostra sua imagem e seu título em links para um site que pertence à Página; com qualquer outro link a publicação falha e explica o motivo

Parâmetro	Tipo	Descrição
`connectionId`OBRIGATÓRIO	`string`	O id da conta de /social-accounts a que esta configuração se aplica
`documentTitle`	`string`	Título exibido em uma publicação DOCUMENT (máx. 100 caracteres). Por padrão, o nome do arquivo; ignorado nos outros tipos de conteúdo
`reshareOf`	`string`	Uma publicação do LinkedIn a compartilhar, com o texto da publicação como comentário: um URN urn:li:share: ou urn:li:ugcPost:, ou um URL de publicação do LinkedIn que contenha um, como /feed/update/urn:li:share:7123/ ou o link de incorporação da publicação (máx. 500 caracteres). Nesta conta nenhuma mídia é anexada; as outras plataformas da publicação continuam recebendo a mídia. Um URN de atividade ou um URL /posts/...-activity-... devolve 400

Exemplo

{
  "contentType": "DOCUMENT",
  "mediaUrls": ["https://cdn.adaptlypost.com/.../q3-results.pdf"],
  "linkedinConnectionIds": ["conn_li_001"],
  "linkedinConfigs": [{
    "connectionId": "conn_li_001",
    "documentTitle": "Q3 results"
  }]
}

Perfil da Empresa no Google

O Perfil da Empresa no Google aceita publicações TEXT ou IMAGE com uma imagem JPEG ou PNG de até 5 MB e texto de até 1500 caracteres. Não há texto alternativo. Um local sem configuração publica uma atualização STANDARD.

Parâmetro	Tipo	Descrição
`connectionId`OBRIGATÓRIO	`string`	O id da conta de /social-accounts a que esta configuração se aplica
`topicType`OBRIGATÓRIO	`string`	STANDARD, EVENT ou OFFER. EVENT e OFFER exigem eventTitle, eventStart e eventEnd
`callToActionType`	`string`	BOOK, ORDER, SHOP, LEARN_MORE, SIGN_UP ou CALL. CALL usa o número de telefone do Perfil da Empresa
`callToActionUrl`	`string`	Para onde o botão leva. Obrigatório para todos os botões, exceto CALL
`eventTitle`	`string`	Título do evento ou da oferta
`eventStart`	`string`	Início no horário local da empresa, como YYYY-MM-DD ou YYYY-MM-DDTHH:mm, sem fuso horário
`eventEnd`	`string`	Término no horário local da empresa, como YYYY-MM-DD ou YYYY-MM-DDTHH:mm, sem fuso horário
`offerCouponCode`	`string`	Código do cupom exibido na oferta
`offerRedeemUrl`	`string`	Link onde os clientes resgatam a oferta
`offerTerms`	`string`	Termos e condições da oferta

Exemplo

{
  "googleBusinessConfigs": [{
    "connectionId": "conn_gbp_001",
    "topicType": "EVENT",
    "eventTitle": "Live music night",
    "eventStart": "2026-10-16T19:00",
    "eventEnd": "2026-10-16T23:00",
    "callToActionType": "LEARN_MORE",
    "callToActionUrl": "https://example.com/events/live-music"
  }]
}

Tumblr

Parâmetro	Tipo	Descrição
`connectionId`OBRIGATÓRIO	`string`	O id da conta de /social-accounts a que esta configuração se aplica
`tags`	`string[]`	Até 30 tags com até 140 caracteres cada, sem vírgulas. O # inicial é removido
`title`	`string`	Título exibido acima do post, até 4.096 caracteres
`sourceUrl`	`string`	Link http ou https creditado como origem, até 2.048 caracteres

Exemplo

{
  "tumblrConfigs": [{
    "connectionId": "conn_tumblr_001",
    "title": "Studio notes, week 12",
    "tags": ["art process", "sketchbook"],
    "sourceUrl": "https://example.com/blog/studio-notes"
  }]
}