Exact Online
Het token verloopt na tien minuten en je mag hem niet vernieuwen
Exact Online is de koppeling waar het eerlijke antwoord over de architectuur gaat en niet over de uitvoering. De tokenregels maken vernieuwen op verzoek onmogelijk, dus moet het vernieuwen op een vast ritme draaien, of er nu iemand belt of niet.
Access token
10 minuten
Vernieuwdrempel
570 seconden
Limiet
60 / minuut, per administratie
Wat er gevraagd wordt
Vier taken, in de volgorde waarin mensen ze willen
De beller herkennen tussen de relaties
Eén gefilterde uitvraag op het nummer, met een token dat al in het geheugen staat en niet er ter plekke bij wordt gehaald.
De factuur of order in kwestie lezen
Zodat de agent iets kan zeggen over dát document, in plaats van te beloven dat iemand ernaar gaat kijken.
Controleren of iets betaald is
Voordat de agent iets toezegt. Dit is de uitvraag die je het meest goed wilt hebben, want je vergissen over geld kost twee keer.
Het gesprek vastleggen voor de financiële kant
In een wachtrij voor na afloop, zodat het limietbudget aan uitvragen opgaat zolang de beller er nog is.
De beperking die pijn doet
Je kunt een token niet vernieuwen wanneer je hem nodig hebt
Een access token van Exact Online is tien minuten geldig. Het voor de hand liggende ontwerp is om hem te vernieuwen zodra een gesprek er een nodig heeft. Dat ontwerp werkt niet: Exact staat niet toe dat je vaker dan eens per tien minuten een nieuw access token opvraagt, met een gedocumenteerd minimum van 570 seconden tussen twee aanvragen. Vernieuw je op verzoek, dan krijgt de tweede beller van die minuut een foutmelding in plaats van een antwoord.
Dus draait het vernieuwen op een timer op de achtergrond, en leest de gespreksroute alleen het token dat er al ligt.
Exact staat niet meer dan tien fouten toe per API-sleutel, per gebruiker, per administratie, per endpoint, per uur. Ga je daaroverheen, dan wordt de sleutel geblokkeerd, en die blokkade valt er een uur later vanzelf weer af. Een voice-agent die een mislukte zoekopdracht blijft herhalen is de snelste weg naar dat plafond, en hij zou dat doen tijdens precies de storing die je het liefst kort houdt. Het is nog een reden waarom een tool call op ons platform één poging krijgt en niet drie.
Getallen
- Limiet
- 60 aanroepen / minuut per administratie
- Daglimiet
- 5.000 aanroepen / dag per administratie
- Access token
- 10 minuten geldig
- Vernieuwdrempel
- 570 seconden tussen twee aanvragen
- Foutenplafond
- 10 fouten per sleutel, gebruiker, administratie, endpoint, uur
In de praktijk
Een herkend gesprek, van begin tot eind
tokendienst · achtergrond, los van het verkeer
[auth] vernieuwd · drempel 570s gehaald · ok 08:41:00
inbound +31612345678 t+0.00s
[token] uit geheugen · nog 6 min geldig t+0.00s
[eol] GET /crm/Accounts?$filter=...
[eol] 200 · 1 relatie · 520ms t+0.52s
[eol] GET /SalesInvoices?$filter=...
[eol] 200 · 1 open factuur · 480ms t+1.00s
[agent] "Die van 12 augustus staat open." t+1.08s
limietbudget gebruikt 2 van 60 per minuut
tokens opgehaald 0 · dat is de hele trucWat we bouwen
Eerst een tokendienst, dan pas de rest
Het eerste onderdeel is niet het opzoeken. Het is een kleine dienst die het huidige access token vasthoudt, het ruim binnen dat venster van tien minuten op een vast ritme vernieuwt, en het uitdeelt aan al het andere. Staat die er eenmaal, dan is de rest gewoon werk: gefilterd lezen op de gespreksroute, schrijven in een wachtrij voor na het gesprek, en een stroomonderbreker die Exact helemaal met rust laat zodra de fouten beginnen, zodat die blokkade van een uur nooit valt.
vernieuwen elke 8 minuten, op een timer
drempel minimaal 570s tussen aanvragen, afgedwongen
gespreksroute leest alleen · vraagt nooit een vernieuwing aan
bij fouten stroomonderbreker na 3 fouten in 10 minuten
// Die stroomonderbreker bestaat vanwege het foutenplafond:
// 10 fouten kost je een blokkade van een uur, en een
// herhaallus haalt die 10 sneller dan een mens het merkt.Wat we van je nodig hebben
Vier dingen, en één ervan is een persoon
De app-registratie
Client id en secret in jouw omgeving, met de bijbehorende redirect. De inloggegevens staan achter het endpoint waar wij naartoe posten, nooit op ons platform.
Welke administraties
Het limietbudget wordt per administratie geteld en loopt niet in elkaar over. Vier administraties bedienen vanuit één koppeling is vier budgetten, niet één gedeeld budget.
Ergens waar de tokendienst kan draaien
Hij moet aan blijven staan als er niemand belt, want de timer trekt zich niets aan van de telefoon. Dit is het enige onderdeel dat niet pas bij een verzoek mag opstarten.
Wie je waarschuwt als de sleutel geblokkeerd is
Een blokkade duurt een uur en valt er vanzelf af. Iemand moet dat weten voordat hij dingen gaat herstarten en het erger maakt.
Wat we het eerst gevraagd krijgen
Kan de agent Exact live lezen tijdens een gesprek?
Ja, voor het gefilterd lezen van één record, en ruim binnen de dertig seconden die een tool call krijgt. Wat hij niet kan is eerst een token ophalen, en daarom bestaat de tokendienst.
Wat gebeurt er als Exact traag is of plat ligt?
De tool call loopt af, de agent krijgt te horen dat het opzoeken mislukte, en hij zegt dat en biedt aan terug te bellen of door te verbinden. Hij verzint geen saldo. Dichtvallen bij twijfel is hier een keuze op platformniveau en niet iets per koppeling.
Geldt de limiet per administratie?
Ja. Zestig aanroepen per minuut en vijfduizend per dag worden per administratie geteld, en dat telt zwaar als je meerdere administraties bedient vanuit één koppeling, want het budget loopt niet in elkaar over.
Van wie is de app-registratie bij Exact?
Van jou. De inloggegevens staan in jouw omgeving achter het endpoint waar wij naartoe posten, dus de tokendienst is ook van jou, of wij hem nu samen met je bouwen of jij hem zelf schrijft.
Dieper graven
De twee artikelen onder deze pagina
Dertig seconden, één poging
Waarom een tool call één poging krijgt, welke zoekopdrachten een gesprek mogen ophouden, en wat de agent zegt terwijl hij wacht.
Dertig seconden, één pogingWeten wie er belt voordat hij het zegt
Het nummer komt binnen in E.164 en je CRM bevat zes andere vormen. Normaliseren, cachen en gedeelde nummers.
Weten wie er belt voordat hij het zegtKom maar met de lastige
Stuur het systeem, de API-documentatie en één gesprek dat je wilt automatiseren. Tijdens de kennismaking zeggen we of het zware deel de code is of de inrichting, en welke van de twee de datum bepaalt.