wyro

Blog · 2026-11-17 · Markdown

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:

Depois começa o trabalho de verdade, que é manter tudo isso:

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:

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:

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.

Teste sem cadastro
curl -X POST https://wyroapi.com/v1/sandbox