Dokumentasi

Selamat datang di KonekSip. Panduan menghubungkan setiap channel langkah demi langkah, dan mengirim pesan pertama Anda.

Hubungkan channel

Pilih channel yang ingin Anda hubungkan. Setiap panduan lengkap berdiri sendiri, dari yang dibutuhkan di awal sampai mengatasi masalah umum.

Membangun integrasi sendiri? Referensi API mencantumkan semua endpoint, payload webhook, dan kode error.

Mulai Cepat

Mulai kirim pesan WhatsApp pertama Anda dalam hitungan menit.

curl -X POST https://koneksip.com/api/messages \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "type": "text",
    "receiver": "628123456789",
    "message": "Hello from KonekSip!"
  }'

Selanjutnya, lihat Referensi API untuk semua endpoint, payload webhook, dan kode error.

Workflow

Workflow menghubungkan sebuah pemicu dengan rangkaian langkah di kanvas, sehingga satu tugas berjalan sendiri: menjawab kata kunci, bertanya lalu menyimpan jawaban, memanggil sistem lain, atau menindaklanjuti setelah chat ditutup. Owner dan admin membuatnya di AI & Otomasi, lalu Workflow.

Membuat workflow

1. Tekan Tambah Workflow, beri nama, lalu mulai dari templat atau pilih pemicu.
2. Tambah langkah dari pustaka, atau tekan + di samping konektor yang masih terbuka. Kondisi punya konektor Benar dan Salah. Hubungkan langkah dengan menarik dari konektor ke langkah, atau lewat daftar Koneksi di panel samping.
3. Isi setiap langkah. Kolom yang kurang atau tidak valid ditandai merah. Tulis variabel seperti {{ $trigger.body }} atau pilih dari Sisipkan variabel.
4. Tekan Uji Coba untuk menjalankan alur dengan contoh pesan. Tidak ada yang dikirim, dipanggil, atau diubah, dan hasilnya digambar di kanvas.
5. Pilih channel, nyalakan saklar Aktif, lalu tekan Simpan Perubahan. Workflow hanya berjalan selama aktif dan sudah tersimpan.

Pemicu

• Pesan Masuk: pesan pelanggan yang mengandung atau sama dengan sebuah kata kunci (kata kunci kosong cocok dengan semua pesan). Pesan yang cocok ditangani workflow dan tidak diteruskan ke balasan otomatis maupun AI, kecuali Anda memilih Teruskan ke balasan otomatis dan AI dan workflow tidak mengirim balasan. Secara bawaan, percakapan yang dipegang agen tidak diganggu.
• Cron Terjadwal: berjalan sesuai jadwal pada zona waktu yang Anda pilih. Butuh channel dan nomor penerima di langkahnya.
• Webhook Masuk: sistem lain mengirim permintaan POST berisi JSON ke URL pribadi yang tampil di langkah ini. Siapa pun yang punya URL dapat menjalankan workflow, jadi rahasiakan. Perbarui URL menggantinya.
• Percakapan Ditugaskan dan Percakapan Ditutup: berjalan saat percakapan ditugaskan atau diselesaikan.

Langkah

• Kondisi, Jeda (hingga 7 hari, diperiksa kira-kira setiap 30 detik), Tunggu Balasan Pengguna (menyimpan balasan berikutnya ke variabel, dan berhenti menunggu setelah menit yang Anda atur), Atur Variabel, dan JSON / Transformasi.
• Kirim Pesan, Balas dengan Kutipan, Notifikasi Admin, dan Perbarui Kontak.
• Permintaan HTTP: hanya memanggil alamat publik. Responsnya disimpan sebagai variabel seperti {{ $vars.http.body }}.

Batasan dan hal yang perlu diketahui

• Pesan dari workflow dihitung seperti pesan lain. Pada nomor yang dikelola KonekSip, biayanya dipotong dari dompet, dan pesan di luar jendela 24 jam mengikuti aturan WhatsApp. Pesan yang gagal terkirim dicatat sebagai langkah gagal.
• Satu run berhenti setelah 50 langkah berturut-turut atau 100 langkah total, dan satu organisasi memulai paling banyak 60 run per menit. Satu kontak tidak bisa memulai workflow yang sama lagi selama jeda ulangnya.
• Pesan yang tidak menjawab pelanggan (jadwal, webhook) tidak dikirim ke kontak yang berhenti berlangganan dari kampanye.
• Buka Eksekusi untuk melihat setiap run, langkah demi langkah, beserta error langkah yang gagal. Run disimpan sesuai masa riwayat paket Anda.

Dompet dan AI

Dompet prabayar membayar apa yang ditagih sesuai pemakaian: pesan di nomor WhatsApp yang dikelola KonekSip, dan AI. Owner dan admin yang mengelolanya.

Isi saldo dompet

1. Buka Tagihan & Langganan, lalu Dompet.
2. Pilih jumlah, mulai Rp 20.000, dan bayar dengan QRIS. Saldo bertambah begitu pembayaran dikonfirmasi.
3. Riwayat top up menampilkan setiap percobaan beserta statusnya. Tekan Bayar sekarang untuk membuka kode QR yang belum kedaluwarsa, dan Kuitansi untuk mengunduh PDF dari isi saldo yang sudah dibayar.

Balasan AI

1. Buka Balasan Otomatis AI di menu dan pilih channel. Anda tidak perlu akun AI atau API key.
2. Tulis instruksi tentang bisnis Anda, pilih berapa pesan sebelumnya yang dibaca AI, lalu aktifkan.
3. Centang Alihkan ke anggota tim saat AI tidak bisa menjawab supaya AI berhenti saat ragu: chat menjadi Tertunda, pesan Anda dikirim, dan AI diam sampai chat diselesaikan.
4. Halaman menampilkan harga per 1.000 token dan token yang terpakai bulan ini. Saat saldo dompet terlalu rendah, AI berhenti dan halaman meminta Anda mengisi saldo. Saldo tidak pernah menjadi minus.

Ringkas percakapan

Buka percakapan dan tekan tombol berkilau di headernya. Sebuah jendela menampilkan topik dan paling banyak lima poin, dengan tombol Salin, dan menyebutkan berapa pesan yang dipakai (100 pesan teks terakhir). Siapa pun yang bisa melihat percakapan itu dapat memakainya. Ringkasan dibayar dari dompet, dan meminta lagi saat tidak ada yang baru menampilkan ringkasan yang sama tanpa biaya.