Ez a dokumentáció a Zapier és a QlickCRM rendszer integrációját ismerteti. Az integráció lehetővé teszi, hogy adatlapokat, partnereket, hozzászólásokat és eseményeket hozz létre a CRM rendszerben Zapieren keresztül, valamint hogy a CRM-ben történő eseményekből indíts automatizmusokat más rendszerekben.
A QlickCRM önálló alkalmazásként elérhető a Zapierben. Hozz létre egy új Zapet, majd az alkalmazások közül keresd ki és válaszd a QlickCRM alkalmazást. A fiók összekötéséhez a CRM webcímére és egy API kulcsra lesz szükséged (lásd lentebb).
API Autentikáció
Az API hívásokhoz autentikáció szükséges, amelyhez egy API kulcsot kell generálni a CRM rendszerben:
- Lépj a „Rendszer beállítások” menüpontba.
- Válaszd az „API kulcsok” opciót.
- Generálj egy új API kulcsot, amit a Zapier integrációhoz használhatsz.
ℹ️ A végpontok a nyilvános API v2 alatt érhetők el, ezért az útvonalak az /api/v2/ előtaggal kezdődnek.
Akciók és Végpontok
Az alábbi végpontok használhatóak az egyes műveletekhez:
Adatlap hozzáadása
- Végpont: `https://{subdomain}.qlickcrm.com/api/v2/zapier/add/object`
- Kötelező mezők: Modul ID (integer), Megnevezés (string)
- Opcionális mezők: Kategória ID, Státusz ID, Partner ID, Felhasználók, Sablon ID, Leírás, Kezdő időpont, Határidő, Címkék, UTM mezők, Cégnév, Vezetéknév, Keresztnév, Névjegy leírás, E-mail cím, Hírlevél feliratkozás, Telefonszám, Névjegy kategóriák, Számlázási név, Számlázási ország, Számlázási megye, Számlázási város, Számlázási cím, Számlázási irányítószám, Adószám, Szállítási név, Szállítási ország, Szállítási megye, Szállítási város, Szállítási cím, Szállítási irányítószám.
💡 Jó tudni: ha az adatlap hozzáadásakor megadsz Vezetéknevet és Keresztnevet vagy Cégnevet, a rendszer automatikusan létrehozza a partnert is, és az adatlaphoz kapcsolja. Ha a megadott e-mail cím vagy telefonszám már szerepel egy meglévő partnernél, nem jön létre duplikátum: az adatlap a meglévő partnerhez kapcsolódik.
Partner hozzáadása
- Végpont: `https://{subdomain}.qlickcrm.com/api/v2/zapier/add/person`
- Kötelező mezők: Cégnév vagy Vezetéknév és Keresztnév
- Opcionális mezők: Leírás, E-mail cím, Hírlevél feliratkozás, Telefonszám, Kategória, Címkék, Adatvédelmi hozzájárulás dátuma, Számlázási név, Számlázási ország, Számlázási megye, Számlázási város, Számlázási cím, Számlázási irányítószám, Adószám, Szállítási név, Szállítási ország, Szállítási megye, Szállítási város, Szállítási cím, Szállítási irányítószám.
Hozzászólás hozzáadása
- Végpont: `https://{subdomain}.qlickcrm.com/api/v2/zapier/add/comment`
- Kötelező mezők: Adatlap ID (integer), Típus (internal, external, system), Hozzászólás (text), HTML hozzászólás (boolean)
- Opcionális mezők: E-mail cím, Tárgy, Feladó, Feladó e-mail címe.
Esemény hozzáadása
- Végpont: `https://{subdomain}.qlickcrm.com/api/v2/zapier/add/event`
- Kötelező mezők: Naptár ID (integer), Felhasználó ID (integer), Megnevezés (string), Kezdés (dátum és idő), Befejezés (dátum és idő), Egész napos esemény (boolean)
- Opcionális mezők: Partner ID, Leírás, URL, Modul ID, Adatlap kategória ID, Adatlap státusz ID, Adatlap felhasználók, Kezdő időpont, Határidő, Adatlap sablon ID, Cégnév, Vezetéknév, Keresztnév, Partner leírás, E-mail cím, Hírlevél feliratkozás, Telefonszám, Partner kategóriák, Számlázási név, Számlázási ország, Számlázási megye, Számlázási város, Számlázási cím, Számlázási irányítószám, Adószám, Szállítási név, Szállítási ország, Szállítási megye, Szállítási város, Szállítási cím, Szállítási irányítószám.
Elérhető triggerek
A műveletek (akciók) mellett a QlickCRM eseményeiből is indíthatsz Zapeket. Az alábbi triggerek érhetők el, amelyekkel a CRM-ben létrejövő új rekordokból indíthatsz automatizmusokat más rendszerekben:
- Új adatlap: új adatlap létrejöttekor indul.
- Új partner: új partner létrejöttekor indul.
- Új esemény: új naptáresemény létrejöttekor indul.
Mezők és Specifikációk
A mezők specifikációi az alábbi táblázatokban találhatóak. Minden mezőnél megadjuk a címkét, a kulcsot és a mező típusát.
Adatlap mezők
| Type | Label | Key |
|---|---|---|
| Input Field | Modul ID | module_id |
| Input Field | Kategória ID | category_id |
| Input Field | Státusz ID | status_id |
| Input Field | Partner ID | contact_id |
| Input Field | Felhasználók | user_ids |
| Input Field | Sablon ID | object_template_id |
| Input Field | Megnevezés | name |
| Input Field | Leírás | description |
| Input Field | Kezdő időpont | start_date |
| Input Field | Határidő | end_date |
| Input Field | Címkék | object_tags |
| Input Field | UTM forrás | utm_source |
| Input Field | UTM médium | utm_medium |
| Input Field | UTM kampány | utm_campaign |
| Input Field | UTM tartalom | utm_content |
| Input Field | UTM kulcsszó | utm_term |
| Input Field | Cégnév | company |
| Input Field | Vezetéknév | lastname |
| Input Field | Keresztnév | firstname |
| Input Field | Névjegy leírás | contact_description |
| Input Field | E-mail cím | |
| Input Field | Hírlevél feliratkozás | newletter_subscribed |
| Input Field | Telefonszám | phone |
| Input Field | Névjegy kategóriák | contact_category_ids |
| Input Field | Számlázási név | invoice_name |
| Input Field | Számlázási ország | invoice_country |
| Input Field | Számlázási megye | invoice_county |
| Input Field | Számlázási város | invoice_city |
| Input Field | Számlázási cím | invoice_address |
| Input Field | Számlázási irányítószám | invoice_zip |
| Input Field | Adószám | vat_number |
| Input Field | Szállítási név | shipping_name |
| Input Field | Szállítási ország | shipping_country |
| Input Field | Szállítási megye | shipping_county |
| Input Field | Szállítási város | shipping_city |
| Input Field | Szállítási cím | shipping_address |
| Input Field | Szállítási irányítószám | shipping_zip |
Partner mezők
| Type | Label | Key |
|---|---|---|
| Input Field | Cégnév | company |
| Input Field | Vezetéknév | lastname |
| Input Field | Keresztnév | firstname |
| Input Field | Leírás | contact_description |
| Input Field | E-mail cím | |
| Input Field | Hírlevél feliratkozás | newletter_subscribed |
| Input Field | Telefonszám | phone |
| Input Field | Kategória | contact_category_ids |
| Input Field | Címkék | contact_tags |
| Input Field | Adatvédelmi hozzájárulás dátuma | privacy_policy_accepted_at |
| Input Field | Számlázási név | invoice_name |
| Input Field | Számlázási ország | invoice_country |
| Input Field | Számlázási megye | invoice_county |
| Input Field | Számlázási város | invoice_city |
| Input Field | Számlázási cím | invoice_address |
| Input Field | Számlázási irányítószám | invoice_zip |
| Input Field | Adószám | vat_number |
| Input Field | Szállítási név | shipping_name |
| Input Field | Szállítási ország | shipping_country |
| Input Field | Szállítási megye | shipping_county |
| Input Field | Szállítási város | shipping_city |
| Input Field | Szállítási cím | shipping_address |
| Input Field | Szállítási irányítószám | shipping_zip |
Hozzászólás mezők
| Type | Label | Key |
|---|---|---|
| Input Field | Adatlap ID | object_id |
| Input Field | Típus | type |
| Input Field | E-mail cím | user_email |
| Input Field | Tárgy | subject |
| Input Field | Hozzászólás | comment |
| Input Field | HTML hozzászólás? | is_html |
| Input Field | Feladó | from_name |
| Input Field | Feladó e-mail címe | from_email |
Esemény mezők
| Type | Label | Key |
|---|---|---|
| Input Field | Naptár ID | calendar_id |
| Input Field | Felhasználó ID | user_id |
| Input Field | Partner ID | contact_id |
| Input Field | Megnevezés | name |
| Input Field | Leírás | description |
| Input Field | Kezdés | start |
| Input Field | Befejezés | end |
| Input Field | Egész napos esemény | allday |
| Input Field | URL | url |
| Input Field | Modul ID | module_id |
| Input Field | Adatlap kategória ID | category_id |
| Input Field | Adatlap státusz ID | status_id |
| Input Field | Adatlap felhasználók | user_ids |
| Input Field | Kezdő időpont | start_date |
| Input Field | Határidő | end_date |
| Input Field | Adatlap sablon ID | object_template_id |
| Input Field | Cégnév | company |
| Input Field | Vezetéknév | lastname |
| Input Field | Keresztnév | firstname |
| Input Field | Partner leírás | contact_description |
| Input Field | E-mail cím | |
| Input Field | Hírlevél feliratkozás | newletter_subscribed |
| Input Field | Telefonszám | phone |
| Input Field | Partner kategóriák | contact_category_ids |
| Input Field | Számlázási név | invoice_name |
| Input Field | Számlázási ország | invoice_country |
| Input Field | Számlázási megye | invoice_county |
| Input Field | Számlázási város | invoice_city |
| Input Field | Számlázási cím | invoice_address |
| Input Field | Számlázási irányítószám | invoice_zip |
| Input Field | Adószám | vat_number |
| Input Field | Szállítási név | shipping_name |
| Input Field | Szállítási ország | shipping_country |
| Input Field | Szállítási megye | shipping_county |
| Input Field | Szállítási város | shipping_city |
| Input Field | Szállítási cím | shipping_address |
| Input Field | Szállítási irányítószám | shipping_zip |
Rate Limit és Korlátozások
Az API hívások korlátozása: percenként maximum 60 hívás engedélyezett.