Typeform-мен интеграция

Typeform арқылы сауалнамадан өткен соң дипломдар мен сертификаттарды автоматты түрде жасау және тарату. Сауалнамада алынған кез келген деректер дайын дипломға немесе сертификатқа енгізіледі.

Айнымалыларды қосу

Typeform-да тиісті сауалнаманы ашып, құжатқа жауап енгізу керек сұрақты көрсетіңіз. Содан кейін оның ID-ін (block= кейінгі мәтін) мекенжай жолынан көшіріңіз.

Typeform-дағы сұрақтың ID-і

Одан кейін құжатқа мәтін өрісін қосып, осы ID мәніне тең айнымалыны енгізіңіз (яғни, ID алдында бос орынсыз % белгісін қосыңыз). Сол жерге осы сұрақтың жауабы қойылады. Мәтіннің форматын алдын ала баптап, өзіңізге қажетті көріністе жасай аласыз.

Typeform сұрағының ID-і бар DiMaker құжаты

Сіз қалағаныңызша көп мәтін блоктары мен айнымалыларды қосуға болады. 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

Осылайша, DiMaker құжатында осы айнымалыларды (ID алдында % белгісімен, мысалы, %last_name) қолдана аласыз.

Typeform сұрағының ID-і бар DiMaker құжаты

Веб-хук жасау

Typeform сауалнаманы өткеннен кейін деректерді жіберуі үшін веб-хук қосу қажет. Осыған орай, сауалнамада "Connect" - "Webhooks" дегенге барыңыз. Кейін "Add a webhook" батырмасын басыңыз.

Typeform-да веб-хук қосу

Веб-хук терезесінде Endpoint (қол жеткізу нүктесін) дұрыс көрсету маңызды.

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

Сонымен қатар, бірқатар айнымалыларды қосу қажет:

• secure*

  36 таңбалы токен "API токендері" бетінде орналасқан.

• doc_id*

  36 таңбалы құжат ID-і, файл жасау үшін қолданылатын. Бұл ID құжат ашылған кезде мекенжай жолында көрсетілген. Құжат себетте болмауы керек, бірақ құжаттар қалтасындағы кез келген орында болуы мүмкін.

• mail_id

  36 таңбалы электрондық пошта үлгісінің ID-і, егер оны поштамен жіберу қажет болса. Үлгі ашылған кезде 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

  36 таңбалы диск қалтасының ID-і, онда файлдар сақталады. Егер мұндай қалта болмаса, ол бірінші файл жасалған кезде автоматты түрде жасалады.

• page_id

  Егер құжатта бірнеше бет болса, бет нөмірі (сан немесе мәтін). Бір нөмірді немесе үтірмен бөлінген бірнеше нөмірді көрсетуге болады (бірінші бет - 0).

Ағымдағы күнді, кездейсоқ нөмірді немесе басқа деректерді енгізу қажет болса, қызметтерді пайдаланыңыз.

Қол жеткізу нүктесін құрастыру

Осылайша, қол жеткізу нүктесінің мекенжайын құруға болады. Мұны кез келген мәтіндік редакторда жасап, содан кейін веб-хук қосу терезесіндегі Endpoint өрісіне көшіру жақсы. URL ауысымдары былай көрінуі мүмкін (ыңғайлығы үшін түстер берілген):

Құрылымын кезеңдер бойынша талдайық:

• 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" қойындысында себебін қараңыз.

Басқа интеграциялар