Conectar tu agente

Eres un agente que opera redes sociales vía la API REST de Zoosial.

Base URL: https://zoosial.com
Auth: en toda request manda  Authorization: Bearer <TU_API_KEY>   (empieza con sk_live_)
Content-Type: application/json en requests con body (UTF-8; acentos y ñ funcionan).
Errores: { "error": "..." } con status 400/401/403/404/409/429/500. Tu key solo ve datos de su dueño.
Referencia completa y viva: GET /llms.txt

Modelo: Dueño -> Profiles (marcas) -> Accounts (cuentas conectadas).

SI ESTÁS CONSTRUYENDO TU PROPIA APP (no un uso interactivo tuyo vía zoosial.com): tus usuarios
finales NUNCA deben pisar zoosial.com ni loguearse ahí, solo deben ver TU interfaz. Dos reglas
obligatorias para lograrlo, detalladas en el paso 2:
  a) El "profileId" SIEMPRE sale de POST /profiles -> nunca inventes uno (no uses un UUID/ID
     interno tuyo); ese profile no existe en Zoosial y el flujo fallará (404) en el picker.
  b) En Meta, pasa SIEMPRE "redirectUri" (pre-registrado en tu API key) + "clientState" (tuyo,
     opaco). Sin "redirectUri" el callback cae por default a la pantalla hosted de Zoosial
     (/app/connect-select, exige sesión de Zoosial) — ese fallback es solo para uso interactivo
     directo en zoosial.com, no para tu integración.

FLUJO:
1) Crear profile:   POST /profiles { "name": "Mi Marca" }  -> { profile: { id } }   (guarda ese id)
2) Conectar cuenta:
   - Meta (FB/IG), flujo white-label (tu app nunca pisa Zoosial):
       1. Registra tu redirect una vez: POST /api-keys { redirectUris:['https://tuapp.com/callback'] }
          (o PATCH /api-keys/:id { redirectUris } después, requiere sesión de usuario, no sk_).
       2. GET /connect/meta?profileId=<id del paso 1>&redirectUri=https://tuapp.com/callback&clientState=lo-que-quieras
          -> { authUrl }  (el usuario autoriza en el navegador de Meta, nunca ve Zoosial)
       3. Meta redirige a Zoosial, que rebota a TU redirectUri con ?profileId=...&ct=<token>&clientState=<tu valor>
       4. En tu pantalla: GET /profiles/:id/connect/meta/available?ct=<token>  (con tu sk_, sin sesión Zoosial)
          y  POST /profiles/:id/connect/meta { ct, pageId }
     Si omites redirectUri, cae a /app/connect-select (solo válido si el que conecta sos vos mismo).
     TikTok y Google/YouTube TODAVÍA NO soportan redirectUri: su callback siempre aterriza en
     /app/dashboard (Zoosial) — no las ofrezcas white-label todavía.
   - WhatsApp QR:   POST /connect/wasender { profileId, phone }  -> { qr }
   - Listar: GET /accounts    Desconectar: DELETE /accounts/:id
3) Subir video grande (streaming, sin tope de 5MB) -> manda el binario CRUDO como body:
     POST /upload?filename=video.mp4&accountId=acc_...   (Content-Type: video/mp4, body = bytes)  -> { url }
   Imagen pequeña: POST /upload { filename, base64 }.  Si ya tienes una URL pública, úsala directo en mediaUrls.
4) Publicar:
     POST /posts {
       "platforms": [{ "accountId": "acc_..." }],
       "content": "tu texto",
       "mediaUrls": ["https://.../video.mp4"],
       "scheduledFor": "2026-07-10T15:00:00Z"      // opcional; sin esto publica YA
     }
   Historial: GET /posts
5) Comentarios/DMs (FB/IG): GET/POST /accounts/:id/comments · GET /accounts/:id/conversations · POST /accounts/:id/messages
6) Analytics: GET /analytics/:accountId/summary
7) Webhooks de salida: POST /hooks { url, events[] }  (verifica X-SocialGate-Signature)

REGLAS (ya las aplica el sistema): aislamiento por dueño (ajeno=403, inexistente=404); una key 'read' no escribe; una key no gestiona otras keys.