Zapier

Zapier Quire-ге әр интеграция пайдаланатын сол REST API, OAuth клиенттері мен вебхуктер арқылы қосылады. Екі жақта да Quire-ге тән код жоқ, сондықтан API анықтамасы ұсынатын кез келген нәрсені Zap жасай алады.

Quire-де бірдеңе болғанда Zap бастау

1. Zapier-де триггер ретінде Webhooks by Zapier таңдап, оқиға ретінде Catch Raw Hook таңдаңыз. Raw, өйткені қолтаңба Quire жіберген дәл байттар бойынша есептеледі. Zapier берген мекенжайды көшіріңіз.
2. Quire-де /admin/webhooks ашып, Add subscription таңдап, мекенжайды қойып, оқиғаларды таңдаңыз, мысалы course_completion.changed. Quire алдымен сынақ оқиғасын жібереді; Zapier оны алғаннан кейін жазылым басталады.
3. Жазылым құпиясымен қолтаңбаны тексеретін Code by Zapier қадамын қосыңыз, мұны әзірлеуші нұсқаулығы көрсетеді. Ол тексерілмесе Zap-ті тоқтатыңыз.
4. Денені талдап, қажетті қадамдармен жалғастырыңыз.

Zap-тен Quire-де әрекет ету

Custom Request әрекетімен Webhooks by Zapier пайдаланыңыз немесе қолданба қадамында API Request пайдаланыңыз:

• URL: https://acme.quirelms.com/api/v1/..., мысалы біреуді жазу үшін /api/v1/enrolments.
• Headers: Authorization: Bearer qk_live_..., кілт осы Zap үшін ғана /admin/integrations/api-keys мекенжайында жасалған, және триггер ID-інен құралған Idempotency-Key, сондықтан Zapier қайта ойнатқан Zap сол адамды екі рет жазбайды.
• Data: API анықтамасы сипаттағандай JSON.

Ұйым ретінде емес, адам ретінде әрекет ету үшін Zapier-дің қайта бағыттау мекенжайымен /admin/integrations/oauth-clients мекенжайында OAuth клиентін тіркеп, оны жеке Zapier интеграциясынан пайдаланыңыз.

Мысал: мәміле жабылғанда тұтынушыны жазу

1. Триггер: CRM-іңіздің «deal won» оқиғасы.
2. Адамның аты мен поштасымен PUT /api/v1/users/ext:{customer id} теңшелетін сұранысы: пайдаланушыны жасайды немесе бар болса жаңартады.
3. Пайдаланушы мен курспен POST /api/v1/enrolments теңшелетін сұранысы және Idempotency-Key: deal-{deal id}.