---
title: "Zapier"
description: "Cysylltu Quire â Zapier drwy webhooks a'r API REST."
image: "https://docs.quirelms.com/og.png"
---

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

# Zapier

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

Mae Zapier yn cysylltu â Quire drwy'r un API REST, cleientiaid OAuth a
webhooks ag unrhyw integreiddiad arall. Nid oes cod Quire penodol ar y naill
ochr na'r llall, felly gall Zap wneud unrhyw beth sydd ar gael yn y [cyfeirnod API](https://docs.quirelms.com/api/).

## Dechrau Zap pan fydd rhywbeth yn digwydd yn Quire <!--quire:start-a-zap-when-something-happens-in-quire-->

1. Yn Zapier, dewiswch **Webhooks by Zapier** fel y sbardun, gyda'r digwyddiad
   **Catch Raw Hook**. Raw, oherwydd caiff y llofnod ei gyfrifo dros yr union
   beitiau a anfonodd Quire. Copïwch y cyfeiriad a roddir gan Zapier.
2. Yn Quire, agorwch `/admin/webhooks`, dewiswch **Add subscription**, gludwch y
   cyfeiriad, a dewiswch y digwyddiadau, er enghraifft `course_completion.changed`.
   Mae Quire yn anfon digwyddiad prawf yn gyntaf; bydd y tanysgrifiad yn dechrau unwaith y bydd Zapier wedi'i
   dderbyn.
3. Ychwanegwch gam **Code by Zapier** sy'n gwirio'r llofnod gan ddefnyddio'r
   gyfrinach tanysgrifio, fel y dangosir yn y
   [canllaw datblygwr](/cy/developer/#webhooks). Stopiwch y Zap os nad yw'n
   dilysu.
4. Dosrannwch y corff a pharhewch â'r camau sydd eu hangen arnoch.

## Gweithredu yn Quire o Zap <!--quire:act-in-quire-from-a-zap-->

Defnyddiwch **Webhooks by Zapier** gyda'r weithred **Custom Request**, neu **API
Request** mewn cam ap:

- **URL**: `https://acme.quirelms.com/api/v1/...`, er enghraifft
  `/api/v1/enrolments` i gofrestru rhywun.
- **Headers**: `Authorization: Bearer qk_live_...` gydag allwedd a grëwyd yn
  `/admin/integrations/api-keys` ar gyfer y Zap hwn yn unig, ac
  `Idempotency-Key` wedi'i lunio o ID y sbardun fel na fydd ailchwarae Zap gan Zapier
  yn cofrestru'r un person ddwywaith.
- **Data**: JSON, fel y disgrifir yn y cyfeirnod API.

I weithredu fel person yn hytrach nag fel y sefydliad, cofrestrwch gleient OAuth
yn `/admin/integrations/oauth-clients` gyda chyfeiriad ailgyfeirio Zapier a'i ddefnyddio
o integreiddiad preifat Zapier.

## Enghraifft: cofrestru cwsmer pan fydd bargen yn cau <!--quire:example-enrol-a-customer-when-a-deal-closes-->

1. Sbardun: “bargen wedi ennill” yn eich CRM.
2. Cais personol `PUT /api/v1/users/ext:{customer id}` gydag enw ac e-bost y person:
   creu'r defnyddiwr, neu ei ddiweddaru os yw'n bodoli.
3. Cais personol `POST /api/v1/enrolments` gyda'r defnyddiwr a'r cwrs,
   a `Idempotency-Key: deal-{deal id}`.

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