Zapier

ކޮންމެ އިންޓިގްރޭޝަނެއް ބޭނުންކުރާ އެއް REST API، OAuth client އަދި webhook އިން Zapier ޤުއަރޭއާ ގުޅެއެވެ. ދެކޮޅުމެއްގައި ޤުއަރޭ ހާއްސަ ކޯޑެއް ނެތެވެ؛ API reference ގައި ހުރި ކޮންމެ ތަކެއްޗެއް Zap އެއްގައި ކުރެވޭނެއެވެ.

ޤުއަރޭގައި ކަމެއް ހިނގުމުން Zap ފަށާށެވެ

1. Zapier ގައި Webhooks by Zapier trigger ގޮތުގައި ހޮވައި Catch Raw Hook އިވެންޓް ހޮވާށެވެ. Signature ހިސާބުކުރެވެނީ ޤުއަރޭ ފޮނުވި ހަމަ ބައިޓްތަކުންނެވެ، އެހެންވެ raw އެވެ. Zapier ދޭ އެޑްރެސް ކޮޕީކޮށްލާށެވެ.
2. ޤުއަރޭގައި /admin/webhooks ހުޅުވައި Add subscription ހޮވާ، އެޑްރެސް ޕޭސްޓްކޮށް course_completion.changed ފަދަ އިވެންޓްތައް ހޮވާށެވެ. ޤުއަރޭ ފުރަތަމަ ޓެސްޓް އިވެންޓެއް ފޮނުވާނެއެވެ؛ Zapier އެއް ނަގާފަހުން subscription ފެށެއެވެ.
3. developer guide ގައި ދައްކާގޮތަށް subscription secret ބޭނުންކޮށް signature ވެރިފައިކުރާ Code by Zapier step އެއް އިތުރުކޮށްލާށެވެ. ޗެކް ނުފާސްވާ ޙާލަތުގައި Zap ހުއްޓާށެވެ.
4. body ޕާސް ކޮށް، ބޭނުންވާ step ތަކާއެކު ދެމިދާށެވެ.

Zap އިން ޤުއަރޭގައި ކަމެއް ކުރުން

Webhooks by Zapier އާއެކު Custom Request action ނުވަތަ app step ގައި API Request ބޭނުންކުރާށެވެ:

• URL: https://acme.quirelms.com/api/v1/...، މިސާލަކަށް މީހަކު އެންރޯލް ކުރުމަށް /api/v1/enrolments.
• Headers: Authorization: Bearer qk_live_... އާއެކު މި Zap އަށް އެކަނި /admin/integrations/api-keys ގައި ހަދި ކީ، އަދި trigger ގެ ID އިން ހަދި Idempotency-Key؛ Zapier އަލުން ހިންގިޔަސް މީހަކު ދެފަހަރު ނުއެންރޯލްވާނެއެވެ.
• Data: API reference ގައި އެންގިފަދަ JSON.

އޮގަނައިޒޭޝަން ގޮތުން ނޫން، މީހަކުގެ ފަރުވާގައި ކަމެއް ކުރަން /admin/integrations/oauth-clients ގައި Zapier ގެ redirect address އާއެކު OAuth client ރަޖިސްޓަރކޮށް އެއީ private Zapier integration އިން ބޭނުންކުރާށެވެ.

މިސާލު: ޑީލް ނިމުމުން ކަސްޓަމަރެއް އެންރޯލްކުރުން

1. Trigger: ތިބާގެ CRM ގެ “deal won”.
2. Custom request PUT /api/v1/users/ext:{customer id} އިން މީހާގެ ނަމާއި email ދީ: ޔޫޒަރެއް ހަދާ، ކުރިން ހުރިޔާ އަޕްޑޭޓްކުރާށެވެ.
3. Custom request POST /api/v1/enrolments އިން ޔޫޒަރާއި ކޯސް ދީ، Idempotency-Key: deal-{deal id} ލާށެވެ.