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

Сурамжылоодон өткөндөн кийин Typeform аркылуу диплом жана сертификаттарды автоматтык түрдө түзүү жана жөнөтүү. Сурамжылоо учурунда алынган бардык маалыматтар даяр документке автоматтык түрдө кошулат.

Өзгөрмөлөрдү кошуу

Typeform ичиндеги керектүү сурамжылоону ачыңыз жана анын ичинде, документке жайгаштырылышы керек болгон суроону тандаңыз. Андан соң, суроонун ID’сын дарек сапынан көчүрүңүз (block= белгисинен кийинки текст).

Typeform ичиндеги суроонун IDси

Андан кийин, документке тексттик талаа кошуп, бул ID’ны камтыган өзгөрмөнү (%) белгиси менен жазып коюңуз. Ошол жерге суроонун жообу автоматтык түрдө жайгаштырылат. Текстке мурунтан формат берүү аркылуу аны сизге туура келгендей кылып жасай аласыз.

Документтеги 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

Бул учурда, DiMaker документинде ошол түшүнүктүү IDлерди (%last_name сыяктуу) колдонсоңуз болот.

DiMaker ичиндеги документтин түрү

Веб-хук түзүү

Typeform сурамжылоодон кийин маалыматтарды жөнөтүшү үчүн веб-хук кошуу керек. Керектүү сурамжылоону ачып, "Connect" - "Webhooks" тандаңыз. Андан соң – "Add a webhook" басыңыз.

Typeform өзүңүзгө веб-хук кошуу

Веб-хук кошуу терезесинде Endpoint (маалыматтарды алып келүүчү дарек) туура көрсөтүү маанилүү.

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

Ошондой эле, бир нече өзгөрмөлөр көрсөтүлүшү керек:

• secure*

  "API Токендер" баракчасынан алынуучу 36 белгиден турган токен.

• doc_id*

  Файл түзүлүүчү документтин IDси (36 белгиден турган сап). Бул ID каалоо документти ачканда дарек сапынан алынат. Документ таштандыда болбошу керек, бирок каалаган папкада жайгашкан болушу мүмкүн.

• mail_id

  Электрондук кат аркылуу жөнөтүү үчүн шаблондун IDси. Бул ID шаблон ачылган учурда дарек сапынан алынат. Бул өзгөрмө көрсөтүлбөсө, кат жөнөтүлбөйт.

• email_send

  Каттарды жөнөтүү убакыты. Төмөнкү маанилерге ээ:
  onfinish - Бардык файлдар түзүлгөндөн кийин каттарды жөнөтүү (демейки мааниси)
  oncreate - Файл түзүлгүн сайын каттарды дароо жөнөтүү.
  timeout - Каттарды белгиленген убакыт өткөндөн кийин жөнөтүү. Мындай учурда кошумча параметрлерди көрсөтүү керек:
  email_timeout_value - сандык убакыт мааниси, каттарды жөнөтүүгө чейин өтө турган убакыт
  email_timeout_value - убакытты өлчөө бирдиги ("m" - мүнөттөр, "h" - сааттар, "d" - күндөр). Же так жөнөтүү убакытын көрсөтүү үчүн email_timeout_timestamp форматы колдонулат. Timeout жана email_timeout_timestamp көрсөтүлгөндө, акыркысы артыкчылыкка ээ болот.

• folder_id

  Файлдар сакталуучу Папканын IDси. Эгер папка жок болсо, ал биринчи файл түзүлгөндө автоматтык түрдө жаралат.

• page_id

  Документте баракчалар бар болсо, кайсы баракчаларды колдонуу керек экенин көрсөтүү. Баракчаларды сан катары бир же бир нечесин көрсөтө аласыз (биринчи барак - 0).

Учурдагы күндү, кокустук номерди же башка маалыматтарды керек киргизүү үчүн функцияларды колдонсоңуз болот.

Endpoint түзүү

Эми, маалыматтарды жеткирүүчү 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 токен

Өзгөрмөлөрдүн ортосунда & белгиси колдонулат. Демейки боштуктар жаӊылыштыкка алып келет. Дайындарды кылдат текшерип, тиешелүү түзөтүүлөрдү жасагандан кийин веб-хукту сактагыла.

Эми баары даяр! Жыйынтыгын текшерип көрүӊүз. Сурамжылоону толтуруп, файлдар түзүлгөнүн текшерсеӊиз болот. Жөнөтүү каталары болсо, Typeform ичиндеги "View deliveries" бөлүгү аркылуу себебин караӊыз.

Башка интеграциялар