Endpoint Utama
Ringkasan
Section titled “Ringkasan”Endpoint Utama adalah daftar fungsi API yang paling sering digunakan untuk menghubungkan TENTA dengan sistem lain.
Melalui endpoint, sistem eksternal dapat melakukan aktivitas tertentu seperti mengirim pesan, mengambil data percakapan, melihat detail percakapan, mengecek saldo kredit, atau menerima event melalui webhook.
Endpoint biasanya digunakan oleh developer atau tim teknis saat membuat integrasi.
Kapan Digunakan
Section titled “Kapan Digunakan”Endpoint Utama digunakan ketika sistem eksternal perlu berinteraksi langsung dengan TENTA.
Gunakan endpoint untuk:
- Mengirim pesan dari sistem lain melalui TENTA.
- Mengambil daftar percakapan pelanggan.
- Melihat detail percakapan tertentu.
- Mengecek saldo kredit yang tersedia.
- Menerima notifikasi event melalui webhook.
Pastikan authentication sudah disiapkan sebelum menggunakan endpoint API.
Kirim Pesan
Section titled “Kirim Pesan”Endpoint kirim pesan digunakan untuk mengirim pesan dari sistem eksternal melalui TENTA.
Contoh kebutuhan:
- Mengirim pesan follow up otomatis.
- Mengirim notifikasi kepada customer.
- Mengirim informasi transaksi dari sistem internal.
- Mengirim pesan layanan dari aplikasi bisnis.
Sebelum mengirim pesan, pastikan data tujuan, isi pesan, dan channel pengiriman sudah benar.
Ambil Daftar Percakapan
Section titled “Ambil Daftar Percakapan”Endpoint ambil daftar percakapan digunakan untuk menampilkan daftar chat yang ada di TENTA.
Data ini dapat digunakan oleh sistem eksternal untuk membaca daftar percakapan yang masuk.
Contoh data yang biasanya dibutuhkan:
- Daftar percakapan terbaru.
- Status percakapan.
- Channel asal percakapan.
- Waktu pesan terakhir.
- Agent yang menangani jika tersedia.
Endpoint ini membantu sistem lain memantau aktivitas percakapan tanpa harus membuka dashboard TENTA secara manual.
Ambil Detail Percakapan
Section titled “Ambil Detail Percakapan”Endpoint ambil detail percakapan digunakan untuk melihat isi lengkap dari satu percakapan tertentu.
Endpoint ini berguna ketika sistem membutuhkan informasi lebih detail dari sebuah chat.
Contoh informasi yang dapat dilihat:
- Riwayat pesan.
- Identitas customer.
- Channel percakapan.
- Status chat.
- Agent yang menangani.
- Waktu percakapan.
Gunakan endpoint ini jika daftar percakapan saja belum cukup untuk memahami konteks chat.
Cek Saldo Kredit
Section titled “Cek Saldo Kredit”Endpoint cek saldo kredit digunakan untuk melihat jumlah kredit yang tersedia di akun TENTA.
Endpoint ini berguna jika sistem perlu memastikan bahwa kredit masih cukup sebelum menjalankan aktivitas tertentu.
Contoh kebutuhan:
- Mengecek saldo sebelum mengirim pesan.
- Memantau penggunaan kredit.
- Menampilkan saldo pada dashboard internal.
- Menghindari kegagalan pengiriman karena kredit tidak mencukupi.
Jika saldo rendah, sistem atau tim dapat melakukan pengecekan lebih lanjut sebelum melanjutkan pengiriman.
Webhook Event
Section titled “Webhook Event”Webhook event digunakan untuk mengirim notifikasi otomatis dari TENTA ke sistem lain saat ada aktivitas tertentu.
Contoh event:
- Pesan baru masuk.
- Customer membalas pesan.
- Status chat berubah.
- Campaign mendapatkan respon.
- Percakapan selesai.
Webhook membantu sistem eksternal menerima update tanpa harus terus-menerus mengecek data secara manual.
Contoh Penggunaan
Section titled “Contoh Penggunaan”Sebuah bisnis memiliki sistem internal untuk memantau customer.
Tim developer menggunakan endpoint TENTA untuk mengambil daftar percakapan dan detail chat pelanggan.
Saat ada pesan baru masuk, webhook mengirim notifikasi ke sistem internal. Jika perlu, sistem juga dapat mengirim pesan follow up melalui endpoint kirim pesan.
Dengan cara ini, TENTA dapat terhubung dengan alur kerja sistem internal bisnis.
Catatan Penting
Section titled “Catatan Penting”- Pastikan API token sudah benar sebelum menggunakan endpoint.
- Gunakan endpoint sesuai kebutuhan integrasi.
- Jangan mengambil data terlalu sering jika tidak diperlukan.
- Pastikan format request sesuai dengan dokumentasi API.
- Simpan log integrasi agar lebih mudah melakukan pengecekan jika terjadi kendala.
Kendala yang Sering Terjadi
Section titled “Kendala yang Sering Terjadi”Endpoint Tidak Merespon
Section titled “Endpoint Tidak Merespon”Cek koneksi sistem, URL endpoint, dan status layanan API.
Request Ditolak
Section titled “Request Ditolak”Periksa API token, izin akses, dan format request yang dikirim.
Data Tidak Sesuai
Section titled “Data Tidak Sesuai”Pastikan parameter yang dikirim sudah benar dan sesuai kebutuhan endpoint.
Terlalu Banyak Request
Section titled “Terlalu Banyak Request”Periksa penggunaan API agar tidak melewati batas rate limit.
Langkah Selanjutnya
Section titled “Langkah Selanjutnya”Setelah memahami Endpoint Utama, lanjutkan ke halaman berikutnya: