Otopilot
Modüller

CRM Entegrasyonu

Hazırlayan Son güncelleme:

Bu Sayfa Ne Yapar

Entegrasyonlar ekranı, sitenizdeki form, sohbet, randevu, sosyal medya ve Google yorumları modüllerinin verisini kendi CRM'inize ya da Zapier ve Make gibi otomasyon araçlarına iki yoldan aktarır: izinleri sizin belirlediğiniz bir API anahtarıyla veri okuma ve yazma, ve bir olay olduğu anda imzalı JSON gönderen olay adresleri (webhook).

Modüllerin içinde biriken müşteri verisi satış ekibinin kullandığı sisteme ulaşmazsa elle kopyalanır ve kayıplar başlar. Ekranın solunda bölüm menüsü, sağında beş kart vardır: Otopilot API erişimi anahtarı ve API adresini; Anahtarın izinleri modül bazlı okuma/yazma izinlerini; Olay adresleri (webhook) bildirim gönderilecek adresleri ve gönderim kayıtlarını; API kullanımı istek sayısını, hata oranını ve istek gelen IP'leri; IP izin listesi anahtarı yalnız belirli sunuculara kısıtlamayı gösterir. Menünün altında API dokümanı bağlantısı yer alır.

API anahtarı bu sitenin SEO düzeltme entegrasyonunda kullanılan anahtarla aynıdır; yeniden üretirseniz iki entegrasyonda da yeni anahtarı girmeniz gerekir. Anahtar yalnız işaretlediğiniz izinlerle çalışır; sitede açık olmayan modülün izni ve olayı seçilemez. Olay gönderimleri cevap alınamazsa artan aralıkla 8 kez denenir, gönderim kayıtları 30 gün saklanır; art arda 50 gönderim başarısız olursa adres kendiliğinden kapatılır ve size bildirim gelir. Bir projede en fazla 5 olay adresi tanımlanır. API kullanım kayıtları 90 gün tutulur.

Ekran; kendi CRM'i (HubSpot, Pipedrive, Salesforce ya da şirket içi sistem) olan işletmeler, Zapier/Make ile otomasyon kuran ajanslar ve panel verisini kendi uygulamasına bağlayan geliştiriciler içindir. Sonuçta yeni bir form kaydı, sohbetten müşteri adayı, randevu ya da Google yorumu saniyeler içinde kendi sisteminize düşer.

Sık yanlış anlamalar: kendi CRM'iniz yoksa bu ekrana ihtiyacınız olmayabilir; Satış ve Müşteri Takibi modülü aynı kaynaklardan kişileri kendiliğinden toplar. Anahtar tarayıcı koduna konmamalıdır; istekler yalnız sunucunuzdan yapılır.

Anlatılan sayfayı panelde aç(giriş yapınca açılır)

Ön Koşullar

  • Projede entegrasyona bağlanabilecek en az bir modül açık olmalıdır: Form Oluşturucu, Web Sitesi Sohbet Asistanı, Online Randevu, sosyal medya mesaj/yorum kutusu ya da Google Yorumları.
  • API anahtarını, izinleri, IP listesini ve olay adreslerini yalnız proje sahibi yönetir; ekip üyeleri ekranı salt okunur görür.
  • Olay adresi herkese açık bir https adresi olmalıdır; iç ağ adresleri, kullanıcı adı/parola içeren adresler ve yönlendirme yapan adresler kabul edilmez.
  • Gelen bildirimleri doğrulamak için alıcı sunucunuzda HMAC-SHA256 imza doğrulaması yapabilmeniz gerekir.

