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 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.

Vijf routes, per vestiging

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

• settings — de instellingenkaarten lezen en bijwerken: stem, spreeksnelheid (ai_speech_speed, 0,25 tot 1,5), stemdienst (ai_stemdienst: openai of azure) en Nederlandse stem (ai_azure_stem: nl-NL-ColetteNeural, nl-NL-FennaNeural of nl-NL-MaartenNeural), Gastvrouw inschakelen, Zelf aannemen tot, scenario en begroetingen, het Telnyx-nummer, de drie doorverbindnummers en de OpenAI-koppeling. Bij lezen komen de API-sleutel en het webhookgeheim gemaskeerd terug. Zie De OpenAI-sleutel invoeren en testen en Doorverbindnummers instellen.
• settings/test-openai — dezelfde test die de knop Verbinding testen op de OpenAI-kaart uitvoert. Zonder sleutel in het verzoek test hij de sleutel die een gesprek nu zou gebruiken.
• faq — de FAQ 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 bewaart de opdracht vanzelf zodra je het vak verlaat, en roept daarbij exact deze route aan; 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 stem en Gastvrouw inschakelen altijd expliciet mee. Die worden bij elke opslag overschreven met wat je meestuurt; laat je ze weg, dan vallen ze terug op hun standaardwaarde. Dat kan de gastvrouw ongewild uitzetten. Het scenario (ai_scenario), de spreeksnelheid (ai_speech_speed) en de begroetingen (ai_begroeting_assistent, _open, _gesloten, _druk) blijven juist staan als je ze weglaat; een lege begroeting zet de standaardtekst terug en een snelheid buiten 0,25 tot 1,5 wordt geweigerd, dan bewaart Morris niets. De oude velden voor telefoonuren worden niet meer gebruikt.
• Een leeg veld of een ontbrekend veld is niet hetzelfde. Stuur je een doorverbindnummer of het project-ID als lege tekst mee, dan wordt die waarde gewist. Laat je het veld helemaal weg, dan blijft de bestaande waarde staan. De groepsgrootte blijft staan als je hem weglaat.
• De API-sleutel wis je met openai_api_key_wissen: true. Een leeg of ontbrekend sleutelveld laat de bestaande sleutel 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.

Meer over AI-telefonie op morris-horeca.nl.

Bijgewerkt op 15 oktober 2026