Connessione LinkedIn

Questa guida fornisce istruzioni dettagliate per configurare l'integrazione con LinkedIn, permettendoti di pubblicare i tuoi contenuti direttamente sulla piattaforma.

1. Configurazione dell'integrazione LinkedIn

1.1. Variabili d'Ambiente Essenziali

Assicurati di configurare le seguenti variabili d'ambiente:

  • DATABASE_URL - URL completo del database PostgreSQL
  • OPENAI_API_KEY - Chiave API di OpenAI
  • SECRET_KEY - Chiave segreta per la crittografia delle sessioni

1.2. Configurazione del Database

Assicurati che il database PostgreSQL sia configurato correttamente:

flask db upgrade

2. Configurazione di LinkedIn

Importante: Configurare correttamente LinkedIn è essenziale per il funzionamento della condivisione diretta dei contenuti.

2.1. Creazione dell'App LinkedIn

  1. Accedi al LinkedIn Developer Portal
  2. Clicca su "Create App"
  3. Inserisci le informazioni richieste:
    • App name: un nome a tua scelta (es. "AI Post Generator")
    • Company: seleziona la tua azienda o profilo LinkedIn
    • Logo: carica un logo dell'applicazione
    • Descrizione: breve descrizione dell'applicazione
  4. Una volta creata l'app, vai su "Auth" nel menu laterale

2.2. Configurazione OAuth di LinkedIn

  1. Nella sezione "OAuth 2.0 settings", trova "Redirect URLs"
  2. Aggiungi l'URL di callback dell'applicazione nel formato:
    https://tua-app.replit.app/linkedin/callback
    Nota: Sostituisci "tua-app.replit.app" con il dominio effettivo della tua applicazione dopo il deployment.
  3. Nella sezione "Products", abilita "Share on LinkedIn" e "Sign In with LinkedIn"
  4. Copia il "Client ID" e il "Client Secret" dalla sezione "Auth"

2.3. Configurazione delle Variabili d'Ambiente per LinkedIn

Imposta le seguenti variabili d'ambiente per l'integrazione con LinkedIn:

  • LINKEDIN_CLIENT_ID - Il Client ID dell'app LinkedIn
  • LINKEDIN_CLIENT_SECRET - Il Client Secret dell'app LinkedIn
  • LINKEDIN_REDIRECT_URI - L'URL esatto di callback configurato nel portale LinkedIn:
    https://tua-app.replit.app/linkedin/callback
Attenzione: L'URL specificato in LINKEDIN_REDIRECT_URI deve corrispondere esattamente a quello configurato nel Developer Portal di LinkedIn, incluso l'uso di http/https e la presenza/assenza di slash finali.

2.4. Test dell'Integrazione LinkedIn

Per verificare che l'integrazione funzioni correttamente:

  1. Accedi all'applicazione
  2. Genera un contenuto
  3. Nella pagina di visualizzazione del contenuto, clicca su "Condividi su LinkedIn"
  4. Dovresti essere reindirizzato alla pagina di autorizzazione di LinkedIn
  5. Dopo l'autorizzazione, dovresti vedere un messaggio di conferma per la pubblicazione

3. Risoluzione dei Problemi

3.1. Errori di Reindirizzamento OAuth

Problema: "Error: invalid_request - Missing required parameter: redirect_uri"

Soluzione: Assicurati che il LINKEDIN_REDIRECT_URI sia impostato correttamente nelle variabili d'ambiente e corrisponda esattamente a quello configurato nel Developer Portal.

Problema: "Error: redirect_uri_mismatch"

Soluzione: L'URL di reindirizzamento non corrisponde a quello autorizzato. Controlla che:

  • Non ci siano slash finali in eccesso
  • Il protocollo (http vs https) corrisponda
  • Il dominio sia scritto esattamente come configurato

3.2. Errori di Pubblicazione

Problema: "Error: insufficient_scope"

Soluzione: L'app LinkedIn potrebbe non avere i permessi necessari. Assicurati di aver abilitato "Share on LinkedIn" nei prodotti dell'app.

Problema: Errore di connessione durante lo sviluppo locale

Soluzione: Gli ambienti di sviluppo come Replit hanno limitazioni nelle connessioni in uscita. In fase di sviluppo, potresti ricevere errori di connessione verso LinkedIn. Questo comportamento è normale e non influisce sul funzionamento in produzione.

4. Consigli e Suggerimenti

Utilizzo in Produzione

Prima di pubblicizzare l'applicazione agli utenti finali, esegui sempre un test completo del flusso di pubblicazione su LinkedIn in ambiente di produzione.

Sicurezza

Non condividere mai le tue chiavi API o credenziali LinkedIn. Utilizzare sempre variabili d'ambiente per gestire questi valori sensibili.

Aggiornamenti

LinkedIn può modificare le sue API e politiche. Controlla regolarmente il Developer Portal di LinkedIn per eventuali cambiamenti che potrebbero influenzare l'integrazione.

Torna alla Dashboard