wyro

Caso de cliente

UP Creative: cada empresa conecta as suas redes e publica pelo calendário

A UP Creative é uma plataforma de marketing: conteúdo, desempenho de anúncios da Meta, calendário e uma assistente de IA, a euGenia. Em novembro de 2026 integrou a Wyro como partner para que as empresas clientes conectem as suas redes e agendem posts sem sair da UP Creative.

Cliente
UP Creative
O que é
Plataforma de marketing com assistente de IA
Integração
API de partner
Desde
Novembro de 2026
Redes
Instagram, TikTok, LinkedIn e mais

Para ficar claro: a UP Creative e a Wyro são da mesma equipe. Foi o primeiro partner, e cada melhoria da API de partner é testada lá primeiro.

O desafio

A solução

Um espaço de trabalho por empresa

Quando uma empresa começa a usar as redes na UP Creative, o espaço de trabalho dela na Wyro é criado com o id da empresa como external_id. É automático e idempotente.

Conexões com a marca dela

Na página Conexões da UP Creative, a empresa toca em «Conectar Instagram» (ou TikTok, LinkedIn…). A página de conexão mostra o nome, o logo e a cor da UP Creative e, no fim, volta para Conexões.

O calendário publica

Quando uma peça do calendário é agendada, o criativo é enviado ao armazenamento da Wyro e o post é criado em nome da empresa com o token de partner e X-Wyro-External-Id.

Um único webhook

Um webhook de partner recebe os eventos de todas as empresas, cada um com o seu external_id: posts publicados ou com falha e contas conectadas ou desconectadas.

Como foi construído

Quatro chamadas a partir do backend da UP Creative. O token de partner nunca chega ao navegador, e a UP Creative não guarda uma chave por empresa: basta o token e X-Wyro-External-Id.

  1. 1. Criar o espaço de trabalho da empresa

    Com o token de partner. Se já existe para esse external_id, devolve o mesmo.

    curl -X POST https://wyroapi.com/v1/partner/workspaces \
      -H "Authorization: Bearer $PARTNER_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{"external_id":"empresa-123","name":"Empresa 123"}'
  2. 2. Pedir o link de conexão

    Em nome da empresa. return_url é a página Conexões: a empresa volta para lá com o resultado.

    curl -X POST https://wyroapi.com/v1/connect \
      -H "Authorization: Bearer $PARTNER_TOKEN" \
      -H "X-Wyro-External-Id: empresa-123" \
      -H "Content-Type: application/json" \
      -d '{"platform":"instagram","return_url":"https://app.sua-plataforma.com/conexoes"}'
  3. 3. Enviar o criativo

    O calendário envia a imagem ou o vídeo e recebe uma URL para o post. Arquivos de mais de 4 MB usam um envio direto com um token temporário.

    curl -X POST "https://wyroapi.com/v1/media?filename=peca.jpg" \
      -H "Authorization: Bearer $PARTNER_TOKEN" \
      -H "X-Wyro-External-Id: empresa-123" \
      -H "Content-Type: image/jpeg" \
      --data-binary @peca.jpg
  4. 4. Agendar o post

    Com as contas da empresa e a data do calendário. O resultado chega ao webhook.

    curl -X POST https://wyroapi.com/v1/posts \
      -H "Authorization: Bearer $PARTNER_TOKEN" \
      -H "X-Wyro-External-Id: empresa-123" \
      -H "Content-Type: application/json" \
      -d '{"text":"Nova coleção","account_ids":["acc_…"],"media":[{"url":"https://…/peca.jpg"}],"scheduled_at":"2026-12-01T10:00:00-03:00"}'

O que usa

POST /v1/partner/workspacesUm espaço de trabalho por empresa, com o seu external_id.
POST /v1/connectLink de conexão com return_url para a página Conexões.
POST /v1/mediaEnvia o criativo para o armazenamento de mídia.
POST /v1/postsCria e agenda o post nas contas da empresa.
Webhook de partnerUma URL para os eventos de todas as empresas.

O resultado

O que a empresa vê ao conectar

A página de conexão é da UP Creative: o nome, o logo e a cor dela. A tela de autorização da rede é da própria rede e mostra o nome do app aprovado que faz a conexão.

Você tem uma plataforma ou um SaaS?

O mesmo fluxo serve para qualquer produto que queira que os seus clientes publiquem nas redes. Crie a sua conta de desenvolvedor e teste com clientes simulados.