---
title: "Zapier"
description: "Ikonekta ang Quire sa Zapier gamit ang mga webhook at REST API."
image: "https://docs.quirelms.com/og.png"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.quirelms.com/fil/llms.txt
> Use this file to discover all available pages before exploring further.

# Zapier

<span id="zapier"></span>

Kumokonekta ang Zapier sa Quire sa pamamagitan ng parehong REST API, OAuth
client, at webhook na ginagamit ng bawat integration. Walang Quire-specific na
code sa alinmang panig, kaya magagawa ng Zap ang lahat ng nasa
[sanggunian ng API](https://docs.quirelms.com/api/).

## Magsimula ng Zap kapag may nangyari sa Quire <!--quire:start-a-zap-when-something-happens-in-quire-->

1. Sa Zapier, piliin ang **Webhooks by Zapier** bilang trigger at ang event na
   **Catch Raw Hook**. Raw ang kailangan dahil kinukuwenta ang lagda sa eksaktong
   bytes na ipinadala ng Quire. Kopyahin ang address na ibinigay ng Zapier.
2. Sa Quire, buksan ang `/admin/webhooks`, piliin ang **Add subscription**,
   i-paste ang address at piliin ang mga event, halimbawa `course_completion.changed`.
   Nagpapadala muna ang Quire ng test event; magsisimula ang subscription kapag
   natanggap ito ng Zapier.
3. Magdagdag ng hakbang na **Code by Zapier** para suriin ang lagda gamit ang
   subscription secret gaya ng inilalarawan sa [gabay ng developer](/fil/developer/#webhooks).
   Ihinto ang Zap kapag nabigo ang pagsusuri.
4. I-parse ang body at ipagpatuloy ang mga hakbang na kailangan mo.

## Magsagawa ng aksiyon sa Quire mula sa Zap <!--quire:act-in-quire-from-a-zap-->

Gamitin ang action na **Custom Request** ng **Webhooks by Zapier**, o ang
**API Request** sa hakbang ng app:

- **URL**: `https://acme.quirelms.com/api/v1/...`, halimbawa `/api/v1/enrolments`
  para mag-enroll ng tao.
- **Headers**: `Authorization: Bearer qk_live_...` gamit ang key na ginawa para
  lamang sa Zap na ito sa `/admin/integrations/api-keys`, at `Idempotency-Key`
  na binuo mula sa ID ng trigger para hindi makapag-enroll nang dalawang beses
  kapag inulit ng Zapier ang Zap.
- **Data**: JSON ayon sa paglalarawan sa sanggunian ng API.

Para kumilos bilang isang tao sa halip na organisasyon, magrehistro ng OAuth
client sa `/admin/integrations/oauth-clients` gamit ang redirect address ng
Zapier at gamitin ito mula sa pribadong Zapier integration.

## Halimbawa: mag-enroll ng customer kapag nagsara ang deal <!--quire:example-enrol-a-customer-when-a-deal-closes-->

1. Trigger: ang event na “deal won” sa CRM mo.
2. Custom request na `PUT /api/v1/users/ext:{customer id}` kasama ang pangalan at
   email ng tao: gagawa ng user o mag-a-update kung mayroon na.
3. Custom request na `POST /api/v1/enrolments` kasama ang user at kurso at
   `Idempotency-Key: deal-{deal id}`.

Source: https://docs.quirelms.com/fil/integrations/zapier/index.mdx