wyro

Blog · 2026-11-16 · Markdown

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:

1. Crea el espacio del 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.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:

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:

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:

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

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.

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.

¿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 y TikTok.

Más: Página para agencias · Cómo automatizar las redes de tus clientes con IA · Publicar en varias redes a la vez.

Pruébalo sin registro
curl -X POST https://wyroapi.com/v1/sandbox