Muitos usuários corporativos dependem de ferramentas de terceiros como Hootsuite, Buffer e Later para agendar postagens em redes sociais. Quando essas ferramentas falham ao publicar no Threads no horário programado, ou quando os posts são atrasados ou rejeitados, a causa geralmente é a própria API do Threads. A Meta projetou a API do Threads com limites de taxa rigorosos, regras de conteúdo e requisitos de autenticação que os agendadores de terceiros precisam seguir. Este artigo explica exatamente quais limitações da API causam falhas de agendamento e como contorná-las.
Principais Conclusões: Limites da API do Threads que Afetam o Agendamento
- Limite de taxa de 200 requisições por usuário por hora: Ferramentas de terceiros só podem enviar 200 chamadas de API por hora por usuário do Threads, o que limita o agendamento em massa.
- Restrições de tamanho e formato de mídia: Imagens devem ter menos de 5 MB e vídeos menos de 100 MB; formatos não suportados causam falhas silenciosas.
- Sem exclusão ou edição programática: Uma vez que um post é agendado e enviado, a API não pode editá-lo ou excluí-lo — a ferramenta deve usar o aplicativo Threads para gerenciar posts.
Como a API do Threads Limita o Agendamento por Terceiros
A API do Threads foi lançada em junho de 2024 e ainda está em fase beta limitada. Diferente das APIs do Facebook ou Instagram Graph, a API do Threads não suporta todos os recursos que os agendadores de terceiros precisam. A API foi projetada principalmente para publicar posts de texto e mídia, ler perfis de usuários e buscar respostas. Agendamento, filas e operações em massa não são nativos da API. Em vez disso, as ferramentas de terceiros precisam construir sua própria camada de agendamento sobre a API, o que introduz várias limitações.
A limitação mais significativa é o limite de taxa. Cada usuário do Threads pode fazer no máximo 200 requisições de API por hora. Um único post agendado geralmente requer pelo menos duas requisições: uma para enviar a mídia e outra para publicar o post. Se você agendar 50 posts de uma vez, a ferramenta usa 100 requisições, potencialmente bloqueando outras operações pelo resto da hora. Esse limite de taxa é por usuário, não por aplicativo, então usuários com várias contas do Threads não podem agrupar requisições.
Outra limitação é a falta de um endpoint dedicado de agendamento. A API tem um endpoint POST /me/threads que cria um post e um endpoint POST /me/threads_publish que o publica. Não há endpoint para especificar um horário futuro de publicação. Ferramentas de terceiros precisam armazenar o post localmente e chamar o endpoint de publicação no horário agendado exato. Se o servidor da ferramenta estiver sobrecarregado ou se o token de acesso do usuário expirar, o post falha silenciosamente.
Regras de Validação de Conteúdo
A API valida o conteúdo antes de publicar. Links devem usar HTTPS e não podem ser encurtados por serviços como bit.ly a menos que o serviço seja pré-aprovado. Hashtags são permitidas, mas não são indexadas para busca dentro do Threads. Posts que contenham conteúdo proibido, como discurso de ódio, assédio ou desinformação, são rejeitados com um código de erro genérico. Ferramentas de terceiros não podem tentar novamente esses posts rejeitados porque a API não fornece motivos detalhados de rejeição.
Restrições de Upload de Mídia
Imagens devem estar nos formatos JPEG, PNG ou WebP, com tamanho máximo de 5 MB. Vídeos devem ser MP4 ou MOV, com menos de 100 MB e duração máxima de 5 minutos. Se um post agendado incluir um arquivo de mídia que exceda esses limites, a API retorna um erro e todo o post falha. Ferramentas que comprimem mídia automaticamente ainda podem falhar se a compressão não atender aos requisitos exatos de formato.
Passos para Verificar e Contornar as Limitações da API
Antes de agendar posts, verifique se sua ferramenta de terceiros suporta corretamente a API do Threads. Nem todas as ferramentas integraram a API, e algumas usam métodos não oficiais que podem parar de funcionar a qualquer momento. Siga estes passos para testar e otimizar sua configuração de agendamento.
- Verifique a integração oficial da sua ferramenta com o Threads
Abra a central de ajuda ou as configurações da ferramenta. Procure por uma seção chamada Threads, Meta ou Instagram. Se a ferramenta listar o Threads como uma rede suportada, ela usa a API oficial. Caso contrário, a ferramenta pode estar usando um raspador web que viola os termos de serviço da Meta. - Confirme que sua conta do Threads está conectada
Na ferramenta, vá em Contas > Threads. Confirme que a conta mostra Conectada e que o token de acesso é válido. Os tokens expiram após 60 dias, a menos que sejam renovados. Algumas ferramentas renovam tokens automaticamente, mas outras exigem que você reconecte manualmente. - Agende um post de teste único
Crie um post apenas com texto e um link para seu site. Defina o agendamento para 10 minutos à frente. Após a publicação, verifique o aplicativo Threads para confirmar que o post apareceu. Este teste verifica se a ferramenta consegue acessar a API e se seu token está funcionando. - Agende um post com mídia
Envie uma imagem JPEG com menos de 5 MB e agende-a. Se o post falhar, verifique o formato e o tamanho do arquivo. Converta a imagem para JPEG ou PNG e reduza suas dimensões para 1080×1080 pixels ou menos. - Monitore o uso do limite de taxa
Algumas ferramentas exibem estatísticas de uso da API. Se você perceber que suas requisições estão perto de 200 por hora, distribua seus posts agendados ao longo de várias horas. Evite agendar mais de 30 posts em uma única hora. - Use o aplicativo Threads para gerenciar posts
Como a API não suporta edição ou exclusão de posts, use o aplicativo móvel do Threads para remover ou editar qualquer post que tenha sido publicado incorretamente. A ferramenta de terceiros não pode desfazer um post publicado.
Problemas Comuns ao Agendar Posts no Threads
Post Falha com Código de Erro Genérico
Se a API retornar um erro como API_ERROR ou INVALID_PARAMETER, o conteúdo provavelmente viola alguma regra. Remova links encurtados, verifique se todas as URLs começam com https:// e garanta que as hashtags não contenham espaços ou caracteres especiais. Se o erro persistir, agende o mesmo post manualmente pelo aplicativo Threads para ver se funciona sem a ferramenta de terceiros.
Upload de Mídia Trava ou Excede o Tempo Limite
Arquivos de vídeo grandes geralmente causam timeouts. A API tem um tempo limite de 30 segundos para uploads de mídia. Se seu vídeo exceder 100 MB ou tiver mais de 5 minutos, ele falhará. Use um compressor de vídeo para reduzir o tamanho do arquivo para menos de 100 MB e corte o vídeo para 5 minutos ou menos. Também garanta que a resolução do vídeo seja 1920×1080 ou inferior.
Post Agendado Publica no Horário Errado
Isso geralmente acontece porque a ferramenta de terceiros e a API estão em fusos horários diferentes. Verifique a configuração de fuso horário da ferramenta. A maioria das ferramentas usa UTC como padrão. Se você agendar um post para as 9:00 AM no horário local, mas a ferramenta usar UTC, o post será publicado às 9:00 AM UTC, que pode ser 5:00 AM ou 2:00 PM no seu horário. Defina o fuso horário da ferramenta para corresponder ao fuso horário da sua conta do Threads.
Token de Acesso Expira Antes do Horário Agendado
Os tokens de acesso do Threads expiram 60 dias após serem emitidos. Se você agendar um post com 61 dias de antecedência, o token será inválido quando a ferramenta tentar publicar. Agende posts com no máximo 30 dias de antecedência para evitar esse problema. Algumas ferramentas renovam tokens automaticamente a cada 30 dias, mas você deve verificar isso na documentação da ferramenta.
API do Threads vs API do Instagram Graph: Limites de Agendamento Comparados
| Item | API do Threads | API do Instagram Graph |
|---|---|---|
| Limite de taxa por usuário por hora | 200 requisições | 200 requisições |
| Limite de tamanho de mídia (imagem) | 5 MB | 8 MB |
| Limite de tamanho de mídia (vídeo) | 100 MB | 100 MB |
| Limite de duração de vídeo | 5 minutos | 60 minutos |
| Endpoint de agendamento | Não disponível | Disponível via /media_publish |
| Edição ou exclusão de posts | Não suportado | Suportado via DELETE e PATCH |
| Indexação de hashtags | Não indexadas | Indexadas para busca |
A API do Threads é significativamente mais restritiva que a API do Instagram Graph, especialmente em relação à duração de vídeos, agendamento e gerenciamento de posts. Ferramentas de terceiros que suportam ambas as plataformas precisam implementar lógica separada para o Threads, o que geralmente resulta em menos recursos para os usuários do Threads.
Agora você pode identificar por que sua ferramenta de agendamento de terceiros falha ao publicar posts no Threads. Verifique primeiro o status de integração oficial da sua ferramenta, depois confirme se seus arquivos de mídia atendem aos requisitos de tamanho e formato. Para um agendamento confiável, mantenha seus posts agendados dentro de 30 dias e monitore o uso do limite de taxa da API. Como próximo passo, teste o mesmo post usando o aplicativo móvel do Threads para isolar se o problema está na API ou na sua ferramenta. Para usuários avançados, considere usar o Business Suite da Meta, que tem suporte nativo de agendamento para o Threads e contorna algumas limitações da API de terceiros.