wyro

Blog · 2026-11-17 · Markdown

Cómo agregar publicación en redes sociales a tu SaaS sin pasar por la app review

Tarde o temprano, los usuarios de un generador de contenido, un CRM o una herramienta para comercios piden lo mismo: «¿puedo publicar esto directo en Instagram?». En el roadmap parece una tarea chica: un botón y una llamada a una API.

No lo es. Esta guía explica qué hay detrás, por qué lo difícil no es el código y cómo se resuelve con la API de partner de wyro API. También dice qué no resuelve.

Lo que implica construirlo directo

Para publicar en nombre de tus usuarios en una red social, tu producto necesita una app de desarrollador aprobada por esa red. Eso significa, por cada una:

Y después empieza el trabajo de verdad, que es mantenerla:

Si tu producto solo necesita una red y tienes tiempo para su revisión, integrar directo tiene sentido: no dependes de nadie. El problema aparece cuando tus usuarios quieren tres, cinco u ocho redes.

La alternativa: una API con la app ya aprobada

Una API de publicación como wyro API ya pasó esas revisiones. Tus usuarios autorizan la conexión a través de esa app aprobada, así que tu producto no necesita registrar una propia en cada red ni pasar ninguna app review. Tú hablas con una sola API para las ocho redes: Instagram, Facebook, TikTok, LinkedIn, X, Threads, YouTube y Pinterest.

Conviene ser claro con lo que eso implica, porque no es magia:

Cómo queda el flujo en tu producto

La API de partner tiene cuatro pasos. Todos se hacen desde tu backend.

1. Un workspace por cliente

Cada cliente tuyo es un workspace con su propia clave y sus propias cuentas conectadas. Lo creas con tu token de partner:

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-saas.com/webhooks/wyro"}'

external_id es el id del cliente en tu sistema, y la llamada es idempotente: si la repites, recibes el mismo workspace. La primera respuesta trae la api_key del workspace y el webhook_secret; guárdalos cifrados, porque no se vuelven a mostrar. Con la clave de un workspace solo se ven sus cuentas: un account_id de otro devuelve 404.

2. Un link de conexión

Cuando el usuario toca «Conectar Instagram» en tu producto, pides un link con la clave de su workspace:

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.tu-saas.com/redes/conectada"}'

La respuesta trae un connect_url firmado que vence en 24 horas. No se puede modificar para apuntarlo a otro workspace o a otra red, y return_url tiene que ser https.

3. El usuario autoriza y vuelve

Tu usuario abre el link, va directo a la autorización oficial de la red, sin login en wyro API, y vuelve a tu return_url con el resultado en la dirección:

Guardas el account_id junto al cliente. Para confirmarlo del lado del servidor, GET /v1/accounts lista las cuentas del workspace y además te llega el evento account.connected.

4. Publicar con account_ids

curl -X POST https://wyroapi.com/v1/posts \
  -H "Authorization: Bearer $WORKSPACE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Nuevo lanzamiento","account_ids":["acc_..."],"media":[{"url":"https://tu-saas.com/img/lanzamiento.jpg"}],"scheduled_at":"2026-12-01T10:00:00-03:00"}'

Sin scheduled_at, el post sale en el momento. La misma llamada sirve para cualquiera de las ocho redes.

Detalles que conviene diseñar desde el principio

Webhooks, no polling. En la webhook_url recibes post.published, post.partial y post.failed cuando un post llega a su estado final, con el link publicado o el error de cada red, y account.connected y account.disconnected. Cada entrega viene firmada (X-Wyro-Signature, un HMAC-SHA256 de <timestamp>.<cuerpo> con tu webhook_secret): verifícala y rechaza los timestamps de más de 5 minutos. Hoy cada evento se intenta entregar dos veces, sin reintentos posteriores, así que responde rápido con un 2xx, procesa en segundo plano y, si un estado es crítico, confírmalo con GET /v1/posts/{id}.

Desconexiones. Si un usuario revoca el acceso desde la red, te llega account.disconnected, la cuenta queda en disconnected y publicar en ella devuelve account_disconnected. Lo razonable es mostrarle un botón «Volver a conectar» que pida un link nuevo.

Validación antes de publicar. Cada red tiene sus límites: 2 200 caracteres en Instagram, 280 en X, video obligatorio en TikTok y YouTube. La API valida lo mismo y cada error trae un código, el motivo y cómo arreglarlo, en español, inglés o portugués, así puedes mostrárselo a tu usuario.

Claves solo en el backend. El token de partner y las claves nunca van al navegador. POST /v1/partner/workspaces/{id}/key rota una clave al instante, y DELETE /v1/partner/workspaces/{id} da de baja a un cliente: desconecta sus cuentas y revoca la clave.

Lo que todavía no hace

Para que no lo descubras a mitad de la integración: hoy wyro API publica y programa, pero no trae métricas de las publicaciones (insights), ni anuncios, ni mensajes directos automáticos.

Cuánto cuesta y cómo empezar

El precio público es USD 5 por cuenta conectada al mes, sin cargo por usuario ni por post. Si tus usuarios van a conectar muchas cuentas, las condiciones por volumen se conversan. El token de partner no se genera desde el panel: lo habilitamos nosotros después de una llamada corta, que puedes pedir desde la página para SaaS.

Mientras tanto, puedes probar la publicación gratis y sin registro con una clave de prueba, con cuentas simuladas de las ocho redes.

Más: Documentación: empezar · Cuentas y conexión · API de partner para agencias y SaaS · Publicar sin aprobaciones de Meta ni TikTok.

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