Webhooks: Få beskjed når et møte er klart

En webhook er en adresse du gir Dara. Når noe skjer med et møte du har tilgang til, sender Dara en melding dit med en gang. Du slipper å spørre API-et om det har skjedd noe nytt.

Typisk bruk: en Zapier- eller Make-flyt som legger oppsummeringen i HubSpot, Notion eller Slack så snart møtet er ferdig. Eller ditt eget system som skal vite når det er nytt å hente.

Webhooks er inkludert i Bedrift-planen, sammen med API-nøkler. Webhooken forteller deg at noe skjedde og sender med oppsummeringen. Trenger du transkripsjonen eller mer, henter du det fra API-et med en nøkkel.

Hendelser du kan abonnere på

• Oppsummering klar (meeting.summary_ready): Dara er ferdig med å oppsummere et møte. Den de fleste vil ha.

• Oppsummering endret (meeting.summary_updated): noen redigerte eller slettet oppsummeringen. Sendes én gang etter at redigeringen har roet seg i to minutter, ikke for hvert tastetrykk.

• Transkripsjon klar (meeting.transcript_ready): transkripsjonen er ferdig, litt før oppsummeringen.

• Møte delt med meg (meeting.shared): noen delte et møte direkte med deg.

• Møte slettet (meeting.deleted): et møte du tidligere har fått varsel om ble slettet. Nyttig for å rydde i systemet du har sendt det til.

Du får bare meldinger om møter du selv ser i Dara: dine egne, de som er delt med deg, og de i mapper du har tilgang til. Du kan også begrense en webhook til bestemte mapper, for eksempel bare «Kundemøter».

Sett opp en webhook

1. Lag først adressen i det andre systemet. I Zapier: ny Zap med trigger «Webhooks by Zapier → Catch Hook», kopier adressen. I Make: «Webhooks → Custom webhook». I n8n: en Webhook-node.

2. I Dara: Innstillinger → Integrasjoner → Webhooks → Legg til webhook. Lim inn adressen, velg hendelser, eventuelt mapper, og opprett.

3. Du får en signeringshemmelighet (whsec_…). Kopier den nå, den vises bare én gang. Du trenger den bare hvis du vil verifisere avsender (anbefalt for egne systemer, unødvendig i Zapier).

4. Trykk Send test. Dara sender en webhook.test-melding og viser svaret fra mottakeren. I Zapier dukker den opp som testdata du kan bygge resten av flyten på.

Slik ser meldingen ut

En POST med JSON. For meeting.summary_ready:

{
  "id": "8f3c…",
  "type": "meeting.summary_ready",
  "created_at": "2026-10-11T12:30:00.000Z",
  "data": {
    "meeting": {
      "id": "5555…",
      "title": "Ukesmøte salg",
      "date": "2026-10-11T09:00:00.000Z",
      "duration_seconds": 1800,
      "owner": "Kari Nordmann",
      "is_mine": true,
      "folder": { "id": "4444…", "name": "Salg" },
      "attendees": [{ "name": "Ola", "email": "ola@firma.no" }],
      "summary_markdown": "# Oppsummering\n…",
      "my_notes": null,
      "has_transcript": true,
      "url": "https://api2.meetdara.co/v1/meetings/5555…"
    }
  }
}

meeting.shared har i tillegg data.shared_by med navnet på den som delte. meeting.deleted har bare data.meeting.id, siden møtet ikke finnes lenger. Feltet id øverst er det samme ved alle nye forsøk på samme levering, så du kan bruke det til å hoppe over duplikater.

Verifisere at det er Dara som sender

Hver melding har tre headere etter Standard Webhooks-formatet: webhook-id, webhook-timestamp (Unix-sekunder) og webhook-signature (v1,<base64>). Signaturen er HMAC-SHA256 over id.timestamp.body med hemmeligheten din (delen etter whsec_, base64-dekodet) som nøkkel.

// Node.js
import { createHmac, timingSafeEqual } from "crypto";

function verify(secret, headers, rawBody) {
  const key = Buffer.from(secret.replace("whsec_", ""), "base64");
  const signed = `${headers["webhook-id"]}.${headers["webhook-timestamp"]}.${rawBody}`;
  const expected = createHmac("sha256", key).update(signed).digest("base64");
  const received = headers["webhook-signature"].split(",")[1];
  return timingSafeEqual(Buffer.from(expected), Buffer.from(received));
}

Biblioteker som standardwebhooks (npm, pip) og Svix sine gjør det samme med én linje. Avvis meldinger der tidsstempelet er mer enn fem minutter gammelt.

Feil og nye forsøk

Dara regner alt som svarer 2xx innen 10 sekunder som levert. Svar raskt og gjør jobben etterpå. Ved feil prøver vi igjen etter 1 minutt, 5 minutter, 30 minutter, 2 timer og 12 timer, og gir så opp den ene leveringen. Feiler 50 leveringer på rad, slår vi webhooken av og viser hvorfor i Dara. Du slår den på igjen med ett klikk når mottakeren er oppe, og det som har stått i kø går ut da.

Under hver webhook i Dara ser du de siste 25 leveringene med tidspunkt, hendelse, status, svarkode og eventuell feilmelding. Det er stedet å begynne når noe ikke kommer frem.

Begrensninger

• Inntil 10 webhooks per bruker.

• Adressen må være https og på det åpne internettet. Lokale adresser og interne nett går ikke. Bruk en tunnel som ngrok under utvikling.

• Webhooken er personlig og følger ditt aktive workspace, på samme måte som API-nøkler. Slutter du i workspacet, eller workspacet går av Bedrift-planen, slutter webhooken å sende.