Zapier | Quire

Zapier се свързва с Quire чрез същите REST API, OAuth клиенти и уебкуки, които използва всяка интеграция. Няма специфичен за Quire код от нито една страна, затова Zap може да прави всичко от справочника за API.

Стартиране на Zap при събитие в Quire

В Zapier изберете Webhooks by Zapier като тригер и събитие Catch Raw Hook. Изберете Raw, защото подписът се изчислява върху точните байтове, изпратени от Quire. Копирайте адреса, който Zapier ви дава.
В Quire отворете /admin/webhooks, изберете Add subscription, поставете адреса и изберете събития, например course_completion.changed. Quire първо изпраща тестово събитие; абонаментът започва след получаването му от Zapier.
Добавете стъпка Code by Zapier, която проверява подписа с тайната на абонамента, както е показано в ръководството за разработчици. Спрете Zap, ако проверката не мине.
Анализирайте тялото и продължете с нужните стъпки.

Действие в Quire от Zap

Използвайте Webhooks by Zapier с действието Custom Request или API Request в стъпка на приложение:

URL: https://acme.quirelms.com/api/v1/..., например /api/v1/enrolments, за да запишете човек.
Headers: Authorization: Bearer qk_live_... с ключ, създаден на /admin/integrations/api-keys само за този Zap, и Idempotency-Key, съставен от ID на тригера, за да не запише повторно същия човек при преизпълнение от Zapier.
Data: JSON, както е описано в справочника за API.

За действия от името на човек, а не на организацията, регистрирайте OAuth клиент на /admin/integrations/oauth-clients с адреса за пренасочване на Zapier и го използвайте от частна интеграция със Zapier.

Пример: записване на клиент при приключване на сделка

Тригер: CRM системата ви отчита „deal won“.
Персонализирана заявка PUT /api/v1/users/ext:{customer id} с име и имейл на човека: създава потребител или го актуализира, ако вече съществува.
Персонализирана заявка POST /api/v1/enrolments с потребителя и курса, и Idempotency-Key: deal-{deal id}.