Cada cliente conecta as redes dele por OAuth, uma única vez, e a MAIA publica por ele, agendado ou na hora. Este documento responde: dá pra construir? Quanto custa em esforço? E o que fazer enquanto a nossa não fica pronta.
Pra você bater o martelo sem ler o documento inteiro. O detalhe técnico vem depois.
integrations/zernio/publish.py. Ou seja: não precisamos travar o crescimento esperando a plataforma própria."Seria possível construir uma Zernio pra nós? Como é que ela faz pra ter acesso às redes, pra a gente só conectar? Como a gente está crescendo em escala e vendendo o ecossistema pra outros clientes, seria interessante ter uma plataforma onde os clientes conectam as redes deles e já fazem as postagens."
Essa é a resposta direta à sua pergunta "como é que ela faz pra ter acesso às redes". Não existe mágica nem gambiarra; é um padrão que toda plataforma do tipo usa.
Cada rede social oferece duas coisas:
A "Zernio" (e a nossa) é, tecnicamente, um app de desenvolvedor aprovado em cada rede. Registramos um único app por rede (ex.: "MAIA Publisher"), passamos pela revisão da plataforma, e a partir daí qualquer cliente autoriza esse mesmo app.
Quando o cliente clica em "Conectar", ele é levado pra tela da própria rede (não pra uma tela nossa), faz login na conta dele, e concede permissão ao nosso app. A rede então devolve pra gente um token de acesso daquele cliente específico. Guardamos esse token (criptografado, por tenant) e ele é a "chave" que permite publicar naquela conta, sem nunca ver a senha do cliente.
Os tokens expiram; a plataforma renova sozinha (refresh token) em segundo plano. É por isso que na Zernio você conecta uma vez e "esquece"; a nossa faz igual.
Nenhuma dessas APIs aceita a mídia "colada" na requisição. A mídia (foto/vídeo) precisa estar num URL público que a rede vai baixar. Por isso a Zernio te pede pra subir o arquivo primeiro, e a nossa vai precisar do mesmo: um storage de mídia com URL pública. Isso a gente já tem (MinIO + domínio drive.salatielbatista.com.br).
access_token + refresh_token e guarda criptografado, isolado por tenant.Pesquisado no estado atual da documentação oficial. A diferença entre as redes não é a dificuldade de programar; é a burocracia de aprovação pra postar em conta de terceiro.
| Rede | O que precisa | Aprovação (tempo aprox.) | Limite / custo | Dificuldade |
|---|---|---|---|---|
| Instagram + Facebook Graph API |
App Meta com instagram_content_publish (+ pages_manage_posts p/ FB). App Review + Business Verification obrigatórios pra postar em conta de terceiro. Conta do cliente precisa ser Business/Creator ligada a uma Página. |
~1 a 4 semanas (App Review). Business Verification pode pedir documentos da empresa. | Até 100 posts / 24h por conta. Carrossel = 1 post. Grátis. | Média |
| TikTok Content Posting API |
App com video.publish. Modos: Direct Post (posta direto) ou Upload/rascunho. Precisa passar por auditoria. App não auditado só posta como privado (SELF_ONLY). |
Auditoria: dias a semanas. Sem ela, o cliente vê o post só como privado. | Grátis. Consultar limites por conta antes de postar. | Média |
| YouTube Data API v3 |
OAuth + escopo de upload. Projeto não verificado publica vídeo como PRIVADO até passar por audit/verification do Google (escopo sensível). | OAuth verification do Google: semanas, com política de privacidade e vídeo de demonstração. | Cota padrão 10.000 unidades/dia; cada upload custa ~1.600 → ~6 uploads/dia por projeto (dá pra pedir aumento). | Difícil |
| Threads Threads API (Meta) |
API oficial da Meta, OAuth próprio. Mesma família do IG, reaproveita boa parte da verificação Meta. Publicação de texto/imagem/vídeo. | Curta, se a Business Verification da Meta já estiver feita. | Limites por conta; grátis. | Fácil* |
| Pinterest Pinterest API v5 |
App Pinterest, OAuth, criação de Pins. Precisa de App Review pra sair do modo trial (que só posta na conta do dono do app). | App Review: ~1 a 2 semanas. | Grátis, com rate limits por app. | Média |
| LinkedIn Community Management API |
Postar por terceiros exige o Marketing Developer Platform / Community Management API, um programa de acesso fechado, com aplicação e justificativa de caso de uso. Difícil de conseguir. | Semanas a meses; aprovação não garantida. | Grátis, mas gargalo é o acesso. | Difícil |
| X (Twitter) API v2 |
Postar via API exige plano pago (Basic ~US$100/mês; Free praticamente não posta). OAuth 2.0. Limites de escrita apertados nos tiers baixos. | Imediato (é comprar acesso), mas custo mensal recorrente. | Custo mensal por tier + limites de posts. | Difícil (caro) |
IG/FB, TikTok, Pinterest e Threads são o "core" viável: aprovação em semanas, sem custo recorrente. YouTube é valioso mas tem cota apertada e verification chato. LinkedIn e X são os mais caros (acesso fechado / mensalidade): entram por último, só se houver demanda real de cliente.
* Threads é "fácil" condicionado a já ter a verificação Meta feita, o que a gente vai fazer de qualquer jeito pro IG/FB.
A gente não começa do zero; boa parte da fundação já roda hoje.
media_publish). Metade do caminho IG/FB andada. Falta empacotar como multi-tenant.integrations/zernio/publish.py posta texto/imagem/vídeo/carrossel, agenda, e sobe mídia por URL. TikTok e YouTube já resolvidos hoje, sem esperar nada.drive.salatielbatista.com.br. É exatamente o que toda API de rede exige (mídia por URL). Requisito crítico já atendido.Nada exótico. As peças são conhecidas e a maioria já existe no ecossistema. Abaixo, os blocos e como encaixam no produto MAIA que a gente vende.
Idêntico a finpj e AzulMEI: cada comprador da MAIA vira um tenant. Ele entra no painel dele (subdomínio próprio ou área dentro do painel MAIA), conecta as redes dele uma vez, e a partir daí a MAIA (ou ele mesmo) publica. A plataforma é nossa, com nossa marca, vendida como parte do pacote. É o ativo virando produto, não um custo de ferramenta de terceiro.
Com a Zernio, cada cliente que a gente coloca é custo recorrente pra um terceiro e a marca dele aparece. Com a nossa, cada cliente conectado é margem e reforça a marca Agência no Bolso. Num produto que a gente revende, não dá pra terceirizar o núcleo.
Mesmo modelo de finpj/AzulMEI: ondas curtas, cada uma entrega algo usável. Ordem por valor × facilidade de aprovação. As estimativas são de esforço de dev, paralelas às janelas de aprovação das redes, que correm sozinhas.
O esqueleto: tenants, cofre de tokens, storage, fila, painel base
O par mais valioso, e onde já andamos metade
Enquanto a aprovação não sai, já servimos via ponte Zernio
Baixo custo de aprovação, aproveitam a base Meta
Só se cliente pagante pedir; acesso caro/fechado
O esforço de desenvolvimento das ondas 0 a 3 soma cerca de 3 a 4 semanas de dev. As janelas de aprovação das redes correm em paralelo a isso: a gente abre os processos na Onda 1/2 e continua codando enquanto elas analisam. O produto entra no ar com IG/FB nativo + TikTok/YouTube pela ponte, e vai "trocando o motor" pra nativo conforme cada aprovação sai, sem parar.
Não trave o crescimento. TikTok e YouTube já estão resolvidos hoje pela Zernio, via nosso integrations/zernio/publish.py. Enquanto a gente sobe a plataforma própria, a Zernio segura a operação, inclusive pra clientes novos do ecossistema, se precisar.
E construa a nossa como ativo próprio. Um produto que a gente revende não pode ter o coração num terceiro: dependência de preço, de marca alheia e de disponibilidade de outra empresa é risco estratégico. A plataforma própria vira margem, vira marca Agência no Bolso, e vira algo que a gente controla.
Comece pelo IG/FB, onde já temos metade pronta e está o maior valor pro cliente típico. TikTok/YouTube ficam na ponte Zernio até a aprovação nativa sair. Sem corrida, sem travar ninguém.
Quatro decisões. Nenhuma trava a operação hoje (a Zernio segura), mas definem o rumo da construção.
Minha recomendação é sim, como ativo do ecossistema e não como urgência. Se você concordar, eu abro a Onda 0 com o Paulo no mesmo molde do finpj/AzulMEI.
Sugiro IG + Facebook na largada (metade pronta, maior valor), depois TikTok + YouTube nativos. Threads e Pinterest em seguida. LinkedIn/X só sob demanda de cliente pagante. Confirma essa ordem ou reordena.
Recomendo manter pra TikTok/YouTube até a aprovação nativa sair, pra não travar ninguém. É custo baixo e reversível. Ok?
App Review / Business Verification (Meta), auditoria (TikTok), verification (YouTube) precisam de documento da empresa, política de privacidade e um responsável pra responder às análises. Preciso saber quem assume isso. Eu preparo tudo, mas a conta e os documentos são da empresa.
Assim que você bater o martelo nos pontos 1 e 2, eu delego a Onda 0 + Onda 1 (IG/FB) pro Paulo no molde finpj/AzulMEI, e em paralelo monto o pacote de App Review / Business Verification da Meta pra você (ou quem você indicar) só assinar e enviar.