Üçüncü Parti Entegrasyonlar

Genel Bakış

DOLU.ai, CRM yeteneklerinizi genişletmek için popüler üçüncü parti hizmetlerle bağlantı kurar. Entegrasyonlar sayesinde takvimleri senkronize edebilir, potansiyel müşterileri reklam platformlarına aktarabilir, Zapier aracılığıyla iş akışlarını otomatikleştirebilir, webhook'lar ile gerçek zamanlı olay bildirimleri alabilir ve DOLU.ai API'sine programatik erişim sağlayabilirsiniz. Bu sayfa mevcut tüm entegrasyonları ve her birinin nasıl yapılandırılacağını açıklar.

Nasıl Erişilir

Ana Sayfa → Ayarlar → Entegrasyonlar

Sol menüden Ayarlar'a tıklayın, ardından Entegrasyonlar'ı seçin. Entegrasyon kartlarını kategorilere göre gruplandırılmış olarak göreceksiniz: Takvim, Reklam, Otomasyon ve Geliştirici.

Google Calendar Entegrasyonu

DOLU.ai randevularınızı Google Calendar ile senkronize edin. AI Beyin veya CRM üzerinden yapılan her rezervasyon otomatik olarak takviminizde görünsün.

Ön Koşullar

• Google Calendar etkin bir Google hesabı
• Üçüncü parti uygulamalara yetki verme izni (Google Workspace kullanıyorsanız yöneticinize danışın)

Bağlantı Adımları

1. Ayarlar > Entegrasyonlar > Google Calendar bölümüne gidin.
2. Google Calendar Bağla butonuna tıklayın.
3. Google OAuth penceresi açılacaktır. Takvimini senkronize etmek istediğiniz Google hesabıyla giriş yapın.
4. DOLU.ai'ye takviminizdeki etkinlikleri görüntüleme ve düzenleme izni verin.
5. Yetkilendirme sonrası DOLU.ai'ye geri yönlendirileceksiniz. Google Calendar kartı Bağlı durumunu gösterecek.
6. Açılır menüden varsayılan takvim seçin (birden fazla takviminiz varsa).
7. Senkronizasyon yönünü belirleyin:
   • Tek yönlü (DOLU.ai'den Google'a): DOLU.ai'de oluşturulan randevular Google Calendar'da görünür.
   • Çift yönlü: Her iki sistemdeki değişiklikler diğerinde yansıtılır.
8. Ayarları Kaydet butonuna tıklayın.

Nasıl Çalışır

• Bir müşteri AI Beyin aracılığıyla randevu aldığında, müşterinin adı, iletişim bilgileri ve randevu detaylarıyla otomatik olarak bir takvim etkinliği oluşturulur.
• Çift yönlü senkronizasyon etkinse, Google Calendar'da zaman bloklama yapılması bu aralıkları DOLU.ai'de müsait olmayan olarak işaretler.
• DOLU.ai'de iptal edilen randevular Google Calendar'dan otomatik olarak kaldırılır.

Google Ads Entegrasyonu

Hangi reklam kampanyalarının DOLU.ai CRM'inizde potansiyel müşteri oluşturduğunu takip etmek için Google Ads'i bağlayın.

Ön Koşullar

• Aktif kampanyaları olan bir Google Ads hesabı
• Google Ads'te dönüşüm takibinin etkin olması

Bağlantı Adımları

1. Ayarlar > Entegrasyonlar > Google Ads bölümüne gidin.
2. Google Ads Bağla butonuna tıklayın.
3. Ads hesabını yöneten Google hesabınızla kimlik doğrulaması yapın.
4. Listeden Google Ads hesabını (Müşteri Kimliği) seçin.
5. Potansiyel müşteri dönüşüm takibini etkinleştirin. DOLU.ai, bir Google Ads tıklamasından potansiyel müşteri oluşturulduğunda otomatik olarak dönüşüm etkinliği gönderecektir.
6. İsteğe bağlı olarak DOLU.ai potansiyel müşteri aşamalarını Google Ads dönüşüm eylemlerine eşleyin (örn: "Nitelikli Potansiyel Müşteri" = dönüşüm, "Kazanılan Anlaşma" = değerli dönüşüm).
7. Ayarları Kaydet butonuna tıklayın.

Dönüşüm Takibi

Bağlandıktan sonra DOLU.ai, gelen widget sohbetlerinden gclid (Google Tıklama Kimliği) bilgisini Google Ads'e geri iletir. Bu sayede:

• Hangi anahtar kelimelerin ve kampanyaların en nitelikli potansiyel müşterileri oluşturduğunu görebilirsiniz.
• Reklam harcamalarınızı sadece tıklamalara değil, gerçek CRM sonuçlarına göre optimize edebilirsiniz.
• Google'ın Akıllı Teklif özelliğini DOLU.ai'den gelen gerçek dönüşüm verileriyle kullanabilirsiniz.

Zapier Entegrasyonu

Zapier, DOLU.ai'yi 5.000'den fazla uygulamayla bağlar. DOLU.ai ile favori araçlarınız arasında veri aktarmak için otomatik iş akışları (Zap) oluşturun.

