# Deixe seus usuários publicarem no Instagram, TikTok, LinkedIn e mais 5 redes a partir do seu produto.

> Seus usuários conectam as contas com o login oficial de cada rede e voltam para o seu app, sem criar conta no Wyro. Uma API para 8 redes, sem app review.

Infraestrutura de publicação para agentes de IA. URL: https://wyroapi.com/pt/para-saas

Funciona com Claude Code, Codex, Cursor, n8n, Make, Zapier e qualquer cliente MCP ou HTTP.

## Teste em 60 segundos, sem cadastro

Chave de teste (72 horas, tudo simulado):

```bash
curl -X POST https://wyroapi.com/v1/sandbox
```

Ou cole este prompt no seu agente (troque SUA_CHAVE pela chave):

```
Instale o wyro para você poder publicar nas minhas redes.
1) Adicione o MCP: claude mcp add --transport http wyro https://wyroapi.com/mcp --header "Authorization: Bearer SUA_CHAVE"
   (se você usa Codex ou Cursor, o guia está em https://wyroapi.com/AGENTS.md)
   Se o MCP não ficar disponível nesta sessão, use a API REST com a mesma chave: https://wyroapi.com/pt/llms.txt
2) Publique um post de teste no Instagram dizendo "Olá do meu agente", com esta imagem: https://picsum.photos/seed/wyro/1080/1080
   Depois me mostre o link da prévia.
3) Me explique como conectar minha conta real quando eu quiser publicar de verdade.
```

## O que é o Wyro?

Uma única integração para o seu agente, o seu app ou o seu fluxo publicar em 8 redes sociais. Você conecta cada conta uma vez e publica com uma chamada. Só APIs oficiais.

Disso a gente cuida:

- **As aprovações de cada rede.** Apps de desenvolvedor, revisões e verificação da empresa.
- **Tokens e permissões.** A conexão de cada conta, a renovação e as permissões.
- **Formatos e limites.** O que cada rede exige: mídia, tamanho do texto e limites de uso.
- **Mudanças de API.** Quando uma rede muda a API, a sua integração continua igual.

Um vídeo em 3 redes, uma única chamada:

```bash
curl -X POST https://wyroapi.com/v1/posts \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"text":"Lançamos uma novidade",
       "platforms":["instagram","linkedin","tiktok"],
       "media":[{"url":"https://seu-site.com/video.mp4","type":"video"}]}'
```

## Por que usar o Wyro?

- **Sem app review, uma API para 8 redes.** Você não registra um app na Meta, no TikTok nem no LinkedIn nem passa pelas revisões deles. O mesmo POST /v1/posts publica no Instagram, Facebook, TikTok, LinkedIn, X, Threads, YouTube e Pinterest.
- **Login oficial e de volta ao seu app.** Seu usuário abre um link, autoriza com o login oficial da rede e volta para o seu return_url com o account_id. Ele nunca cria conta no Wyro nem passa a senha para você.
- **Uma chave por workspace e webhooks.** Cada cliente seu é um workspace com chave e contas próprias, isolado dos demais. Um webhook assinado avisa quando um post sai ou falha, e quando uma conta é conectada ou desconectada.

## Como se integra? O fluxo de partner, de ponta a ponta

1. **Você cria um workspace por cliente.** No seu backend, com o seu token de partner. external_id é o id do cliente no seu sistema, e a chamada é idempotente. A primeira resposta traz a api_key e o webhook_secret dele, que não são mostrados de novo.

```
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"}'
```

2. **Você pede um link de conexão.** Com a chave desse workspace. Mostre como um botão «Conectar Instagram» no seu produto. O link é assinado e vence em 24 horas.

```
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"}'
```

3. **Seu usuário autoriza na rede.** Ele abre o connect_url, vai direto para a autorização oficial da rede, sem login no Wyro, e volta para o seu return_url com o resultado (ou com wyro_status=error e o motivo).

```
https://app.seu-saas.com.br/redes/conectada?wyro_status=connected&account_id=acc_…&platform=instagram&username=…
```

4. **Você publica com account_ids.** Com a chave do workspace. Sem scheduled_at, sai na hora. O status final chega no seu webhook_url como post.published, post.partial ou post.failed.

```
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"}'
```

### Endpoints que você vai usar

- `POST /v1/partner/workspaces`: Cria o workspace de um cliente (token de partner).
- `POST /v1/partner/workspaces/{id}/key`: Troca a chave dele: a anterior para de funcionar na hora.
- `DELETE /v1/partner/workspaces/{id}`: Desliga o cliente: desconecta as contas e revoga a chave.
- `POST /v1/connect`: Link de conexão assinado, com o seu return_url.
- `GET /v1/accounts`: Contas conectadas desse workspace.
- `POST /v1/posts`: Publica ou agenda nas contas que você escolher.
- `PUT /v1/webhooks`: Muda a URL de eventos do workspace.

## Como conecto o Wyro ao meu agente ou ao meu app?

Três formas de entrar. A mesma API por trás.

- **MCP** (para agentes): Claude Code, Codex e Cursor publicam com ferramentas. Nada para instalar nem hospedar: é um servidor remoto.
- **API REST** (para o seu app ou fluxo): Um POST /v1/posts de qualquer linguagem, n8n, Make ou Zapier.
- **CLI** (para o terminal): npx @wyroapi/wyro init cria a sua chave de teste e salva no .env.

### Claude

