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

Выкарыстоўвайце дзеянне 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, і Idempotency-Key, сфарміраваны з ID трыгера, каб паўторны запуск Zapier не залічыў таго ж чалавека двойчы.
Data: JSON паводле даведкі API.

Каб дзейнічаць ад імя чалавека, а не арганізацыі, зарэгіструйце кліент OAuth у /admin/integrations/oauth-clients з адрасам перанакіравання Zapier і выкарыстоўвайце яго ў прыватнай інтэграцыі Zapier.

Прыклад: залічыць кліента пасля закрыцця здзелкі

Трыгер: у CRM здзелка атрымала статус «выканана».
Запыт Custom Request PUT /api/v1/users/ext:{customer id} з імем і электроннай поштай чалавека: ён стварае карыстальніка або абнаўляе існага.
Запыт Custom Request POST /api/v1/enrolments з карыстальнікам і курсам, а таксама Idempotency-Key: deal-{deal id}.