Integration med Typeform
Automatisk generering och utskick av diplom och certifikat från Typeform efter enkätsvar. All data från enkäten kommer att fyllas i det färdiga diplomet eller certifikatet.
Lägg till variabler
Öppna enkäten i Typeform och välj den fråga vars svar ska inkluderas i dokumentet. Kopiera sedan dess ID från adressfältet (texten som kommer efter block=).
Fråge-ID i Typeform
Lägg därefter till ett textfält i dokumentet, där du placerar variabeln motsvarande detta ID (lägg till ett procenttecken framför ID utan mellanrum). På det stället kommer svaret på frågan att visas. Du kan även formatera texten för att få exakt det utseende du önskar.
Dokument i DiMaker med fråge-ID
Du kan lägga till valfritt antal textblock och variabler. DiMaker kan använda data från följande typer av Typeform-fält: Kort text, Lång text, Telefonnummer, E-post, Webbplats, Nummer, Datum, Ranking, Alternativskala, Betyg, Matris, Flera val, Ja/Nej.
Lättlästa ID
För att göra variablerna enklare att arbeta med, publicera enkäten i Typeform. Gå sedan till inställningar och klicka på "Block references" för att ge mer begripliga ID:n (t.ex. last_name eller first_name).
Block references i Typeform
Nu kan du använda dessa variabler i DiMaker-dokumentet (med ett procenttecken framför ID, t.ex. %last_name).
Dokument i DiMaker med fråge-ID
Skapa en webhook
För att Typeform ska kunna skicka data efter enkätsvaren behöver du lägga till en webhook. Öppna den aktuella enkäten, klicka på "Connect" - "Webhooks" och sedan på "Add a webhook".
Lägga till webhook i Typeform
I webhook-fönstret är det viktigt att ange Endpoint (åtkomstadress) korrekt.
https://dimaker.app/api/v1/typeform-create/
Du behöver också lägga till några variabler:
-
secure*
Token (en sträng med 36 tecken) från sidan "API Tokens".
-
doc_id*
Dokumentets ID (en sträng med 36 tecken) som ska användas för att skapa filen. Du hittar ID i adressfältet när dokumentet är öppet. Dokumentet får inte ligga i papperskorgen men kan vara placerat i valfri mapp.
-
mail_id
Mall-ID (en sträng med 36 tecken) för e-postutskick. Du hittar ID i adressfältet när mallen är öppen. Om variabeln inte anges skickas inget e-postmeddelande.
-
email_send
Tiden för att skicka e-postmeddelandet med filen. Följande värden accepteras:
onfinish - Skicka alla e-postmeddelanden efter att alla filer skapats (standard)
oncreate - Skicka e-postmeddelanden så snart filen skapats. Vid enskilt filskapande är onfinish och oncreate samma sak.
timeout - Skicka e-post efter en viss tid. För detta behövs ytterligare två parametrar:
email_timeout_value - Tidsintervall (heltal) efter vilket e-postmeddelandet ska skickas
email_timeout_unit - Tidsenhet. Kan vara "m" (minuter), "h" (timmar) eller "d" (dagar).
Alternativt kan du ange exakt tid med unix time i email_timeout_timestamp. Om både timeout och email_timeout_timestamp anges, prioriteras den senare. -
folder_id
ID för mappen på Disk (en sträng med 36 tecken) där filerna sparas. Om mappen inte finns skapas den automatiskt vid skapandet av den första filen.
-
page_id
Sidanummer (ett tal eller sträng) om dokumentet har flera sidor. Du kan ange ett numret (första sidan är 0) eller flera sidnummer (separerade med komma) som ska användas för att skapa filen.
För att inkludera aktuellt datum, ett slumpmässigt nummer eller annan data, använd funktionerna.
Skapa en åtkomstadress
Nu kan du sätta ihop åtkomstadressen. Det är enklast att göra detta i en textredigerare och sedan kopiera adressen till webhook-Endpoint-fältet. URL:en kan se ut så här (färgkodat för enkelhet):
Låt oss gå igenom adressen i detalj:
- https://dimaker.app/api/v1/typeform-create/? - begärans adress
- doc_id=b75b01cf-c732-49c6-80a0-77dd051a8299 - Dokument-ID
- folder_id=5a390b28-9845-4c01-b94a-7d252b115e2e - Mapp-ID på Disk
- mail_id=fb5eff48-4c08-4df7-a9e6-29e17896317c - Mall-ID för e-postmeddelande
- secure=8453bc41-с34у-4ead-80e8-c4e76175a11b - API-token
Variabler separeras med tecknet &. Mellanslag får inte användas. Kontrollera att alla tecken är korrekta innan du sparar webhook:en.
Klart! Nu kan du testa om allt fungerar. Fyll i din enkät. Om allt är rätt konfigurerat kommer en fil med diplomet eller certifikatet att dyka upp i mappen på Disk. Om mail_id är angett skickas filen även via e-post. Om filen inte dyker upp, kontrollera webhook-sändningshistoriken i Typeform under "View deliveries" i fliken "Response" för att se vad som gick fel.