Bouw op KobiVoice
Hoe een koppeling tussen KobiVoice en een CRM in elkaar zit, wanneer hij af is, en wat er vandaag wel en niet open staat voor derden.
Waar dit over gaat
KobiVoice is een telefoniecentrale die tijdens elk gesprek het klantdossier ophaalt uit het CRM van de klant. Welk CRM dat is, maakt voor de telefoon niets uit: daartussen zit een gateway die per organisatie weet met welk systeem hij praat.
Deze pagina beschrijft dat model - voor wie wil begrijpen hoe een koppeling werkt, wil weten wanneer wij een koppeling af noemen, of wil voorstellen welk systeem er als volgende bij komt.
Er is vandaag geen publieke API en geen webhooks. Koppelingen worden door ons gebouwd, niet door derden. Wat er wel is, staat hieronder; wat er niet is, staat er ook.
Hoe een koppeling werkt
Van de eerste bel tot het scherm, in de volgorde waarin het gebeurt.
De centrale meldt een gesprek
Bij elk inkomend en uitgaand gesprek geeft de centrale het telefoonnummer door, samen met welk account belt.
De gateway bepaalt de organisatie
Welke koppeling wordt gebruikt volgt uit het account dat de aanvraag doet. De app stuurt nooit zelf een organisatie mee - er is geen veld waarmee een toestel een andere organisatie zou kunnen aanwijzen.
De provider vertaalt
Per CRM bestaat één provider die de vragen van de gateway omzet naar de aanroepen van dat systeem, en het antwoord terugvertaalt naar een vorm die van geen enkele leverancier is.
Eén kaart terug
De app en de werkplek krijgen één klantkaart. Wat een provider niet kan, laat de kaart weg - geen leeg vak met een streepje, en geen knop die een foutmelding oplevert.
Wat je toevoegt gaat terug
Een notitie of taak die tijdens het gesprek wordt gemaakt, gaat naar hetzelfde contact in het CRM. Verder wordt er niets weggeschreven.
Waarom het model leverancierloos is
De app kent geen enkel veld van een specifiek CRM. Een offerte is een offerte, of hij nu uit Teamleader, HubSpot of een eigen systeem komt. Zou het belscherm ook maar één veld van één leverancier kennen, dan is het geen platform meer maar een koppeling.
Wat een CRM níet kan, vertelt de provider zelf. De kaart laat dat blok dan weg. Daarom staat er op de Teamleader-pagina expliciet dat er geen tickets zijn: dat pakket heeft geen ticketsysteem, dus is er niets om te tonen.
- De app kent alleen een eigen contactverwijzing, niet het id van het CRM. Stapt een klant over, dan blijven onze verwijzingen kloppen.
- Elke aanvraag wordt afgeschermd per organisatie: de koppeltabel en de tijdelijke opslag staan allebei op de organisatie.
- Sleutels staan versleuteld op onze servers en komen nooit in een app op een telefoon.
Wanneer een koppeling af is
Een koppeling bestaat pas als de hele keten af is. Dat is bij ons geen afspraak maar een controle: de website leidt de stand van een koppeling af uit tien schakels en kan hem niet beschikbaar noemen zolang er één ontbreekt. Er is geen veld om met de hand op 'live' te zetten.
Zo blijft de statuspagina kloppen zonder dat iemand hem bijhoudt.
De tien schakels
Elke schakel staat pas aan als het onderdeel in productie werkt - niet als eraan begonnen is.
| Schakel | Wat het betekent |
|---|---|
| Provider | Werkende providerklasse in de gateway |
| Aanmelding | OAuth of configuratie, inclusief automatisch vernieuwen |
| Marketplace | Te koppelen vanuit de werkplek, door een beheerder |
| Onboarding | Begeleide eerste koppeling met een controle achteraf |
| Documentatie | Integratiepagina met capabilities en gegevensstromen |
| Help | Handleiding: koppelen, testen, ontkoppelen |
| Probleemoplossing | Bekende fouten met een oplossing per geval |
| Status | Publiek zichtbare stand van de koppeling |
| Support | Een bereikbaar kanaal dat deze koppeling kent |
| Knowledge | Doorzoekbare ingang in de kennisbank |
De referentie-implementatie
Teamleader Focus is de eerste koppeling die alle tien schakels heeft. Wie wil zien hoe ver een koppeling gaat - welke gegevens er heen en weer gaan, wat er bewust niet in zit, en hoe het koppelen eruitziet - kan het beste daar beginnen.
De integratiepagina beschrijft wat de koppeling doet; de handleiding beschrijft koppelen, testen, ontkoppelen en het oplossen van problemen.
Wat er nog niet is
Zodat niemand hierop hoeft te wachten zonder het te weten.
- Geen publieke API. De REST-laag tussen onze eigen app en de gateway is intern en niet gedocumenteerd voor derden.
- Geen webhooks. Gesprekken worden niet naar externe adressen gestuurd.
- Geen SDK's.
- Geen zelfbouw-providers. Een provider is een klasse in onze gateway; koppelingen worden door ons gebouwd en uitgerold.
- Komt daar verandering in, dan verschijnt het hier - met dezelfde regel als bij koppelingen: pas als het werkt.
Een koppeling voorstellen
Gebruik je een systeem dat er nog niet bij staat, of wil je weten wanneer het zover is? Laat het ons weten - welk pakket, welke versie, en wat je tijdens een gesprek zou willen zien.