# API de redes sociales para agencias y SaaS (un espacio por cliente, con tu marca adelante)

Si tienes una agencia o un producto que publica en redes por cuenta de otros, el problema no es escribir el post. Es todo lo que lo rodea: que cada cliente conecte sus cuentas sin darte la contraseña, que las cuentas de un cliente no se mezclen con las de otro, y enterarte de si el post salió o falló sin revisar red por red.

Construirlo por tu cuenta implica registrar una app en cada red, pasar sus revisiones y mantener ocho integraciones distintas. Esta guía muestra cómo queda resuelto con la API de partner de wyro API: tu sistema es lo que ven tus clientes y wyro API trabaja por detrás.

## El modelo: un espacio por cliente

Cada cliente tuyo tiene su propio espacio de trabajo (*workspace*), con su propia clave. Las cuentas que se conectan con esa clave solo existen en ese espacio: al listar las cuentas con la clave del cliente A nunca aparecen las del cliente B, y una cuenta no se puede reasignar de un espacio a otro.

Tú guardas dos cosas, siempre en tu backend:

- Un **token de partner**, que solo sirve para crear y administrar espacios.
- La **clave de cada cliente**, que se usa para todo lo demás: conectar redes, publicar y consultar estados.

## 1. Crea el espacio del 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.tu-agencia.com/webhooks/redes"}'
```

`external_id` es el identificador del cliente en tu sistema. La llamada es idempotente: si repites el mismo `external_id`, recibes el espacio que ya existía en vez de uno duplicado.

La primera respuesta trae `workspace_id`, la `api_key` del cliente y un `webhook_secret`. Guárdalos en ese momento, porque no se vuelven a mostrar. Si alguna vez necesitas cambiar la clave, `POST /v1/partner/workspaces/{id}/key` genera una nueva y la anterior deja de funcionar al instante.

## 2. Mándale un link de conexión

Con la clave del cliente, pides un link para la red que quiere conectar:

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

La respuesta trae un `connect_url`. Lo muestras como un botón en tu producto o se lo mandas al cliente. Qué pasa cuando lo abre:

1. No tiene que crear una cuenta ni iniciar sesión en wyro API.
2. Va directo a la pantalla de autorización oficial de la red (la de Instagram, la de LinkedIn, la que corresponda). Nunca te da su contraseña.
3. Al terminar vuelve a tu `return_url`, con el resultado en la dirección: `wyro_status=connected` junto con el `account_id`, la red y el nombre de usuario, o `wyro_status=error` con el motivo (por ejemplo, `cancelled`).

El link va firmado y vence a las 24 horas: no se puede modificar para apuntarlo a otro cliente o a otra red. `return_url` tiene que ser `https`.

## 3. Publica con account_ids

Con la clave del cliente, `GET /v1/accounts` devuelve sus cuentas conectadas. Para publicar, indicas las cuentas exactas:

```bash
curl -X POST https://wyroapi.com/v1/posts \
  -H "Authorization: Bearer $CLAVE_DEL_CLIENTE" \
  -H "Content-Type: application/json" \
  -d '{"text":"Nueva colección","account_ids":["acc_..."],"media":[{"url":"https://tu-servidor.com/foto.jpg"}],"scheduled_at":"2026-11-20T10:00:00-03:00"}'
```

Sin `scheduled_at`, el post sale en el momento. Con `account_ids` eliges la cuenta puntual aunque el cliente tenga varias de la misma red.

Si el que publica es un agente de IA, cada espacio trae además su propia dirección de servidor MCP (`mcp_url`, en la respuesta de creación). El agente que trabaja para un cliente solo ve las cuentas de ese cliente.

## 4. Vistas previas para que el cliente apruebe

Para mostrar un post antes de que exista en la cuenta real, usa una clave de prueba: `POST https://wyroapi.com/v1/sandbox` devuelve una sin registro, válida por 72 horas, con cuentas simuladas de las 8 redes. Cada post que creas con ella devuelve un `preview_url`: un link público con el aspecto del post en cada red, que puedes mandarle al cliente. Cuando aprueba, publicas lo mismo con la clave de su espacio.

Los espacios de partner no tienen cuentas simuladas: ahí todo lo que publicas es real.

## 5. Recibe el estado por webhook

En la `webhook_url` que indicaste al crear el espacio (o que fijas después con `PUT /v1/webhooks`) recibes estos eventos:

- `post.published`, `post.partial` y `post.failed`, cuando un post llega a su estado final. Cada red viene con su estado, el link al post publicado o el error.
- `account.connected` y `account.disconnected`.

Cada evento incluye tu `external_id`, así sabes de qué cliente es sin buscarlo. Las entregas van firmadas: llegan los headers `X-Wyro-Timestamp` y `X-Wyro-Signature`, y la firma es el HMAC-SHA256 del texto `<timestamp>.<cuerpo>` con tu `webhook_secret`. Verifícala y rechaza los timestamps de más de 5 minutos.

Un detalle para diseñar bien: responde rápido con un 2xx, procesa en segundo plano y, si un estado te importa mucho, confírmalo con `GET /v1/posts/{id}`.

## Cuando un cliente se va

- `DELETE /v1/posts/{id}` cancela un post programado.
- `DELETE /v1/accounts/{id}` desconecta una cuenta.
- `DELETE /v1/partner/workspaces/{id}` da de baja el espacio completo: desconecta sus cuentas y revoca la clave. El historial queda.

## Cómo se accede y cuánto cuesta

El token de partner no se genera desde el panel: lo habilitamos nosotros para cada agencia o producto. El precio público de wyro API es USD 5 por cuenta conectada al mes; para agencias y productos con muchas cuentas, las condiciones se conversan según tu volumen. Para pedirlo, [escríbenos desde la página para agencias](https://wyroapi.com/agencias).

Mientras tanto puedes probar toda la parte de publicación con una clave de prueba, gratis y sin registro.

## Preguntas frecuentes

**¿Mis clientes tienen que crear una cuenta en wyro API?** No. Abren el link de conexión y autorizan directamente en la red. El link pasa por el dominio de wyro API antes de llegar a la pantalla oficial de la red, y después vuelven a tu producto.

**¿Tengo que registrar apps en Meta, TikTok o LinkedIn?** No. Las cuentas se conectan a través del acceso que ya tiene wyro API. Más detalle en [Publicar sin aprobaciones](https://wyroapi.com/sin-aprobaciones).

**¿Qué redes cubre?** Instagram, Facebook, TikTok, LinkedIn, X, Threads, YouTube y Pinterest, con la misma llamada. Cada red tiene su página, por ejemplo [Instagram](https://wyroapi.com/instagram-api) y [TikTok](https://wyroapi.com/tiktok-api).

Más: [Página para agencias](https://wyroapi.com/agencias) · [Cómo automatizar las redes de tus clientes con IA](https://wyroapi.com/blog/agencias-redes-sociales-con-ia) · [Publicar en varias redes a la vez](https://wyroapi.com/docs/varias-redes).

---
Publicado el 2026-11-16 en https://wyroapi.com/blog/api-redes-sociales-marca-blanca-agencias
