Indice della documentazione

Connettori Social

Collega i tuoi account e autorizza le pubblicazioni.

I Connettori permettono di collegare i tuoi account social e pubblicarvi i contenuti. Ogni utente collega i propri account — se sei un'agenzia, puoi aggiungere N account della stessa piattaforma per N clienti.

Piattaforme Supportate

📱 Pubblicazione Social (Live)

  • Instagram — Graph API ufficiale (max 25 post/giorno)
  • Facebook — Pages API
  • TikTok — Content Posting API (post privati fino ad audit completato)
  • YouTube — Channel upload via OAuth
  • X (Twitter) — API v2 (richiede piano Basic a pagamento)
  • Pinterest — Pins API v5
  • Threads — Threads API ufficiale
  • Reddit — OAuth per subreddit moderati
  • Telegram — Bot API (canali e bot personali)
  • Mastodon — Access token (istanza a scelta)
  • Bluesky — App password

📢 Pubblicità (Ads)

  • Meta Ads (Facebook/Instagram) — Gestione campagne
  • Google Ads — Campaign API
  • TikTok Ads — Self-serve
  • Telegram Ads — Manuale (Telegram non offre API per crearle)

💬 Messaggi & Utilità

  • WhatsApp Business — Cloud API (lista broadcast)
  • Google Drive, Gmail, Google Calendar, Google Sheets — "Collega con Google" one-click
  • Notion — Connessione per sincronizzazione calendari
  • Canva — Design team integration

Come Collegare un Account

Metodo 1: One-Click OAuth (Google, TikTok, Meta…)

Per le piattaforme che supportano OAuth, premi il pulsante "Collega con Google" o simile:

  1. Si apre una finestra di autorizzazione
  2. Accedi al tuo account
  3. Autorizza OmniaStudio
  4. Il connettore è pronto

Niente chiavi da copiare — pensiamo noi a tutto.

Metodo 2: Wizard Manuale

Per le altre piattaforme, segui il Wizard Connettore:

1️⃣ Guida passo-passo

Ogni piattaforma ha una sua guida:

  • Telegram: Apri BotFather, crea un bot, copia il token
  • X (Twitter): Vai a developer.x.com, crea un'app, copia API key + secret + token + token secret
  • Instagram: Facebook Developers, crea un'app, genera token Graph API con permessi
  • YouTube: Google Console, crea credenziali OAuth, copia ID + secret + refresh token
  • Pinterest: Pinterest Developers, crea app, fai OAuth, copia access token
  • (E così via per ogni piattaforma)

2️⃣ Dai un nome al connettore

Es. "Cliente Rossi — Instagram" o "Il mio TikTok aziendale"

Serve per riconoscerlo quando ne hai N della stessa piattaforma.

3️⃣ Assegna a un Progetto (opzionale)

Se usi i Progetti per organizzare per cliente:

  • Lascia "Tutti i progetti" (default)
  • Oppure scegli un progetto specifico

4️⃣ Salva e Verifica

Premo "Salva e verifica": se tutto è corretto, il connettore passa allo stato Attivo.

Se fallisce, messaggio di errore con il motivo — leggi le guide di ogni piattaforma per le credenziali esatte.

Gestione dei Connettori

Accedi, Testa, Elimina

Nel tab 🔌 Connessioni:

  • Verifica → test della connessione (utile se il token è scaduto)
  • Elimina → rimuovi il connettore (le pubblicazioni programmate che lo usavano falliranno)

Credenziali Sicure

Le credenziali (token, secret, API key) sono:

  • Cifrate lato server
  • MAI rileggibili — compare solo una preview mascherata (•••• + ultimi 4 caratteri)
  • Visibili solo a te — nel team, gli altri collaboratori NON vedono i token, solo li usano per pubblicare

Budget Mensile (per Ads)

Se colleghi un account pubblicitario, puoi settare un budget mensile:

  • Lasciato vuoto = niente limite
  • Impostato = il sistema monitorerà la spesa per non superare quel tetto

Utile se gestisci budget di clienti diversi.

LinkedIn: Perché non è supportato?

LinkedIn non consente l'auto-posting via API (Terms of Use §3.1.26). L'API ha scopi di integrazione business, non content management.

Alternativa: Se devi postare su LinkedIn, fai un copia-incolla manuale dal nostro Copywriter oppure usa uno strumento esterno autorizzato da LinkedIn.

In Arrivo (Soon)

  • Facebook Messenger — Automazioni bot
  • LinkedIn — Valutazione di alternative autorizzate

Problemi comuni

"Autorizzazione fallita"

  • Accertati di avere l'accesso all'account (sei admin o owner?)
  • Se è un account aziendale, verifica di avere i permessi (Facebook Pages per biz, YouTube channels per il canale, ecc.)
  • Alcuni account richiedono 2FA abilitato

Token scaduto (403 Unauthorized)

  • Premi "Verifica" dal tab Connessioni
  • Se il token è scaduto da >30 giorni, sarà necessario ricollegar il connettore da capo

Non riesco a trovare il mio IG user ID

  • Apri Facebook Graph API Explorer (developers.facebook.com)
  • Query: GET me/accounts → nota il field instagram_business_account → ID node
  • Copialo nel wizard

Il connettore è attivo ma la pubblicazione fallisce comunque

  • Controlla il log del job nel tab Approvazione o Galleria
  • Messaggi di errore tipici: account sospeso, limite giornaliero raggiunto, formato non supportato (es. LinkedIn video >2GB)

Setup iniziale: ~30 minuti per collegare i tuoi account. Dopo, un click per pubblicare su N piattaforme.