CRM API inteqrasiyası digər biznes sistemlərinizin məlumatları ekranlar arasında əllə köçürməyə ehtiyac olmadan CRM ilə avtomatik mübadilə etməsinə imkan verir. Böyüyən şirkətlərin əksəriyyəti birdən çox alətdən istifadə edir: veb-sayt, onlayn mağaza, mühasibat və ya anbar sistemi, hesabat aləti və bəzən onlar üçün tərtibatçı tərəfindən xüsusi hazırlanmış proqram təminatı. Onların hər biri müştəri tarixçəsinin bir hissəsini saxlayır. Bu sistemlər arasındakı yeganə körpü iki brauzer tabı və cədvəli olan bir şəxs olduqda, məlumatlar gecikir, səhv daxil edilir və ya ümumiyyətlə çatmır. Bu bələdçi CRM API inteqrasiyasının nə olduğunu, Lua CRM inteqrasiyalar səhifəsi və sənədlərinə əsasən LuaCRM API-nin nələr təklif etdiyini, bağlantının necə planlaşdırılacağını, API giriş məlumatlarının necə təhlükəsiz idarə olunacağını və hansı səhvlərdən qaçınmaq lazım olduğunu izah edir.
Əsas məqamlar
- CRM API inteqrasiyası xarici sistemləri kod vasitəsilə CRM-inizə bağlayır, beləliklə məlumatlar əllə kopyalanmadan ötürülür.
- LuaCRM API sizə LuaCRM REST API v1 istifadə edən xarici sistemlər üçün API giriş məlumatları (credentials) yaratmağa və yeniləməyə (rotate) imkan verir.
- O, Lua CRM inteqrasiyalar səhifəsində token əsaslı məlumat mübadiləsi üçün təhlükəsiz xarici API inteqrasiyaları kimi təsvir edilən Digər kateqoriyasında yerləşir.
- Giriş məlumatları inteqrasiya icazəsi olan istifadəçi tərəfindən Tənzimləmələr, İnteqrasiyalar bölməsindən yaradılır və onlara şifrə kimi yanaşılmalıdır.
- Tərtibatçı hər hansı bir kod yazmazdan əvvəl hansı məlumatların hansı istiqamətdə hərəkət edəcəyini və bağlantıya kimin cavabdeh olduğunu planlaşdırın.
CRM API inteqrasiyası nədir?
API (tətbiqi proqramlaşdırma interfeysi) bir proqram təminatının digəri ilə əlaqə qurması üçün müəyyən edilmiş üsuldur. REST API bunu internet üzərindən həyata keçirir: xarici sistem bir ünvana sorğu göndərir, qəbul edən sistem sorğunu kimin göndərdiyini yoxlayır və məlumatla cavab verir və ya dəyişikliyi təsdiqləyir. CRM API inteqrasiyası bu mexanizmdən istifadə edir ki, veb-saytınız, mağazanız, daxili alətləriniz və ya hesabatlarınız öz cədvəllərinə uyğun olaraq CRM məlumatlarını oxuya və ya yaza bilsin.
Mesencer və ya təqvimin qoşulması kimi hazır inteqrasiyalar bir neçə kliklə ümumi ehtiyacları qarşılayır. API inteqrasiyası isə qalan hər şey üçündür: yalnız şirkətinizin istifadə etdiyi sistem, xüsusi hesabat və ya heç bir hazır bağlayıcının dəstəkləmədiyi bir proses. Bunun üçün tərtibatçı tələb olunur, lakin bu, tam olaraq nəyin mübadilə edildiyinə nəzarət etmək imkanı verir.
LuaCRM API nələri təklif edir
Lua CRM inteqrasiyalar səhifəsi LuaCRM API-ni Digər kateqoriyasında göstərir və onu LuaCRM ilə üçüncü tərəf sistemləri arasında token əsaslı məlumat mübadiləsi üçün təhlükəsiz xarici API inteqrasiyaları kimi təsvir edir. LuaCRM API kartında qeyd olunur ki, o, LuaCRM REST API v1 istifadə edən xarici sistemlər üçün API giriş məlumatları yaratmağa və yeniləməyə imkan verir.
İnteqrasiyalar üzrə Lua CRM sənədləri praktiki təfərrüatları əlavə edir. İnteqrasiyalar Tənzimləmələr, İnteqrasiyalar bölməsində idarə olunur və orada işləmək üçün inteqrasiya icazəsinə ehtiyacınız var. LuaCRM API kartı REST API üçün giriş məlumatlarını təyin etdiyiniz yerdir və onun Qoşul düyməsi token dialoqunu açır. Sənədlərdə həmçinin bu kart üçün ətraflı səhifənin tezliklə istifadəyə veriləcəyi qeyd olunur, buna görə də son nöqtələr (endpoints), mövcud qeydlər və limitlər barədə təxmin etmək əvəzinə Lua CRM komandası ilə əlaqə saxlayın.
| Maddə | Rəsmi mənbələrin bildirdiyi | Sizin üçün nə deməkdir |
|---|---|---|
| Kateqoriya | Digər: token əsaslı məlumat mübadiləsi üçün təhlükəsiz xarici API inteqrasiyaları | Seçdiyiniz üçüncü tərəf sistemlərini qoşmaq üçün nəzərdə tutulub |
| Məqsəd | Xarici sistemlər üçün API giriş məlumatlarını yaratmaq və yeniləmək | Hər bir xarici sistem öz giriş məlumatlarını ala bilər |
| API versiyası | LuaCRM REST API v1 | Tərtibatçınız sorğuları 1-ci versiyaya uyğun qurur |
| Harada idarə olunur | Tənzimləmələr, İnteqrasiyalar, LuaCRM API kartı | Yalnız inteqrasiya icazəsi olan istifadəçilər onu idarə edə bilər |
| Qoşulma əməliyyatı | Token dialoqunu açır | Giriş məlumatları e-poçt vasitəsilə tələb olunmur, CRM daxilindən yaradılır |
| Ətraflı bələdçi | Sənədlərdə tezliklə təqdim ediləcək kimi qeyd edilib | Son nöqtələri və məlumat əhatəsini Lua CRM komandası ilə dəqiqləşdirin |
Eyni kateqoriyada ChatGPT, Claude və Grok kimi süni intellekt köməkçilərini iş sahəsinə qoşan LuaCRM MCP və müştəri mobil tətbiqi olan My Lua da yer alır. Bunlar öz məqsədləri olan ayrıca kartlardır; bu məqalə yalnız LuaCRM API-ni əhatə edir.
Sistemi API vasitəsilə qoşmağın tipik səbəbləri
Hər bir şirkətin öz sistemləri var, buna görə də aşağıdakı siyahıya zəmanət verilmiş funksiyalar siyahısı kimi deyil, tərtibatçınız və Lua CRM komandası ilə müzakirə ediləcək məqamlar kimi yanaşın.
Daxili və ya xüsusi hazırlanmış proqram təminatı
Bir çox şirkət xüsusi olaraq onlar üçün yaradılmış rezervasiya sistemi, tərəfdaş portalı və ya əməliyyat alətindən istifadə edir. API bağlantısı bu cür alətə ikinci, köhnəlmiş bir siyahı saxlamaq əvəzinə müştəri məlumatlarını CRM ilə paylaşmağa imkan verir.
Hesabat və analitika
Rəhbərlik tez-tez maliyyə və ya marketinq rəqəmləri ilə yanaşı CRM məlumatlarını da görmək istəyir. API hesabat alətinə əllə ixraca arxalanmaq əvəzinə məlumatları cədvəl üzrə avtomatik toplamaq imkanı verir.
Hazır bağlayıcısı olmayan sistemlər
Lua CRM artıq bir çox alətlər üçün hazır inteqrasiyalar təklif edir, məsələn forma göndərişləri üçün Google Forms CRM inteqrasiyası, onlayn mağaza kataloqları üçün WooCommerce CRM inteqrasiyası və e-poçt üçün SendGrid CRM inteqrasiyası. Hazır inteqrasiya mövcud olduqda, oradan başlayın. API qalan sistemlər üçün olan seçimdir.
Təkrarlanan məlumat daxiletməsinin azaldılması
Hər bir əllə kopyalama addımı vaxt itkisinə və xətalara səbəb olur. Həddindən artıq proqram təminatı ilə biznes idarə etməyin gizli xərcləri haqqında məqaləmiz şirkət böyüdükcə bir-biri ilə əlaqəsi olmayan sistemlərin nə üçün baha başa gəldiyini izah edir.
CRM API inteqrasiyasını necə planlaşdırmaq olar
İnteqrasiya problemlərinin əksəriyyəti kodlaşdırma yox, planlaşdırma problemləridir. Kimsə kod yazmağa başlamazdan əvvəl, prosesin biznes sahibi və proqramçı ilə birlikdə bu sualların cavablarını razılaşdırın.
- Əsas məlumat mənbəyi (source of truth) hansı sistemdir? İki sistemin bir-birinin məlumatlarını üzərinə yazmaması üçün hər bir məlumat parçasının harada yaradıldığını və redaktə edildiyini müəyyənləşdirin.
- Hansı məlumatlar və hansı istiqamətdə ötürülür? Dəqiq qeydləri və sahələri, həmçinin məlumatın CRM-dən oxunduğunu, ora yazıldığını və ya hər ikisini qeyd edin.
- Hansı tezliklə? Bəzi proseslər real vaxta yaxın yeniləmələr tələb edir; digərləri üçün isə gündəlik yenilənmə kifayətdir.
- Xəta baş verdikdə nə olur? Sorğu uğursuz olduqda kimə bildiriş göndəriləcəyini və uğursuz qeydlərin necə yenidən cəhd ediləcəyini razılaşdırın.
- İnteqrasiyanın sahibi kimdir? Giriş məlumatları (credentials), kod və monitorinqə cavabdeh olan bir nəfəri müəyyən edin.
Əgər mövcud sistemlərinizdəki məlumatlar qarışıqdırsa, nəsə qoşmazdan əvvəl onları təmizləyin. Excel-dən CRM-ə miqrasiya üzrə bələdçimiz API layihələrinə də eyni dərəcədə aid olan təkrarlanmaların aradan qaldırılması və sahələrin təmizlənməsini əhatə edir.
Xarici sistemi Lua CRM-ə necə qoşmaq olar
Aşağıdakı addımlar rəsmi mənbələrin təsvir etdiklərinə əsaslanır və mənbələrin qeyd etmədiyi texniki detalları Lua CRM komandasına həvalə edir.
- Əhatə dairəsini təsdiqləyin. Planınızı Lua CRM komandası ilə paylaşın və sizin vəziyyətiniz üçün REST API v1-in hansı qeydləri və əməliyyatları dəstəklədiyini təsdiqləyin.
- İcazələri yoxlayın. Giriş məlumatlarını yaradacaq şəxsin Lua CRM-də inteqrasiyalar üzrə icazəyə malik olduğundan əmin olun.
- LuaCRM API kartını açın. Parametrlər (Settings) > İnteqrasiyalar (Integrations) bölməsinə keçin, LuaCRM API kartını tapın və token dialoq pəncərəsini açmaq üçün Qoşul (Connect) düyməsinə klikləyin.
- Bir sistem üçün giriş məlumatları yaradın. Müvafiq xarici sistem üçün giriş məlumatları (credentials) yaradın və yadda saxlayın. Hansı sistemin hansı giriş məlumatlarından istifadə etdiyini bilmək üçün onları adlandırın və ya sənədləşdirin.
- Giriş məlumatlarını təhlükəsiz şəkildə saxlayın. Onları təhlükəsiz kanal vasitəsilə proqramçıya ötürün və kod repozitoriyalarında, çatlarda və ya elektron cədvəllərdə deyil, gizli məlumat anbarında (secrets store) saxlayın.
- Kiçik məlumat dəsti ilə sınaqdan keçirin. Bir neçə test qeydi ilə başlayın, nəticəni Lua CRM-də yoxlayın və canlı rejimə keçməzdən əvvəl sahələrin uyğunlaşdırılmasını (field mapping) tənzimləyin.
- Canlı rejimə keçin və monitorinq aparın. Tam axını işə salın, ilk həftələrdə xətaları diqqətlə izləyin və inteqrasiyanı müntəzəm olaraq nəzərdən keçirin.
API giriş məlumatlarını təhlükəsiz idarə etmək
API giriş məlumatları sistemə müştəri məlumatlarınıza giriş imkanı verir, ona görə də onlara ofisinizin açarları kimi yanaşın. İnteqrasiyalar səhifəsində qeyd olunan giriş məlumatlarını yeniləmək (rotate) imkanı bunun vacib bir hissəsidir.
- Hər sistem üçün bir dəst giriş məlumatı. Əgər bir sistem ləğv edilərsə və ya təhlükəyə məruz qalarsa, digərlərini pozmadan onun giriş məlumatlarını dəyişə bilərsiniz.
- Qrafik üzrə və dəyişikliklərdən sonra yeniləyin. Giriş məlumatlarını müntəzəm olaraq və çıxışı olan bir proqramçı və ya podratçı layihədən ayrıldıqda yeniləyin.
- İnteqrasiyaları idarə edə biləcək şəxsləri məhdudlaşdırın. İnteqrasiyalar icazəsini yalnız buna ehtiyacı olan az sayda şəxs üçün saxlayın.
- Giriş məlumatlarını heç vaxt açıq mətn şəklində paylaşmayın. E-poçt yazışmaları və mesajlaşma proqramları məxfi məlumatlar üçün təhlükəsiz yer deyil.
- Sadə bir reyestr saxlayın. Qoşulmuş hər bir sistemi, onun sahibini, giriş məlumatlarının nə vaxt yaradıldığını və sonuncu dəfə nə vaxt yeniləndiyini qeyd edin.
Yol verilməməsi lazım olan ümumi səhvlər
- Planlaşdırmadan əvvəl qurmağa başlamaq. Əsas məlumat mənbəyi razılaşdırılmadan yazılmış kod çox vaxt təkrarlanan qeydlər yaradır və ya düzgün məlumatların üzərinə yazılır.
- İmkanları fərz etmək. CRM-dəki hər ekranın API vasitəsilə əlçatan olduğunu fərz etmək əvəzinə, API-nin hansı məlumatları əhatə etdiyini Lua CRM komandası ilə təsdiqləyin.
- Hər yerdə eyni giriş məlumatlarından istifadə etmək. Ortaq giriş məlumatları onların yenilənməsini riskli edir və hansı sistemin hansı dəyişikliyi etdiyini gizlədir.
- İstifadəyə verildikdən sonra sahibin olmaması. Proseslər, sahələr və ya sistemlər dəyişdikdə inteqrasiyaların texniki dəstəyə ehtiyacı olur.
- Hazır inteqrasiyaları nəzərə almamaq. Fərdi bağlantı qurmaq və saxlamaq artıq mövcud olan hazır konnektordan daha baha başa gəlir.