ContentFlows/Documentación

Conectar canales

ContentFlows publica en tus canales sociales automáticamente una vez que los conectas. Cada canal necesita dos valores: un token de acceso (lo que concede permiso) y un ID (la cuenta / página / canal en el que publicar). Ambos se pegan en tu panel y se guardan cifrados en AWS Secrets Manager, aislados para tu cuenta.


Dónde conectarlos

En tu panel de administración, ve a la pestaña Integrations. Verás una tarjeta para cada canal compatible con campos de entrada para cada valor que necesite esa plataforma. Rellénalos y haz clic en Save.

Configuración única por canal

Solo tienes que hacerlo una vez por plataforma. ContentFlows usa los valores guardados para todas las publicaciones futuras hasta que un token caduque o lo reemplaces.


LinkedIn

ContentFlows publica mediante la API UGC Posts de LinkedIn. Necesitas dos campos:

  • Access token (LINKEDIN_ACCESS_TOKEN) — token OAuth 2.0 con el scope w_member_social.
  • Member URN (LINKEDIN_AUTHOR_ID) — identifica bajo qué perfil o Company Page aparecen las publicaciones; empieza por urn:li:person: o urn:li:organization:.

Guía paso a paso: obtener un token y URN de LinkedIn →

Caducidad del token

Los tokens de acceso de LinkedIn caducan cada 60 days. El URN es permanente — solo necesitas regenerar el token.

Facebook

ContentFlows publica en una Facebook Page (no en un perfil personal). Necesitas dos campos:

  • Page access token (FB_PAGE_ACCESS_TOKEN) — debe incluir el scope pages_manage_posts (el que más a menudo se olvida). Cuando se deriva de un token de usuario de larga duración, los tokens de Page nunca caducan.
  • Page ID (FB_PAGE_ID) — el ID numérico de la Page (p. ej. 123456789012345), NO el nombre de usuario legible.

Debes ser administrador de la Page.

Guía paso a paso: obtener el token y el ID de la Facebook Page →

Instagram

La publicación en Instagram requiere una Professional account (Business o Creator) vinculada a una Facebook Page. Las cuentas personales de Instagram no se pueden usar para publicar mediante API.

  • Access token (IG_ACCESS_TOKEN) — opcional. Déjalo en blanco para reutilizar el token de la Facebook Page que ya configuraste.
  • Business Account ID (IG_BUSINESS_ACCOUNT_ID) — ID numérico de la Instagram Business Account vinculada a tu Facebook Page (p. ej. 17841412345678901).

Guía paso a paso: obtener el Business Account ID de Instagram →

Convertir a una Professional account

En la app de Instagram: ve a Settings → Account → Switch to Professional Account. Elige Business o Creator. Después vincúlala a tu Facebook Page en Settings → Account → Linked Accounts.

YouTube

ContentFlows usa la YouTube Data API v3 para generar metadatos (títulos, descripciones, etiquetas) para tu calendario de contenido.

  • API key (YOUTUBE_API_KEY) — de Google Cloud Console con YouTube Data API v3 habilitada.
  • Channel ID (YOUTUBE_CHANNEL_ID) — el ID único de tu canal (empieza por UC), que encontrarás en YouTube Studio → Settings → Channel → Advanced settings.

Guía paso a paso: obtener la clave de API y el Channel ID de YouTube →

Newsletter por email

ContentFlows envía newsletters a través de Amazon SES a tu lista de suscriptores por tenant. No se requiere token — se configura cuando se aprovisiona tu cuenta.

Gestionar suscriptores

La pestaña Newsletter de tu panel tiene un panel completo de suscriptores con:

  • Stats header — contadores de activos / pendientes / dados de baja / rebotados / con quejas
  • Import — subida de CSV, clave API de Mailchimp o clave API de ConvertKit
  • List view — buscar, filtrar por estado, eliminar por fila, eliminación masiva, exportación CSV
  • Re-subscribe — recuperar un contacto dado de baja o rebotado

Tu URL pública de registro es https://YOUR-SLUG.contentflows.cc/subscribe, donde YOUR-SLUG es el identificador apto para DNS definido en tu tenant (valor predeterminado: una versión depurada del nombre de tu empresa). Los registros se hacen con doble opt-in (correo de confirmación); las importaciones por CSV / Mailchimp / ConvertKit omiten la verificación porque al subirlos declaras que existe consentimiento.

Configuración DNS única (solo operador)

Para que la página de registro del subdominio resuelva para cualquier tenant, el operador de la plataforma necesita configurar una vez el DNS comodín: *.contentflows.cc como CNAME apuntando al origen que sirva la web raíz contentflows.cc. Hasta que eso esté en su sitio, la URL de reserva https://contentflows.cc/subscribe?tenant=YOUR-SLUG funciona en todos los casos.

Los enlaces de baja están firmados con HMAC-SHA256 e incrustados en cada newsletter enviada (se incluye el encabezado RFC-8058 List-Unsubscribe-Post para la compatibilidad de un clic en Gmail / Yahoo).

Dominio de envío (DKIM + SPF + DMARC)

Por defecto, los emails salen de noreply@contentflows.cc. Para una entregabilidad mucho mejor, autentica tu propio dominio para que las newsletters salgan desde newsletter@your-business.com.

Abre la pestaña Brand, busca la tarjeta Sending domain, escribe tu dominio, copia los 5 registros DNS que muestra, pégalos en tu proveedor DNS y haz clic en Verify. La tarjeta consulta SES durante 10 minutos hasta que se validan DKIM + DMARC.

Cuáles son los 5 registros

  • 3 × CNAME para la firma DKIM (tokens generados por SES)
  • 1 × TXT en el dominio raíz para SPF (v=spf1 include:amazonses.com -all)
  • 1 × TXT en _dmarc.your-domain.com para DMARC (v=DMARC1; p=none; rua=mailto:dmarc@your-domain.com)

Cómo se almacenan las credenciales

Todos los campos de todas las plataformas de tu tenant se guardan como un único blob JSON cifrado en AWS Secrets Manager en contentflows/tenants/YOUR_TENANT_ID/social-tokens. Los secretos nunca se registran, nunca se muestran de nuevo después de guardarlos y quedan aislados de tu cuenta. ContentFlows nunca almacena la contraseña de tus redes sociales.

Sustituir un valor

Para actualizar un token o un ID (p. ej., tras la caducidad del token), ve a la pestaña Integrations, pega el nuevo valor o valores en los campos correspondientes y haz clic en Save. Solo se actualizan los campos que cambies — el resto del blob permanece intacto.

Qué ocurre después de conectar

Una vez conectado un canal, ContentFlows publica automáticamente el contenido aprobado según tu calendario. Revisa y aprueba cada pieza desde la pestaña Content Queue antes de que se publique.

Canales compatibles

  • LinkedIn — publicaciones personales o de Company Page (UGC Posts API)
  • Facebook — publicaciones en Page (Graph API)
  • Instagram — publicaciones en el feed de cuentas Professional (Graph API)
  • YouTube — consultas de metadatos (Data API v3)
  • Newsletter por email — a través de Amazon SES (configurado automáticamente)

Siguientes pasos