För utvecklare
Hur du integrerar med DealBuilder
Med DealBuilder kan du enkelt integrera dina system med hjälp av API, webhooks eller GET-förfrågningar.
Detta gör det möjligt att automatisera arbetsflöden, minska manuellt arbete och säkerställa att data flödar sömlöst mellan DealBuilder och dina andra affärssystem.
🛠️ Tre enkla sätt att integrera
- Webhooks – Ta emot data från DealBuilder när specifika händelser inträffar (t.ex. när ett dokument skickas eller signeras).
- GET-förfrågan till DealBuilder – Skicka data från egna system till DealBuilder för att automatiskt förifylla avtal.
- API – Ett komplett API för automatiserad dokumenthantering och produktsynkronisering.
(Se guiden för API-integrationer här.)
📡 1. Integration via webhooks
Webhooks låter dig automatiskt ta emot data från DealBuilder till ditt system varje gång en definierad händelse inträffar – till exempel när ett dokument skickas, öppnas eller signeras.
Så här ställer du in en webhook:
- Gå till Admin > Webhooks i DealBuilder.
- Klicka på Lägg till webhook.
- Fyll i följande:
- Namn: Ge integrationen ett beskrivande namn, t.ex. Från DealBuilder till CRM.
- URL: Ange slutpunkten (endpoint) som ska ta emot data.
- E-post vid fel: Fyll i en e-postadress för aviseringar om något går fel.
- Händelse: Välj vad som ska trigga webhooken (t.ex. Dokument signerat)
👉 Tips: Testa gärna webhooken via en tjänst som webhook.site för att se hur datan struktureras för respektive händelse.
Du kan även se ett exempel på datastrukturen här (vid eventet Dokument signerat):
Google-dokument: webhookexempel
✅ Test av webhooks
När webhooken har sparats kan du testa att allt fungerar genom att klicka på Kör test.
Observera att du behöver ha data i ditt konto för den händelse du testar.
Exempel:
Om du har satt upp en webhook för händelsen Dokument signerat måste du ha ett signerat dokument i ditt DealBuilder-konto för att köra testet.
Systemet använder automatiskt det senast signerade dokumentet som testdata.
👉 Tips: Skicka först ut ett dokument för signering och signera det själv för att ha testdata tillgängligt.
🧩 Tillgängliga händelser för webhooks
- Dokument skickat – När ett dokument skickas från DealBuilder.
- Dokument öppnat – När mottagaren öppnar dokumentet.
- Dokument signerat – När dokumentet signeras (all data skickas i en webhook).
- Signeringsfrist utgången – När tidsfristen för signering löper ut.
- Dokument skickat för intern godkännande – När ett dokument först måste godkännas internt innan det skickas till signering.
- Dokument signerat (per orderrad) – Skickar en webhook per orderrad i dokumentet.
📥 2. Integration via GET-förfrågan till DealBuilder
Du kan automatiskt förifylla avtalsmallar i DealBuilder genom att skicka en GET-förfrågan till följande endpoint:
https://app.dealbuilder.io/Contract/CreateNewContractExternal
Genom att inkludera information som kund-ID, organisationsnummer, e-postadress m.m. i URL:en kan du skapa färdigifyllda avtal direkt från ditt eget system.
Exempel:
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 avtalet har signerats kan du använda webhooks för att hämta kund-ID och annan information tillbaka till ditt system.
📋 Du kan automatiskt fylla i följande datapunkter i DealBuilder:
Du kan även lägga till egna fält under Admin > Mallar > Anpassade fält för att skräddarsy dina avtal ännu mer.
Dessa kan placeras antingen högst upp i dokumentet eller under orderraderna i produktmodulen, och kan även vara dolda (metadata i webhooken).
🚀 Vad betyder detta i praktiken?
Det innebär att ni enkelt kan lägga in en knapp eller länk till DealBuilder i ert eget system.
När användaren klickar på den för att skapa ett nytt avtal eller offert öppnas DealBuilder redan färdigifyllt med kundinformation och eventuella anpassade fält (t.ex. kund-ID eller projektdetaljer).
Det sparar tid, minskar manuellt arbete och säkerställer att rätt uppgifter alltid följer med i avtalen.
Ni kan också ha färdiga mallar i DealBuilder med era egna villkor och bilagor.
När användaren startar ett nytt avtal från ert system behöver de bara göra små justeringar innan det skickas – hela processen tar bara några sekunder.
För att detta ska fungera måste användarna ha en DealBuilder-inloggning och vara inloggade i systemet.
📦 Produktmodul för dynamiska avtal
DealBuilder har en produktmodul som gör det möjligt att lägga till produkter direkt i avtalsmallarna på ett dynamiskt sätt.
Det betyder att användaren, förutom kundinformation, även kan lägga till produkter från produktbiblioteket i DealBuilder innan avtalet eller offerten skickas till signering – en snabb, flexibel och helhetslös process.
🎥 Se hur det fungerar
Vill du se hur du kan integrera DealBuilder med dina egna system?
Vi har skapat korta videor som visar hela processen – från inställning av webhooks till testning och användning:
👉 Så här skapar du en ny webhook:
https://www.loom.com/share/7e9821361b1f4e2e952c3eab538b1c34?sid=4d93fdd8-6e2d-4a2d-890c-d2a66ca08bd7
👉 Så här skickar du data till DealBuilder (GET-förfrågan / Query URL):
https://www.loom.com/share/87d7c294d1fa4e28870c4fbeae4a992e?sid=676db381-5536-4252-b542-18279ef1335f
🔌 3. Integration via API
DealBuilders API ger dig kraftfull och flexibel automatisering av hela dokumentflödet – både för färdiga PDF-dokument och mallbaserade avtal.
📌 Tre huvudtyper av dokumentflöde via API
- PDF-signering (automatisk)
Skicka in en färdig PDF med signatörer och eventuella metadata.
Mall-ID styr deadlines, signeringsmetod, notifieringar m.m.
Dokumentet skickas automatiskt till signering, och webhooken returnerar status. - Dokument genererat från mall (automatisk)
Ett externt system skickar in data som produkter, antal, priser, villkor, bilagor m.m.
DealBuilder genererar dokumentet baserat på mallen och skickar det direkt till signering. - Halvautomatisk dokumentflöde
Samma som ovan, men användaren får möjlighet att granska eller redigera dokumentet innan det skickas. Perfekt när något behöver kvalitetssäkras.
(Se den fullständiga guiden för API-integrationer här.)
🔄 Produktsynkronisering
API:et stöder även synkronisering av produkter mellan DealBuilder och era system, så att ni alltid har uppdaterad produktdata tillgänglig i dokumenten.
📧 Behöver du hjälp med integrationer?
Du kan själv sätta upp integrationerna med hjälp av API, webhooks eller GET-förfrågningar – eller be oss om hjälp.
Ni kan även kontakta en av våra integrationspartners, som hjälper er att bygga skräddarsydda integrationer och automatisera viktiga processer.
👉 Kontakta oss via vårt formulär, så hjälper vi dig att komma i gång.