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
| 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 | Sempre feed no Threads. |
| caption | string | Não | O texto do post, até 500 caracteres. Obrigatório quando não há mídia. |
| media | array | Não | Até 20 imagens ou vídeos, em ordem. Pode ficar de fora para um post só de texto. |
| threads.reply_control | string | Não | Quem pode responder: everyone, accounts_you_follow, mentioned_only, parent_post_author_only ou followers_only. |
| threads.link_attachment | string | Não | Link com prévia anexado ao post. Só em post sem mídia. |
| threads.topic_tag | string | Não | Tag de tópico, até 50 caracteres, sem ponto e sem &. |
| threads.first_comment | string | Não | Resposta 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.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
