Módulo RRSS

Devuelve la estrategia de la empresa activa. data: null si no existe.

curl -s "https://api.growth54.com/api/rrss/estrategia" -H "Authorization: Bearer <token>" | jq

Crea o actualiza la estrategia. Todos los campos son opcionales.

curl -s -X PUT "https://api.growth54.com/api/rrss/estrategia" \
  -H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
  -d '{
    "objetivo":      "Generar visibilidad y captar leads",
    "audiencia":     "Dueños de PYME, 28-45 años, LATAM",
    "tono":          "Profesional pero cercano",
    "frecuencia":    "6 posts semanales",
    "cta_principal": "Agendar llamada de diagnóstico gratuita",
    "embudo":        "RRSS → Website → Lead Magnet → CRM",
    "plataformas":   ["Facebook","Instagram","LinkedIn"],
    "pilares":       ["Educación","Casos de éxito","Detrás de cámaras"],
    "kpis":          ["Alcance orgánico","Engagement","Leads generados"]
  }' | jq

Lista ideas. Filtros opcionales: ?status=aprobado  ·  ?platform=Instagram

curl -s "https://api.growth54.com/api/rrss/ideas?status=aprobado" -H "Authorization: Bearer <token>" | jq

Crea una idea manualmente. topic es obligatorio.

curl -s -X POST "https://api.growth54.com/api/rrss/ideas" \
  -H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
  -d '{
    "topic":           "5 errores que cometen las PYMEs en Instagram",
    "platform":        "Instagram",
    "keyword":         "marketing PYME",
    "fecha_propuesta": "2026-05-15"
  }' | jq

Cambia el estado. Valores: idea · aprobado · descartado

curl -s -X PUT "https://api.growth54.com/api/rrss/ideas/1/status" \
  -H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
  -d '{"status": "aprobado"}' | jq

Elimina una idea. Solo puede eliminar ideas de su empresa activa.

Lista posts. Filtros opcionales: ?status=borrador  ·  ?platform=LinkedIn

curl -s "https://api.growth54.com/api/rrss/posts" -H "Authorization: Bearer <token>" | jq

Crea un post manualmente. tema es obligatorio.
New Acepta fecha_programada y status opcionales, para crear el post ya con fecha o directamente programado (lo usa el composer del calendario). Si se omiten, el comportamiento es el de siempre: borrador sin fecha.
— status admite borrador o programado.
— Con programado la fecha es obligatoria y debe ser futura, o responde 422.
— fecha_programada se interpreta en la zona horaria de la empresa, igual que en /schedule, y se guarda en UTC.

curl -s -X POST "https://api.growth54.com/api/rrss/posts" \
  -H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
  -d '{
    "tema":             "5 errores que cometen las PYMEs en Instagram",
    "platform":         "Instagram",
    "copy_instagram":   "¿Tu negocio está en Instagram pero no consigue resultados?\n...",
    "copy_facebook":    null,
    "copy_linkedin":    null,
    "cta":              "Escríbenos para una auditoría gratuita",
    "hooks":            ["¿Tu negocio está en IG pero no consigue resultados?"],
    "fecha_programada": "2026-08-05T14:30:00",
    "status":           "programado"
  }' | jq

Edita un post existente. Todos los campos son opcionales; solo se escribe lo que mandes.
New Ahora acepta también fecha_programada y status, con las mismas reglas que POST: así el panel guarda contenido, fecha y estado en una sola llamada.
— Mandar fecha_programada: null borra la fecha; omitir la clave la deja como estaba.
— Campos editables: tema, platform, copy_instagram, copy_facebook, copy_linkedin, hook, cta, imagen_url.

curl -s -X PUT "https://api.growth54.com/api/rrss/posts/1" \
  -H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
  -d '{
    "tema":             "5 errores que cometen las PYMEs en Instagram",
    "copy_instagram":   "Texto corregido a mano...",
    "fecha_programada": "2026-08-05T14:30:00",
    "status":           "programado"
  }' | jq

Cambia el estado del post.
— Al aprobar → guarda approved_by_user_id automáticamente.
— Al publicar → guarda fecha_publicada con la fecha actual.

curl -s -X PUT "https://api.growth54.com/api/rrss/posts/1/status" \
  -H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
  -d '{"status": "aprobado"}' | jq

Programa el post para una fecha futura. Cambia status a programado. La fecha debe ser futura. New La hora se interpreta en la zona horaria de la empresa (companies.timezone): p. ej. "2026-05-20T10:00:00" con empresa en Nicaragua = 10:00 hora de Nicaragua. Internamente se guarda en UTC. Si la empresa no tiene zona configurada, se asume UTC. Verifica que la empresa tenga su zona horaria establecida en Editar datos de la empresa → País / Zona horaria; sin ella, las horas se programarán en UTC.

