Entegrasyonlar

Google E-Tablolar'dan Kommo'ya aktar

Widget, verileri Google E-Tablolar'dan Kommo'ya otomatik olarak yüklemenize ve güncel tutmanıza olanak tanır. Yeni kişiler, şirketler ve fırsatlar oluşturun. Apps Komut Dosyası tetikleyicisi ayarlanırken, değişiklikler tablo değişikliklerinden sonraki bir dakika içinde içe aktarılır.

Ozellikler

Verileri Google E-Tablolar'dan otomatik olarak indir

Kişiler, şirketler ve fırsatlar oluşturun

Tablo değişikliğinden sonra bir dakika içinde içe aktarın (Apps Komut Dosyası aracılığıyla)

Yedekleme periyodik senkronizasyon modu (her 10 dakikada bir)

Esnek yinelenen işleme senaryoları

İçe aktarma için çalışma saatlerini ayarlama

Fırsatlar için otomatik etiketler

Yükleme widget'ıyla iki yönlü senkronizasyon

Kolay tablo formatı özelleştirmesi

Kurulum ve ayar kilavuzu

Widget ile calismak icin ayrintili kilavuz "Google E-Tablolar'dan Kommo'ya aktar"

ICINDEKILER

Temel ayarlar
İşleme süreleri
İçe aktarma için bir tablo ayarlama
Anında İçe Aktarma için Apps Komut Dosyasını Ayarlama
"Google E-Tabloya Yükle" widget'ıyla ortak çalışma yapın
İçe aktarmayı ayarlama (son adım)
Veri aktarım bilgileri

Temel ayarlar

Widget'ı yükledikten sonra Ayarlar'a gidin ve +Ekle düğmesini tıklayın.

Ardından içe aktarma parametrelerini yapılandırın:
Tablo bağlantısı — Google Sheet bağlantınızı yapıştırın.
Satış Takip Hattı ve aşama — müşterilerin içe aktarılacağı Satış Takip Hattı ve aşamayı seçin.
Çalışma saatleri — içe aktarma için zaman aralığını belirtin.
Müşteri etiketi — içe aktarma sırasında müşterilere otomatik olarak eklenecek etiketi girin.

Zaman ayarları örneği: İçe aktarmayı 23:00 ile 10:00 arasında yapılandırmanız gerekiyorsa iki aralık ekleyin:
23:00–23:59
00:00–10:00

İçe aktarma için başka bir tablo eklemeniz gerekiyorsa +Ekle'yi tıklayın ve tabloyu aynı prensibe göre yapılandırın.
Tüm tablolar aynı anda dikkate alınacaktır.

Ayarları tamamladıktan sonra Kaydet'i tıklayın.

İşleme süreleri

Alımlar için komut dosyası işlevi ayarlarda mevcuttur:

Satış Takip Hattı ve başlık eşleşirse (varsayılan) - Satış Takip Hattı (aşama önemli değil) ve müşteri adı eşleşirse müşteri güncellenir.
Bir Satış Takip Hattı eşleştiğinde - Müşteri, yalnızca Satış Takip Hattı eşleştiğinde güncellenir.
Her zaman yeni oluştur - her içe aktarma yeni bir müşteri oluşturur. Bu senaryoyu seçerken tablodaki Hash ve müşteri kimliğini silmelisiniz.
Herhangi bir müşteri bulundu - Kişinin veya şirketin zaten en az bir müşterisi varsa müşteri güncellenir.

İçe aktarma için bir tablo ayarlama

Önemli: tablo erişim ayarlarında “Bağlantıya sahip olan herkes düzenleyebilir” seçeneğini belirtin veya şu e-postaya erişim verin: [email protected]

Tablonun ilk satırında sütunların adları belirtilir
Biçim: Varlık.Alan adı (örneğin: Müşteri.Adı, İlgili Kişi.Telefon)
Daha fazla ayrıntı için bağlantıya bakın.

Anında İçe Aktarma için Apps Komut Dosyasını Ayarlama

Bir tabloyu değiştirdiğinizde verileri otomatik olarak içe aktarmak için Google E-Tablonuza özel bir Apps Komut Dosyası yüklemeniz gerekir. Bu, değişikliklerin hızlı bir şekilde (bir dakika içinde) işlenmesini sağlayacaktır. Kurulum yalnızca 2 dakika sürer; kodu yapıştırın ve bir işlevi çalıştırın!

⚡ Apps Komut Dosyası olmadan içe aktarma, periyodik kontrol modunda (10 dakikada bir) çalışır ve bu, veri senkronizasyonunu önemli ölçüde yavaşlatır.

Tetikleyici oluşturmanın avantajları:

⚡ Hızlı işleme – değişiklikler bir dakika içinde içe aktarılır
🔄 Otomasyon – periyodik senkronizasyonu beklemeye gerek yok
💪 Veri alaka düzeyi – Kommo'deki bilgiler her zaman tabloya karşılık gelir

💡Hesap Kimliğini nerede bulabilirim? Kommo'de sol üstteki avatarınızı → Müşteri numaranız'ı tıklayın. Bu sizin account_id'nizdir.

Adım adım talimatlar:

Google E-Tablonuzu açın
Menüden şunu seçin: Uzantılar → Apps Komut Dosyası
Aşağıdaki kodu kopyalayıp düzenleyicinize yapıştırın (mevcut tüm kodların yerine)
setup işlevini çalıştırın (açılır listeden seçim yapın ve ▶️ tuşuna basın)
Görüntülenen pencerede tablo sayfasına dönün (sonraki sekmede bulunur), account_id'nizi girin (Kommo'de: sol üstteki avatara tıklayın → Müşteri numaranız)
Hazır! Artık tablodaki değişiklikler otomatik olarak içe aktarılacak

