Integrazione AI

AI Importer ti consente di collegare Clerk.io a qualsiasi piattaforma che esponga un’API — senza configurazioni predefinite o campi di modulo fissi.

La configurazione avviene interamente all’interno di Ask Clerk.io. Descrivi cosa vuoi collegare e Ask Clerk.io ti guida in tutto il processo: trova l’API, richiede le credenziali, costruisce l’importatore e lo testa prima di passare a Data Sync.

Per iniziare #

Vai su Ask Clerk.io e indica da quale piattaforma desideri importare. Se hai un URL del tuo store, includilo — offre ad Ask Clerk.io un utile punto di partenza.

Ask Clerk.io determinerà la configurazione necessaria. Invece di presentarti un modulo pieno di campi sconosciuti, stabilisce da solo i requisiti e chiede solo ciò che serve — una cosa alla volta.

Credenziali #

Ask Clerk.io richiederà le credenziali necessarie a seconda delle esigenze della piattaforma. Potrebbe essere una API key, una serie di dati di accesso o un token — a seconda di come avviene l’autenticazione nella piattaforma.

Se Ask Clerk.io riesce a trovare autonomamente la documentazione API, lo farà. Se la documentazione non è pubblicamente disponibile o vuoi velocizzare il processo, puoi incollarla o condividere direttamente un URL nella chat. Ask Clerk.io la utilizzerà come contesto per il resto della configurazione.

Test #

Una volta configurata la connessione, Ask Clerk.io esegue un test per verificare di poter raggiungere la piattaforma e recuperare i dati previsti.

Se il test ha successo, vedrai un riepilogo di quanto trovato. Se qualcosa fallisce, Ask Clerk.io identifica la causa e propone una soluzione — che si tratti di un problema di credenziali, un endpoint errato o qualcosa nella risposta dell’API.

Risoluzione dei problemi #

Quando qualcosa va storto, Ask Clerk.io spiegherà cosa è successo e suggerirà il prossimo passo da compiere.

Puoi chiedergli di riprovare con la configurazione attuale, modificare dettagli specifici o ricominciare l’intero processo da zero. La conversazione resta contestualizzata, quindi Ask Clerk.io ricorda cosa è già stato provato e non ripete i passaggi che non hanno funzionato.

Se vuoi annullare tutto e ricominciare da capo, basta chiedere. Ask Clerk.io cancellerà lo stato e ti permetterà di partire nuovamente dall’inizio.

Estendere l’importazione #

Dopo che la connessione iniziale funziona, puoi estendere cosa viene importato. Ask Clerk.io può:

• Importare attributi di prodotto aggiuntivi utilizzati dal tuo catalogo
• Collegare fonti di dati di terze parti insieme alla piattaforma principale
• Adattare la logica di importazione per allinearsi alla struttura del tuo catalogo

Devi solo spiegare ciò che ti serve. Ask Clerk.io aggiornerà la configurazione senza che tu debba spiegare tutto da capo.

Passaggio a Data Sync #

Quando l’importatore è pronto, Ask Clerk.io lo passa a Data Sync con tutta la configurazione applicata.

Il contesto dalla conversazione — la piattaforma, le credenziali e qualsiasi modifica fatta durante la configurazione — viene trasferito automaticamente. Non dovrai reinserire nulla una volta arrivato in Data Sync.

Da qui, puoi gestire l’importatore, controllare il momento della sincronizzazione e monitorare i log nello stesso modo di qualsiasi altro metodo di sincronizzazione.

Per approfondire, leggi Data Sync.

Gestire un importatore #

Apri Data > Configuration. Le Sync settings comuni, incluso Sync Time, appaiono dopo Sync platform. Se hai più importatori, seleziona la scheda corrispondente sotto Your importers.

La sezione importatore mostra una descrizione leggibile basata sul codice attuale. Spiega la fonte dei dati, i tipi di dati importati, le trasformazioni e i limiti rilevanti. I campi delle credenziali compaiono quando necessari.

Scegli Edit importer per aprire Ask Clerk.io con l’importatore selezionato come contesto. Questo non invia alcuna richiesta né avvia un lavoro. Scrivi la modifica che desideri nel campo del messaggio, poi inviala.

Scegli Test importer per eseguire un test di prova. Un popup spiega il test e mostra un riepilogo del risultato, i dettagli di validazione e una preview limitata dei record. Il test non avvia una vera sincronizzazione dati. Chiudi il popup per tornare alla configurazione.

Utilizza l’azione separata Start new data sync quando vuoi eseguire una sincronizzazione reale.