Il Wiring Lab

Il Wiring Lab è dove colleghi una persona a un engine. Questa connessione si chiama link — abbina esattamente una persona a un engine, così l'engine gira con la voce di quella persona. Ogni link ha il proprio api_slug, un identificatore univoco per quel specifico cablaggio, così la piattaforma sa sempre a quale combinazione persona-engine appartiene una richiesta.

Per creare un link:

Apri il Wiring Lab e scegli la persona che vuoi portare online.
Trascina un engine dalla libreria sulla canvas per collegarlo a quella persona.
Clicca Salva (il pulsante Commit Wiring) per salvare il link. Finché non fai commit, il cablaggio non è salvato.

Puoi creare più link persona-engine in un unico account — ognuno è la propria connessione con il proprio api_slug.

Chiavi API

Una chiave API è il modo in cui un bot esterno o un'integrazione si autentica su FluidTalk. Ci sono due modi per crearne una:

Crea — genera una chiave semplice, a livello di account non ancora associata a nessuna persona o engine.
Provisioning — genera una chiave già associata a una persona e a un engine specifici in un unico passaggio. Questo è il percorso consigliato , perché una chiave già associata è pronta a servire traffico live.

Gestisci le chiavi dal Wiring Lab:

Collega / associa una chiave — lega una chiave account-wide esistente a una persona e un engine (e facoltativamente rinominala). Una chiave mai associata non può servire chiamate live.
Elenca — visualizza tutte le chiavi dell'account.
Revoca — elimina una chiave in modo che non possa più essere utilizzata.

Attenzione

Il segreto di una chiave API è mostrato una sola volta, nel momento in cui viene creata. Copiala subito e conservala in un posto sicuro — se la perdi, non puoi vederla di nuovo. Revoca semplicemente quella chiave e creane una nuova.

Attenzione

Una chiave deve essere associata a una persona (e a un engine) prima di poter servire traffico live. Una chiave account-wide non associata viene rifiutata nelle chiamate live — esegui il provisioning di una chiave associata, o collega una esistente, prima.

Checklist per andare live

Quando tutti e quattro sono verificati, sei live:

Persona pronta — identità e foto configurate.
Engine collegato — l'engine cablato a quella persona e committato nel Wiring Lab.
Una chiave API associata — provisioning (o collegata) a quella specifica persona e engine.
Punta il tuo bot sull'handshake — la tua integrazione invia ogni messaggio in entrata all'endpoint handshake live, passando la chiave nell'header X-API-Key . FluidTalk risponde con il messaggio successivo e l'azione da intraprendere.

Per gli endpoint esatti, i campi della richiesta e le risposte, vedi il riferimento API per sviluppatori.

Suggerimento

Non devi andare live per provarlo. Esegui l'intera conversazione nel simulatore integrato prima — lo stesso engine, nessuna chiave e nessun traffico reale — poi cablalo una volta che si comporta come vuoi.

Attenzione

Il servizio live richiede un piano a pagamentoattivo. Un account free o scaduto viene rifiutato all'handshake, quindi il tuo bot smette di servire nel momento in cui il piano termina. Vedi Fatturazione e piani.

Guide correlate

Engine builder — progetta la conversazione prima di cablarla.
Test nel simulatore — prova l'engine end-to-end senza chiave.
Riferimento API per sviluppatori — le chiamate handshake esatte e gli header.
Fatturazione e piani — cosa sblocca un piano a pagamento per il servizio live.