n8n

Naghatag ang node sa komunidad sa Quire alang sa n8n og action node para sa REST API ug trigger node nga mosugod og workflow kon adunay mahitabo sa Quire. Wala kiniy dependency nga modagan, busa node ra mismo ang idugang niini sa imong n8n instance.

Pag-instalar

Sa n8n, ablihi ang Settings, dayon Community nodes, pilia ang Install ug isulod ang @quire/n8n-node. Sa kaugalingong gi-host nga n8n, mahimo usab nimong padaganon ang npm install @quire/n8n-node sulod sa folder sa n8n user ug i-restart kini.

Pagsumpay

Paghimo og kredensiyal. Duha ka matang ang gitanyag:

• Quire API Key: ibutang ang adres sa imong organisasyon sa Base URL, nga walay slash sa kataposan, sama sa https://acme.quirelms.com. Ang API Key mao ang yawe nga gihimo sa tigdumala sa /admin/integrations/api-keys, nga nagsugod sa qk_live_. Ihatag lamang ang scope nga gikinahanglan sa workflow.
• Quire OAuth2: para sa workflow nga molihok isip usa ka tawo. Irehistro ang OAuth client sa /admin/integrations/oauth-clients uban sa adres nga gamiton sa pagbalik ngadto sa n8n (ipakita kini sa n8n sa kredensiyal), dayon isulod ang client ID, sekreto ug mga scope.

Mga lihok

Gilangkuban sa Quire node ang mga user, kurso, pagparehistro, grupo, pagkompleto, grado, sertipiko, gisumite, pagsulay sa quiz, programa, order, email ug organisasyon. Kon gitugotan sa API, mahimong ilista, kuhaon, himoon, usbon ug papason ang matag usa; mahimo usab ang upsert pinaagi sa gawasnong ID. Mao kini ang angay sa pag-sync: modagan ang sama nga workflow sa makaduha nga walay doble nga rekord.

Gihimo ang mga operasyon gikan sa dokumento sa OpenAPI sa Quire, busa matag field niini katugbang sa pakisayran sa API. Mahimo usab gamiton nga gamit sa ahente sa AI sa n8n ang matag operasyon; gikan sa pakisayran sa API ang paghulagway niini.

Ibalik sa lista ang tanang panid sa sinugdanan. Palonga ang Return All ug butangi og kinutoban kon dako ang organisasyon.

Trigger

Idugang ang Quire Trigger node, pilia ang kredensiyal ug ang Events: ngalan sa hitabo sama sa enrolment.created, tibuok dapit sama sa course.*, o tanan. Inigpaandar sa workflow, maghimo ang node og webhook subscription sa Quire para sa adres sa n8n; inigpalong niini, tangtangon ang subscription.

Susihon ang pirma sa matag delivery sa dili pa modagan ang workflow. Kon mapakyas ang pagsusi, isalikway kini uban sa sayop sa node, busa dili makasugod ang workflow tungod sa peke nga hangyo. Naa sa data sa hitabo ang mga ID; idugang ang Quire node human sa trigger aron makuha ang kompletong rekord.

Pananglitan: email sa pag-abiabi inigparehistro

1. Quire Trigger sa enrolment.created.
2. Quire node, kapanguhaan Users, operasyon Get, gamit ang user ID nga {{$json.data.user_id}}.
3. Quire node, kapanguhaan Courses, operasyon Get, gamit ang {{$json.data.course_id}}.
4. Imong email o chat node, gamit ang ngalan sa tawo ug ulohan sa kurso.

Pagsulbad sa problema

• 401 sa matag tawag: lahi ang organisasyong gipanag-iya sa Base URL ug yawe, o gibakwi ang yawe.
• 403 sa usa ka operasyon: kulang ang scope sa yawe. Idugang kini sa /admin/integrations/api-keys.
• Dili gayod moandar ang trigger: kinahanglang maabot sa Quire pinaagi sa HTTPS ang adres sa webhook sa n8n. Susihi ang delivery log sa subscription sa /admin/webhooks.