Bağlantı Adımları

1. Ayarlar > Entegrasyonlar > Zapier bölümüne gidin.
2. Zapier Bağla butonuna tıklayın. Bu, Zapier web sitesini açar.
3. Zapier uygulama dizininde DOLU.ai'yi arayın.
4. Yeni bir Zap oluşturun ve tetikleyici veya eylem uygulaması olarak DOLU.ai'yi seçin.
5. İstendiğinde DOLU.ai API Anahtarınızı yapıştırın (Ayarlar > Entegrasyonlar > API Anahtarları bölümünde bulunur).
6. Zap tetikleyicinizi (örn: "Yeni Potansiyel Müşteri Oluşturuldu") ve eylemini (örn: "Google Sheets'e Satır Ekle") yapılandırın.
7. Zap'ı test edin ve etkinleştirin.

Popüler Zap Örnekleri

Tetikleyici (DOLU.ai)	Eylem (Harici Uygulama)	Kullanım Senaryosu
Yeni Potansiyel Müşteri	Google Sheets'e satır ekle	Müşteri adayı yedekleme
Anlaşma Aşaması Değişti	Slack bildirimi gönder	Satış ekibi uyarıları
Yeni Randevu	Google Calendar etkinliği oluştur	Takvim senkronizasyonu
Yeni Destek Talebi	Trello kartı oluştur	Destek görev takibi
Müşteri Puanı Güncellendi	Mailchimp ile e-posta gönder	Yüksek puanlı müşteri besleme

Webhook'lar

Webhook'lar, belirli olaylar gerçekleştiğinde DOLU.ai'nin sunucunuza gerçek zamanlı HTTP POST bildirimleri göndermesini sağlar.

Yapılandırma Adımları

1. Ayarlar > Entegrasyonlar > Webhook'lar bölümüne gidin.
2. Webhook Ekle butonuna tıklayın.
3. Webhook için bir ad girin (örn: "Potansiyel Müşteri Bildirimleri").
4. Sunucu uç noktanızın URL'sini girin (HTTPS olmalıdır).
5. Bu webhook'u tetikleyecek olayları seçin:
   • lead.created — Yeni potansiyel müşteri eklendi
   • lead.updated — Potansiyel müşteri bilgileri değişti
   • deal.stage_changed — Anlaşma yeni bir aşamaya geçti
   • appointment.created — Yeni randevu alındı
   • appointment.canceled — Randevu iptal edildi
   • message.received — Herhangi bir kanaldan yeni mesaj geldi
   • ticket.created — Destek talebi açıldı
6. İsteğe bağlı olarak yük imza doğrulaması için bir gizli anahtar ekleyin.
7. Webhook'u Kaydet butonuna tıklayın.

Yük Formatı

Webhook'lar aşağıdaki yapıda JSON yükü gönderir:

{
  "event": "lead.created",
  "timestamp": "2025-01-15T10:30:00Z",
  "data": {
    "id": "lead_abc123",
    "name": "Ahmet Yılmaz",
    "email": "[email protected]",
    "phone": "+905551234567",
    "source": "whatsapp",
    "score": 75
  }
}

Webhook İmza Doğrulaması

Gizli anahtar yapılandırdıysanız, her istek X-Dolu-Signature başlığı içerir. Gizli anahtarınızı kullanarak ham istek gövdesinin HMAC-SHA256 değerini hesaplayın ve başlık değeriyle karşılaştırın.

Yeniden Deneme Politikası

DOLU.ai, başarısız webhook teslimatlarını (2xx dışı yanıtlar) üstel geri çekilme ile 3 kez yeniden dener: 1 dakika, 5 dakika, 30 dakika.

API Anahtarları

API anahtarları, özel entegrasyonlar ve scriptler için DOLU.ai REST API'si ile kimlik doğrulaması yapmanızı sağlar.

API Anahtarı Oluşturma

1. Ayarlar > Entegrasyonlar > API Anahtarları bölümüne gidin.
2. Yeni Anahtar Oluştur butonuna tıklayın.
3. Bir etiket girin (örn: "Backend Entegrasyonu", "Zapier").
4. İzinleri seçin: Sadece Okuma, Okuma/Yazma veya Tam Erişim.
5. Oluştur butonuna tıklayın. Anahtar yalnızca bir kez gösterilir. Hemen kopyalayın — tekrar görüntülenemez.
6. Yeni anahtar, etiketi, oluşturulma tarihi, son kullanım tarihi ve izinleriyle listede görünür.

API Anahtarı Yönetimi

• İptal etme: Bir anahtarı kalıcı olarak iptal etmek için yanındaki çöp kutusu simgesine tıklayın. İptal edilen anahtarlar anında çalışmayı durdurur.
• Döndürme: Yeni bir anahtar oluşturun, entegrasyonunuzu yeni anahtarı kullanacak şekilde güncelleyin, ardından eski anahtarı iptal edin.
• Etkinlik Günlüğü: O anahtarla yapılan son API çağrılarını görmek için anahtarın etiketine tıklayın.