Adım Adım Kullanım

  1. Sol menüde Modüller → Entegrasyonlar'ı açın ya da bir modül ekranındaki CRM Entegrasyonu sekmesinden Entegrasyonlara git'e basın; ikinci yolda ekran ilgili modül seçili olarak açılır.
  2. Otopilot API erişimi kartında anahtar yoksa üretin; API anahtarı ve API adresi değerlerini kopyalayın. Anahtarı yalnız sunucunuzda, ortam değişkeni gibi güvenli bir yerde saklayın.
  3. Anahtarın izinleri kartında yalnız gereken izinleri işaretleyin: konuşmalar için Konuşmaları okuma ve Konuşmalara cevap yazma, devralma, kapatma, formlar için Form kayıtlarını okuma ve Kayıt durumunu değiştirme (okundu, arşiv, spam), randevular için Hizmetleri, boş saatleri ve randevuları okuma ile Randevu açma, onaylama, iptal etme, yorumlar için Google yorumlarını okuma.
  4. İsteklerinizi sunucunuzdan, her istekte anahtarı X-SP-Auth başlığında göndererek yapın. Uç noktalar ve örnek gövdeler için menünün altındaki API dokümanı bağlantısını açın.
  5. Olay adresleri (webhook) kartında Adres ekle'ye basın; Adres alanına CRM'inizin ya da Zapier/Make senaryonuzun webhook adresini yazın ve Gönderilecek olaylar listesinden ihtiyacınız olanları seçin (ör. form.submission.created, chat.lead.captured, booking.appointment.created, review.created).
  6. Kaydettikten sonra gösterilen İmza anahtarını hemen kopyalayıp güvenli bir yere kaydedin; yalnız bir kez gösterilir. Anahtarı kaybederseniz adresi düzenlerken yeni imza anahtarı üretme seçeneğini işaretleyin; eski anahtar hemen geçersiz olur.
  7. Satırdaki Deneme gönder: Gönder düğmesine basın; adrese bir deneme olayı gider ve sonuç "Deneme gönderildi (HTTP 200)" ya da hata nedeniyle bildirim olarak görünür. Deneme olayları gövdede gerçek bir olay olmadığını belirten bir notla gelir. Düğme yalnız açık adreslerde görünür.
  8. Gönderim kaydını göster ile her gönderimin durumunu (Teslim edildi, Bekliyor, Teslim edilemedi, Vazgeçildi), deneme sayısını ve gövdesini inceleyin; düzelttikten sonra başarısız gönderimi Yeniden gönder ile tekrar yollayın.
  9. API kullanımı kartında 7, 30 ya da 90 günlük aralık seçip İstek, Hatalı yanıt, IP listesi reddi ve Farklı IP sayılarını, uç nokta ve IP kırılımlarını izleyin.
  10. IP izin listesi kartında sunucu adresinizi (tek IP ya da CIDR) ekleyin; kullanım listesindeki bir adresi Listeye ekle ile tek tıkla da ekleyebilirsiniz. Liste hazır olunca Yalnız listedeki adreslere izin ver anahtarını açın; onay penceresi son günlerde listede olmayan adreslerden kaç istek geldiğini gösterir.

İmzayı doğrulama (Node.js)

code
const crypto = require('crypto')

function verify(rawBody, header, secret) {
  const parts = Object.fromEntries(header.split(',').map((p) => p.split('=')))
  if (Math.abs(Date.now() / 1000 - Number(parts.t)) > 300) return false
  const expected = crypto.createHmac('sha256', secret).update(parts.t + '.' + rawBody).digest('hex')
  const a = Buffer.from(expected)
  const b = Buffer.from(parts.v1 || "")
  return a.length === b.length && crypto.timingSafeEqual(a, b)
}

Örnek istek ve yanıt başlıkları

code
curl https://PANEL_ADRESI/api/integrations/v1/me \
  -H "X-SP-Auth: $SP_API_KEY"

X-SP-Signature: t=1790000000,v1=5257a869e7ecebeda32affa62cdca3fa51cad7e77a0e56ff536d0ce8e108d8bd
X-SP-Event: fix.ready
X-SP-Event-Id: evt_9f2c1a7b3d5e8a4c01
X-SP-Delivery: clx8k2m0a0001