// 🚀 İlk kurulum işlevi — bir kez çalıştırın!
function setup() {
  var ui = SpreadsheetApp.getUi();
  
  // Kullanıcıdan account_id iste
  var response = ui.prompt(
    '⚙️ Otomatik içe aktarma kurulumu',
    'Account ID girin (amoCRM: sol üstteki avatar → Müşteri numaranız):',
    ui.ButtonSet.OK_CANCEL
  );
  
  if (response.getSelectedButton() !== ui.Button.OK) {
    ui.alert('❌ Kurulum iptal edildi');
    return;
  }
  
  var accountId = response.getResponseText().trim();
  if (!accountId) {
    ui.alert('❌ Account ID boş olamaz');
    return;
  }
  
  // account_id kaydet
  PropertiesService.getScriptProperties().setProperty('account_id', accountId);
  
  // Eski tetikleyicileri kaldır
  var triggers = ScriptApp.getProjectTriggers();
  for (var i = 0; i < triggers.length; i++) {
    if (triggers[i].getHandlerFunction() === 'onEdit') {
      ScriptApp.deleteTrigger(triggers[i]);
    }
  }
  
  // Yeni tetikleyici oluştur
  ScriptApp.newTrigger('onEdit')
    .forSpreadsheet(SpreadsheetApp.getActive())
    .onEdit()
    .create();
  
  ui.alert(
    '✅ Kurulum tamamlandı!',
    'Account ID: ' + accountId + '\n\n' +
    'Artık tablo değiştiğinde veriler bir dakika içinde amoCRM'e otomatik aktarılacak.',
    ui.ButtonSet.OK
  );
}

// Tablo saat dilimini veya hata durumunda UTC döndürür
function getSafeTimeZone() {
  try {
    var tz = SpreadsheetApp.getActiveSpreadsheet().getSpreadsheetTimeZone();
    return (tz && tz.trim()) ? tz : 'UTC';
  } catch(e) {
    return 'UTC';
  }
}

// ⚙️ Ayarlardan account_id al
function getAccountIdFromProperties() {
  return PropertiesService.getScriptProperties().getProperty('account_id');
}

// 🔄 Ana işlev — tablo düzenlendiğinde otomatik çalışır
function onEdit(e) {
  var accountId = getAccountIdFromProperties();
  
  if (!accountId) {
    Logger.log("❌ Account ID yapılandırılmadı. setup() çalıştırın");
    return;
  }
  
  var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  var activeSheet = e.source.getActiveSheet();
  var sheetId = activeSheet.getSheetId();
  var baseUrl = spreadsheet.getUrl();
  var fullUrl = baseUrl + "?gid=" + sheetId + "#gid=" + sheetId;
  
  var url = "https://qp1-nova.ru/api/events/gimport_market/" + accountId;
  var payload = {
    url: fullUrl,
    timestamp: (function() {
      var tz = getSafeTimeZone();
      var date = new Date();
      return new Date(Utilities.formatDate(date, tz, "yyyy/MM/dd HH:mm:ss")).getTime();
    })(),
    sheet_name: activeSheet.getName(),
    spreadsheet_id: spreadsheet.getId()
  };
  
  var options = {
    method: "post",
    contentType: "application/json",
    payload: JSON.stringify(payload),
    muteHttpExceptions: true
  };
  
  try {
    UrlFetchApp.fetch(url, options);
    Logger.log("✅ İçe aktarma başlatıldı, sayfa: " + activeSheet.getName());
  } catch (error) {
    Logger.log("❌ Gönderme hatası: " + error.toString());
  }
}

💡 Önemli: Apps Komut Dosyasının yüklenmesi, widget'ın tüm kullanıcıları için önerilir. Bu, Google Sheet ile Kommo arasında optimum veri senkronizasyon hızı sağlar. Kurulumla ilgili sorularınız varsa lütfen teknik destekle iletişime geçin.

"Google E-Tabloya Yükle" widget'ıyla ortak çalışma yapın

İki yönlü senkronizasyon için İçe Aktarma ve Dışa Aktarma widget’larını birlikte kullanın. Bu durumda tüm değişiklikler otomatik olarak senkronize edilir.

Kurulum:
1. Her iki widget’ı da hesaba yükleyin.
2. Dışa aktarma ve içe aktarma için tek bir ortak tablo oluşturun.

Kommo'de bir alan değiştirildi → tabloda güncellendi,
tablodaki bir alanı değiştirdi → Kommo'de güncellendi.

Bundan sonra, bir müşteri tetikleme aşamasına ulaştığında veriler tabloya yüklenir.

İçe aktarmayı ayarlama (son adım)

Widget ayarlarında aynı tabloya bir bağlantı ekleyin İçe Aktar.
Bir aşama seçin (herhangi biri - widget, aşamadan bağımsız olarak müşteriyi güncelleyecektir).

Tablodaki değişiklikler ve müşteri kayıtları artık otomatik olarak senkronize edilecek
Tabloya bağlandıktan sonra Karmayı Değiştir hizmet sütunu eklenecektir - senkronizasyonun doğruluğunu izlemek gerekir
Böylece Kommo ile Google E-Tablolar arasındaki müşteri kayıtlarının her iki yönde de tam senkronizasyonunu elde edersiniz.

Veri aktarım bilgileri

ℹ️Bu hizmetin sunucuları (Google E-Tablolar) Rusya Federasyonu dışında bulunmaktadır. Rusya Federasyonu vatandaşlarının kişisel verilerini işliyorsanız, sınır ötesi veri aktarımına ilişkin 152-FZ sayılı “Kişisel Verilere İlişkin” Federal Kanunun gerekliliklerine uygunluğunuzu sağlamanızı öneririz.