Riferimento SDK

Ogni SDK di Keyda — Android, iOS, React Native, Flutter, Ionic — implementa la stessa piccola interfaccia. Se ne hai usato uno, li hai usati tutti.

L'API

Chiama	Cosa fa
`init` / `initialize`	Memorizza il tuo client id. Lo valida e restituisce un errore evidente se è formattato male.
`show`	Mostra la chat sopra la tua app.
`dismiss`	La chiude.
`isShowing`	Se è presentato in questo momento.

Deliberatamente non c'è nient'altro. Nessuna API per l'invio di messaggi, nessun conteggio dei non letti, nessuna chiamata all'identità utente, perché nessuno di questi funziona ancora end-to-end, e un metodo che non funziona è peggio di uno mancante.

L'URL che ogni SDK apre

{baseUrl}/chat/{clientId}

baseUrl è impostato su https://keyda.in/business per predefinita ed è modificabile su ogni piattaforma, per ambienti di staging o un'installazione self-hosted.

Perché una vista web e quanto ti costa

C'è un'unica interfaccia di chat, gestita dalla piattaforma, che viene caricata su ogni canale.

Cosa ottieni: una modifica effettuata dal proprietario nella dashboard — colore di accento, messaggio di benvenuto, nome del bot, messa online — raggiunge immediatamente ogni app, senza alcuna nuova release. Una correzione viene applicata ovunque nello stesso momento. La chat è identica su tutte le piattaforme.

Costi: la chat richiede una connessione. Non c'è una modalità offline e non ci sono ancora notifiche push.

Preferiamo che tu lo sappia prima di pubblicare piuttosto che scoprirlo dopo.

Garanzie offerte da ogni SDK

Fuga dalla navigazione. Un link verso qualsiasi altra origine si apre nel browser di sistema invece di sostituire la chat. Senza questo, un singolo tocco su un link nel footer interrompe la conversazione del cliente senza possibilità di ritorno.
Continuità della conversazione. La memorizzazione DOM è attiva, quindi un cliente che chiude l'app e la riapre ritrova la sua chat esattamente dove l'aveva lasciata (per 24 ore).
La tastiera non copre mai il campo di input.
Le aree sicure vengono rispettate: nessuna chat viene posizionata sotto una tacca o una barra di navigazione.
Nessun arresto anomalo raggiunge la tua app. Un caricamento non riuscito mostra un tentativo di ripetizione.
Nessun analytics, nessun identificatore di dispositivo, nessuna dipendenza di terze parti. Aggiungere un SDK di Keyda non aggiunge alcun tracker alla tua app.

Formato del Client ID

kb_live_ followed by 8-48 hexadecimal characters

Qualsiasi altra richiesta viene rifiutata all'inizializzazione invece di mostrare un errore 404 davanti a un cliente. Il Client ID è pubblico per progettazione — è visibile in qualsiasi sito web che integri il widget — e non consente in alcun modo di leggere o modificare il tuo account. Consulta la sezione limiti e sicurezza.

Origine

Pubblico, con licenza MIT: github.com/KeydaAI/keyda-business-sdks. Il contratto condiviso a cui ogni pacchetto deve attenersi si trova in CONTRACT.md in cima a quel repository.