Ekrandaki öğeler

  • Bölüm menüsü — kartlara atlayan bağlantılar ve en altta API dokümanı.
  • Otopilot API erişimi — API anahtarı, API adresi, API sürümü; anahtar yoksa "Bu proje için henüz API anahtarı üretilmedi." yazar.
  • Anahtarın izinleri — Konuşmalar (Web Sitesi Sohbet Asistanı + sosyal mesajlar), Form Oluşturucu, Online Randevu, Google Yorumları grupları; kapalı modülde (modül kapalı) ve Modülü al.
  • Olay adresleri (webhook) — adres satırları, Açık/Kapalı durumu, "4 olay" gibi olay sayısı, son gönderim sonucu; Adres ekle, Düzenle, Sil, Deneme gönder: Gönder, Gönderim kaydını göster/Gönderim kaydını gizle.
  • Gönderim kaydı — Teslim edildi, Bekliyor, Teslim edilemedi, Vazgeçildi durumları, deneme sayısı, Sonraki deneme, Gövde ve Yeniden gönder.
  • API kullanımı — 7 gün, 30 gün, 90 gün aralıkları; İstek, Hatalı yanıt, IP listesi reddi, Farklı IP kartları, Günlük istek grafiği, Uç noktaları ve İsteğin geldiği IP adresleri tabloları.
  • Kullanım alanları — SEO düzeltmeleri, Yapay zekâ asistanı (MCP), Hesap bilgisi, Modül uçları.
  • IP izin listesi — adres ekleme alanı, Ekle, Çıkar, Listede/Listede değil etiketleri ve Yalnız listedeki adreslere izin ver anahtarı.

Sonuçları nasıl yorumlarsınız

  • Bir olay adresinin satırında "Son gönderim başarılı" yazıyorsa bağlantı sağlıklıdır; "Son gönderim başarısız" görüyorsanız gönderim kaydında hata nedenini okuyun. Bekliyor durumundaki gönderimler yeniden denenecektir, Vazgeçildi ise 8 denemenin tükendiği anlamına gelir.
  • Hatalı yanıt oranı 4xx/5xx ile biten istekleri sayar: eksik izin, geçersiz kayıt kimliği ya da sunucu hatası. Oran yükseliyorsa Uç noktaları tablosunda hangi ucun hata verdiğine bakın; çoğu zaman eksik bir izin işaretlenmemiştir.
  • IP listesi reddi yalnız kısıt açıkken ölçülür; sıfırdan büyükse ya sunucunuzun adresi değişmiştir ya da anahtar başka bir yerden kullanılıyordur. İkinci durumda anahtarı yeniden üretin.
  • Farklı IP sayısı beklediğinizden fazlaysa anahtarın sızmış olabileceğini düşünün ve IP kısıtını açın.

Örnek senaryo

örnek.com bir dil kursu olsun ve satış ekibi Pipedrive kullanıyor olsun. Kurs sitesinde Form Oluşturucu ve Web Sitesi Sohbet Asistanı açık. Proje sahibi Entegrasyonlar ekranında anahtar üretiyor, yalnız Form kayıtlarını okuma ve Konuşmaları okuma izinlerini işaretliyor. Ardından Make'te bir senaryo kurup senaryonun webhook adresini Adres ekle ile giriyor ve form.submission.created ile chat.lead.captured olaylarını seçiyor; gösterilen imza anahtarını Make senaryosundaki doğrulama adımına yapıştırıyor.

Deneme gönder: Gönder ile deneme olayı yollanıyor, sonuç "Deneme gönderildi (HTTP 200)" çıkıyor ve Make senaryosunun geçmişinde deneme olayının ulaştığı görülüyor. Make sunucularının IP aralığı IP izin listesi'ne ekleniyor; kısıt açılmadan önce onay penceresi son günlerde listede olmayan adresten istek gelmediğini doğruluyor.

Sonraki günlerde her yeni form kaydı ve sohbette bilgisini bırakan her ziyaretçi Pipedrive'a saniyeler içinde düşüyor. Bir gece Make tarafındaki kesinti nedeniyle gönderimler Bekliyor durumunda birikiyor; servis düzelince yeniden denemeler kendiliğinden teslim ediliyor ve gönderim kaydında Teslim edildi görünüyor.

