Diğer programları bağlayın: API, webhook'lar ve Slack veya Teams uyarıları

Ayarlar altındaki Entegrasyonlar'da Kaam360'ı başka programlara bağlayabilirsiniz. Bu, Business paketinin bir parçasıdır. Yalnızca yöneticiler açabilir.

Verilerinizi bir API anahtarıyla okuyun

1. Ayarlar'ı açın ve Entegrasyonlar'ı seçin.
2. API anahtarları altında bir Ad yazın (örneğin Zapier ya da Muhasebe tablosu) ve API anahtarı oluştur düğmesine basın.
3. Görünen anahtarı kopyalayın. Yalnızca bir kez gösterilir. Anahtara sahip olan herkes kuruluşunuzun tüm verilerini okuyabilir, bu yüzden gizli tutun.
4. Anahtarı programa verin. Program onu Authorization: Bearer ... başlığında gönderir. API'yi kullanma sayfası adresleri ve bir örneği gösterir.
5. Oluştururken Bu anahtarın potansiyel müşteri eklemesine izin ver kutusunu işaretlemediğiniz sürece bir anahtar yalnızca okuyabilir. İşaretlerseniz yeni potansiyel müşteriler de ekleyebilir (aşağıya bakın). Başka hiçbir şeyi asla değiştiremez ya da silemez. Bir anahtarı hemen durdurmak için İptal et düğmesine basın. Bir anahtar, onu oluşturan kişi Kullanıcılar altında devre dışı bırakıldığında da çalışmayı durdurur; başka bir yöneticinin hesabından yeni bir anahtar oluşturun.

Zapier ya da Make kullanın

Zapier ve Make, programları hiç kod yazmadan birbirine bağlayan hizmetlerdir. Bunlar için özel bir Kaam360 uygulamasına ihtiyacınız yoktur.

1. Yukarıdaki gibi bir API anahtarı oluşturun. Formların, reklamların ya da elektronik tabloların Kaam360'a potansiyel müşteri göndermesini istiyorsanız Bu anahtarın potansiyel müşteri eklemesine izin ver kutusunu işaretleyin.
2. Zapier'de ya da Make'te bir web adresini çağıran bir adım seçin (Zapier'de: Webhooks by Zapier; Make'te: HTTP). Anahtarınızla birlikte Authorization: Bearer ... başlığını kullanın.
3. Veri okumak için API'yi kullanma altında listelenen adresleri çağırın (örneğin /api/v1/leads ya da /api/v1/deals). Potansiyel müşteri eklemek için potansiyel müşterinin soyadı ya da e-postasıyla birlikte /api/v1/leads adresine bir POST gönderin.
4. API'yi kullanma sayfası, API'nin tamamının yazılı tanımı olan /api/v1/openapi.json dosyasına da bağlantı verir. Geliştiriciler ve araçlar bunu okuyabilir. Daha yeni API'yi (sürüm 2) de içeren tam geliştirici rehberi /developers adresindedir.
5. Bir şey olduğunda haber almak için webhook'lar altında Başka bir program (imzalı JSON) seçeneğini kullanın.

Slack ya da Microsoft Teams'te uyarı alın

1. Slack'te ya da Teams'te istediğiniz kanal için bir incoming webhook oluşturun ve web adresini kopyalayın.
2. Entegrasyonlar'da, Webhook'lar ve sohbet uyarıları altında bir Ad yazın, Bir Slack kanalı ya da Bir Microsoft Teams kanalı seçin ve Web adresi'ni yapıştırın.
3. Ne zaman haber verilsin altında neyi duymak istediğinizi işaretleyin. Her şeyden haberdar olmak için hiçbir şeyi işaretlemeyin.
4. Adres ekle'ye, ardından Test gönder'e basın. Kanalda kısa bir test mesajı görünmelidir.

Başka bir programa haber verin

1. Başka bir program (imzalı JSON) seçeneğini seçin ve web adresini yazın. Adres https:// ile başlamalı ve herkese açık internette olmalıdır.
2. Görünen imzalama gizli anahtarı'nı kopyalayın. Yalnızca bir kez gösterilir. Diğer program, bir mesajın gerçekten Kaam360'tan geldiğini kontrol etmek için bunu kullanır.
3. Her mesaj; bir kimlik, olay adı, kısa bir özet ve ana ayrıntıları içeren bir JSON'dur. Kaydın tamamını almak için API'yi kullanın.
4. Her mesaj imzalıdır: X-Kaam360-Signature başlığı, gönderilme zamanının (X-Kaam360-Timestamp) ve mesajın HMAC-SHA256 değerini taşır. Alıcı, kopyalanmış bir mesajın sonradan yeniden gönderilememesi için beş dakikadan eski bir mesajı reddetmelidir. Geliştirici rehberi, bu kontrol için hazır kod içerir.
5. Bir adresi, olaylarını ya da notunu değiştirmek için Düzenle'ye basın. Gizli anahtar sızmış olabilirse Yeni imzalama gizli anahtarı'na basın: eskisi hemen çalışmayı bırakır, bu yüzden yenisini hemen diğer programa verin.

Nelerden haberdar olabilirsiniz

Bir müşteri ya da potansiyel müşteri eklendi, bir fırsat kazanıldı ya da kaybedildi, bir proje oluşturuldu ya da değiştirildi, bir görev eklendi, değiştirildi ya da tamamlandı, bir fatura yazıldı, düzenlendi (gönderildi), ödendi ya da iptal edildi, bir proje ödemesi başka bir aşamaya geçti, bir sözleşme imzalandı ve bir destek talebi açıldı.

Teslimat kaydı

Teslimat kaydı, son iki haftadaki her mesajı listeler: ne zaman, hangi adrese gönderildiği, alıcının yanıtı (durum kodu ve ne kadar sürdüğü) ve sonuç.

1. Yalnızca onları görmek için bir adres, bir sonuç (Teslim edildi, Yeniden deneme bekleniyor, Bırakıldı) ya da bir olay seçin.
2. Mesajı ve alıcının yanıtının başını görmek için Gönderileni göster'e basın.
3. Teslim edilmiş ya da bırakılmış bir mesajı bir kez daha göndermek için Yeniden gönder'e basın. Aynı kimliği korur, böylece alıcı bunun bir tekrar olduğunu anlayabilir.

Bir sorun olursa

• Alıcı çalışmıyorsa Kaam360 1 dakika, 5 dakika, 30 dakika, 2 saat ve 12 saat sonra yeniden dener, ardından vazgeçer.
• Art arda 15 kez başarısız olan bir adres kapatılır ve entegrasyonları yönetebilen herkes bir e-posta alır. Sayfadaki kırmızı bir not bunun ne zaman olduğunu söyler. Sorunu düzeltin, Sürdür'e basın, ardından kaçırılan mesajları Teslimat kaydı'ndan yeniden gönderin.
• Özel bir ağın içindeki adreslere (localhost, 10.0.0.1 ya da 192.168.1.5 gibi) izin verilmez ve bu, her mesaj gönderildiğinde yeniden kontrol edilir.
• Entegrasyonlar'ı göremiyorsanız paketiniz bunu içermiyor olabilir ya da rolünüzün "Entegrasyonları yönet" yetkisi olmayabilir.