Hız Sınırları

Plan	Hız Sınırı
Başlangıç	100 istek/dakika
Profesyonel	500 istek/dakika
Kurumsal	2.000 istek/dakika

Hız sınırını aşmak HTTP 429 döndürür. İstemcinizde üstel geri çekilme uygulayın.

İpuçları ve En İyi Uygulamalar

API Anahtarları İçin Açıklayıcı Etiketler Kullanın

API anahtarlarınızı beslediği hizmete göre adlandırın (örn: "Zapier Üretim", "Dahili CRM Senkronizasyonu"). Bu, gerektiğinde doğru anahtarı tespit edip iptal etmeyi kolaylaştırır.

Webhook'ları webhook.site Gibi Bir Araçla Test Edin

Webhook'ları üretim sunucunuza yönlendirmeden önce, yükleri incelemek ve olay yapısını doğrulamak için webhook.site gibi bir test hizmeti kullanın.

Çift Yönlü Takvim Senkronizasyonunu Etkinleştirin

DOLU.ai ile Google Calendar arasında çift yönlü senkronizasyon, manuel olarak bloklanan zaman aralıklarının AI Beyin müşterilere randevu saati sunarken dikkate alınmasını sağlar.

API Anahtarı İzinlerini Sınırlayın

En az yetki ilkesini takip edin. Bir entegrasyon yalnızca veri okuyorsa, Sadece Okuma anahtarı oluşturun. Bu, anahtarın ele geçirilmesi durumunda riski en aza indirir.

Sorun Giderme

Google Calendar etkinlikleri senkronize olmuyor

• Google Calendar kartında Yeniden Bağla butonuna tıklayarak Google bağlantısını yeniden yetkilendirin.
• Seçili varsayılan takvimin salt okunur paylaşımlı takvim olmadığından emin olun.
• Google Calendar değişikliklerinin DOLU.ai'ye yansımasını bekliyorsanız çift yönlü senkronizasyonun etkin olduğunu kontrol edin.

Zapier tetikleyicileri çalışmıyor

• DOLU.ai API anahtarınızın hâlâ geçerli olduğunu (iptal edilmediğini) doğrulayın.
• Hata detayları için Zapier'deki Zap geçmişini kontrol edin.
• Tetikleyici olayın DOLU.ai'de gerçekten gerçekleştiğinden emin olun (örn: gerçek bir potansiyel müşteri oluşturuldu, sadece düzenlenmedi).

Webhook teslimat hataları

• Uç nokta URL'nizin HTTPS olduğunu ve genel erişime açık olduğunu onaylayın.
• Yükü işlerken oluşan hatalar için sunucu loglarınızı kontrol edin.
• Yanıt kodunun 2xx olduğunu doğrulayın. DOLU.ai, 3xx yönlendirmelerini başarısız olarak kabul eder.
• Teslimat girişimlerini ve yanıtları görmek için Ayarlar > Entegrasyonlar > Webhook'lar > Loglar bölümünü kullanın.

API anahtarı 401 Unauthorized döndürüyor

• Anahtarı Authorization: Bearer ANAHTARINIZ başlığında gönderdiğinizi doğrulayın.
• Anahtarın iptal edilmediğini kontrol edin.
• Anahtarın çağırdığınız uç nokta için yeterli izinlere sahip olduğundan emin olun.

Google Ads dönüşümleri takip edilmiyor

• gclid parametresinin web siteniz veya widget'ınız tarafından yakalandığını doğrulayın.
• Google Ads hesabının düzgün bağlandığını ve dönüşüm eyleminin yapılandırıldığını kontrol edin.
• Dönüşümlerin Google Ads raporlamasında görünmesi için 24 saate kadar bekleyin.

SSS

S: Kaç tane webhook oluşturabilirim? C: Tüm planlarda tenant başına 20 webhook'a kadar.

S: Birden fazla Google hesabı bağlayabilir miyim? C: Şu anda entegrasyon türü başına (Calendar, Ads) bir Google hesabı desteklenmektedir. Çoklu hesap desteği planlanmaktadır.

S: Zapier'e gönderilen veriler şifreli mi? C: Evet. Tüm API iletişimi HTTPS/TLS şifrelemesi kullanır. API anahtarınız bağlantının kimlik doğrulamasını sağlar.

S: Zapier tarafından kullanılan bir API anahtarını iptal edersem ne olur? C: Zap bir sonraki tetiklemede başarısız olur. Zap'ı yeni bir API anahtarıyla güncellemeniz gerekecektir.

S: Webhook'un hangi olayları alacağını filtreleyebilir miyim? C: Evet. Webhook oluşturur veya düzenlerken tam olarak hangi olayların tetikleyeceğini seçersiniz. Seçilmeyen olaylar gönderilmez.

S: Entegrasyonlar API hız sınırımı tüketir mi? C: DOLU.ai'den gelen Zapier ve webhook teslimatları gelen hız sınırınıza sayılmaz. Yalnızca API anahtarı kullanarak DOLU.ai API'sine yaptığınız istekler sayılır.