API og webhooks

Denne side er til den, der sætter jeres eget system op — fx en webshop, et CRM eller et automatiseringsværktøj som Zapier eller Make. Der er to retninger:

• API — jeres system sender henvendelser ind i Telenoa.
• Webhook — Telenoa sender nye henvendelser ud til jeres system.

Send henvendelser ind (API)Kopiér link til afsnittet

Alle formularer har også en nøgle. Du finder den i menuen ud for kilden: Kopiér API-nøgle.

Send en POST med JSON til adressen:

curl -X POST https://app.telenoa.com/api/v1/submit/<nøgle> \
  -H "Content-Type: application/json" \
  -d '{"name":"Anna Jensen","email":"anna@firma.dk","subject":"Tilbud","message":"Hej …"}'

• Felterne name, email, phone, subject og message kendes. Alt andet gemmes som egne felter.
• Der skal være mindst en email eller en message.
• Svaret er {"success": true, "id": "…"}.
• Formdata (application/x-www-form-urlencoded) virker også.

Tilladte domænerKopiér link til afsnittet

Skriver du tilladte domæner, bliver kald fra andre hjemmesider afvist. Kald fra en server uden Origin er altid tilladt. Tomt betyder, at alle må sende.

GrænserKopiér link til afsnittet

• 60 kald i minuttet pr. nøgle og 20 i minuttet pr. IP-adresse.
• Højst 5 henvendelser på 5 minutter fra samme mailadresse.
• Højst 100 KB pr. kald og 10.000 tegn i beskeden.

Bliver en grænse ramt, svarer Telenoa med HTTP 429. En nøgle, der er sat på pause eller slettet, giver HTTP 401.

Send nye henvendelser ud (webhook)Kopiér link til afsnittet

Webhooks kræver Pro, Business eller Enterprise.

Hver ny henvendelse sendes som JSON — uanset om den kom fra en formular, en widget, API'et, en mail eller et opkald til Noa Voice. Mail, der lander i Spam, sendes ikke:

{
  "event": "inquiry.created",
  "inquiry": {
    "id": "…",
    "org_id": "…",
    "api_id": "…",
    "category_id": null,
    "status": "active",
    "priority": "medium",
    "owner_user_id": null,
    "team_id": null,
    "contact_email": "anna@firma.dk",
    "created_at": "2026-09-29T10:00:00.000Z"
  }
}

Henvendelser fra mail og opkald har desuden feltet channel (mail eller phone), og api_id peger på kilden Email eller Telefon.

Tjek, at det er osKopiér link til afsnittet

Har du skrevet en hemmelighed, sender Telenoa headeren x-telenoa-signature. Den er en HMAC-SHA256 af hele JSON-teksten med hemmeligheden som nøgle, skrevet som hex. Den samme værdi sendes også i den gamle header x-sentreo-signature, så eksisterende modtagere bliver ved med at virke. Regn den samme værdi ud på jeres side, og afvis kald, hvor den ikke passer.

LeveringerKopiér link til afsnittet

Under indstillingen ser du de seneste leveringer: Leveret, Venter eller Fejlede. Svarer jeres adresse ikke med 2xx, prøver Telenoa igen — op til 5 forsøg i alt.

Skifter I ned til Essential, bliver adressen gemt, men intet sendes, før I opgraderer igen.

Se ogsåKopiér link til afsnittet

• Webhooks — flere hændelser, signeret efter Standard Webhooks
• Kilder
• Kategorier og regler
• Plan og forbrug