# 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:

```bash
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:

```bash
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`, com `account_id`, `platform` e `username`, ou
- `wyro_status=error`, com o motivo em `reason` (por exemplo, `cancelled` se 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

```bash
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](https://wyroapi.com/pt/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](https://wyroapi.com/pt/docs/comecar) · [Contas e conexão](https://wyroapi.com/pt/docs/contas) · [API de partner para agências e SaaS](https://wyroapi.com/pt/blog/api-redes-sociais-white-label-agencias) · [Publicar sem aprovação da Meta nem do TikTok](https://wyroapi.com/pt/sem-aprovacao).

---
Publicado em 2026-11-17 em https://wyroapi.com/pt/blog/adicionar-publicacao-redes-sociais-ao-seu-saas
