Zapier

Zapier бардык интеграция колдонгон ошол REST API, OAuth клиенттери жана вебхуктар аркылуу Quire’ге туташат. Эки тарапта да Quire’ге өзгөчө код жок, ошондуктан API документациясы сунуштаган каалаган нерсени Zap кыла алат.

Quire’де бир нерсе болгондо Zap баштоо

1. Zapier’де триггер катары Webhooks by Zapier тандаңыз, Catch Raw Hook окуясы менен. Raw, анткени кол коюу Quire жөнөткөн так байттардын үстүнөн эсептелет. Zapier берген даректи көчүрүңүз.
2. Quire’де /admin/webhooks ачып, Жазылуу кошууну тандаңыз, даректи чаптаңыз жана окуяларды тандаңыз, мисалы 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_... — бул /admin/integrations/api-keys жеринен ушул Zap үчүн гана жасалган килит, жана триггердин 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} custom request: колдонуучуну түзөт же ал бар болсо жаңыртат.
3. Колдонуучу жана курс менен POST /api/v1/enrolments custom request, жана Idempotency-Key: deal-{deal id}.