> ## Documentation Index > Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # API do Threads > Opções para publicar usando a API do Threads A publicação no Threads busca a mídia da sua URL por meio do crawler no servidor da Meta. Se você vir o código de erro 379 do Ayrshare — especialmente junto com um erro 440 ou 138 do Instagram no mesmo envio — consulte [Meta Media Crawler Blocked](/help-center/technical-support/meta_media_crawler_blocked). ## Publicando no Threads JSON para uma publicação básica com link e imagem usando a API do Threads: ```json Threads Post theme={"system"} { "post": "The best Threads post ever #best #awesome https://www.threads.net", // empty string is allowed "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], "platforms": ["threads"] } ``` A API do Threads tem os seguintes requisitos e restrições: ## Opções do Threads Você pode definir opções adicionais para uma publicação usando o parâmetro `threadsOptions`. ```json Threads Options theme={"system"} { "threadsOptions": { "allowCountries": ["US", "CA"], "thread": true, "threadNumber": true, "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"] // used when sending as a thread of threads } } ``` As opções do Threads são campos opcionais que podem ser usados para controlar a publicação. Restrinja publicações a países específicos usando códigos de país. Use [códigos de país](/iso-codes/country). Disponível apenas se a Meta tiver ativado restrições geográficas para sua conta. Consulte [Restrições geográficas do Threads](/apis/post/social-networks/threads#geo-restrictions) para mais informações. Divida publicações longas em uma série conectada de threads com numeração e mídia opcionais. Consulte [Thread](/apis/post/social-networks/threads#thread) para mais informações. Adiciona automaticamente números ao final de cada thread no formato 1/n. Requer `thread: true`. Adicione objetos de mídia a uma thread de threads. Um objeto de mídia será adicionado a cada thread na ordem. Use `null` para pular mídia em uma thread específica. Use objetos com múltiplas URLs para múltiplas mídias por thread. Consulte [Mídia da Thread](/apis/post/social-networks/threads#thread-media) para mais informações. ## Adicionando quebras de linha ou rich text a uma publicação do Threads Quebras de linha do Threads podem ser adicionadas a uma publicação com um [caractere de nova linha especial](/apis/post/post#line-breaks). Rich text, como negrito ou itálico, pode ser adicionado a uma publicação do Threads com alguns [elementos HTML](/apis/post/overview#rich-text-posts). ## Carrossel de imagens e vídeos Você pode postar várias imagens ou vídeos no Threads como um carrossel; até um total combinado de 20 imagens ou vídeos pode ser usado em um carrossel. Basta adicionar suas imagens ou vídeos adicionais ao array `mediaUrls` e o carrossel será criado automaticamente. ```json theme={"system"} "mediaUrls": ["https://url.com/image.jpg", "https://url.com/video.mp4" ...]; // Max 20 images or videos ``` URLs de vídeo devem terminar em uma extensão conhecida, como mp4. ## Limites de caracteres Consulte [Limites de caracteres do Threads](/help-center/technical-support/character_limits#threads-character-limits) para mais informações. ## Restrições geográficas Você pode restringir uma publicação a um país ou países específicos usando o array `allowCountries`. ```json theme={"system"} { "threadsOptions": { "allowCountries": ["US", "CA"] } } ``` Restrições geográficas (geo-gating) no Threads só estão disponíveis se a Meta tiver ativado este recurso para sua conta. A Meta decide quais contas do Threads são elegíveis para restrições geográficas com base em fatores como verificação de conta, contagem de seguidores ou status de criador de conteúdo. Se sua conta for elegível, você verá as configurações geográficas (ícone de globo) no compositor de publicações ao criar uma nova publicação no Threads. Você pode verificar se um User Profile é elegível para restrições geográficas do Threads verificando a propriedade `isEligibleForGeoRestrictions` no endpoint [/user](/apis/user/profile-details). ## Menções no Threads Mencione outro usuário do Threads adicionando @handle no texto da publicação. Por exemplo: ```json theme={"system"} { "post": "The best social media API @Ayrshare ever!", "mediaUrls": ["https://images.com"], "platforms": ["threads"] } ``` O usuário @mencionado será notificado da menção. Revise as [regras importantes](/testing/post-verification#mentions) sobre menções. Se a cota tiver sido atingida, uma mensagem de erro será retornada. ## Thread Uma thread do Threads, também conhecida como threadstorm, é uma série conectada de publicações no Threads que permite compartilhar ideias mais longas além do limite de caracteres de uma única publicação, aparecendo como uma narrativa contínua quando visualizada em conjunto. ### Publicando uma Thread Uma thread do Threads pode ser publicada via API. Uma thread é uma publicação dividida em um conjunto de publicações de resposta associadas entre si no Threads. Você pode dividir a publicação automaticamente ou especificar as [quebras da thread](/apis/post/social-networks/threads#thread-breaks) no texto da publicação. ```json Threads Thread theme={"system"} { "threadsOptions": { "thread": true, // required for threadstorm "threadNumber": true, // optional to add numbers to each thread "mediaUrls": ["https://site.com/image1.png", "https://site.com/image2.png", ...] // optional one media object is added to a thread in order } } ``` #### Mídia da Thread ##### Pular mídia Pule a mídia de uma thread usando `null` no array. Por exemplo: `["https://site.com/image1.png", null, "https://site.com/image2.png"]` Isso colocará image1 na primeira publicação, nenhuma imagem na segunda publicação e image2 na terceira publicação. ##### Múltiplas mídias Múltiplos objetos de mídia podem ser adicionados a uma única publicação dentro de uma thread, adicionando um objeto `{}` com as URLs de mídia no array `mediaUrls`. Quaisquer chaves de objeto únicas podem ser usadas. Por exemplo: ```json Threads Thread with Multiple Media URLs theme={"system"} { "threadsOptions": { "thread": true, "threadNumber": true, "mediaUrls": [ "https://img.ayrshare.com/random/photo-1.jpg", { "1": "https://img.ayrshare.com/random/photo-2.jpg", "2": "https://img.ayrshare.com/random/photo-3.jpg" }, "https://img.ayrshare.com/random/photo-4.jpg" ] } } ``` Neste exemplo, a primeira publicação conterá photo-1.jpg, a segunda publicação photo-2.jpg e photo-3.jpg, e a terceira publicação photo-4.jpg. #### Quebras de thread O Ayrshare divide automaticamente o texto da publicação em posts de tamanho apropriado (> 500 caracteres) para o Threads. Ao criar threads, priorizamos manter frases completas em uma única publicação, quando possível. Se uma frase não couber, dividimos entre frases. Para frases muito longas, dividimos entre palavras. Em casos raros em que uma palavra é muito longa, dividimos a própria palavra. Você também pode adicionar manualmente parágrafos com `\n\n` no texto da publicação para indicar que uma nova thread deve ser criada. Se você tiver `\n\n` no texto da publicação, não dividiremos automaticamente a publicação em threads. Por exemplo: ```json Example Threads Thread theme={"system"} { "post": "This is post 1\n\nThis is post 2.", "platforms": ["threads"], "threadsOptions": { "thread": true } } ``` resultará em duas publicações na thread. Se você quiser adicionar parágrafos, mas sem dividir em publicações, use `\u2063\n\u2063\n`. ```json Threads Thread with Paragraphs theme={"system"} { "post": "This is paragraph 1\u2063\n\u2063\nThis is paragraph 2.", "platforms": ["threads"], "threadsOptions": { "thread": true } } ``` resultará em uma publicação com dois parágrafos, já que a publicação tem menos de 500 caracteres. ### Excluir uma Thread O Threads não suporta exclusões via API. As exclusões devem ocorrer manualmente usando o aplicativo do Threads.