DiMaker DiMaker В чём разница?

Інтэграцыя з Typeform

Дакументацыя перакладзена аўтаматычна з выкарыстаннем машыннага навучання.

Аўтаматычнае стварэнне і рассылка дыпломаў і сертыфікатаў з Typeform пасля праходжання апытання. Усе даныя, атрыманыя ў апытанні, будуць устаўлены ў гатовы дыплом ці сертыфікат.

Даданне зменных

Адкрыйце ў Typeform патрэбнае апытанне і знайдзіце пытанне, адказ на якое трэба размясціць у дакуменце. Затым скапіруйце яго ID з радка адраса (тэкст, які ідзе пасля block=).

Стварэнне сертыфіката па праходжанні апытання ў Typeform - ID пытання ID пытання ў Typeform

Далей, у дакуменце дадайце тэкставае поле, у якое ўстаўце зменную, роўную гэтаму ID (г.зн. дадайце знак працэнта перад ID без прабелу). На гэтае месца будзе падстаўлены адказ на гэтае пытанне. Вы можаце папярэдне наладзіць фарматаванне тэксту, каб ён выглядаў так, як вам неабходна.

Стварэнне сертыфіката па праходжанні апытання ў Typeform - акно дакумента Дакумент у DiMaker з ID пытання

Можна дадаць любую колькасць тэкставых блокаў і зменных. DiMaker можа ўставіць даныя з наступных палёў Typeform: Short Text, Long Text, Phone Number, Email, Website, Number, Date, Ranking, Option Scale, Rating, Matrix, Multiple Choice, Yes/No.

Панятныя ID

Каб са зменнымі было зручна працаваць, апублікуйце апытанне ў Typeform. Затым у наладках націсніце "Block references" і задайце зразумелыя ID (напрыклад, last_name або first_name).

Стварэнне сертыфіката па праходжанні апытання ў Typeform - Block references Block references у Typeform

У гэтым выпадку ў дакуменце DiMaker вы зможаце выкарыстоўваць гэтыя зменныя (са знакам % перад ID, напрыклад %last_name).

Стварэнне сертыфіката па праходжанні апытання ў Typeform - акно дакумента Дакумент у DiMaker з ID пытання

Стварэнне веб-хука

Каб Typeform адпраўляў даныя пасля завяршэння апытання, трэба дадаць веб-хук. Для гэтага, знаходзячыся ў патрэбным апытанні, націсніце "Connect" - "Webhooks". Затым - "Add a webhook".

Стварэнне сертыфіката па праходжанні апытання ў Typeform - даданне веб-хука Даданне веб-хука ў Typeform

У акне дадання веб-хука важна дакладна ўказаць Endpoint (кропку доступу).

https://dimaker.app/api/v1/typeform-create/

Таксама трэба дадаць шэраг зменных:

  • secure*

    Токен (радок, 36 сімвалаў), са старонкі "API Токены".

  • doc_id*

    ID дакумента (радок, 36 сімвалаў), які будзе выкарыстоўвацца для стварэння файла. ID можна атрымаць з радка адраса, калі дакумент адкрыты. Дакумент не павінен быць у корзине, але можа знаходзіцца ў любой тэчцы Документаў.

  • mail_id

    ID шаблону ліста (радок, 36 сімвалаў) для адпраўкі па электроннай пошце. ID можна атрымаць у радку адраса, калі шаблон адкрыты. Калі зменная не перададзена, то ліст адпраўлены не будзе.

  • email_send

    Час адпраўкі ліста з файлам. Магчымыя наступныя значэнні:
    onfinish - Адправіць усе лісты пасля стварэння ўсіх файлаў (па змаўчанні)
    oncreate - Адпраўляць лісты адразу пасля стварэння файла. Пры стварэнні аднаго файла onfinish і oncreate ідэнтычныя.
    timeout - Адправіць лісты праз пэўны прамежак часу. У гэтым выпадку трэба перадаць яшчэ два параметры:
    email_timeout_value - лічбавае значэнне прамежку часу, праз які трэба адправіць лісты, цэлае значэнне
    email_timeout_unit - адзінка вымярэння прамежку часу. Можа мець значэнне "m" (хвіліны), "h" (гадзіны), "d" (дні).
    Альбо, каб указаць дакладны час адпраўкі - перадайце час у фармаце unix time у email_timeout_timestamp. Калі перададзены адначасова timeout і email_timeout_timestamp, то прыярытэт будзе ў апошняга.

  • folder_id

    ID тэчкі на Дыску (радок, 36 сімвалаў), дзе будуць захоўвацца файлы. Калі тэчка адсутнічае, яна будзе створана аўтаматычна пасля стварэння першага файла.

  • page_id

    Парадавы нумар ліста (лічба або радок), калі ў дакуменце ёсць некалькі лістоў. Можна перадаць адзін нумар (першы ліст - 0), або некалькі нумароў (праз коску) лістоў, якія трэба выкарыстоўваць для стварэння файла.

Калі трэба ўставіць бягучую дату, выпадковы нумар ці іншыя даныя - выкарыстоўвайце функцыі.

Складаем кропку доступу

Цяпер можна скласці адрас кропкі доступу. Лепш гэта зрабіць у любым рэдактары, а потым скапіраваць у поле Endpoint у акне дадання веб-хука. URL можа мець выгляд (колеры па зручнасці):

https://dimaker.app/api/v1/typeform-create/?doc_id=b75b01cf-c732-49c6-80a0-77dd051a8299&folder_id=5a390b28-9845-4c01-b94a-7d252b115e2e&mail_id=fb5eff48-4c08-4df7-a9e6-29e17896317c&secure=8453bc41-с34у-4ead-80e8-c4e76175a11b

Разгледзім радок па парадку:

  • https://dimaker.app/api/v1/typeform-create/? - адрас запыту
  • doc_id=b75b01cf-c732-49c6-80a0-77dd051a8299 - ID дакумента
  • folder_id=5a390b28-9845-4c01-b94a-7d252b115e2e - ID тэчкі на Дыску
  • mail_id=fb5eff48-4c08-4df7-a9e6-29e17896317c - ID шаблону ліста
  • secure=8453bc41-с34у-4ead-80e8-c4e76175a11b - API токен

Між зменнымі - знак &. Нельга выкарыстоўваць прабелы. Уважліва складзіце радок, устаўляючы свае даныя і не прапусціўшы ніводнага сімвала. Пасля ўстаўкі URL захавайце веб-хук.

Гатова! Застаецца праверыць, як ўсё працуе. Для гэтага запоўніце ваша апытанне. Калі ўсё наладжана правільна, у выніку ў тэчцы на Дыску з’явіцца файл дыплома або сертыфіката. Калі вы ўказалі mail_id, файл будзе адпраўлены на электронную пошту. Калі файл адсутнічае, паглядзіце гісторыю адпраўкі веб-хукаў у Typeform і ў раздзеле "View deliveries", на ўкладцы "Response" будзе паказана прычына.


Іншыя інтэграцыі