Posts

Publicar no Threads pela API

Um POST /posts com o format feed publica no Threads da conta que o cliente conectou. Você não implementa o OAuth do Threads nem guarda tokens: manda o conteúdo e o Connect publica em segundo plano. O mesmo endpoint serve as outras redes.

A chamada

POST /api/posts?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>

{
  "external_reference": "post-5120",
  "format": "feed",
  "caption": "We shipped v2 of the dashboard. What do you want to see in v3?",
  "threads": {
    "reply_control": "accounts_you_follow",
    "topic_tag": "saas",
    "first_comment": "Full changelog on our site."
  }
}

O que dá para fazer

  • Publicar texto puro, com legenda de até 500 caracteres.
  • Publicar até 20 imagens ou vídeos em um único post.
  • Definir quem pode responder com reply_control.
  • Anexar um link com prévia em um post de texto com link_attachment.
  • Marcar o post com um topic_tag e publicar um first_comment logo depois.

Regras e limites

  • Só o format feed existe no Threads. Precisa de legenda ou de mídia.
  • link_attachment só vale em post sem mídia. topic_tag não aceita ponto nem &.
  • O POST /posts responde 202 e a publicação roda depois. Acompanhe por GET /posts/{uuid}.
  • external_reference é obrigatória. Publicar de novo a mesma referência na mesma conta, enquanto publica ou depois de publicada, retorna 409.
  • O header Idempotency-Key (até 255 caracteres) devolve o post já gravado se a mesma requisição for repetida.

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.
formatstringSimSempre feed no Threads.
captionstringNãoO texto do post, até 500 caracteres. Obrigatório quando não há mídia.
mediaarrayNãoAté 20 imagens ou vídeos, em ordem. Pode ficar de fora para um post só de texto.
threads.reply_controlstringNãoQuem pode responder: everyone, accounts_you_follow, mentioned_only, parent_post_author_only ou followers_only.
threads.link_attachmentstringNãoLink com prévia anexado ao post. Só em post sem mídia.
threads.topic_tagstringNãoTag de tópico, até 50 caracteres, sem ponto e sem &.
threads.first_commentstringNãoResposta publicada pela própria conta logo após o post, até 500 caracteres.

Para quem

  • Ferramenta de social media

    Seu produto de agendamento próprio envia o post ao Threads junto com Instagram e LinkedIn, pelo mesmo endpoint.

  • Agente de IA que publica

    Um agente redige o texto e publica no Threads do cliente, escolhendo reply_control para limitar as respostas.

  • CRM com conteúdo

    Um CRM publica novidades dos clientes no Threads e usa first_comment para colocar o link logo abaixo.

Funciona com

  • Threads

Perguntas frequentes

Posso publicar só texto no Threads?

Sim. Envie format feed e caption, sem media. A legenda vai até 500 caracteres.

Quantas mídias cabem em um post do Threads?

Até 20 imagens ou vídeos em um post.

Como sei se o post foi publicado?

O POST /posts responde 202 com o post em created. Consulte GET /posts/{uuid} até o status ser published ou failed.

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.