Hubungkan program lain: API, webhook, dan peringatan Slack atau Teams

Di Integrasi (di bawah Pengaturan) Anda dapat menghubungkan Kaam360 dengan program lain. Fitur ini bagian dari paket Business. Hanya administrator yang dapat membukanya.

Membaca data Anda dengan kunci API

1. Buka Pengaturan dan pilih Integrasi.
2. Di bawah Kunci API, ketik Nama (misalnya Zapier atau Lembar akuntansi) dan tekan Buat kunci API.
3. Salin kunci yang muncul. Kunci hanya ditampilkan sekali. Siapa pun yang memegang kunci dapat membaca semua data organisasi Anda, jadi rahasiakan.
4. Berikan kunci itu kepada program. Program mengirimkannya di header Authorization: Bearer .... Halaman Menggunakan API menampilkan alamat-alamatnya dan sebuah contoh.
5. Sebuah kunci hanya bisa membaca, kecuali Anda mencentang Izinkan kunci ini menambahkan prospek saat membuatnya. Dengan begitu kunci juga dapat menambahkan prospek baru (lihat di bawah). Kunci tidak pernah dapat mengubah atau menghapus hal lain. Tekan Cabut untuk langsung menghentikan sebuah kunci. Kunci juga berhenti bekerja saat orang yang membuatnya dinonaktifkan di Pengguna; buat kunci baru dari akun administrator lain.

Menggunakan Zapier atau Make

Zapier dan Make adalah layanan yang menghubungkan program-program tanpa perlu menulis kode. Anda tidak memerlukan aplikasi Kaam360 khusus untuk keduanya.

1. Buat kunci API seperti di atas. Centang Izinkan kunci ini menambahkan prospek jika Anda ingin formulir, iklan, atau spreadsheet mengirim prospek ke Kaam360.
2. Di Zapier atau Make, pilih langkah yang memanggil alamat web (di Zapier: Webhooks by Zapier; di Make: HTTP). Gunakan header Authorization: Bearer ... dengan kunci Anda.
3. Untuk membaca data, panggil alamat yang tercantum di Menggunakan API (misalnya /api/v1/leads atau /api/v1/deals). Untuk menambahkan prospek, kirim POST ke /api/v1/leads dengan nama belakang atau email prospek.
4. Halaman Menggunakan API juga menautkan ke /api/v1/openapi.json, yaitu uraian lengkap API secara tertulis. Pengembang dan alat dapat membacanya. Panduan pengembang lengkap, dengan API yang lebih baru (versi 2), ada di /developers.
5. Untuk diberi tahu saat sesuatu terjadi, gunakan Program lain (JSON bertanda tangan) di bawah webhook.

Mendapat peringatan di Slack atau Microsoft Teams

1. Di Slack atau Teams, buat incoming webhook untuk saluran yang Anda inginkan dan salin alamat webnya.
2. Di Integrasi, di bawah Webhook dan peringatan obrolan, ketik Nama, pilih Saluran Slack atau Saluran Microsoft Teams, lalu tempel Alamat web.
3. Di bawah Beri tahu saat, centang apa yang ingin Anda ketahui. Jangan centang apa pun untuk mendapat kabar tentang semuanya.
4. Tekan Tambah alamat, lalu Kirim uji. Pesan uji singkat seharusnya muncul di saluran.

Memberi tahu program lain

1. Pilih Program lain (JSON bertanda tangan) dan ketik alamat webnya. Alamat harus diawali https:// dan berada di internet publik.
2. Salin rahasia penandatanganan yang muncul. Rahasia ini hanya ditampilkan sekali. Program lain memakainya untuk memeriksa bahwa sebuah pesan benar-benar berasal dari Kaam360.
3. Setiap pesan berupa JSON dengan id, nama peristiwa, ringkasan singkat, dan detail utama. Gunakan API untuk mengambil catatan lengkapnya.
4. Setiap pesan ditandatangani: header X-Kaam360-Signature berisi HMAC-SHA256 dari waktu pengiriman (X-Kaam360-Timestamp) dan pesannya. Penerima sebaiknya menolak pesan yang lebih tua dari lima menit, agar pesan yang disalin tidak dapat dikirim ulang nanti. Panduan pengembang punya kode siap pakai untuk pemeriksaan ini.
5. Untuk mengubah alamat, peristiwanya, atau catatannya, tekan Ubah. Jika rahasia mungkin bocor, tekan Rahasia penandatanganan baru: yang lama langsung berhenti berlaku, jadi segera berikan yang baru kepada program lain.

Apa saja yang bisa diberitahukan

Pelanggan atau prospek ditambahkan, peluang dimenangkan atau kalah, proyek dibuat atau diubah, tugas ditambahkan, diubah, atau diselesaikan, faktur dibuat, diterbitkan (dikirim), dibayar, atau dibatalkan, pembayaran proyek pindah ke tahap lain, kontrak ditandatangani, dan tiket dukungan dibuka.

Log pengiriman

Log pengiriman mencantumkan setiap pesan dalam dua minggu terakhir: kapan dikirim, ke alamat mana, jawaban penerima (kode status dan berapa lama waktunya), dan hasilnya.

1. Pilih alamat, hasil (Terkirim, Menunggu dicoba lagi, Dihentikan), atau peristiwa untuk melihat itu saja.
2. Tekan Tampilkan yang dikirim untuk melihat pesan dan awal jawaban penerima.
3. Tekan Kirim lagi untuk mengirim sekali lagi pesan yang sudah terkirim atau dihentikan. Pesan tetap memakai id yang sama, sehingga penerima tahu bahwa itu pengulangan.

Jika terjadi masalah

• Jika penerima sedang mati, Kaam360 mencoba lagi setelah 1 menit, 5 menit, 30 menit, 2 jam, dan 12 jam, lalu berhenti.
• Alamat yang gagal 15 kali berturut-turut dinonaktifkan, dan semua orang yang boleh mengelola integrasi menerima email. Catatan merah di halaman menyebutkan kapan itu terjadi. Perbaiki masalahnya, tekan Lanjutkan, lalu kirim lagi pesan yang terlewat dari Log pengiriman.
• Alamat di dalam jaringan privat (seperti localhost, 10.0.0.1, atau 192.168.1.5) tidak diizinkan, dan diperiksa lagi setiap kali pesan dikirim.
• Jika Anda tidak melihat Integrasi, mungkin paket Anda tidak mencakupnya, atau peran Anda tidak punya hak "Kelola integrasi".