Bu rehberde: Pipedrive hesabınızı kişisel API token'ı ve şirket alan adınızla bağlarsınız. Müşteri adayları CRM'e eşitle kutusuyla e-postaya göre kişi (person) olarak güncellenir veya oluşturulur, şirket adı organizasyona bağlanır; isterseniz fırsat (deal) ya da Leads Inbox'a potansiyel (lead) açılır. Fırsat kazanıldığında veya yeni kişi eklendiğinde iş akışı başlatabilirsiniz.
⏱ 10 dakika
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | PIPEDRIVE |
| Kategori | CRM |
| Kimlik doğrulama | Kişisel API token'ı (x-api-token başlığı) + şirket alan adı (sirketiniz.pipedrive.com) |
| Kapsam | Organizasyon bazlı |
| Webhook | Evet – bağlanınca otomatik oluşturulur, HTTP Basic kimlik doğrulamasıyla korunur |
| Yetenekler | CRM eşitleme, uygulama işlemleri, uygulama tetikleyicileri |
Ne işe yarar?
- CRM eşitleme (
leads.crmSync): adayıncompany/companyNamealanı adla aranır, yoksa organizasyon oluşturulur. Kişi e-postayla aranır (tam eşleşme): bulunursa adı, boşsa organizasyonu ve hiç telefonu yoksa telefonu güncellenir; bulunamazsa oluşturulur. Mevcut e-posta ve telefonlar silinmez. - Fırsat / potansiyel: hedef
dealsise kişinin açık bir fırsatı yoksa fırsat açılır (varsa o fırsat döner, ikinci kez açılmaz); hedefleadsise arşivlenmemiş potansiyeli yoksa Leads Inbox'a eklenir. - Alan eşleme: entegrasyon ayarındaki
fieldMap(aday alanı → Pipedrive alan anahtarı, 40 karakterlik kod) ve adayda doğrudan 40 karakterlik alan anahtarları özel alanlara yazılır. - Pipedrive kutusu (iş akışı): kişi oluştur/güncelle, fırsat oluştur, potansiyel oluştur, not ekle, fırsat aşaması/durumu güncelle, kişi bul.
- Tetikleyiciler: Fırsat kazanıldı (durum
wonolduğunda) ve Kişi eklendi.
Ön koşullar
- Bir Pipedrive hesabı (API erişimi tüm planlarda vardır).
- Fırsatlar için: hedef pipeline ve aşama ID'leri (isteğe bağlı; boşsa Pipedrive varsayılanı).
Adım adım kurulum
- Pipedrive'da sağ üstte profil → Personal preferences → API → Your personal API token'ı kopyalayın.
- Şirket alan adınızı not edin:
https://sirketiniz.pipedrive.comadresindekisirketiniz. - OrqLabs'ta Entegrasyonlar → Pipedrive → Bağla → Personal API token ve Company domain alanlarını doldurun → Bağla.
- Bağlantı sırasında OrqLabs iki webhook oluşturur (
dealdeğişikliği vepersonoluşturma, sürüm 2.0). Webhook'larorqlabskullanıcı adı ve OrqLabs'ın gizli anahtarıyla HTTP Basic kimlik doğrulaması kullanır; Pipedrive → Tools and apps → Webhooks sayfasında görebilirsiniz.
CRM eşitleme ayarları
CRM'e eşitle kutusunda bu bağlantıyı seçin. Target alanı persons (varsayılan), deals veya leads olabilir. Entegrasyon ayarı (config) isteğe bağlı olarak şunları alır:
| Anahtar | Anlamı |
|---|---|
defaultObject | Target boşken kullanılan hedef (persons / deals / leads) |
ownerId | Oluşturulan kayıtların sahibi (kullanıcı ID) |
pipelineId, stageId | Yeni fırsatların pipeline'ı ve aşaması |
currency | Fırsat / potansiyel para birimi (ör. TRY) |
fieldMap | Aday alanı → Pipedrive özel alan anahtarı ({"budget": "a1b2…"}) |
Fırsat başlığı adayın dealTitle / title alanından, yoksa "Şirket – OrqLabs" biçiminde oluşturulur; tutar dealValue / value alanından alınır.
İş akışı kutusu: Pipedrive
| İşlem | Ne yapar | Çıktı |
|---|---|---|
| Kişi oluştur / güncelle | E-postayla bul–güncelle ya da oluştur; organizasyonu bağla | personId, created, url |
| Fırsat oluştur | Bu e-postadaki kişiye (yoksa oluşturulur) bağlı fırsat | dealId, stageId, url |
| Potansiyel oluştur | Leads Inbox'a potansiyel | leadId, url |
| Not ekle | Fırsat, kişi, organizasyon veya potansiyele not | noteId |
| Fırsat aşamasını güncelle | Aşamayı değiştirir ve/veya won / lost yapar | dealId, status |
| Kişi bul | E-postayla tam eşleşme | found, personId |
Fırsat ve potansiyel oluşturma otomatik yeniden denenmez; bağlantı koparsa Pipedrive'da kaydın oluşup oluşmadığını kontrol edin.
Tetikleyici: Entegrasyon olayı
Entegrasyon olayı tetikleyicisinde Pipedrive bağlantınızı ve PIPEDRIVE · Deal won veya PIPEDRIVE · Person created olayını seçin.
- Deal won: yalnızca durumun gerçekten
won'a değiştiği güncellemeler akışı başlatır (kazanılmış bir fırsatın başka bir alanını düzenlemek başlatmaz). Öğe:dealId,title,value,currency,stageId,personId,organizationId,wonTime,url. - Person created: öğe
personId,name,email,phone,organizationId,ownerId,url.
Sık karşılaşılan hatalar
| Hata | Olası neden | Çözüm |
|---|---|---|
CONFIG – "company domain … must be your Pipedrive subdomain" | Alan adı yanlış | Yalnızca sirketiniz kısmını girin |
AUTH – 401 | Token yanlış veya yenilendi | Yeni token'ı Kimlik bilgileri → Güncelle ile girin |
RATE_LIMIT – 429 | Pipedrive'ın token bazlı limiti | OrqLabs bekleyip yeniden dener; büyük eşitlemeleri parçalayın |
INVALID – "lead needs email or name" | Adayda e-posta ve ad yok | Eşlemeye email veya name ekleyin |
| Webhook kaydı başarısız | Kullanıcının webhook yetkisi yok | Yönetici bir kullanıcının token'ıyla bağlanın |