Kendi sistemlerinizi ve belgelerinizi kullanan botlar
İsteğe bağlı: bir bot sisteminizdeki verileri (fatura durumu, sipariş) bulabilir ve fatura PDF gibi belgeleri gönderebilir — işte OmniBrand'in sizden ihtiyacı olanlar.
Bu, botun isteğe bağlı bir parçasıdır. OmniBrand mühendisleri isteğe bağlı olarak sizin için kurar; çalışma alanında yapılandırmanız gereken bir şey yoktur.
Ne yapabilir
- Standart belgelerinizi gönderin: bir şirket profili, fiyat listesi, menü, broşür — çevrimiçi tuttuğun dosyalar. Her birine bir isim ve bir bağlantı verirsiniz; bot, müşterinin istediği dosyayı gönderir.
- Sohbet ederken sisteminizdeki verileri arayın: müşteri örneğin bir fatura veya sipariş numarası verir, bot sisteminize soruyor ve cevap veriyor — "Fatura 204 ödendi", "Siparişiniz teslimata çıktı".
- Sisteminizin oluşturduğu bir belgeyi, örneğin faturanın PDF'sini, sisteminizin geri gönderdiği bağlantıyı kullanarak gönderin.
- Toplanan cevapları sisteminize gönderin, örneğin CRM'inizde bir potansiyel müşteri oluşturmak için.
Belge sohbete bir dosya olarak gelir: WhatsApp'ta belge mesajı olarak, e-postada ek olarak ve web sitesi sohbetinde ziyaretçinin açabileceği bir dosya olarak. Gelen kutusu konuşmanızda botun mesajı dosya adını 📄 ile gösterir.
OmniBrand'in sizden ne istediği
Standart belgeler için:
- Her belgenin müşterilerin isteyeceği şekliyle adı ve
https://ile başlayan, oturum açmadan indirilebilen dosyaya giden bir bağlantı. WhatsApp, Instagram ve Messenger'da mesajlaşma hizmeti dosyayı bu bağlantıdan alır; e-posta ve web sitesi sohbeti için OmniBrand dosyayı indirir (en fazla 25 MB) ve kendi depolama alanından gönderir.
Sisteminizdeki verileri aramak için:
- Sisteminizdeki hizmetin adresi (URL), bir soruya cevap veren ve
https://ile başlayan — örneğinhttps://erp.example.com/api/invoices/{number}ile ve müşterinin değerinin gittiği yer. - GET mi yoksa POST ile mi çağrıldığı.
- Kimlik bilgisi: bir API anahtarı veya token ve bunun gönderildiği başlığın adı (genellikle
Authorization). Bunu halka açık bir mesajda değil, destek ekibinin size verdiği kanal üzerinden gönderin. - Var olan bir test değeri, diğeri olmayan (örneğin gerçek fatura numarası ve uydurulmuş bir değer), böylece mühendisler gerçek verilerinizle test edebilsin.
- Cevabın kısa bir açıklaması: hangi alanları içerdiği (örneğin
status,amount,pdf_url) ve bunlardan hangilerini botun müşteriye söyleyebileceği. - Sisteminizin "bulunmadı" dediği gibi: HTTP durumu 404 ile yanıt vermelidir. Diğer herhangi bir hata ise "sistem mevcut değil" olarak kabul edilir.
- Bot verileri açıklamadan önce müşterinin kim olduğunu kanıtlamak için ne vermesi gerektiği (örneğin faturadaki telefon numarası); böylece bot bunu sorar.
Verileriniz nasıl korunur
- Sadece https adresleri kabul edilir.
- Kimlik bilgileriniz şifrelenmiş olarak saklanır. Kaydedildikten sonra, OmniBrand personeli sadece son dört karakterini görür; yalnızca sisteminize gelen talebe eklenir ve müşterilere asla gösterilmez.
- Müşterilerin yazdığı değerler adrese güvenli bir şekilde kodlanır; POST ile JSON olarak gönderilir.
- OmniBrand'in sunucuları dahili veya özel ağ adreslerini çağırmayı reddeder ve her yönlendirmeyi yeniden kontrol eder. Sisteminiz başka bir adrese yönlendirdiğinde kimlik bilginiz oraya gönderilmez.
- Her arama en fazla 10 saniye bekler ve cevabın en fazla 256 KB kısmını okunur.
- Bu bağlantılardaki her değişiklik ve her test, bunu yapan mühendisin adıyla kaydedilir.
Sistemin cevap vermezse
Sisteminiz çalışmadığında, yavaş olduğunda, "bulunamadı" yanıtı verdiğinde veya bir hata döndürdüğünde bot bu durum için tasarlanmış yolu izler — örneğin "Bu faturayı bulamadık" — veya konuşmayı "Nothing found in invoices." ya da "The invoices data source failed: …" gibi bir notla (her biri altında Arapça satırıyla) ekibinize devreder. Müşterileriniz asla yanıtsız kalmaz.
Bir belge bağlantısından indirilemezse (e-posta ve web sitesi sohbeti için: herkese açık bir https bağlantısı değilse veya 25 MB'tan büyükse), bot konuşmayı bot-error etiketi ve belgeyi adlandıran bir notla ekibinize devreder.