Como adicionar publicação em redes sociais ao seu SaaS sem passar pela app review
Mais cedo ou mais tarde, os usuários de um gerador de conteúdo, de um CRM ou de uma ferramenta para lojistas pedem a mesma coisa: «dá para publicar isso direto no Instagram?». No roadmap parece uma tarefa pequena: um botão e uma chamada de API.
Não é. Este guia explica o que tem por trás, por que a parte difícil não é o código e como a API de partner do wyro API resolve isso. Também diz o que ela não resolve.
O que envolve construir direto
Para publicar em nome dos seus usuários numa rede social, o seu produto precisa de um app de desenvolvedor aprovado por essa rede. Para cada uma, isso significa:
- Criar o app e pedir as permissões de publicação. Na Meta (Instagram, Facebook e Threads), no TikTok, no LinkedIn, no Google (YouTube), no X e no Pinterest. São oito redes e seis processos diferentes.
- Passar pela revisão. Toda rede pede algo parecido: explicar para que você usa cada permissão, gravar um vídeo do seu produto usando-a, ter uma política de privacidade pública e, em vários casos, verificar a empresa. Enquanto o app não é aprovado, ele só funciona com contas de teste ou com restrições: o TikTok, por exemplo, deixa os vídeos de apps sem auditoria no modo privado.
- Esperar. Os prazos variam, não dependem de você, e uma recusa te devolve ao começo.
Depois começa o trabalho de verdade, que é manter tudo isso:
- Tokens que expiram e precisam ser renovados, diferentes em cada rede.
- Versões de API que são descontinuadas e mudanças de permissão que obrigam a atualizar.
- Regras de formato próprias: tamanho do texto, vídeo obrigatório no TikTok e no YouTube, carrosséis, stories.
- Erros que cada rede informa do seu jeito.
Se o seu produto só precisa de uma rede e você tem tempo para a revisão, integrar direto faz sentido: você não depende de ninguém. O problema aparece quando os seus usuários querem três, cinco ou oito redes.
A alternativa: uma API com o app já aprovado
Uma API de publicação como o wyro API já passou por essas revisões. Os seus usuários autorizam a conexão por meio desse app aprovado, então o seu produto não precisa registrar um app próprio em cada rede nem passar por nenhuma app review. Você fala com uma única API para as oito redes: Instagram, Facebook, TikTok, LinkedIn, X, Threads, YouTube e Pinterest.
Vale ser claro sobre o que isso significa, porque não é mágica:
- Seus usuários nunca criam conta no wyro API. Mas não é um white label completo: o link de conexão passa pelo domínio do wyro API, e a tela de consentimento da rede mostra o nome do app aprovado que faz a conexão, não o do seu produto. Antes e depois desse passo, tudo acontece na sua interface.
- Você depende de um fornecedor. Se amanhã algo mudar numa rede, a gente resolve, mas a sua publicação depende de a nossa API estar funcionando.
- A publicação passa pelas APIs oficiais. Sem automação de navegador e sem senhas guardadas.
Como fica o fluxo no seu produto
A API de partner tem quatro passos. Todos rodam no seu backend.
1. Um workspace por cliente
Cada cliente seu é um workspace com chave própria e contas conectadas próprias. Você cria com o seu token de partner:
curl -X POST https://wyroapi.com/v1/partner/workspaces \
-H "Authorization: Bearer $PARTNER_TOKEN" \
-H "Content-Type: application/json" \
-d '{"external_id":"cliente-123","webhook_url":"https://api.seu-saas.com.br/webhooks/wyro"}'
external_id é o id do cliente no seu sistema, e a chamada é idempotente: se você repetir, recebe o mesmo workspace. A primeira resposta traz a api_key do workspace e o webhook_secret; guarde os dois criptografados, porque não aparecem de novo. A chave de um workspace só enxerga as contas dele: um account_id de outro devolve 404.
2. Um link de conexão
Quando o usuário clica em «Conectar Instagram» no seu produto, você pede um link com a chave do workspace dele:
curl -X POST https://wyroapi.com/v1/connect \
-H "Authorization: Bearer $WORKSPACE_KEY" \
-H "Content-Type: application/json" \
-d '{"platform":"instagram","return_url":"https://app.seu-saas.com.br/redes/conectada"}'
A resposta traz um connect_url assinado que vence em 24 horas. Não dá para alterá-lo para apontar para outro workspace ou outra rede, e o return_url precisa ser https.
3. O usuário autoriza e volta
O seu usuário abre o link, vai direto para a autorização oficial da rede, sem login no wyro API, e volta para o seu return_url com o resultado no endereço:
wyro_status=connected, comaccount_id,platformeusername, ouwyro_status=error, com o motivo emreason(por exemplo,cancelledse ele desistiu).
Você guarda o account_id junto do cliente. Para confirmar no servidor, GET /v1/accounts lista as contas do workspace, e você também recebe o evento account.connected.
4. Publicar com account_ids
curl -X POST https://wyroapi.com/v1/posts \
-H "Authorization: Bearer $WORKSPACE_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"Novo lançamento","account_ids":["acc_..."],"media":[{"url":"https://seu-saas.com.br/img/lancamento.jpg"}],"scheduled_at":"2026-12-01T10:00:00-03:00"}'
Sem scheduled_at, o post sai na hora. A mesma chamada serve para qualquer uma das oito redes.
Detalhes que vale desenhar desde o começo
Webhooks, não polling. No webhook_url você recebe post.published, post.partial e post.failed quando um post chega ao status final, com o link publicado ou o erro de cada rede, além de account.connected e account.disconnected. Cada entrega vem assinada (X-Wyro-Signature, um HMAC-SHA256 de <timestamp>.<corpo> com o seu webhook_secret): verifique a assinatura e rejeite timestamps com mais de 5 minutos. Hoje cada evento tem duas tentativas de entrega, sem novas tentativas depois, então responda rápido com um 2xx, processe em segundo plano e, se um status for crítico, confirme com GET /v1/posts/{id}.
Desconexões. Se um usuário revogar o acesso pela rede, chega account.disconnected, a conta fica disconnected e publicar nela devolve account_disconnected. O ideal é mostrar um botão «Reconectar» que peça um link novo.
Validação antes de publicar. Cada rede tem seus limites: 2.200 caracteres no Instagram, 280 no X, vídeo obrigatório no TikTok e no YouTube. A API valida as mesmas regras, e cada erro traz um código, o motivo e como corrigir, em português, espanhol ou inglês, para você mostrar ao seu usuário.
Chaves só no backend. O token de partner e as chaves dos workspaces nunca vão para o navegador. POST /v1/partner/workspaces/{id}/key troca uma chave na hora, e DELETE /v1/partner/workspaces/{id} desliga um cliente: desconecta as contas e revoga a chave.
O que ainda não faz
Para você não descobrir no meio da integração: hoje o wyro API publica e agenda, mas não traz métricas das publicações (insights), anúncios nem mensagens diretas automáticas.
Quanto custa e como começar
O preço público é USD 5 por conta conectada por mês, sem cobrança por usuário nem por post. Se os seus usuários vão conectar muitas contas, as condições por volume a gente conversa. O token de partner não é gerado pelo painel: a gente libera depois de uma conversa rápida, que você pode pedir na página para SaaS.
Enquanto isso, você pode testar a publicação de graça e sem cadastro com uma chave de teste, com contas simuladas nas oito redes.
Mais: Documentação: começar · Contas e conexão · API de partner para agências e SaaS · Publicar sem aprovação da Meta nem do TikTok.