Bot yang menggunakan sistem dan dokumen Anda sendiri
Opsional: bot dapat mencari data (status faktur, pesanan) di sistem Anda dan mengirim dokumen seperti PDF faktur — inilah yang dibutuhkan OmniBrand dari Anda.
Ini adalah bagian opsional dari bot. Insinyur OmniBrand mengaturnya untuk Anda atas permintaan; tidak ada yang perlu dikonfigurasi di ruang kerja Anda.
Apa yang bisa dilakukan
- Kirim dokumen standar Anda: profil perusahaan, daftar harga, menu, brosur — file yang Anda simpan secara online. Anda memberikan nama dan tautan pada masing-masing dokumen; bot mengirimkan yang diminta pelanggan.
- Cari data di sistem Anda saat mengobrol: pelanggan memberikan, misalnya, faktur atau nomor pesanan, bot menanyakan sistem Anda, dan menjawab — "Faktur 204 sudah dibayar", "Pesanan Anda sedang dalam proses pengiriman".
- Kirim dokumen yang dihasilkan sistem Anda, seperti PDF faktur tersebut, menggunakan tautan yang dikembalikan sistem Anda.
- Kirim jawaban yang dikumpulkan ke sistem Anda, misalnya untuk membuat prospek di CRM Anda.
Dokumen tiba sebagai file di chat: di WhatsApp sebagai pesan dokumen, melalui email sebagai lampiran, dan di chat situs web sebagai file yang dapat dibuka pengunjung. Di thread inbox Anda, pesan bot menampilkan nama file dengan 📄.
Apa yang dibutuhkan OmniBrand dari Anda
Untuk dokumen standar:
- Nama setiap dokumen sebagaimana pelanggan akan memintanya, dan tautan ke file yang diawali
https://dan dapat diunduh tanpa masuk. Di WhatsApp, Instagram, dan Messenger, layanan pesan mengambil file dari tautan tersebut; untuk email dan chat situs web, OmniBrand mengunduhnya (maksimal 25 MB) dan mengirimkannya dari penyimpanannya sendiri.
Untuk mencari data di sistem Anda:
- alamat (URL) dari layanan dalam sistem Anda yang menjawab satu pertanyaan, dimulai dengan
https://— misalnyahttps://erp.example.com/api/invoices/{number}, dengan tempat di mana nilai pelanggan ditempatkan. - Apakah dipanggil dengan GET atau POST.
- credential: kunci API atau token, dan nama header tempat file tersebut dimasukkan (biasanya
Authorization). Kirimkan melalui channel yang diberikan dukungan, bukan dalam pesan publik. - Satu nilai uji yang ada dan satu yang tidak (misalnya nomor faktur asli dan nomor buatan), sehingga insinyur dapat menguji dengan data asli Anda sebelum diaktifkan.
- Deskripsi singkat tentang jawaban: kolom apa saja yang terkandung (misalnya
status,amount,pdf_url) dan kolom mana yang dapat diberitahukan bot kepada pelanggan. - Cara sistem Anda mengatakan "tidak ditemukan": harus menjawab dengan status HTTP 404. Kesalahan lain diperlakukan sebagai "sistem tidak tersedia".
- Apa yang harus diberikan pelanggan untuk membuktikan siapa mereka sebelum bot mengungkapkan data (misalnya nomor telepon pada faktur), sehingga bot memintanya.
Bagaimana data Anda dilindungi
- Hanya alamat https yang diterima.
- Kredensial Anda disimpan terenkripsi. Setelah disimpan, staf OmniBrand hanya melihat empat karakter terakhirnya; hanya ditambahkan ke permintaan ke sistem Anda dan tidak pernah ditampilkan kepada pelanggan.
- Nilai yang diketik pelanggan dikodekan dengan aman ke dalam alamat; dengan POST dikirimkan sebagai JSON.
- Server OmniBrand menolak memanggil alamat jaringan internal atau privat, dan memeriksa ulang setiap pengalihan. Jika sistem Anda mengalihkan ke alamat lain, kredensial Anda tidak dikirim ke sana.
- Setiap panggilan menunggu paling lama 10 detik dan membaca paling banyak 256 KB dari jawaban.
- Setiap perubahan pada koneksi ini dan setiap pengujian dicatat dengan nama insinyur yang melakukannya.
Jika sistem Anda tidak menjawab
Jika sistem Anda sedang mati, lambat, menjawab "tidak ditemukan", atau mengembalikan kesalahan, bot mengikuti jalur yang dirancang untuk kasus tersebut — misalnya "Kami tidak dapat menemukan faktur tersebut" — atau menyerahkan percakapan ke tim Anda dengan catatan seperti "Nothing found in invoices." atau "The invoices data source failed: …" (masing-masing dengan baris bahasa Arab di bawahnya). Pelanggan Anda tidak pernah dibiarkan tanpa balasan.
Jika dokumen tidak dapat diunduh dari tautannya (untuk email dan chat situs web: bukan tautan https publik, atau lebih besar dari 25 MB), bot menyerahkan percakapan ke tim Anda dengan tag bot-error dan catatan yang menyebutkan dokumen tersebut.