İpuçları

  • Her entegrasyon için yalnız gereken izni verin; okuma yetmiyorsa yazma iznini sonradan ekleyin.
  • Webhook alıcınızda X-SP-Event-Id değerini saklayın; yeniden denemelerde aynı olay ikinci kez gelebilir, kimlikle tekrarları ayıklarsınız.
  • İmza doğrulamasında zaman damgasını da kontrol edin; örnek koddaki 300 saniyelik pencere eski isteklerin yeniden oynatılmasını engeller.
  • IP kısıtını açmadan önce API kullanımı kartında son günlerin IP listesini inceleyin; bilmediğiniz bir adres varsa önce onu araştırın.
  • API anahtarını yeniden üretmeden önce SEO düzeltme entegrasyonunda da aynı anahtarın kullanıldığını unutmayın; iki tarafı birlikte güncelleyin.
  • Zapier ve Make senaryolarında başarısız adımları izleyin; panel tarafı yalnız teslimi görür, alıcıdaki iş akışı hatalarını göremez.

Sık yapılan hatalar

  • API anahtarını sitenin JavaScript koduna koymak; anahtar herkese açık hâle gelir.
  • İmza anahtarını kopyalamadan pencereyi kapatmak; anahtar bir daha gösterilmez.
  • Webhook alıcısında uzun işlemi yanıt dönmeden yapmak; 10 saniyelik süre aşılır ve gönderim başarısız sayılır.
  • IP kısıtını liste boşken ya da eksikken açmak; tüm istekler reddedilir.

Sık Karşılaşılan Sorunlar

  • Bu sitede entegrasyona bağlanabilecek açık bir modül yok (Form Oluşturucu, Web Sitesi Sohbet Asistanı, Online Randevu, sosyal medya mesaj/yorum kutusu, Google Yorumları).: Seçili projede bu modüllerin hiçbiri açık değildir. Modül mağazası düğmesiyle modülü bu site için açın; doğru projenin seçili olduğunu sol menünün üstündeki proje seçiciden kontrol edin.
  • İzin ya da olay yanında (modül kapalı) yazıyor: İlgili modül bu sitede açık değildir. Yanındaki Modülü al bağlantısıyla modülü satın alın; modül açıldığında izin ve olay seçilebilir hâle gelir.
  • Yanıt 10 saniyede gelmedi: Alıcı sunucunuz isteği 10 saniye içinde yanıtlamadı. Webhook'u alır almaz 2xx dönüp asıl işlemi arka planda yapın; gönderim artan aralıkla yeniden denenir.
  • Adres iç ağa çözümlendiği için gönderilmedi: Adres özel ya da yerel bir IP'ye çözümleniyor. Herkese açık bir alan adı kullanın; iç ağdaki bir sistemi bağlamak için önüne herkese açık bir ara sunucu koyun.
  • Gönderimler başarısız olduğu için kapatıldı: Art arda başarısız gönderim sınırı aşıldığı için adres kapatıldı ve size bildirim geldi. Alıcı tarafı düzeltin, adresi Düzenle ile yeniden açın ve gerekirse kayıtlardaki gönderimleri Yeniden gönder ile yollayın.
  • İstekler reddediliyor, IP listesi reddi sayacı artıyor: IP kısıtı açıkken listede olmayan bir adresten istek geliyor. İsteğin geldiği IP adresleri listesinde sunucunuzun adresini bulup Listeye ekle'ye basın; sunucunuz değiştiyse eski adresi çıkarın.
  • En çok 5 adres eklenebilir.: Bir projede en fazla beş olay adresi tanımlanabilir. Kullanılmayan adresi silin ya da birden çok olayı tek adrese yönlendirip alıcı tarafta olay türüne göre ayırın.

İlgili Kılavuzlar

Bu adımları kendi sitenizde uygulayın

Önce ücretsiz site analiziyle sitenizdeki sorunları görün. Hesabınız varsa rehberde anlatılan sayfayı panelde açın.

Tüm rehberler