İçeriğe geç

Telefon

Ekibinizin telefonunu çaldıran iş numaraları; aktarma, yönlendirme ve kayıtla.

Telefon aç
19 Kasım 2026 tarihinde kontrol paneliyle karşılaştırıldı

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:

curl -s https://xuda.ai/cpi/search_voice_numbers \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","country":"US","type":"local","area_code":"415"}'
const res = await fetch('https://xuda.ai/cpi/search_voice_numbers', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ api_key: 'YOUR_API_KEY', country: 'US', type: 'local', area_code: '415' }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/search_voice_numbers',
    json={'api_key': 'YOUR_API_KEY', 'country': 'US', 'type': 'local', 'area_code': '415'},
)

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_token ve create_voice_call_intent, bir tarayıcı yazılım telefonunun arama yapmasını sağlar: niyet, sahip olduğunuz bir numaradan bir to numarasına tek bir giden aramayı yetkilendirir. Xuda iPhone uygulaması belirteçlerini push_env (sandbox veya production) 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ıt push: true der.
  • list_voice_transfer_targets ve transfer_voice_call, canlı bir aramayı profildeki başka bir kişiye taşır; takeover_voice_call ise 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.

Yöntemler

Bu kılavuz nasıl?

Son güncelleme: 19 Kasım 2026