n8n | Quire

Автоматизирайте Quire с n8n и общностния възел на Quire.

Общностният възел на Quire за n8n предоставя възел за действие към REST API и възел за задействане, който стартира работен поток при събитие в Quire. Няма зависимости по време на изпълнение и не добавя нищо към вашата инсталация на n8n освен себе си.

Инсталиране

В n8n отворете Settings, после Community nodes, изберете Install и въведете @quire/n8n-node. При самостоятелно хостван n8n можете да изпълните npm install @quire/n8n-node в потребителската папка на n8n и да рестартирате.

Свързване

The API keys page with a key named for an n8n automation. — Create a key at /admin/integrations/api-keys and paste it into the Quire credential in n8n.

Създайте удостоверение. Предлагат се два вида:

Quire API Key: Base URL е адресът на организацията ви без наклонена черта в края, например https://acme.quirelms.com. API Key е ключ, създаден от администратор на /admin/integrations/api-keys, който започва с qk_live_. Дайте му само обхватите, нужни на работния поток.
Quire OAuth2: за работни потоци, които трябва да действат като конкретен човек. Регистрирайте OAuth клиент на /admin/integrations/oauth-clients с адреса за пренасочване на n8n (n8n го показва в удостоверението), после въведете клиентския ID, тайната и обхватите.

Действия

Възелът Quire обхваща потребители, курсове, записвания, групи, завършвания, оценки, сертификати, предадени работи, опити за тестове, програми, поръчки, имейли и организации. Всеки предлага изброяване, получаване, създаване, актуализиране и изтриване там, където API го позволява, както и upsert по външен ID — подходящо за синхронизация: повторното изпълнение на работния поток не дублира нищо.

Операциите се генерират от OpenAPI документа на Quire и съвпадат поле по поле със справочника за API. Всяка може да се използва и като инструмент за ИИ агент в n8n; описанието ѝ идва от справочника.

По подразбиране списъците връщат всяка страница. За големи организации изключете Return All и задайте лимит.

Тригер

Добавете възела Quire Trigger, изберете удостоверението и посочете Events: събитие по име като enrolment.created, цяла област като course.* или всички събития. При активиране на работния поток възелът създава абонамент за уебкук в Quire към адреса на n8n; при деактивиране абонаментът се премахва.

Преди работният поток да стартира се проверява подписът на всяка доставка. Непроверена доставка се отхвърля с грешка във възела, така че подправена заявка не може да стартира потока ви. data на събитието съдържа идентификатори; добавете възел Quire след тригера, за да получите пълния запис.

Пример: приветствен имейл при записване

Quire Trigger за enrolment.created.
Възел Quire, ресурс Users, операция Get, с ID на потребителя {{$json.data.user_id}}.
Възел Quire, ресурс Courses, операция Get, с {{$json.data.course_id}}.
Ваш възел за имейл или чат, който използва името на човека и заглавието на курса.

Отстраняване на проблеми

401 при всяко извикване: Base URL и ключът са от различни организации или ключът е отнет.
403 при една операция: липсва нужният обхват. Добавете го на /admin/integrations/api-keys.
Тригерът никога не се задейства: адресът за уебкук на n8n трябва да е достъпен за Quire по HTTPS. Проверете журнала за доставките на абонамента на /admin/webhooks.