Zoho CRM entegrasyonu, web formlarınızı, sitenizi veya iş uygulamalarınızı Zoho CRM'e bağlayarak potansiyel müşteri, kişi ve fırsat kayıtlarını otomatik oluşturmak ve güncellemektir. Zoho CRM API v8 OAuth 2.0 ile çalışır; hesabınızın bulunduğu veri merkezine göre doğru adresi kullanmak gerekir.
İlgili içerikler: CRM entegrasyonu rehberi · HubSpot entegrasyonu · Bitrix24 entegrasyonu
Self Client ile Token Alma
api-console.zoho.comadresinde Self Client oluşturun; Client ID ve Client Secret "Client Secret" sekmesinde görünür.- "Generate Code" sekmesinde scope'ları virgülle yazın (ör.
ZohoCRM.modules.leads.CREATE), süreyi ve organizasyonu seçin; tek kullanımlık grant token üretilir. - Grant token'ı
{accounts_URL}/oauth/v2/tokenadresinegrant_type=authorization_codeile gönderin. Yanıtta access token, refresh token veapi_domaindöner. - Access token 1 saat geçerlidir; süresi dolunca refresh token ile yenilenir.
curl -X POST "https://accounts.zoho.eu/oauth/v2/token" \
-d grant_type=authorization_code \
-d client_id=CLIENT_ID \
-d client_secret=CLIENT_SECRET \
-d code=GRANT_TOKEN| Kural | Değer |
|---|---|
| Grant token | Tek kullanımlık, varsayılan 3 dakika geçerli |
| Access token | 1 saat |
| Refresh token | Kullanıcı başına en fazla 20; 21. üretilince en eskisi geçersiz olur |
| Yenileme | Bir refresh token'dan 10 dakikada en fazla 10 access token |
Veri Merkezine Göre Adresler
| Veri merkezi | Accounts adresi |
|---|---|
| ABD | accounts.zoho.com |
| AB | accounts.zoho.eu |
| Hindistan | accounts.zoho.in |
| Avustralya | accounts.zoho.com.au |
| Japonya | accounts.zoho.jp |
| Kanada | accounts.zohocloud.ca |
Kayıt Ekleme, Upsert ve Arama
| İşlem | Uç nokta | Not |
|---|---|---|
| Ekleme | POST /crm/v8/{module} | Çağrı başına en çok 100 kayıt; Leads'te Last_Name zorunlu |
| Upsert | POST /crm/v8/{module}/upsert | duplicate_check_fields ile kontrol sırası; Leads ve Contacts'ta varsayılan Email |
| Arama | GET /crm/v8/{module}/search | criteria, email, phone veya word ile; en fazla 2.000 sonuç |
curl -X POST "https://www.zohoapis.eu/crm/v8/Leads/upsert" \
-H "Authorization: Zoho-oauthtoken ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"data":[{"Last_Name":"Yılmaz","Email":"ayse@ornek.com","Lead_Source":"Web Form"}],"duplicate_check_fields":["Email"]}'Ekleme isteğindeki trigger parametresi iş akışı, onay ve blueprint gibi otomasyonların çalışıp çalışmayacağını belirler; boş liste verilirse otomasyon tetiklenmez. Upsert yanıtında her kayıt için "insert" veya "update" döner; kısmi başarıda HTTP 207 gelir.
İstek Sınırları (Kredi Sistemi)
Zoho, kayan 24 saatlik pencerede kredi sayar. Free planda 5.000 kredi var; ücretli planlarda kredi lisans sayısına göre artar. Ekleme, güncelleme ve upsert işlemleri her 10 kayıt için 1 kredi harcar. Eşzamanlı istek sayısı da plana göre sınırlıdır (Free 5, Standard 10, Professional 15, Enterprise 20, Ultimate 25); aşılınca TOO_MANY_REQUESTS döner.
Değişiklik Bildirimleri
| Yöntem | Nasıl | Not |
|---|---|---|
| Notification API | POST /crm/v8/actions/watch ile kanal açılır; olaylar (ör. Leads.create) ve bildirim adresi verilir | Kanal en fazla 1 hafta geçerli; yenilenmesi gerekir |
| Workflow webhook | Setup, Automation, Actions, Webhooks; bir iş akışı kuralına bağlanır | Yalnızca 80 ve 443 portları; 10 saniye zaman aşımı; başarısızsa 15 dakika sonra 1 kez daha denenir |
Web Formları
Zoho CRM'in kendi web formları Setup, Channels, Webforms yolundan oluşturulur; Leads, Contacts, Cases ve özel modüllerle çalışır. Formlar kaynak kodu, gömme kodu veya bağlantı olarak siteye eklenebilir; reCAPTCHA v2, çift onay ve onay kuyruğu seçenekleri vardır.
Veri Merkezi
Zoho'nun veri merkezi listesinde Türkiye yok. Varsayılan veri merkezi kayıt sırasındaki IP konumuna göre atanıyor; taşıma için Zoho'ya talep gönderilmesi gerekiyor.
Sık Sorulan Sorular
Hangi API adresini kullanmalıyım?
Token yanıtındaki api_domain değerini. Accounts adresi hesabınızın veri merkezine göre seçilir.
Mükerrer potansiyel müşteri nasıl önlenir?
/upsert kullanıp duplicate_check_fields ile kontrol edilecek alanı (ör. Email) belirterek.
Webhook mu Notification API mi?
Kodla kanal açıp olayları dinlemek için Notification API; koşula bağlı, kodsuz akışlar için iş akışı webhook'u.
Marka adları sahiplerine aittir. Bu yazı bağımsız bir teknik rehberdir; adı geçen kuruluşlarla bayilik veya ortaklık ilişkisi bulunduğu anlamına gelmez.