Telefoniegegevens via de API benaderen voor een eigen koppeling

Dezelfde routes waarmee Morris zelf het instellingentabblad en de beheerpagina vult, zijn ook rechtstreeks aan te roepen: instellingen, FAQ, de gesprekkenlijst en — sinds vandaag — de opdracht aan de gastvrouw.

Wanneer gebruik je dit

Je wilt telefonie-gegevens van buiten Morris om uitlezen of bijwerken — bijvoorbeeld vanuit een eigen koppeling — in plaats van via het instellingentabblad of de beheerpagina zelf.

Vier onderdelen, per vestiging

Onder /api/telefonie/<naam-van-je-vestiging>/… staan vier onderdelen, elk met dezelfde routes die het instellingentabblad en de beheerpagina zelf ook gebruiken:

• settings — de instellingenkaarten lezen en bijwerken: stem, Gastvrouw inschakelen, het venster, Ook in het weekend, Zelf aannemen tot, de drie doorverbindnummers en de OpenAI-koppeling. Bij lezen komen de API-sleutel en het webhookgeheim gemaskeerd terug. Zie Hoe de OpenAI-sleutel en de doorverbindnummers worden bewaard.
• settings/test-openai — dezelfde test die de knop Verbinding testen op de OpenAI-kaart uitvoert.
• faq — de kennisbank van de gastvrouw lezen, een vraag toevoegen en een vraag verwijderen. Een vraag rechtstreeks bewerken kan hier niet, net zomin als op de beheerpagina zelf. Zie Een FAQ-antwoord toevoegen of verwijderen.
• gesprekken — de gesprekkenlijst opvragen, tot maximaal tweehonderd gesprekken per aanroep.
• prompt — de opdracht aan de gastvrouw lezen en vastleggen. Het tekstveld op het instellingentabblad heeft een eigen knop Opdracht opslaan die exact deze route aanroept; deze API-weg is dus geen alternatief ervoor, maar dezelfde route rechtstreeks benaderen. Zie Wat je in een opdrachtveld typt, komt er niet altijd in.

Toegang

Elke aanroep moet de header x-admin-api-key meesturen, met dezelfde sleutel die het instellingentabblad en de beheerpagina zelf ook gebruiken — en die nooit in je browser terechtkomt. Zie Wie telefoongesprekken mag zien en instellen. Ontbreekt de sleutel of klopt hij niet, dan antwoordt elke route hetzelfde: geweigerd, en er verandert niets.

Let op

• Stuur bij settings de schakelaars en het venster altijd expliciet mee. Stem, Gastvrouw inschakelen, Altijd bereikbaar, Ook in het weekend én de tijden Van/Tot worden bij elke opslag overschreven met wat je meestuurt — laat je ze weg, dan vallen ze terug op hun standaardwaarde (de tijden worden dan zelfs leeggemaakt). Dat kan de gastvrouw ongewild uitzetten of haar venster ongewild wissen. De doorverbindnummers, het project-ID en de groepsgrootte werken wel met een leeg veld: dat laat de bestaande waarde staan.
• Deze routes zijn precies dezelfde routes die het instellingentabblad en de beheerpagina zelf aanroepen via een tussenstation op de server — er is geen apart "koppelingen"-systeem ernaast.
• De webhooks waarmee de telefonieprovider zelf een inkomend gesprek meldt, vallen hier niet onder en vragen geen x-admin-api-key. Zie Wie een gesprek kan laten aanmaken zonder dat er echt gebeld is.

Bijgewerkt op 28 augustus 2026