curl -s -X PUT "https://api.growth54.com/api/rrss/posts/1/schedule" \
  -H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
  -d '{"fecha_programada": "2026-05-20T10:00:00"}' | jq

Resumen por plataforma. Filtros: ?platform=Instagram · ?from=2026-05-01 · ?to=2026-05-31

curl -s "https://api.growth54.com/api/rrss/metricas?from=2026-05-01&to=2026-05-31" \
  -H "Authorization: Bearer <token>" | jq

// Respuesta:
{
  "data": [{
    "platform":            "Instagram",
    "alcance_total":       12430,
    "impresiones_total":   38000,
    "engagement_total":    584,
    "engagement_rate_avg": 4.7,
    "clics_total":         384,
    "leads_total":         17
  }]
}

Top 10 posts publicados ordenados por engagement.

curl -s "https://api.growth54.com/api/rrss/metricas/top-posts" -H "Authorization: Bearer <token>" | jq

Dispara el agente Strategist AI. Key: rrss_strategist

curl -s -X POST "https://api.growth54.com/api/rrss/run-strategist" -H "Authorization: Bearer <token>" | jq

Dispara el agente Content AI. Key: rrss_content_ai. El campo mode controla si genera ideas o un post específico.

// Generar ideas:
curl -s -X POST "https://api.growth54.com/api/rrss/run-content-ai" \
  -H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
  -d '{"mode": "ideas", "idea_id": null}' | jq

// Generar post desde una idea aprobada:
curl -s -X POST "https://api.growth54.com/api/rrss/run-content-ai" \
  -H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
  -d '{"mode": "post", "idea_id": 5}' | jq

Dispara el agente Analytics AI. Key: rrss_analytics. No requiere body.

curl -s -X POST "https://api.growth54.com/api/rrss/run-analytics" -H "Authorization: Bearer <token>" | jq

Lista los tokens configurados para la empresa activa. El campo access_token no se devuelve por seguridad.

curl -s "https://api.growth54.com/api/rrss/tokens" -H "Authorization: Bearer <token>" | jq

Crea o actualiza el token de una plataforma (upsert por platform). Si access_token se omite en una actualización, el token existente no cambia.

curl -s -X PUT "https://api.growth54.com/api/rrss/tokens" \
  -H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
  -d '{
    "platform":               "Instagram",
    "access_token":           "EAAxxxx...",
    "page_id":                "123456789",
    "instagram_account_id":   "17841400000000000",
    "label":                  "System User — Cliente XYZ",
    "expires_at":             "2027-01-01"
  }' | jq

Elimina un token. Solo puede eliminar tokens de su empresa activa.

El panel llama este endpoint con el company_id. Laravel construye la URL de autorización de Meta y redirige al usuario al login de Facebook. El estado OAuth incluye el company_id encriptado en Base64 para recuperarlo en el callback.

// El frontend abre esta URL en el mismo tab o popup:
window.location.href = "https://api.growth54.com/api/oauth/meta/redirect?company_id=3"

// Parámetros enviados a Meta:
scope = pages_manage_posts, pages_read_engagement,
        instagram_basic, instagram_content_publish
response_type = code
state = base64({ company_id: 3, csrf: "aleatorio" })

Meta redirige aquí con el code de autorización. Laravel intercambia el code por un token de corta duración, lo convierte a token de 60 días, obtiene las páginas de Facebook y la cuenta de Instagram vinculada, y guarda todo en company_social_tokens. Al terminar redirige al panel.

Elimina los tokens de Facebook e Instagram de la empresa. El botón "Desconectar" del panel llama este endpoint.

curl -s -X POST "https://api.growth54.com/api/oauth/meta/disconnect" \
  -H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
  -d '{"company_id": 3}' | jq

// Respuesta:
{ "ok": true, "deleted": 2 }

Canales activos con handle, objetivo, frecuencia, formatos, rol en el embudo y la configuración de imagen que eligió el cliente para esa red (image_config).

{ "data": [{
  "id": 12, "platform": "Facebook", "handle": "...", "objective": "...",
  "content_formats": ["post","carrusel"],
  "image_config": {
    "img_estilo":     "realista",           // realista | humanos | 3d | animado | minimalista | artistico
    "img_formato":    "horizontal",         // cuadrada (1:1) | vertical (4:5) | horizontal (16:9)
    "img_texto_modo": "titulo_subtitulo"    // sin_texto | solo_titulo | titulo_subtitulo | titulo_sub_detalles | libre
  }
}]}

Estrategia vigente. Devuelve null si no existe.

Ideas con status aprobado, listas para convertirse en posts.

