n8n ile Rapitek CRM: kayıtları okuyun, yazın, olaylarla akış başlatın.
n8n'in HTTP Request düğümü OAuth2 client_credentials ile jeton alır ve Rapitek CRM REST API'sinden kayıt okuyup yazar. Kayıt oluştuğunda, güncellendiğinde ya da silindiğinde Rapitek CRM imzalı webhook ile n8n Webhook düğümüne haber verir.
n8n ile Rapitek CRM nasıl bağlanır?
n8n, iş akışlarını görsel düğümlerle kuran bir otomasyon aracıdır. Rapitek CRM ile iki yönde çalışır: n8n CRM'e istek gönderir ve kayıt okur ya da yazar; CRM de kayıt olaylarını n8n'e gönderir.
Bağlantı için hazır bir eklenti kurmanız gerekmez. n8n'in kendi HTTP Request ve Webhook düğümleri yeterlidir. Rapitek CRM'deki kayıtlar REST API ile /api/v1/<nesne>/ adresinden okunur ve yazılır; kayıt olayları Ayarlar > Webhooklar ekranındaki imzalı aboneliklerle gönderilir.
Beş adımda n8n ile Rapitek CRM
-
1
Jeton alın
HTTP Request düğümüyle firmanıza ait token adresine istemci kimliği ve gizli anahtarı gönderin. Dönen erişim jetonu 4 saat geçerlidir.
-
2
Kayıt okuyun ve yazın
Jetonu Bearer başlığıyla gönderin. Nesnenin /api/v1/ adresine GET ile listeler, POST ile yeni kayıt açarsınız.
-
3
Alanları keşfedin
Bir nesnenin alanlarını /describe/ adresinden, bütün uç noktaları /api/docs belgesinden görürsünüz.
-
4
Webhook aboneliği açın
Hesap yöneticisi Ayarlar > Webhooklar ekranında n8n Webhook düğümünün adresini ve izlenecek olayları seçer.
-
5
İmzayı doğrulayın
Gelen her bildirim HMAC-SHA256 ile imzalıdır. n8n akışında imzayı doğrulayıp sonra işleme alırsınız.
Erişim jetonu almak
Jeton isteği, firmanızın Rapitek CRM adresine gider. Adresin sonundaki eğik çizgi gereklidir:
POST https://<firma>.app.rapitek.com/o/token/
n8n'de HTTP Request düğümünü şöyle ayarlayın:
- Method: POST
- Body Content Type: Form Urlencoded (x-www-form-urlencoded)
- Gövde alanları:
grant_type=client_credentials,client_id,client_secret
Yanıttaki access_token 4 saat geçerlidir. Süre dolunca aynı istekle yeni jeton alırsınız. Kapsamlar: read, write, delete, offline_access, setup.
Kayıt okumak ve yazmak
Sonraki HTTP Request düğümlerinde jetonu Authorization: Bearer <access_token> başlığıyla gönderin. İsteklere kendi User-Agent başlığınızı da ekleyin (ör. n8n-rapitek).
GET /api/v1/<nesne>/: kayıtları listeler. Liste sayfa başına 50 kayıt döner;limitveoffsetile sonraki sayfalara geçersiniz.POST /api/v1/<nesne>/: yeni kayıt açar.PUT,PATCH,DELETE /api/v1/<nesne>/<uuid>/: tek kaydı günceller ya da siler./api/v1/<nesne>/bulk/: tek istekte en fazla 200 kayıt işler./api/v1/<nesne>/search/: kayıt arar./api/v1/<nesne>/describe/: nesnenin alanlarını ve türlerini verir.
Nesne adlarının ve alanların tam listesi https://<firma>.app.rapitek.com/api/docs adresindeki belgededir.
Kayıt olaylarını n8n'e göndermek
Hesap yöneticisi Ayarlar > Webhooklar ekranında bir abonelik açar ve n8n Webhook düğümünün adresini girer. İzlenebilecek olaylar: record.created, record.updated, record.deleted.
Her bildirim şu başlıklarla gelir: X-Rapitek-Signature, X-Rapitek-Timestamp, X-Rapitek-Event, X-Rapitek-Delivery.
İmza, zaman damgası ve istek gövdesinin zaman_damgası.gövde biçiminde birleştirilip abonelik gizli anahtarıyla HMAC-SHA256 ile özetlenmesidir. n8n akışında aynı hesabı yapıp sonucu X-Rapitek-Signature ile karşılaştırın. Zaman damgası 300 saniyeden eski olan isteği işleme almayın.
Teslim edilemeyen bildirim en fazla 5 kez yeniden denenir. Aynı bildirimin ikinci kez işlenmemesi için X-Rapitek-Delivery değerini akışınızda saklayabilirsiniz.
n8n ile Rapitek CRM'de kurulan akışlar
Formdan CRM kaydına
Sitenizdeki ya da başka bir araçtaki form başvurusunu n8n'de alır, POST isteğiyle Rapitek CRM'de yeni kayıt açarsınız.
Yeni kayıtta bildirim
record.created olayı n8n'e düşer; akış ekibinize e-posta ya da kullandığınız mesajlaşma aracından haber verir.
Toplu aktarım
Başka bir sistemden gelen kayıtları /bulk/ ile tek istekte 200'er kayıtlık partiler hâlinde aktarırsınız.
Güncellemede tetik
record.updated olayıyla bir kayıt değiştiğinde muhasebe, e-ticaret ya da tablo tarafını n8n üzerinden güncellersiniz.
Zamanlanmış okuma
n8n'in zamanlayıcı düğümüyle kayıtları düzenli aralıklarla okuyup rapor ya da tabloya aktarırsınız.
Alan keşfi
Yeni bir akış kurmadan önce /describe/ ile nesnenin alanlarını görür, eşleştirmeyi doğru alan adlarıyla yaparsınız.
Kimler için uygun?
İş akışlarını n8n ile kuran ekipler, müşterisine otomasyon kuran ajanslar ve Rapitek CRM'i kendi sistemine bağlamak isteyen yazılım ekipleri için uygundur. Bağlantı standart HTTP istekleri ve webhook ile kurulur; HTTP isteği gönderip webhook alabilen Zapier ve Make gibi araçlarda da aynı adımlar izlenir.
ERP, muhasebe ve e-ticaret bağlantıları için entegrasyonlar sayfasına, bağlantı yöntemlerinin karşılaştırması için CRM entegrasyon karşılaştırması sayfasına bakın.
n8n entegrasyonu hakkında
n8n ile Rapitek CRM bağlanabilir mi?
Ayrı bir n8n eklentisi kurmak gerekir mi?
Erişim jetonu ne kadar geçerli?
Bir istekte kaç kayıt döner?
Hangi kayıt olayları n8n'e gönderilir?
Webhook imzası nasıl doğrulanır?
Bildirim teslim edilemezse ne olur?
Webhook aboneliğini kim açar?
Zapier ya da Make ile de bağlanır mı?
KVKK açısından ne sağlanıyor?
Rapitek CRM'i 7 gün ücretsiz deneyin.
Formu doldurun, Rapitek CRM'i 7 gün ücretsiz deneyebileceğiniz hesabı açıp giriş bilgisini size iletelim. Kredi kartı gerekmez. İsterseniz 30 dakikalık bir tanışma da planlayabilirsiniz.