```
// Claude web, desktop ou Cowork
Personalizar → Conectores → Adicionar conector personalizado

Nome:   wyro
URL:    https://wyroapi.com/mcp/k/SUA_CHAVE
```

### Claude Code

```
claude mcp add --transport http wyro https://wyroapi.com/mcp \
  --header "Authorization: Bearer SUA_CHAVE"
```

### Codex

```
export WYRO_API_KEY=SUA_CHAVE

# ~/.codex/config.toml
[mcp_servers.wyro]
url = "https://wyroapi.com/mcp"
bearer_token_env_var = "WYRO_API_KEY"
```

### Cursor

```
// .cursor/mcp.json
{
  "mcpServers": {
    "wyro": {
      "url": "https://wyroapi.com/mcp",
      "headers": {
        "Authorization": "Bearer SUA_CHAVE"
      }
    }
  }
}
```

### curl

```
curl -X POST https://wyroapi.com/v1/posts \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"text":"Olá do meu agente","platforms":["linkedin"]}'
```

## Em quais redes o meu agente pode publicar?

Oito redes, uma API. Em todas você pode publicar na hora ou agendar.

- **Instagram:** Fotos, carrosséis e Reels. https://wyroapi.com/pt/instagram-api
- **TikTok:** Vídeos com legenda. https://wyroapi.com/pt/tiktok-api
- **Facebook:** Posts com texto, foto ou vídeo. https://wyroapi.com/pt/facebook-api
- **LinkedIn:** Posts com texto, imagem ou vídeo. https://wyroapi.com/pt/linkedin-api
- **X:** Posts de até 280 caracteres. https://wyroapi.com/pt/x-api
- **Threads:** Posts com texto, imagem ou vídeo. https://wyroapi.com/pt/threads-api
- **YouTube:** Vídeos com descrição. https://wyroapi.com/pt/youtube-api
- **Pinterest:** Pins com imagem ou vídeo. https://wyroapi.com/pt/pinterest-api

## Quanto custa?

- **Sandbox:** grátis, sem cadastro nem cartão. Contas simuladas de todas as redes, prévias para compartilhar, chave válida por 72 horas.
- **Builder:** USD 5 por conta por mês, no cartão. Publicação real em todas as redes, 7 dias de teste com 1 conta.
- **Acesso fundador:** USD 15 por mês, vagas limitadas, preço fixo enquanto você continuar assinando. Até 5 contas, tudo do Builder, canal direto com a equipe.

## Perguntas frequentes

### Meus usuários precisam criar conta no Wyro?

Não. Seus usuários nunca criam conta no Wyro: abrem o link de conexão e autorizam direto na rede. Para não ter surpresa: não é um white label completo. O link passa pelo domínio do Wyro, e a tela de consentimento da rede mostra o nome do app aprovado que faz a conexão, não o do seu produto.

### Quem vê o quê?

Cada cliente seu é um workspace com chave própria. Essa chave só vê e usa as contas daquele workspace: um account_id de outro workspace devolve 404. Você, com o token de partner, vê seus workspaces e as contas conectadas. Seus usuários só veem o seu produto e, no passo de conexão, a rede.

### Como meus usuários conectam as redes?

Por um botão no seu produto que abre o connect_url. Eles entram com o login oficial da rede (Instagram, TikTok, LinkedIn…) e autorizam; nunca passam a senha para você. Voltam para o seu return_url com wyro_status=connected e o account_id, ou com wyro_status=error e o motivo, por exemplo cancelled.

### O que acontece se uma conta for desconectada?

Chega o evento account.disconnected no seu webhook, e a conta aparece com status disconnected em GET /v1/accounts. Publicar nela devolve o erro account_disconnected. Você pede ao usuário para reconectar com um link novo de POST /v1/connect. Você também pode desconectá-la com DELETE /v1/accounts/{id}.

### Podemos manter a nossa interface?

Sim. Tudo é feito pela API a partir do seu backend: o botão de conectar, o editor, o calendário e os status são seus. O único passo fora do seu produto é a autorização na rede, e no final o usuário volta para o seu return_url.

### Quanto custa para um SaaS?

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 numa chamada. O token de partner é liberado por nós; enquanto isso, você pode testar a publicação de graça com uma chave de teste e contas simuladas.

### Preciso me cadastrar para testar?

Não. A chave de teste sai com um comando ou já vem dentro do prompt desta página, e dura 72 horas.

### Publica de verdade?

Com a chave de teste tudo é simulado e você recebe uma prévia. Quando você conecta sua conta, a mesma chave publica de verdade.

### Preciso de um app aprovado pela Meta ou pelo TikTok?

Não. O Wyro já tem acesso às APIs oficiais; você só conecta a sua conta.

### Que conta do Instagram eu preciso?

Uma conta profissional (Business ou Creator), como o Instagram exige.

### Funciona com Codex, Cursor ou n8n?

Sim. É um servidor MCP remoto e uma API REST: funciona com qualquer agente ou ferramenta que use MCP ou HTTP.

### Minha conta pode ser suspensa ou perder alcance por publicar com o Wyro?

Publicamos pelas APIs oficiais de cada rede, não automatizando o navegador. As regras de cada rede sobre spam e conteúdo continuam valendo.

### Quanto custa?

Testar é grátis. Publicar de verdade custa USD 5 por conta por mês.

## Para agentes

- https://wyroapi.com/pt/llms.txt
- https://wyroapi.com/AGENTS.md
- https://wyroapi.com/openapi.json
