BK-205 - Threads operacional: credencial, video e guardrails

Objetivo

• tirar threads_feed do estado de token/configuracao invalida
• permitir configuracao operacional real do Threads no admin
• manter o dispatcher social pre-automatico usando a infraestrutura que ja existe
• deixar claro quando o canal esta apto e quando ainda esta bloqueado por credencial externa

Estado auditado antes desta rodada

• threads_feed ja existe na fila social, no planner, no dispatcher e na agenda
• admin/classes/FacebookEventService.php ja possui:
• getThreadsUserInfo()
• createThreadsMedia()
• publishThreadsMedia()
• admin/cron/sync_facebook_events.php ja:
• detecta se Threads esta configurado
• monta fila threads_feed
• cria container e publica perto do horario due
• o ponto de bloqueio real era operacional:
• config_facebook nao tinha colunas de Threads
• admin/modulos/facebook/configure.php nao tinha campos nem fluxo de Threads
• admin/modulos/campanhas/threads_callback.php parava no code e nao entregava token pronto para o admin

Documentacao oficial confirmada nesta rodada

• threads_basic e obrigatorio para todos os endpoints do Threads
• threads_content_publish e obrigatorio para publicar
• threads_manage_insights e recomendado se quisermos metricas reais do canal
• fluxo oficial:

1. abrir https://threads.net/oauth/authorize
2. receber code
3. trocar por short-lived token em POST https://graph.threads.net/oauth/access_token
4. trocar por long-lived token em GET https://graph.threads.net/access_token?grant_type=th_exchange_token
5. renovar em GET /refresh_access_token antes de expirar

• limites oficiais confirmados:
• texto com limite de 500 caracteres
• media_type aceitando TEXT, IMAGE e VIDEO
• image_url e video_url precisam estar em URL publica

Escopo desta rodada

• abrir configuracao real de Threads no admin
• adicionar schema minimo para Threads em config_facebook
• permitir autorizar conta, trocar code por token e preencher os campos necessarios
• manter o write set minimo sem mexer no dispatcher ja existente

Estado apos esta rodada

• o admin ja ganhou fluxo real de configuracao de Threads em admin/modulos/facebook/configure.php
• o callback do Threads agora devolve o code para a tela de configuracao
• o endpoint admin/modulos/facebook/threads_token_exchange.php ja faz:

1. code -> short-lived token
2. short-lived -> long-lived token
3. leitura opcional de id/username/name para preencher o threads_user_id

• o schema minimo de Threads foi confirmado no banco de producao:
• threads_app_id
• threads_app_secret
• threads_access_token
• threads_user_id
• threads_token_expires_at
• o dispatcher existente ja esta apto a consumir threads_feed quando houver threads_access_token + threads_user_id

Arbitragem desta rodada

• leitura externa gemini: considerou refresh automatico como melhoria operacional e nao como bloqueio imediato da rodada
• leitura externa opencode: confirmou que o cron ja processa threads_feed e que o unico bloqueio real era a trilha de credencial/configuracao
• arbitragem final do Codex:
• o BK desta rodada entrega a habilitacao operacional do canal
• refresh automatico do token e validacao real de video continuam como follow-up, nao como bloqueio da configuracao inicial

Write set desta rodada

• admin/modulos/facebook/configure.php
• admin/modulos/facebook/config_schema.php
• admin/modulos/facebook/threads_token_exchange.php
• admin/modulos/campanhas/threads_callback.php
• sql_updates/update_config_facebook_threads_columns.sql

Proximo passo esperado apos o deploy

1. preencher Threads App ID e Threads App Secret
2. cadastrar o redirect URI do RNT no app do Threads
3. autorizar a conta do Threads do Rio no Teatro
4. trocar o code por token long-lived no admin
5. salvar configuracao
6. validar em execucao real um item threads_feed
7. testar publicacao com video real do acervo

Pendencias que continuam abertas mesmo apos a configuracao

• validar publicacao real de video no Threads com os formatos do acervo
• melhorar leitura operacional no admin quando Threads estiver invalido/expirado
• avaliar renovacao automatica do token long-lived antes do vencimento