Collega il tuo sito
Leggi pagine, prodotti e ordini direttamente dalla tua piattaforma
Panoramica
Collegare il sito dà all'IA una chiave in sola lettura sulla tua piattaforma. Invece di scansionare le pagine dall'esterno, le chiediamo direttamente alla piattaforma.
Così raggiungiamo contenuti che una scansione non può vedere. Passano le pagine dietro un accesso, le pagine profonde a cui nulla rimanda e i siti dietro un muro anti-bot. Prezzi e disponibilità restano aggiornati, perché li rileggiamo invece di affidarci a ciò che la pagina diceva il giorno della scansione.
I tre tipi di dati
Sei tu a scegliere cosa condividere. Ogni scelta corrisponde a ciò a cui l'assistente potrà rispondere.
| Scelta | Che cosa aggiunge | A che cosa può rispondere l'assistente |
|---|---|---|
| Pagine | I contenuti del tuo sito, sincronizzati automaticamente. | Domande su condizioni, servizi, corsi, guide e qualsiasi altra pagina scritta. |
| Prodotti | Prezzi attuali, disponibilità, link e immagini. | Che cosa vendi, quanto costa, se è disponibile e un link per acquistarlo. |
| Ordini | Verifica dello stato degli ordini per i tuoi clienti. | Dov'è l'ordine di un cliente, quando è stato spedito e che cosa conteneva. |
Quali piattaforme funzionano
Tutte. Qualunque sia la base del tuo sito, l'assistente può rispondere partendo dalle tue pagine, dai tuoi prodotti e dai tuoi ordini.
Alcune piattaforme si leggono direttamente con una chiave API. Per le altre gli stessi dati arrivano tramite una scansione, un feed di prodotti, il contesto utente o i tuoi strumenti personalizzati. Non devi capire quale sia il tuo caso: apri la finestra, scegli la piattaforma, spunta ciò che vuoi condividere e compaiono i passaggi adatti a te.
Vedi i passaggi per la tua piattaforma
Come collegare
- Apri la dashboard e trova Collega il tuo sito, accanto ad Aggiungi alla knowledge base.
- Scegli la piattaforma dall'elenco. Seleziona Personalizzato / nessun CMS se hai costruito il sito da solo.
- Spunta ciò che vuoi condividere: pagine, prodotti, ordini o qualsiasi combinazione.
- Premi Continua. Ora vedi i passaggi di configurazione scritti per la tua piattaforma e le tue scelte.
- Segui i passaggi nell'amministrazione della tua piattaforma per creare la chiave.
- Incolla la chiave nei campi in fondo alla stessa finestra e premi Collega.
Che cosa succede quando premi Collega
Verifichiamo la credenziale prima di memorizzarla. Una chiave sbagliata non viene mai salvata.
- Facciamo una vera chiamata alla tua piattaforma con la credenziale che hai incollato.
- Se non riesce, l'errore compare sotto il pulsante e i campi restano modificabili, così puoi correggerlo.
- Se riesce, salviamo il collegamento e iniziamo a leggere i tuoi contenuti.
- La finestra riporta poi il risultato: quanti elementi sono arrivati, o che cosa è andato storto.
Restare aggiornati
Rileggiamo i tuoi contenuti a intervalli regolari, così una variazione di prezzo o una nuova pagina raggiungono l'assistente senza che tu faccia nulla.
Viene reindicizzato solo ciò che è cambiato. Confrontiamo il contenuto di ogni elemento con quello che già abbiamo, quindi una pagina invariata non costa nulla. Puoi anche premere Sincronizza ora nella pagina delle impostazioni della piattaforma in qualsiasi momento.
Permessi e accesso
Quanto può vedere una chiave dipende dalla piattaforma, e la differenza conta.
Magento, Shopify, WooCommerce e BigCommerce concedono i permessi per risorsa. Se spunti solo i prodotti, la chiave raggiunge davvero solo i prodotti.
WordPress e Moodle non funzionano così. Una password per applicazione di WordPress eredita i permessi dell'account che l'ha creata, e un token Moodle vede ciò che vede il suo utente. Non c'è nessun elenco da spuntare. Usa un account che non abbia più accesso dei contenuti a cui vuoi far rispondere, e ricorda che passeranno anche gli articoli privati e protetti da password.
Dal nostro lato leggiamo solo percorsi di contenuto, e solo con GET. Non scriviamo mai.
Collegarsi senza chiave API
Ogni scelta ha anche una via che non richiede alcuna chiave. Funzionano su qualsiasi piattaforma e la finestra le propone accanto ai passaggi.
| Invece di | Usa | Che cosa fa |
|---|---|---|
| Pagine | Scansione | Leggiamo l'intero sito e conserviamo i contenuti nella knowledge base. |
| Prodotti | Feed dati in tempo reale | Indicaci l'URL di un feed di prodotti pubblico. Da lì prezzi e disponibilità restano sincronizzati. |
| Ordini | Contesto utente o Strumenti personalizzati | Invia i dati del cliente collegato dal tuo sito, oppure collega un tuo endpoint che l'assistente può chiamare. |
Scollegare
Apri dalla finestra la pagina delle impostazioni della piattaforma e premi Scollega. Questo rimuove la credenziale memorizzata ed elimina tutto ciò che quella chiave ha portato nella tua knowledge base. I contenuti provenienti da altre fonti restano intatti.
Puoi anche revocare la chiave sulla tua piattaforma. La sincronizzazione successiva fallirà segnalando un errore di autenticazione, e non verrà letto nulla di nuovo.
Risoluzione dei problemi
| Che cosa vedi | Che cosa significa di solito |
|---|---|
| Autenticazione non riuscita | La chiave è errata, scaduta o revocata. Su WordPress succede anche quando si incolla la normale password di accesso invece di una password per applicazione. |
| Fatto, ma non abbiamo trovato nulla da leggere | La credenziale funziona, ma l'account dietro di essa non vede alcun contenuto. Scegli un account con accesso alle pagine o ai prodotti a cui vuoi far rispondere. |
| Collegato, ma non siamo riusciti a leggere i tuoi contenuti | La chiave è stata accettata e poi la lettura è fallita. L'errore esatto della tua piattaforma viene mostrato insieme al messaggio. |
| Manca un permesso | La chiave è stata creata senza una delle risorse elencate nei passaggi. Ricreala con tutti i permessi indicati dalla finestra. |