Automation: Integrera en blankett

Det finns olika sätt att integrera en blankett på sin egna webbplats. Antingen kan man använda sig av den nyckelfärdiga lösningen Webbautomation, eller bygga en API-integration.

Exempel på flöde för integration

Formulärdatan samlas i det här exemplet in i kundens egna system, exempelvis i ett formulär på kundens webbplats eller i en app.

Själva blanketten som ska undertecknas med Asssently kan antingen skapas av integrationen, eller fylla i formulärfält i en befintlig blankett som ligger sparad på en Mall (Template) i Assently. Det val man gör påverkar steg 5 nedan.

OBS. All utveckling ska ske mot testmiljön.

1. Logga in på ditt konto i testmiljön.
2. Skapa en användare specifik för API-integrationen som kommer skapa ärenden och stå som avsändare. 
3. Aktivera API för den användaren. En API-nyckel samt en API-hemlighet genereras. Hemligheten visas bara en gång, så spara den på ett säkert ställe. De båda behövs när API-anrop görs av integrationen.
4. Skapa en ”Mall för blankett” i Webbkontoret under Mallar, och konfigurera mallen avseende meddelanden, signeringsmetoder osv.
5. Det finns två principiellt olika sätt att använda API:et:
   1. Mallen för blankett innehåller inget dokument. API-integrationen skapar med hjälp av kod en PDF-fil varje gång formuläret på den egna webbsidan skickas. Integrationen skapar då ett ärende utifrån mallen och uppdaterar ärendet med den nyskapade PDF-filen.
   2. Mallen för blankett innehåller en PDF-fil med ifyllbara fält. Integrationen skapar ett ärende utifrån mallen, och uppdaterar ärendet med den insamlade formulärfälten (FormFields) i API-anropet, varpå Assently populerar PDF-filen med datan.
6. Därefter följer flödet det för en vanlig blankett. Fördelarna med att göra en API-integration är att man har större möjlighet att styra över vad som undertecknas, och vad som ska hända när ärendet är klart, så som: göra callbacks, prenumerera på händelser, styra besökaren vidare till en annan webbsida med continueUrl eller hämta data som ska användas i externa system.

Viktigt! All utveckling ska ske mot testmiljön, och ska efter acceptanstest flyttas över till produktionsmiljön. Kontrollera att korrekt API-nycklar och endpoints används för att säkerställa att flödet fungerar.

Allmänna rekommendationer vid integrationer

• Informera Assently inför produktionssättning av era integrationer för avstämning och koordination.
• Ifall data samlas in utanför Assentlys säkra miljö bör kunden säkerställa att datan samlas in på ett säkert sätt, och att kryptering sker enligt industristandard i alla lager.