# API de redes sociais para agências e SaaS (um espaço por cliente, com a sua marca na frente)

Se você tem uma agência ou um produto que publica nas redes em nome de outras pessoas, o problema não é escrever o post. É tudo o que vem junto: cada cliente conectar as próprias contas sem passar a senha para você, as contas de um cliente não se misturarem com as de outro, e saber se o post foi publicado ou falhou sem conferir rede por rede.

Construir isso por conta própria significa registrar um app em cada rede, passar pelas revisões de cada uma e manter oito integrações diferentes. Este guia mostra como isso fica resolvido com a API de parceiro do wyro API: o seu sistema é o que os seus clientes veem, e o wyro API trabalha nos bastidores.

## O modelo: um espaço por cliente

Cada cliente seu tem o próprio espaço de trabalho (*workspace*), com a própria chave. As contas conectadas com essa chave existem só naquele espaço: ao listar as contas com a chave do cliente A, as do cliente B nunca aparecem, e uma conta não pode ser transferida de um espaço para outro.

Você guarda duas coisas, sempre no seu backend:

- Um **token de parceiro**, que serve só para criar e administrar espaços.
- A **chave de cada cliente**, usada para todo o resto: conectar redes, publicar e consultar status.

## 1. Crie o espaço do cliente

```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.sua-agencia.com.br/webhooks/redes"}'
```

`external_id` é o identificador do cliente no seu sistema. A chamada é idempotente: se você repetir o mesmo `external_id`, recebe o espaço que já existia em vez de um duplicado.

A primeira resposta traz `workspace_id`, a `api_key` do cliente e um `webhook_secret`. Guarde tudo nesse momento, porque esses dados não aparecem de novo. Se um dia precisar trocar a chave, `POST /v1/partner/workspaces/{id}/key` gera uma nova e a anterior para de funcionar na hora.

## 2. Envie um link de conexão

Com a chave do cliente, você pede um link para a rede que ele quer conectar:

```bash
curl -X POST https://wyroapi.com/v1/connect \
  -H "Authorization: Bearer $CHAVE_DO_CLIENTE" \
  -H "Content-Type: application/json" \
  -d '{"platform":"instagram","return_url":"https://app.sua-agencia.com.br/redes/conectada"}'
```

A resposta traz um `connect_url`. Você mostra como um botão no seu produto ou envia para o cliente. O que acontece quando ele abre:

1. Ele não precisa criar conta nem fazer login no wyro API.
2. Vai direto para a tela de autorização oficial da rede (a do Instagram, a do LinkedIn, a que for). Ele nunca passa a senha para você.
3. Ao terminar, volta para a sua `return_url`, com o resultado no endereço: `wyro_status=connected` junto com o `account_id`, a rede e o nome de usuário, ou `wyro_status=error` com o motivo (por exemplo, `cancelled`).

O link é assinado e expira em 24 horas: não dá para alterá-lo para apontar para outro cliente ou outra rede. A `return_url` precisa ser `https`.

## 3. Publique com account_ids

Com a chave do cliente, `GET /v1/accounts` retorna as contas conectadas dele. Para publicar, você indica as contas exatas:

```bash
curl -X POST https://wyroapi.com/v1/posts \
  -H "Authorization: Bearer $CHAVE_DO_CLIENTE" \
  -H "Content-Type: application/json" \
  -d '{"text":"Nova coleção","account_ids":["acc_..."],"media":[{"url":"https://seu-servidor.com/foto.jpg"}],"scheduled_at":"2026-11-20T10:00:00-03:00"}'
```

Sem `scheduled_at`, o post é publicado na hora. Com `account_ids` você escolhe a conta exata, mesmo que o cliente tenha várias da mesma rede.

Se quem publica é um agente de IA, cada espaço também tem o próprio endereço de servidor MCP (`mcp_url`, na resposta de criação). O agente que trabalha para um cliente só enxerga as contas desse cliente.

## 4. Prévias para o cliente aprovar

Para mostrar um post antes de ele existir na conta real, use uma chave de teste: `POST https://wyroapi.com/v1/sandbox` retorna uma sem cadastro, válida por 72 horas, com contas simuladas das 8 redes. Cada post criado com ela retorna um `preview_url`: um link público com a cara do post em cada rede, que você pode enviar para o cliente. Quando ele aprovar, você publica o mesmo conteúdo com a chave do espaço dele.

Os espaços de parceiro não têm contas simuladas: ali, tudo o que você publica é real.

## 5. Receba o status por webhook

Na `webhook_url` que você informou ao criar o espaço (ou que define depois com `PUT /v1/webhooks`), chegam estes eventos:

- `post.published`, `post.partial` e `post.failed`, quando um post chega ao status final. Cada rede vem com o seu status, o link do post publicado ou o erro.
- `account.connected` e `account.disconnected`.

Cada evento inclui o seu `external_id`, então você sabe de qual cliente é sem precisar procurar. As entregas são assinadas: chegam os headers `X-Wyro-Timestamp` e `X-Wyro-Signature`, e a assinatura é o HMAC-SHA256 do texto `<timestamp>.<corpo>` com o seu `webhook_secret`. Verifique a assinatura e rejeite timestamps com mais de 5 minutos.

Uma dica de arquitetura: responda rápido com um 2xx, processe em segundo plano e, se um status for muito importante para você, confirme com `GET /v1/posts/{id}`.

## Quando um cliente vai embora

- `DELETE /v1/posts/{id}` cancela um post agendado.
- `DELETE /v1/accounts/{id}` desconecta uma conta.
- `DELETE /v1/partner/workspaces/{id}` encerra o espaço inteiro: desconecta as contas e revoga a chave. O histórico fica guardado.

## Como ter acesso e quanto custa

O token de parceiro não é gerado pelo painel: nós liberamos para cada agência ou produto. O preço público do wyro API é US$ 5 por conta conectada por mês; para agências e produtos com muitas contas, as condições são combinadas de acordo com o seu volume. Para pedir acesso, [fale com a gente pela página para agências](https://wyroapi.com/pt/agencias).

Enquanto isso, você pode testar toda a parte de publicação com uma chave de teste, grátis e sem cadastro.

## Perguntas frequentes

**Meus clientes precisam criar uma conta no wyro API?** Não. Eles abrem o link de conexão e autorizam direto na rede. O link passa pelo domínio do wyro API antes de chegar à tela oficial da rede e, depois, eles voltam para o seu produto.

**Preciso registrar apps na Meta, no TikTok ou no LinkedIn?** Não. As contas são conectadas pelo acesso que o wyro API já tem. Mais detalhes em [Publicar sem aprovações](https://wyroapi.com/pt/sem-aprovacao).

**Quais redes são cobertas?** Instagram, Facebook, TikTok, LinkedIn, X, Threads, YouTube e Pinterest, com a mesma chamada. Cada rede tem a sua página, por exemplo [Instagram](https://wyroapi.com/pt/instagram-api) e [TikTok](https://wyroapi.com/pt/tiktok-api).

Mais: [Página para agências](https://wyroapi.com/pt/agencias) · [Como automatizar as redes sociais dos seus clientes com IA](https://wyroapi.com/pt/blog/agencias-redes-sociais-com-ia) · [Publicar em várias redes ao mesmo tempo](https://wyroapi.com/pt/docs/varias-redes).

---
Publicado em 2026-11-16 em https://wyroapi.com/pt/blog/api-redes-sociais-white-label-agencias
