SDK-referentie

Elke Keyda SDK — Android, iOS, React Native, Flutter, Ionic — implementeert dezelfde kleine contracten. Als je er één hebt gebruikt, heb je ze allemaal gebruikt.

De API

Bellen	Wat het doet
`init` / `initialize`	Slaat je client id op. Valideert dit en faalt duidelijk als het verkeerd is opgemaakt.
`show`	Toont de chat over je app heen.
`dismiss`	Sluit het.
`isShowing`	Of het momenteel wordt weergegeven.

Er is bewust niets anders. Geen API voor het verzenden van berichten, geen ongelezen teller, geen aanroep voor gebruikersidentiteit — omdat geen van deze dingen nog end-to-end werkt, en een methode die niet werkt is erger dan een ontbrekende.

De URL die elke SDK opent

{baseUrl}/chat/{clientId}

baseUrl staat standaard ingesteld op https://keyda.in/business en kan op elk platform worden overschreven, voor een testomgeving of een self-hosted installatie.

Waarom een webview en wat het je kost

Er is één chatinterface, geleverd door het platform, en elk oppervlak laadt deze.

Wat je krijgt: een wijziging die een eigenaar maakt in het dashboard — accentkleur, welkomstbericht, botnaam, live gaan — bereikt elke app onmiddellijk, zonder release. Een fix komt overal tegelijk aan. De chat is identiek op alle platformen.

Wat het kost: de chat heeft een verbinding nodig. Er is geen offline modus en er zijn nog geen pushmeldingen.

We hebben dit liever dat je dit weet voordat je live gaat dan dat je er pas achter komt.

Garanties die elke SDK biedt

Navigatie-escapes. Een link naar een andere herkomst opent in de systeembrrowser in plaats van de chat te vervangen. Zonder dit maakt één tik op een footerlink een einde aan het gesprek van een klant zonder weg terug.
Gespreksvoortzetting. DOM-opslag staat aan, dus een klant die de app sluit en terugkomt, vindt de chat waar hij of zij was gebleven (gedurende 24 uur).
Het toetsenbord bedekt de invoer nooit.
Er wordt rekening gehouden met veilige zones — er wordt geen chat getekend onder een notch of een home-indicator.
Geen enkele crash bereikt je app. Bij een mislukte laadactie wordt een knop om opnieuw te proberen getoond.
Geen analyse-tools, geen apparaat-identificaties, geen afhankelijkheden van derden. Het toevoegen van een Keyda SDK voegt geen tracker toe aan je app.

Client id-indeling

kb_live_ followed by 8-48 hexadecimal characters

Al het andere wordt bij de initialisatie geweigerd in plaats van een 404 te openen voor een klant. De client id is ontworpen om openbaar te zijn — deze is zichtbaar op elke website die de widget insluit — en geeft geen bevoegdheid om je account te lezen of te wijzigen. Zie limieten en beveiliging.

Bron

Openbaar, onder MIT-licentie: github.com/KeydaAI/keyda-business-sdks. Het gedeelde contract waaraan elk pakket zich moet houden staat in CONTRACT.md bovenaan die repository.