wyro

Blog · 2026-11-16 · Markdown

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:

1. Crie o espaço do cliente

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:

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:

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:

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

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.

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.

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 e TikTok.

Mais: Página para agências · Como automatizar as redes sociais dos seus clientes com IA · Publicar em várias redes ao mesmo tempo.

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