Posts con status aprobado o programado.

Posts programado cuya fecha_programada ya pasó. Cada post incluye ya el token de Meta de la empresa (page_id, instagram_account_id, access_token) — el Distribution AI publica con eso, no hay que pedirlo aparte.

New Aquí también aparecen los posts creados a mano desde el calendario del panel, no solo los del Content AI. Salen con la misma forma (status: programado, fecha en UTC, platform, copy de esa red e imagen_url), así que el Distribution AI no necesita ningún cambio: los recoge y publica igual.

{ "data": [{
  "id": 123, "platform": "instagram", "copy_instagram": "...", "imagen_url": "...",
  "page_id": "1713965015486703", "instagram_account_id": "17841...", "access_token": "EAAxxxxx..."
}]}

Resuelve la empresa por page_id de Meta (Community AI). Cuando Meta envía un webhook trae el page_id pero no el company_id; esto lo traduce. Devuelve 404 si el page_id no está registrado (el agente NO atiende — sin fallback a una empresa fija). Funciona para cualquier empresa con su página conectada.

{ "company_id": 24, "fb_access_token": "EAAxxxxx...", "ig_user_id": "17841402206774619" }

Guarda o actualiza la estrategia. Incluir company_id.

{ "company_id": 3, "objetivo": "...", "audiencia": "...", "tono": "...",
  "frecuencia": "...", "cta_principal": "...", "embudo": "...",
  "plataformas": ["Instagram","LinkedIn"],
  "pilares": ["Educación","Casos de éxito"],
  "kpis": ["Alcance","Engagement"] }

Guarda ideas en bulk. Respuesta: {"ok": true, "created": N}

{ "company_id": 3, "ideas": [
  { "topic": "5 errores que cometen las PYMEs", "platform": "Instagram", "keyword": "marketing PYME" },
  { "topic": "Cómo automatizar con IA", "platform": "LinkedIn" }
]}

Guarda posts como borradores en bulk. La imagen generada va en imagen_url (URL pública), y opcionalmente el prompt usado en imagen_prompt.

{ "company_id": 3, "posts": [{
  "tema": "5 errores que cometen las PYMEs",
  "platform": "Instagram", "social_idea_id": 5,
  "copy_instagram": "¿Tu negocio está en Instagram pero no consigue resultados?\n...",
  "copy_facebook": "Si tu página de Facebook publica pero no genera conversaciones...",
  "copy_linkedin": "En 2026, producir contenido sin estrategia es el error más común...",
  "hooks": ["¿Tu negocio está en Instagram pero no consigue resultados?"],
  "cta": "Comenta o envíame un DM para una auditoría gratuita.",
  "imagen_url": "https://.../imagen-optimizada.jpg",
  "imagen_prompt": "Minimalist flat design 5 warning signs PYME"
}]}

Marca un post como publicado. Guarda fecha_publicada con la fecha actual. Usar por el agente Publisher tras publicar en la red social.

curl -s -X POST "https://api.growth54.com/api/agent/rrss/posts/7/mark-published" \
  -H "Authorization: Bearer <AGENT_TOKEN>" | jq

Elimina un post. Útil para limpiar borradores duplicados generados en pruebas. Respuesta: {"ok": true}

curl -s -X DELETE "https://api.growth54.com/api/agent/rrss/posts/7" \
  -H "Authorization: Bearer <AGENT_TOKEN>" | jq

Guarda métricas. social_post_id es opcional.

{ "company_id": 3, "metricas": [{
  "platform": "Instagram", "period_start": "2026-05-01", "period_end": "2026-05-31",
  "social_post_id": 12, "alcance": 3420, "impresiones": 10500,
  "engagement_count": 212, "engagement_rate": 6.2, "clics": 89, "leads": 4
}]}

WhatsApp Engine multi-empresa. Resuelve la empresa por el phone_number_id que manda Meta y devuelve toda la config del bot (token, prompt, catálogo, FAQs, mensajes, palabras de lead, correos del vendedor). 404 si el número no está registrado → el agente NO atiende (sin fallback). La config vive en wa_configs (1 fila por empresa); no existe ni se necesita wa_empresas. Las conversaciones se guardan luego con POST /api/agent/whatsapp/inbound.

{ "company_id": 20, "nombre": "Cratingexpress",
  "phone_number_id": "1083260611538246", "wa_access_token": "EAAxxxxx...",
  "system_prompt": "...", "catalogo": "...", "faqs": "...",
  "msg_bienvenida": "...", "msg_followup_24h": "...", "msg_followup_72h": "...",
  "palabras_lead_caliente": ["cotizar","precio"], "emails_vendedor": ["ventas@empresa.com"] }