Typeform bilan integratsiya
Typeform’dan o’tkazilgan so’rovdan so’ng diplom va sertifikatlarni avtomatik yaratish va jo‘natish. So‘rov orqali to‘plangan barcha ma'lumotlar tayyorlangan diplom yoki sertifikatga joylashtiriladi.
O‘zgaruvchilarni qo‘shish
Typeform’dagi kerakli so‘rovni oching, so‘ngra unda hujjatga joylashtirilayotgan javobni tanlang. Keyin, blok ID’sini (block=’dan keyingi matn) manzillar satridan nusxalab oling.
Typeform’dagi savol ID’si
Keyin, hujjatga matn maydoni qo'shing va unda mazkur ID ga ega bo'lgan o‘zgaruvchini joylashtiring (ya'ni ID oldiga hech qanday bo‘sh joy qoldirmasdan % belgisi qo‘shing). Ushbu joyga savolning javobi joylashtiriladi. Istalgan tarzda matn formatini oldindan sozlashingiz mumkin.
DiMaker hujjati savolning ID'si bilan
Cheksiz miqdorda matn bloklari va o‘zgaruvchilar qo‘shishingiz mumkin. DiMaker quyidagi Typeform maydonlaridan ma'lumotlarni oladi: Short Text, Long Text, Phone Number, Email, Website, Number, Date, Ranking, Option Scale, Rating, Matrix, Multiple Choice, Yes/No.
Qulay ID nomlari
O‘zgaruvchilar bilan ishlashni osonlashtirish uchun Typeform’dagi so‘rovni e'lon qiling. Sozlamalar bo‘limida "Block references" ni bosing va qulay ID nomlarini belgilang (masalan, last_name yoki first_name).
Typeform’dagi Block references
Endi, DiMaker hujjatida ushbu o‘zgaruvchilarni (% belgisi ID oldida, masalan, %last_name) ishlatishingiz mumkin bo‘ladi.
DiMaker hujjati savolning ID'si bilan
Veb-huk yaratish
Typeform so‘rovi tugagandan so‘ng ma'lumotlarni yuborishi uchun veb-huk qo'shish kerak bo‘ladi. Buning uchun kerakli so‘rov ichida "Connect" - "Webhooks" tugmasini bosing. So‘ng "Add a webhook" tugmasini tanlang.
Typeform’da veb-huk qo‘shish
Veb-huk qo‘shish oynasida Endpoint (kirish manzili)ni to‘g‘ri ko’rsating.
https://dimaker.app/api/v1/typeform-create/
Bundan tashqari, quyidagi o‘zgaruvchilarni qo‘shish kerak:
-
secure*
API sahifasidan olingan 36 simvollik token.
-
doc_id*
Hujjatning ID’si (36 ta simvol), bu faylni yaratishda ishlatiladi. Hujjat ochilganida manzil bo'lagidan ID ni olishingiz mumkin. Hujjat "Qayta ishlash qutisi"da bo‘lmasligi kerak.
-
mail_id
Elektron pochta uchun maket ID’si (36 ta simvol). Bu ID maket ochiq bo/lganda manzil bo'lagidan olinadi. Agar bu o‘zgaruvchi ko‘rsatilmasa, xabar jo‘natilmaydi.
-
email_send
Fayl bilan birga xatni yuborish vaqti. Quyidagi qiymatlarga ega bo‘lishi mumkin:
onfinish - Barcha fayllar yaratilgandan keyin barcha xatlarni yuborish (standart)
oncreate - Fayl yaratilgandan so‘ng darhol yuborish. Agar faqat bir fayl yaratilsa, onfinish va oncreate bir xil bo‘ladi.
timeout - Ma'lum vaqt o‘tib yuborish. Bunda qo‘shimcha ikki parametrni ko‘rsatish kerak:
email_timeout_value - vaqt oralig'i (raqam, butun qiymat)
email_timeout_unit - vaqt o‘lchov birligi. Yoq "m" (daqiqa), "h" (soat), "d" (kun).
Yoki aniq yuborish vaqtini belgilash uchun email_timeout_timestamp formatida unix time ko’rsatiladi. Agar timeout va email_timeout_timestamp birgalikda belgilangan bo‘lsa, ikkinchisiga ustunlik beriladi. -
folder_id
Fayllarni Diskda saqlash uchun papka ID’si (36 ta simvol). Agar papka mavjud bo‘lmasa, birinchi fayl yaratilganda avtomatik ravishda yaratiladi.
-
page_id
Hujjat ostidagi varaqlar ichidan fayl yaratishda ishlatiladigan varaqlar ketma-ketligi (raqam yoki satr turi)ni ko’rsatadi. Birinchi varaqqa 0 dan boshlab belgilanadi, yoki varaqlarni vergul bilan ajratish orqali ishlatiladigan varaqlar ketma-ketligi ko'rsatilishi mumkin.
Agar hozirgi sana, tasodifiy raqam yoki boshqa ma'lumotlarni qo'shish kerak bo'lsa, funksiyalarni ishlatishingiz mumkin.
Kirish manzilini yaratish
Shunday qilib, kirish manzili uchun URL ni yaratish mumkin. Buni har qanday matn muharririda bajarish va keyinchalik veb-huk oynasida Endpoint maydoniga ko‘chirish maqsadga muvofiq. URL quyidagicha bo‘lishi mumkin (ranglar tushuntirish uchun ishlatiladi):
URL tarkibini bosqichma-bosqich tushuntiramiz:
- https://dimaker.app/api/v1/typeform-create/? - so‘rov manzili
- doc_id=b75b01cf-c732-49c6-80a0-77dd051a8299 - Hujjat ID’si
- folder_id=5a390b28-9845-4c01-b94a-7d252b115e2e - Diskdagi papka ID’si
- mail_id=fb5eff48-4c08-4df7-a9e6-29e17896317c - Elektron pochta maketi ID’si
- secure=8453bc41-с34у-4ead-80e8-c4e76175a11b - API token
O‘zgaruvchilar orasida - "&" belgisidan foydalaniladi. Bo‘shliq qo‘shilmasligi kerak. Ma’lumotlarni kiritib, tarkibni sinchkovlik bilan tuzing va URL ni veb-huk oynasiga joylashtiring.
Hammasi tayyor! Endi ish faoliyatini tekshirish qoldi. So‘rovingizni to‘ldirib ko‘ring. Agar hammasi to‘g‘ri sozlangan bo‘lsa, Diskdagi papkada diplom yoki sertifikat fayli paydo bo‘ladi. Agar mail_id belgilangan bo‘lsa, fayl elektron pochtaga ham yuboriladi. Agar fayl paydo bo‘lmasa, Typeform’dagi veb-huk yuborish tarixini tekshiring. "View deliveries" bo‘limida "Response" ichida sabab ko‘rsatilgan bo‘ladi.