architectuur & techniek

Onder de motorkap.

Voor wie liever weet hoe het werkt dan wat het oplevert: hier staat de stack, de protocollen en de architecturale keuzes — inclusief de afwegingen die we bewust niet anders hebben gemaakt.

telefonie

SIP, WebRTC en Asterisk ARI

Het callplatform draait op Asterisk, aangestuurd via de ARI (Asterisk REST Interface) in plaats van traditionele dialplan-logica. Dat maakt routing, IVR-stappen en call-events programmeerbaar en testbaar, zonder dialplan-scripts te moeten onderhouden.

Agents verbinden via WebRTC rechtstreeks vanuit de browser; externe trunks lopen via standaard SIP. Geen eigen, gesloten signaleringsprotocol — wat binnenkomt via SIP, kan ook weer via SIP naar een andere trunk of provider.

SIP trunk
→
Asterisk
→
ARI events
→
Velio routing-engine
→
WebRTC agent
nextcloud talk

De Velio–Talk-brug

Een agent in Velio kan een collega in Nextcloud Talk bellen, ruggespraak houden en het gesprek doorverbinden — zonder dat die collega een telefoon-app draait, en zonder dat de agent zelf een Talk-client nodig heeft. Het niet-spraakdeel — directory search en presence — loopt via de open OCS-API van Nextcloud.

Voor spraak zet Velio een eigen media-brug in: een headless component dat een Asterisk-kanaal koppelt aan een Talk-gesprek en het geluid tussen beide werelden transcodeert (WebRTC ↔ RTP, Opus ↔ G.711). De brug draait als apart proces náást het platform en praat via WebRTC met de Nextcloud-omgeving van de klant. De Talk-collega blijft gewoon in Talk — er komt één deelnemer bij die de Velio-kant vertegenwoordigt, herkenbaar aan de gespreksnaam.

De doorverbind-choreografie is transport-onafhankelijk opgezet: het gesprek weet enkel dat het naar "een kanaal" gaat. Daardoor ondersteunt Velio zowel de eigen WebRTC-brug als de officiële Talk SIP-bridge als spraakpad, zonder dat de rest van het product verandert. De gespreksopname stopt zodra de Velio-kant de call verlaat — geen doorlopende opname van een Talk-collega zonder grondslag.

Asterisk-kanaal
→
Velio media-brug
↔
WebRTC / Nextcloud HPB
→
Talk-collega
identiteit

OIDC, RBAC & sessies

Authenticatie loopt via OpenID Connect tegen je bestaande identity provider — geen lokale gebruikersdatabase die apart bijgehouden moet worden. Rollen (agent, supervisor, beheerder) worden afgedwongen op zowel API- als UI-niveau via RBAC, met scopes per contact center in plaats van platformbreed.

GET /api/v1/queues/{id}/stats
Authorization: Bearer <oidc_token>
required_role: supervisor | admin
infrastructuur

Voorspelbaarheid boven complexiteit

Velio draait op cloud VPS-infrastructuur, volledig geprovisioned via Ansible. Bewuste keuze: voorspelbaarheid boven complexiteit — geen actieve multi-node HA-clustering, maar een omgeving die binnen minuten opnieuw en identiek opgebouwd kan worden vanuit playbooks.

Dat betekent: bij een storing herstellen we door opnieuw te deployen, niet door te failoveren naar een continu meedraaiende schaduwomgeving. Minder onderhoudslast, minder verborgen state, en een infrastructuur die te begrijpen blijft door één persoon.

Data die niet uit een playbook terugkomt — de database, de opnames — is gedekt door continue back-ups met point-in-time recovery en een versleutelde kopie buiten de server. "Opnieuw deployen" brengt zo ook je gegevens terug, tot op het moment vlak vóór de storing.

provisioning
Ansible playbooks, idempotent
compute
Cloud VPS (NL)
herstel
Re-deploy, geen failover-cluster
back-up
pgBackRest · PITR · off-site
beveiliging

Security als randvoorwaarde, niet als feature

We zijn open over de status hiervan: Velio bevindt zich in actieve ontwikkeling, en een externe, onafhankelijke security-review staat op de planning voordat grotere implementaties volgen.

stack

In het kort

telefonie
Asterisk · ARI · SIP · WebRTC
identiteit
OIDC · RBAC
infrastructuur
Ansible · Cloud VPS
integratie
Directory search · Presence · Nextcloud Talk
documentatie

Architectuur & ontwerpfilosofie

Het volledige document met de productvisie, de ontwerpprincipes en het High Level Design — inclusief referentiearchitectuur, koppelvlakken, security en deployment, met schematische diagrammen. Bedoeld voor architecten, beheerders en partners die willen weten hoe en waarom Velio in elkaar zit.

Velio — Architectuur & Ontwerpfilosofie

Productvisie, High Level Design en referentiearchitectuur.

PDF · Nederlands
↓ Download (NL) ↓ English (EN)