For utviklere
Hvordan integrere med DealBuilder
Med DealBuilder kan du enkelt integrere systemene dine ved hjelp av webhooks og GET-forespørsler. Dette gir deg mulighet til å automatisere arbeidsflyten, redusere manuelt arbeid og sikre at data flyter sømløst mellom DealBuilder og andre forretningssystemer.
🛠️ To enkle måter å integrere på:
- Webhooks – Motta data fra DealBuilder når spesifikke hendelser skjer (f.eks. når et dokument blir sent eller signert).
- GET-forespørsel til DealBuilder – Send data fra egne systemer til DealBuilder ved å forhåndsutfylle kontrakter automatisk.
📡 1. Integrasjon via webhooks
Webhooks lar deg automatisk motta data fra DealBuilder til ditt system hver gang en definert hendelse skjer. Dette kan for eksempel være når et dokument sendes, åpnes eller signeres.
Slik setter du opp en webhook:
- Gå til Admin > Webhooks i DealBuilder.
- Trykk på Legg til webhook.
- Fyll inn følgende:
- Navn: Gi integrasjonen et beskrivende navn, f.eks. Fra DealBuilder til CRM.
- URL: Legg inn endepunktet som skal motta data.
- E-post ved feil: Fyll inn en e-postadresse for varslinger dersom noe går galt.
- Hendelse: Velg hva som skal trigge webhooken (f.eks. Dokument signert).
👉 Tips: For å teste webhooken kan du bruke en tjeneste som webhook.site for å se hvordan dataen struktureres på hver av eventene.
Du kan også se dette dokumentet for å se hvordan dataen er strukturert (her ved eventet "Dokument signert"): https://docs.google.com/document/d/1tguzjCzpw8vGWmkU_IR7Xy4TPtkp9fmoLvlQm-hZrmU/edit?usp=sharing
✅ Testing av webhooks
Når webhooken er lagret, kan du teste at alt fungerer. Trykk på "Kjør test", men vær oppmerksom på at det må være data i kontoen din for det eventet du tester.
For eksempel:
Hvis du har satt opp en webhook med hendelsen "Dokument signert", må du ha et signert dokument i DealBuilder-kontoen din for å kjøre en test. Systemet vil automatisk bruke det siste signerte dokumentet som testdata.
Hvis kontoen din ikke har noen relevante data, vil testen ikke kunne gjennomføres.
👉 Tips: Send først ut et dokument til signering og signer det, slik at du har noe å teste med.
🧩 Tilgjengelige hendelser for webhooks:
- Dokument sendt – Når et dokument sendes fra DealBuilder.
- Dokument åpnet – Når mottakeren åpner dokumentet.
- Dokument signert – Når dokumentet blir signert (all data fra dokumentet følger i én webhook)
- Signeringsfrist utløpt – Når signeringsfristen på dokumentet utløper.
- Dokument sendt til intern godkjenning – Når et dokument må godkjennes internt før det sendes til signering.
- Dokument signert (per ordrelinje) – Sender én webhook per ordrelinje i dokumentet.
📥 2. Integrasjon via GET-forespørsel til DealBuilder
Du kan fylle ut kontraktsmaler automatisk i DealBuilder ved å sende en GET-forespørsel til følgende endepunkt:
https://app.dealbuilder.io/Contract/CreateNewContractExternal
Ved å inkludere informasjon som kunde-ID, organisasjonsnummer, e-postadresse og andre data i URL-en, kan du forhåndsutfylle kontrakter direkte fra ditt eget system.
Eksempel:
https://app.dealbuilder.io/contract/createnewcontractexternal?email=ole@eposten.com&phonenumber=004741434544&companyname=Eksempelfirma%20AS
&customername=Ole+Hansen&address=Eksempelveien%2032+0101+Oslo&visitaddress
=Eksempelveien%2032+0101+Oslo&orgnumber=321654789&CRMid=4963935370
Når kontrakten blir signert, kan du bruke webhooks til å hente ut kunde-ID og annen tilhørende informasjon, slik at dataen automatisk sendes tilbake til ditt system.
📋 Du kan fylle ut DealBuilder med følgende datapunkter automatisk:
I tillegg kan du legge til egne felter under Admin > Maler > Skreddersydde felter for å tilpasse kontraktene dine enda mer.
Du velger selv oppsett og navn for skreddersydde felter, så dette kan i teorien være hva som helst av felter som du ønsker.
Skreddersydde felter kan plasseres på toppen av dokumentet (under Firmanavn, Kontaktperson osv.), eller de kan plasseres under ordrelinjene fra produktmodulen.
Skreddersydde felter kan også være skjulte. Det vil si at de kan ha en verdi, men det vises ikke i dokumentet for mottakeren, men er en del av metadataen til dokumentet og er tilgjengelig gjennom datasettet i webhooken.
🚀 Hva betyr dette i praksis?
Dette betyr at dere enkelt kan sette opp en knapp eller link til DealBuilder i deres eget system. Når brukeren klikker på denne for å opprette en ny kontrakt eller et tilbud, åpnes DealBuilder ferdig utfylt med informasjon om motparten (f.eks. kunden) og eventuelle skreddersydde felter som kunde-IDer eller spesifikke prosjektdetaljer.
Ved å forhåndsutfylle kontrakter med data fra deres system, sparer dere både tid og sikrer at riktige opplysninger følger med i avtalene.
Fra før av kan dere ha klargjort maler i DealBuilder som inneholder deres egne avtaletekster, vilkår og vedlegg. Når brukeren starter en ny kontrakt fra sitt system, trenger de kun å justere innholdet i avtalemalen før de sender ut et tilbud eller en kontrakt – dette kan gjøres på få sekunder.
For at dette skal fungere må brukerne det er snakk om også ha en brukertilgang i DealBuilder, som de på forhånd er logget inn i DealBuilder med.
📦 Produktmodul for dynamiske avtaler
DealBuilder har også en egen produktmodul som gjør det mulig å legge til produkter direkte i avtalemalene på en dynamisk måte.
Dette betyr at brukeren, i tillegg til forhåndsutfylt kundeinformasjon, også kan legge til produkter fra produktbiblioteket i DealBuilder før avtalen eller tilbudet sendes til signering. Dette gir en rask, fleksibel og helhetlig prosess for både kundeavtaler og tilbudshåndtering.
🎥 Se hvordan det fungerer
Vil du se hvordan du kan integrere DealBuilder med dine egne systemer?
Vi har laget en kort video som viser deg hele prosessen – fra oppsett av webhooks til testing og bruk.
👉 Slik setter du opp en ny webhook: https://www.loom.com/share/7e9821361b1f4e2e952c3eab538b1c34?sid=4d93fdd8-6e2d-4a2d-890c-d2a66ca08bd7
👉 Slik kan du sende data til DealBuilder (GET-forespørsel /Query URL): https://www.loom.com/share/87d7c294d1fa4e28870c4fbeae4a992e?sid=676db381-5536-4252-b542-18279ef1335f
📧 Trenger du hjelp med integrasjoner?
Du kan sette opp integrasjonene selv ved hjelp av webhooks og GET-forespørsler, få innspill eller hjelp av oss, eller kontakte en av våre integrasjonspartnere for bistand. Våre partnere hjelper deg med å bygge skreddersydde integrasjoner som passer dine behov og automatiserer viktige prosesser.
👉 Ta kontakt med oss på post "@" dealbuilder.io for mer informasjon om dette.