ContentFlows/Documentazione

Connessione dei canali

ContentFlows pubblica automaticamente sui tuoi canali social una volta collegati. Ogni canale richiede due valori: un token di accesso (ciò che concede l'autorizzazione) e un ID (l'account / pagina / canale su cui pubblicare). Entrambi vengono incollati nella tua dashboard e memorizzati in modo cifrato in AWS Secrets Manager, isolati sul tuo account.


Dove collegare

Nella tua dashboard admin, vai alla scheda Integrations. Vedrai una card per ciascun canale supportato con campi di input per ogni valore richiesto dalla piattaforma. Compilali e fai clic su Save.

Configurazione una tantum per canale

Devi farlo solo una volta per piattaforma. ContentFlows utilizza i valori salvati per tutte le pubblicazioni future finché un token non scade o non lo sostituisci.


LinkedIn

ContentFlows pubblica tramite l'API LinkedIn UGC Posts. Ti servono due campi:

  • Token di accesso (LINKEDIN_ACCESS_TOKEN) — token OAuth 2.0 con scope w_member_social.
  • Member URN (LINKEDIN_AUTHOR_ID) — identifica quale profilo o Company Page mostra i post; inizia con urn:li:person: o urn:li:organization:.

Guida passo per passo: ottenere un token LinkedIn e l'URN →

Scadenza del token

I token di accesso LinkedIn scadono ogni 60 days. L'URN è permanente — devi solo rigenerare il token.

Facebook

ContentFlows pubblica su una Facebook Page (non su un profilo personale). Ti servono due campi:

  • Token di accesso della Page (FB_PAGE_ACCESS_TOKEN) — deve includere lo scope pages_manage_posts (quello che si dimentica più spesso). Se derivato da un token utente long-lived, i token Page non scadono mai.
  • Page ID (FB_PAGE_ID) — l'ID numerico della Page (ad esempio 123456789012345), NON il nome utente leggibile.

Devi essere Admin della Page.

Guida passo per passo: ottenere il token e l'ID della Facebook Page →

Instagram

La pubblicazione su Instagram richiede un account Professional (Business o Creator) collegato a una Facebook Page. Gli account Instagram personali non possono essere usati per la pubblicazione via API.

  • Token di accesso (IG_ACCESS_TOKEN) — opzionale. Lascia vuoto per riutilizzare il token della Facebook Page che hai già configurato.
  • ID dell'account Business (IG_BUSINESS_ACCOUNT_ID) — ID numerico dell'Instagram Business Account collegato alla tua Facebook Page (ad esempio 17841412345678901).

Guida passo per passo: ottenere l'ID dell'Instagram Business Account →

Passare a un account Professional

Nell'app Instagram: vai su Settings → Account → Switch to Professional Account. Scegli Business o Creator. Poi collega la tua Facebook Page in Settings → Account → Linked Accounts.

YouTube

ContentFlows usa la YouTube Data API v3 per generare metadati (titoli, descrizioni, tag) per il tuo calendario dei contenuti.

  • Chiave API (YOUTUBE_API_KEY) — da Google Cloud Console con YouTube Data API v3 abilitata.
  • ID del canale (YOUTUBE_CHANNEL_ID) — ID univoco del tuo canale (inizia con UC), che trovi in YouTube Studio → Settings → Channel → Advanced settings.

Guida passo per passo: ottenere la chiave API YouTube e l'ID del canale →

Email newsletter

ContentFlows invia newsletter tramite Amazon SES alla lista di iscritti del tuo tenant. Non è richiesto alcun token — viene configurato quando il tuo account viene provisionato.

Gestione degli iscritti

La scheda Newsletter nella tua dashboard ha un pannello completo degli iscritti con:

  • Intestazione statistiche — conteggi di attivi / in attesa / disiscritti / rimbalzati / con reclamo
  • Importazione — upload CSV, chiave API Mailchimp o chiave API ConvertKit
  • Vista elenco — ricerca, filtro per stato, eliminazione per riga, eliminazione multipla, esportazione CSV
  • Ri-iscrizione — riporta indietro un contatto disiscritto o rimbalzato

Il tuo URL pubblico di registrazione è https://YOUR-SLUG.contentflows.cc/subscribe, dove YOUR-SLUG è l'identificatore sicuro per DNS impostato sul tuo tenant (predefinito: una versione pulita del nome della tua azienda). Le iscrizioni usano il double opt-in (email di conferma); gli import CSV / Mailchimp / ConvertKit bypassano la verifica perché al momento del caricamento attesti il consenso.

Configurazione DNS una tantum (solo operatore)

Per far risolvere la pagina di registrazione del sottodominio per qualsiasi tenant, l'operatore della piattaforma deve configurare una volta sola il DNS wildcard: *.contentflows.cc come CNAME che punta all'origine che serve il sito radice contentflows.cc. Fino a quando non è impostato, l'URL di fallback https://contentflows.cc/subscribe?tenant=YOUR-SLUG funziona ovunque.

I link di disiscrizione sono firmati con HMAC-SHA256 e incorporati in ogni newsletter in uscita (l'header RFC-8058 List-Unsubscribe-Post è incluso per la conformità one-click di Gmail / Yahoo).

Dominio di invio (DKIM + SPF + DMARC)

Le email partono per impostazione predefinita da noreply@contentflows.cc. Per una deliverability molto migliore, autentica il tuo dominio così che le newsletter partano da newsletter@your-business.com.

Apri la scheda Brand, trova la card Sending domain, digita il tuo dominio, copia i 5 record DNS mostrati, incollali presso il tuo provider DNS e fai clic su Verify. La card interroga SES per 10 minuti finché DKIM + DMARC non vengono convalidati.

Cosa sono i 5 record

  • 3 × CNAME per la firma DKIM (token generati da SES)
  • 1 × TXT sul dominio radice per SPF (v=spf1 include:amazonses.com -all)
  • 1 × TXT su _dmarc.your-domain.com per DMARC (v=DMARC1; p=none; rua=mailto:dmarc@your-domain.com)

Come vengono memorizzate le credenziali

Tutti i campi di tutte le piattaforme per il tuo tenant vengono salvati come un unico blob JSON cifrato in AWS Secrets Manager all'indirizzo contentflows/tenants/YOUR_TENANT_ID/social-tokens. I secret non vengono mai registrati, non vengono mai mostrati di nuovo dopo il salvataggio e sono isolati sul tuo account. ContentFlows non memorizza mai la tua password dei social media.

Sostituire un valore

Per aggiornare un token o un ID (ad esempio dopo la scadenza del token), vai alla scheda Integrations, incolla i nuovi valori nei campi interessati e fai clic su Save. Vengono aggiornati solo i campi che modifichi — il resto del blob rimane intatto.

Cosa succede dopo la connessione

Una volta collegato un canale, ContentFlows pubblica automaticamente i contenuti approvati secondo la tua pianificazione. Rivedi e approva ogni contenuto dalla scheda Content Queue prima che vada online.

Canali supportati

  • LinkedIn — post personali o per Company Page (UGC Posts API)
  • Facebook — post per Page (Graph API)
  • Instagram — post nel feed su account Professional (Graph API)
  • YouTube — recupero metadati (Data API v3)
  • Email newsletter — tramite Amazon SES (configurato automaticamente)

Prossimi passi