n8n | Quire

Автоматизирајте го Quire со n8n и заедничкиот јазол Quire.

Заедничкиот јазол Quire за n8n ви дава јазол за дејство за REST API и јазол-спустач што започнува проток на работа кога нешто се случува во Quire. Нема зависности во извршувањето, така што не додава ништо на вашата n8n-инстанца освен него самиот.

Инсталирање

Во n8n отворете Поставки, потоа Заеднички јазоли, изберете Инсталирај и внесете @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.

Создадете потврда. Се нудат два вида:

Клуч за API на Quire: 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-то го нуди, и вметнување или ажурирање по надворешен ID, што е она што го сакате за синхронизација: пуштете го истиот проток двапати и ништо не се дуплира.

Операциите се генерирани од OpenAPI-документот на Quire, така што се совпаѓаат со референцата за API поле по поле. Секоја операција може исто така да се користи како алатка од AI-агентот на n8n; нејзиниот опис доаѓа од референцата за API.

Списоците ја враќаат секоја страница по стандард. Исклучете Врати ги сите и поставете лимит за големи организации.

Спустач

Додајте го јазолот Quire Trigger, изберете ја потврдата и изберете ги Настаните: настан по име како 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.