Telefon
Ekibinizin telefonunu çaldıran iş numaraları; aktarma, yönlendirme ve kayıtla.
Phone'un elli genel yöntemi vardır ve panelin Phone sayfası bunların üzerine kuruludur. Kırk dördü, API anahtarını kullandığınız hesap adına çalışır. Altısı Xuda'nın kendi operatörleri içindir ve yönetici anahtarı gerektirir: bir ülkenin uyumluluk kayıtlarının incelenmesi ile kullanımın ve kayıtların kapatılması, ayrıca Xuda'nın zaten sahip olduğu bir numarayı satın alma olmadan bir profile atayan adopt_voice_number.
Anahtarınızla bir yönteme istek gönderin:
Numara kiralayın
Bu, Numara kirala işleminin yaptığı şeydir, aynı sırayla.
Numaraların nerede kiralanabildiğine bakın
get_voice_country_catalog, açık olan ülkeleri ve numara türlerini listeler. Bir country için get_voice_compliance_status, numara kiralanabilmesi için o ülkenin sizden hâlâ neye ihtiyaç duyduğunu söyler: politikaları, numaranın arkasındaki kimlik ve düzenlemeye tabi bir ülkede telefon sağlayıcısının kaydı.
Ülkenin kontrollerini tamamlayın
accept_voice_terms, ülkenin listelediği her kimlikle ve tam policy_version ile politikaları kaydeder. get_voice_identity_requirements, ülkenin istediği alanları döndürür, update_profile_business_identity bunları saklar ve submit_voice_compliance bunları incelemeye gönderir. Düzenlemeye tabi bir ülke için upload_voice_compliance_document, sağlayıcının istediği her belgeyi gönderir ve submit_voice_bundle kaydı gönderir.
Arayın ve fiyat alın
search_voice_numbers, boş numaraları country ve type (local, mobile, tollFree veya national) ile arar; area_code, bir contains deseni veya gerekli capabilities ile daraltılabilir. get_voice_number_rates, numaranın neler yapabildiğini ve kullanımın neye mal olduğunu gösterir. quote_voice_number, bir adayın fiyatını verir ve bu fiyatı kısa bir süre boyunca tutar; böylece devam eden bir satın alma sırasında değişemez.
Satın alın
purchase_voice_number, fiyat teklifini (quote_id ve aynı phone_number) kullanır ve yinelenen kirayı tahsil eder. Ödemeyi yapacak kartı seçmek için payment_method_id verin.
Bırakın
release_voice_number, bir numarayı geri verir. Hemen çalmayı bırakır ve aylık yenilemesi iptal edilir.
Mesajlaşma, numara kiralanırken seçilir: yalnızca mesaj alabilen bir numara mesaj gönderebilir veya alabilir ve sonradan eklenemez.
Bir hattın nasıl yanıt vereceğini belirleyin
list_voice_numbers, numaralarınızı her birinin bağlı olduğu profille listeler. shared_only: true ile bunun yerine başkalarının sizinle paylaştığı ve sizin kabul ettiğiniz hatları, her biri shared_from ile listeler; bunlar asla planınıza sayılmaz. attach_voice_number, bir numarayı bir profile verir (profil başına bir numara; ana profil asla numara tutamaz) ve detach_voice_number, numarayı bırakmadan profilden çıkarır.
get_voice_number_setup, bir numaranın nasıl yanıt vereceğini belirleyen her şeyi tek çağrıda okur: profil, planınızın izin verdikleri ve kuralların arkasındaki seçenek listeleri. update_voice_number_setup bunu kaydeder. Her bölüme yalnızca gönderdiğinizde dokunulur; bu yüzden birini kaydetmek diğerini asla sıfırlamaz. Kurulum ayrıca auto_answer değerini taşır: hatta hangi Herkese açık Asistanın ve ne zaman yanıt vereceği (always, when_no_answer, when_closed, schedule); yalnızca değişeni göndererek kaydedilir. Yayında olan Herkese açık Asistanlarınızdan biri olmayan bir seçim assistant_not_public ile reddedilir. Kuralların ring.contacts ve ring.groups alanları, hattın kendi çalışma alanındaki, hattın ayrıca çaldırdığı kişiler ve kişi gruplarıdır (artık var olmayan biri voice_answerer_not_found ile reddedilir) ve shared_with, hattın paylaşıldığı kişileri, bekleyenleri ve kabul edenleri listeler. get_profile_answering_rules ve update_profile_answering_rules, kuralları tek başına okur ve kaydeder: çalışma saatleri, çalma zaman aşımı, kimin çaldırıldığı, cep telefonuna yönlendirme, sesli mesaj ve kayıt.
Planınızın içermediği bir ayar voice_plan_upgrade_required ile reddedilir, asla sessizce atlanmaz. Bir plan düşürme, hemen sonraki aramada geçerli olur ve kaydettikleriniz yerinde kalır; böylece bir yükseltme onları geri getirir.
list_voice_profile_members, share_voice_profile ve revoke_voice_profile_member, bir profilde kimlerin olduğunu, dolayısıyla bir hattın kimleri çaldırabileceğini ve bir aramanın kimlere aktarılabileceğini belirler. Hattın kendisi ekip paylaşımlarıyla paylaşılır (paylaşım türü voice_number ile create_share); kabul edilen bir paylaşım o kişide de çalar. answering: true ile get_voice_browser_token, bu hesapta çalan başkasına ait her hat için bir tarayıcıya birer belirteç verir; böylece orada da çalar, ancak yalnızca yanıtlayabilirler.
Aramalar
list_voice_calls, arama geçmişini hesap, bir profil veya tek bir numara için okur.get_voice_call_transcript, varsa bir aramanın metnini okur.get_voice_browser_tokenvecreate_voice_call_intent, bir tarayıcı yazılım telefonunun arama yapmasını sağlar: niyet, sahip olduğunuz bir numaradan birtonumarasına tek bir giden aramayı yetkilendirir. Xuda iPhone uygulaması belirteçlerinipush_env(sandboxveyaproduction) ile ister: her belirteç o zaman kendi Twilio hesabının Twilio anlık bildirim kimlik bilgisini belirtir; böylece uygulama kapalıyken bile arama telefonu çaldırır ve yanıtpush: trueder.list_voice_transfer_targetsvetransfer_voice_call, canlı bir aramayı profildeki başka bir kişiye taşır;takeover_voice_callise bir aramayı AI resepsiyonistten tarayıcınıza alır.send_voice_announcement, numaralarınızdan birinden arama yapar ve yanıtlayan kişiye yazılmış bir mesajı seslendirir.
Mesajlar
list_voice_message_threads, konuşmaları son mesaj, okunmamış sayısı ve kişinin vazgeçip geçmediğiyle listeler. list_voice_messages, bir konuşmayı okur. send_voice_message, mesaj alabilen bir numaradan bir mesaj gönderir; ona bir idempotency_key verirseniz yeniden deneme bir kez faturalandırılır. STOP gönderen bir kişiye, START gönderene kadar mesaj gönderilmez. mark_voice_message_thread_read, bir konuşmanın okunmamış sayısını sıfırlar.
Plan, kullanım ve hizmet
get_voice_plans, plan basamaklarını ve bulunduğunuz planı okur. set_voice_plan, tier ya da plan kimliği (profile_phone_phone) ile planı etkinleştirir, yükseltir veya düşürür; ücretli bir Xuda hesabı gerekir. get_voice_usage, ayın aramalarını ve mesajlarını, kalan harcama sınırıyla birlikte okur. get_voice_service_status ve activate_voice_service, hesabın telefon hizmetini okur ve hazırlar.