API og integrationer

API'et er til jer, der har et journalsystem, et CRM eller et regneark, der skal kende det samme som TelefonAI. Alt, hvad I kan se på skærmen, kan hentes og skrives den vej.

1. Lav en nøgle

Indstillinger → API og integrationer → Ny nøgle. Vælg de scopes, nøglen skal have — en nøgle, der kun skal læse bookinger, skal ikke kunne slette kunder. Se API-nøgler og scopes.

Nøglen vises én gang. Kopiér den med det samme.

2. Kald API'et

GET https://telefonai.dk/api/v1/bookings?from=2026-09-18
Authorization: Bearer <din-nøgle>

Hele dokumentationen med alle endepunkter, felter og svar står på telefonai.dk/docs. Den er altid den nyeste — den bliver skrevet ud fra koden, ikke ved siden af den.

3. To ting, der sparer jer for besvær

Send en Idempotency-Key med, når I opretter noget. Svigter netværket midtvejs, og I prøver igen, får I det første svar tilbage i stedet for en dublet booking.

Lad os sige til frem for at spørge. I stedet for at kalde hvert minut for at se, om der er sket noget, opretter I en webhook: vi sender en besked til jeres adresse, når et opkald er slut, en booking laves eller en sms kommer ind. Beskeden er signeret i x-telefonai-signature, og vi prøver igen efter 1 minut, 5 minutter, 15 minutter, 1 time og 6 timer, hvis jeres system er nede.

4. Pas på nøglen

• Nøglen hører til på jeres server, i en miljøvariabel — aldrig i kode, der sendes til en browser eller en app.
• Én nøgle pr. system. Så kan I tilbagekalde den ene uden at stoppe de andre.
• Er den sluppet ud: tilbagekald den samme sted, og lav en ny. Det tager sekunder.

Kom hurtigere i gang

Guiderne har færdig kode, I kan kopiere: en webhook-modtager, der holder, hold kartoteket synkront og tovejs-sms i jeres eget system.