İçeriğe geç
n8n entegrasyonu rehberi

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.

Nasıl çalışır?

Beş adımda n8n ile Rapitek CRM

  1. 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. 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. 3

    Alanları keşfedin

    Bir nesnenin alanlarını /describe/ adresinden, bütün uç noktaları /api/docs belgesinden görürsünüz.

  4. 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. 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.

1. adım

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.

2. adım

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; limit ve offset ile 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.

3. adım

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.

Örnek akışlar

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?
Evet. n8n HTTP Request düğümü OAuth2 client_credentials ile jeton alıp Rapitek CRM REST API'si (/api/v1/) üzerinden kayıt okur ve yazar. Kayıt olayları Ayarlar > Webhooklar ekranındaki imzalı aboneliklerle n8n Webhook düğümüne gönderilir.
Ayrı bir n8n eklentisi kurmak gerekir mi?
Hayır. n8n'in kendi HTTP Request ve Webhook düğümleri yeterlidir.
Erişim jetonu ne kadar geçerli?
4 saat. Süre dolunca aynı token isteğiyle yeni jeton alınır.
Bir istekte kaç kayıt döner?
Liste sayfa başına 50 kayıt döner; limit ve offset ile sonraki sayfalar okunur. /bulk/ ile tek istekte en fazla 200 kayıt işlenir.
Hangi kayıt olayları n8n'e gönderilir?
Kayıt oluşturma, güncelleme ve silme: record.created, record.updated ve record.deleted.
Webhook imzası nasıl doğrulanır?
Zaman damgası ve gövde 'zaman_damgası.gövde' biçiminde birleştirilir, abonelik gizli anahtarıyla HMAC-SHA256 hesaplanır ve X-Rapitek-Signature başlığıyla karşılaştırılır. 300 saniyeden eski zaman damgası işleme alınmaz.
Bildirim teslim edilemezse ne olur?
Bildirim en fazla 5 kez yeniden denenir. X-Rapitek-Delivery değeriyle aynı bildirimin ikinci kez işlenmesini önlersiniz.
Webhook aboneliğini kim açar?
Hesap yöneticisi, Ayarlar > Webhooklar ekranından.
Zapier ya da Make ile de bağlanır mı?
Bağlantı yöntemi aynıdır: REST API ve imzalı webhook. HTTP isteği gönderip webhook alabilen Zapier ve Make gibi araçlarda da aynı adımlar izlenir; bu rehber adımları n8n düğümleriyle anlatır.
KVKK açısından ne sağlanıyor?
Verileriniz AB'de (Hetzner Finlandiya/Almanya) barındırılır; alt işleyici listesi sözleşme eki olarak talep üzerine verilir.

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.

RapitekGO ile yapıldı

Ölçüm için isteğe bağlı çerez kullanmak istiyoruz; reddederseniz site aynen çalışır. Çerez politikası