Integrazioni
Collega qualsiasi API
Usa i servizi che non sono nel catalogo dei Connettori, dalle API pubbliche a quelle che richiedono una chiave, oppure aggiungi un tuo connettore che l'AI può usare per creare.
Il catalogo dei Connettori comprende più di 100 servizi, ma la tua app può funzionare con quasi tutti i servizi che hanno un'API (un modo con cui altri software possono comunicare con quel servizio). Questa pagina ti mostra i tre modi per farlo, dal più veloce al più riutilizzabile.
| La tua situazione | Cosa fare |
|---|---|
| L'API è pubblica e non richiede una chiave | Chiedila nella chat |
| L'API richiede una chiave e ti serve in una sola app | Lascia che sia l'AI a chiederti la chiave: viene salvata come segreto per quell'app |
| Userai il servizio in più app, oppure vuoi che l'AI lo capisca bene | Crea un tuo connettore nella pagina Connettori |
Qualunque strada scegli, le chiavi vengono usate solo nel codice server della tua app, quindi non finiscono nei browser dei tuoi visitatori.
Usare un'API pubblica
Molti servizi, come meteo, giorni festivi o dati aperti, non richiedono nessuna chiave. Indica il servizio e spiega cosa vuoi ottenere.
Mostra nella home page le previsioni meteo a 5 giorni per la città del visitatore, usando l'API di Open-Meteo.
Se l'AI ha bisogno di dettagli su un'API che non conosce bene, incolla nella chat la parte rilevante della sua documentazione, per esempio una richiesta di esempio e la risposta che restituisce, oppure allega la documentazione come file. Vedi Aggiungi immagini e file.
Usare un'API che richiede una chiave
Quando una funzione ha bisogno della chiave di un servizio che non è nel catalogo, l'AI mostra nella chat una scheda per la chiave, con il nome che userà, per esempio ACME_API_KEY. Incolla la chiave e clicca Salva, oppure clicca Salta per andare avanti senza.
La scheda lo dice chiaramente: la chiave viene salvata in modo sicuro e cifrata, non compare mai nella chat né nel codice della tua app, e puoi cambiarla in seguito da Gestisci → Segreti (ai collaboratori viene detto che può cambiarla il proprietario del progetto).
Aggiungi un modulo di contatto che crea un nuovo lead nel nostro CRM tramite la sua API. Chiedimi la chiave API.
Puoi anche aggiungere le chiavi tu stesso prima di chiedere: apri la scheda Gestisci, scegli Segreti e aggiungine una sotto Aggiungi un nuovo segreto. L'anteprima recepisce le modifiche in automatico; la tua app pubblicata le riceve alla pubblicazione successiva. Vedi Segreti e chiavi API.
Non scrivere le chiavi in un messaggio della chat. I messaggi della chat vengono salvati insieme al tuo progetto. Usa invece la scheda per la chiave oppure Gestisci → Segreti.
Creare un tuo connettore
Se userai un servizio in più di un'app, o vuoi che l'AI ne capisca bene l'API, aggiungilo come tuo connettore. Descrivi l'API una sola volta; dopo funziona come qualsiasi connettore del catalogo: lo colleghi con la tua chiave, lo attivi o disattivi app per app, e l'AI può usarlo per creare e leggerne i dati mentre crea.
Nella pagina Connettori, scorri fino a I tuoi connettori e clicca Crea connettore. Tieni aperta la documentazione API del servizio, perché ti serviranno il suo indirizzo API e il modo in cui accetta la chiave. Nella descrizione non va inserita nessuna chiave: la tua la usi solo alla fine, per collegarti.
Dettagli
Dagli un Nome. Se vuoi, aggiungi una Descrizione breve per la scheda e Cosa fa (aiuta l'AI a capire quando usarlo). Poi scegli una Categoria, aggiungi se vuoi un Link alla documentazione API e scegli un Colore. Il Nome in codice decide i nomi delle impostazioni che le tue app leggono, come
ACME_CRM_API_KEY. Non si può cambiare in seguito.Come fa l'accesso
Inserisci l'Indirizzo API da cui parte ogni richiesta (deve iniziare con
https://). Poi rispondi a Come fa il servizio a verificare chi sei?: Token Bearer, Chiave API in un'intestazione, Chiave API nell'indirizzo oppure Nome utente e password. Se il servizio richiede più di un valore, come un ID account, aggiungili sotto Serve più di un valore?. Un'anteprima ti mostra Che aspetto ha una richiesta.Richiesta di prova
Scegli una richiesta che si limiti a leggere e che richieda la chiave, come "chi sono" o "elenca i miei elementi". Buildliy la esegue per controllare ogni chiave prima di salvarla, quindi non deve modificare nulla. Sotto Provala (facoltativo) puoi incollare una chiave e cliccare Esegui richiesta di prova per vedere la risposta; quella chiave serve solo per la prova e non viene salvata, a meno che poi tu non la usi per collegarti.
Chi vede i dati
Scegli Solo io: è personale per i dati privati di un account (la tua posta, le note o la banca), oppure Chiunque usi la mia app: è condiviso per i dati pensati per tutti, come un elenco prodotti o annunci pubblici.
Note per l'AI
Se vuoi, incolla le parti della documentazione dell'API che l'AI dovrebbe conoscere: endpoint, richieste e risposte di esempio. Dai a ogni nota un Nome del file e, se ti va, indica Quando deve leggerlo l'AI? Puoi aggiungere fino a 10 note da 20.000 caratteri ciascuna. L'AI vede l'inizio di ogni nota e legge il resto quando ne ha bisogno. Non incollare mai chiavi qui.
Clicca Crea connettore. Si apre poi la finestra di collegamento, con l'eventuale chiave che hai scritto sotto Provala (facoltativo) già inserita: se serve, inserisci la tua chiave e clicca Connetti. Buildliy esegue la tua richiesta di prova con la chiave prima di salvarla, poi la conserva cifrata. Viene usata solo nel codice server delle tue app.
Usa il mio connettore Acme CRM per mostrare i miei 20 contatti più recenti in una pagina dashboard, con una casella di ricerca.
Ognuno dei tuoi connettori ha una scheda con Connetti (Gestisci una volta collegato, oppure Riconnetti se la chiave smette di funzionare), Modifica e un pulsante per eliminare. Eliminare rimuove il connettore e la tua chiave salvata per quel servizio, e le app che lo usano non potranno più raggiungere il servizio finché non lo aggiungi di nuovo. Puoi avere fino a 25 connettori tuoi.
Se hai scelto Solo io: è personale, l'AI protegge tutto ciò che arriva da quel servizio dietro l'accesso della tua app. Una volta collegato, la lista di controllo per il lancio blocca la pubblicazione se il codice della tua app lo usa e l'app non ha l'accesso. Se l'app ha l'accesso, la lista di controllo ti ricorda di assicurarti che possano accedere solo tu (o le persone che scegli), perché una registrazione aperta permetterebbe a chiunque di vedere i dati.
Ricevere eventi da un servizio
Alcuni servizi possono mandare un messaggio alla tua app quando succede qualcosa, come un nuovo ordine o un pagamento completato. Questi messaggi si chiamano spesso webhook. Chiedi all'AI di aggiungere nella tua app un punto in cui riceverli. Se il servizio ti dà un segreto di firma per verificare che i messaggi siano autentici, l'AI te lo chiede con una scheda per la chiave.
Aggiungi un endpoint webhook che riceve gli eventi di nuovo ordine dal nostro sistema di magazzino e salva ogni ordine nel database.
Dai al servizio l'indirizzo della tua app pubblicata, non quello dell'anteprima, perché l'anteprima non è sempre attiva. Vedi Pubblica la tua app.
Vedi anche
Hai ancora dubbi? Leggi le FAQ o contattaci.