Credenziali e integrazioni (AI e social)

Credenziali e integrazioni

Le «credenziali» sono le chiavi che collegano Puntify a servizi esterni. Servono soprattutto a due funzioni: Nemi (l'assistente AI) e Social Studio (i contenuti social). Le gestisci nella pagina «Credenziali», all'indirizzo /merchant/credentials. Come recita la schermata vuota, servono ad «attivare Nemi e Social Studio».

Due tipi di credenziale

1. Provider AI (campo «Tipologia» = «Provider AI»): una chiave API di un servizio di intelligenza artificiale. I provider disponibili sono «Anthropic», «OpenAI» e «Google Gemini». La chiave la generi sul sito del provider (es. console.anthropic.com per Anthropic) e la incolli in Puntify.
2. OAuth: una connessione alle piattaforme social (Google Business, Instagram, Facebook, TikTok, YouTube, Pinterest, Threads) che si autorizza direttamente sul loro sito, senza incollare chiavi.

Aggiungere una chiave AI

1. Nella pagina «Credenziali» tocca «Crea credenziale».
2. In «Tipologia» scegli «Provider AI» e in «Provider» seleziona Anthropic, OpenAI o Google Gemini.
3. Se vuoi, dai un «Nome credenziale» (altrimenti Puntify ne suggerisce uno).
4. Incolla la chiave nel campo «API key» (segui l'aiuto: es. «Chiave API Anthropic. Generala su console.anthropic.com.»).
5. Tocca «Salva»: appare «Credenziale salvata».

La chiave è protetta: Puntify indica «Cifrata AES-GCM at-rest, mai mostrata dopo il salvataggio». Significa che viene conservata in forma cifrata e non è più visibile dopo il salvataggio. Se in futuro la modifichi, il campo mostra «•••••••••• (lascia vuoto per non modificare)»: inserisci una nuova chiave solo se vuoi sostituirla.

Le connessioni social (OAuth)

Per il tipo OAuth, oggi Puntify segnala che «La connessione OAuth richiede flusso esterno con il provider (Meta App Review, Google Cloud Console, ecc.)». Al momento il pulsante è «Connetti (in arrivo)» ed è disattivato per la maggior parte delle piattaforme: la connessione automatica arriverà più avanti (fa eccezione Google Business Profile, collegabile dalle impostazioni di Social Studio).

Gestire e cercare le credenziali

Nell'elenco ogni credenziale mostra il logo del provider, il nome e la tipologia (es. «Provider AI · Anthropic»). La barra «Cerca per tipo, provider o modello…» filtra la lista. Toccando una credenziale la apri: puoi rinominarla, aggiornare la chiave (per i provider AI) o usare «Elimina». Non puoi invece cambiarne tipo e provider dopo la creazione.

Domande comuni

Perché mi serve una chiave AI? Senza una credenziale «Provider AI» non funzionano Nemi né la generazione di testi/immagini in Social Studio. Dove trovo la chiave? Sul sito del provider che scegli (Anthropic, OpenAI o Google): la schermata di Puntify indica l'indirizzo esatto. La mia chiave è al sicuro? Sì: è cifrata e non più visibile dopo il salvataggio. Posso già collegare Instagram o Facebook? La connessione OAuth automatica è «in arrivo»; per ora è disattivata (tranne Google Business Profile).