Ugrás a tartalomhoz

Telefon

Üzleti számok, amelyek a csapatát csengetik, átirányítással, útválasztással és felvétellel.

Telefon megnyitása
Az irányítópulttal összevetve ekkor: 2026. november 19.

A Telefonnak ötven nyilvános metódusa van, és a Telefon irányítópult-oldala ezekre épül. Negyvennégy annak a fióknak a nevében működik, amelynek az API-kulcsát használja. Hat a Xuda saját üzemeltetőié, és adminkulcsot igényel: egy ország megfelelőségi nyilvántartásainak felülvizsgálata, valamint a használat és a regisztrációk elszámolása, továbbá az adopt_voice_number, amely egy, a Xuda tulajdonában lévő számot vásárlás nélkül egy profilhoz rendel.

Küldjön kérést egy metódusnak a kulcsával:

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'},
)

Szám bérlése

Ezt teszi a Szám bérlése, ugyanebben a sorrendben.

Nézze meg, hol bérelhetők számok

A get_voice_country_catalog felsorolja a megnyitott országokat és számtípusokat. A get_voice_compliance_status egy country esetén megmondja, mit kér még az adott ország Öntől, mielőtt számot lehet bérelni: a szabályzatait, a szám mögötti személyazonosságot, és szabályozott országban a telefonszolgáltató regisztrációját.

Teljesítse az ország ellenőrzéseit

Az accept_voice_terms rögzíti a szabályzatokat, az ország által felsorolt minden azonosítóval és a pontos policy_version értékkel. A get_voice_identity_requirements visszaadja az ország által kért mezőket, az update_profile_business_identity eltárolja őket, a submit_voice_compliance pedig felülvizsgálatra küldi. Szabályozott országban az upload_voice_compliance_document elküldi a szolgáltató által kért minden dokumentumot, a submit_voice_bundle pedig a regisztrációt.

Keresés és árajánlat

A search_voice_numbers a szabad számokat keresi country és type (local, mobile, tollFree vagy national) szerint, az area_code, egy contains minta vagy a szükséges capabilities szerint szűkítve. A get_voice_number_rates megmutatja, mit tud a szám, és mibe kerül a használata. A quote_voice_number megárazza az egyik jelöltet, és rövid ideig tartja az árat, így az nem mozdulhat el egy folyamatban lévő vásárlás alatt.

Vásárlás

A purchase_voice_number beváltja az árajánlatot (quote_id és ugyanaz a phone_number), és terheli az ismétlődő bérleti díjat. A payment_method_id megadásával választhatja ki a fizető kártyát.

Felszabadítás

A release_voice_number visszaadja a számot. Azonnal megszűnik csörögni, és a havi megújítása törlődik.

Az üzenetküldést a szám bérlésekor választják: csak az a szám küldhet vagy fogadhat üzeneteket, amelyik tud, és ez később nem adható hozzá.

Mondja meg, hogyan vegye fel a vonal

A list_voice_numbers felsorolja a számait azzal a profillal, amelyhez mindegyik kapcsolódik. A shared_only: true esetén ehelyett azokat a vonalakat sorolja fel, amelyeket mások megosztottak Önnel és Ön elfogadott, mindegyiket shared_from mezővel; ezek soha nem számítanak a csomagjába. Az attach_voice_number egy számot ad egy profilnak (profilonként egy szám, és a fő profil soha nem tarthat egyet), a detach_voice_number pedig leveszi felszabadítás nélkül.

A get_voice_number_setup egyetlen hívásban olvas be mindent, ami eldönti, hogyan veszi fel egy szám a hívást: a profilt, azt, amit a csomagja enged, és a szabályokat a mögöttük lévő opciólistákkal. Az update_voice_number_setup menti. Minden szakaszhoz csak akkor nyúl, ha elküldi, így az egyik mentése soha nem állít vissza másikat. A beállítás az auto_answer mezőt is hordozza, a Nyilvános asszisztenst, aki a vonalat felveszi, és mikor (always, when_no_answer, when_closed, schedule), csak a változó rész elküldésével mentve; az a választás, amely nem az egyik élő Nyilvános asszisztense, assistant_not_public hibával elutasításra kerül. A szabályok ring.contacts és ring.groups mezői a vonal saját munkaterületének kapcsolatai és kapcsolatcsoportjai, amelyeket még csörget (az, amelyik már nincs meg, voice_answerer_not_found hibával elutasításra kerül), a shared_with pedig felsorolja azokat a személyeket, akikkel a vonal meg van osztva, várakozókat vagy elfogadottakat. A get_profile_answering_rules és az update_profile_answering_rules csak a szabályokat olvassa és menti: az üzleti órákat, a csörgési időkorlátot, hogy kit csörget, a mobilra továbbítást, a hangpostát és a felvételt.

A beállítást, amelyet a csomagja nem tartalmaz, voice_plan_upgrade_required hibával elutasítja, soha nem hagyja el csendben. A visszaváltás a következő híváskor lép érvénybe, és amit mentett, a helyén marad, így a magasabb csomagra váltás visszahozza.

A list_voice_profile_members, a share_voice_profile és a revoke_voice_profile_member dönti el, ki van egy profilon, és így kit csörgethet a vonal, és kinek lehet átadni a hívást. Magát a vonalat a csapatmegosztások osztják meg (create_share a voice_number megosztástípussal); az elfogadott megosztás azt a személyt is csörgeti. A get_voice_browser_token az answering: true értékkel egy böngészőnek egy tokent ad mindegyik olyan vonalhoz, amely valaki máséból ezt a fiókot csörgeti, így ott is csörög; azok csak fogadnak.

Hívások

  • A list_voice_calls a híváselőzményeket olvassa, a fiókra, egy profilra vagy egy számra.
  • A get_voice_call_transcript egy hívás szövegét olvassa, ha van.
  • A get_voice_browser_token és a create_voice_call_intent lehetővé teszi, hogy egy böngészős softphone hívást indítson: az intent egy kimenő hívást engedélyez egy Ön tulajdonában lévő számról egy to számra. A Xuda iPhone-alkalmazás a tokenjeit a push_env értékkel kéri (sandbox vagy production): ekkor minden token a saját Twilio-fiókja Twilio push-hitelesítőjét nevezi meg, így a hívás akkor is csörgeti a telefont, ha az alkalmazás be van zárva, és a válasz push: true értéket mond.
  • A list_voice_transfer_targets és a transfer_voice_call az élő hívást a profil egy másik személyére viszi, a takeover_voice_call pedig az AI recepciósról az Ön böngészőjére.
  • A send_voice_announcement hívást indít az egyik számáról, és bepötyögött üzenetet mond el annak, aki felveszi.

Üzenetek

A list_voice_message_threads felsorolja a beszélgetéseket az utolsó üzenettel, az olvasatlanok számával és azzal, hogy a kapcsolat leiratkozott-e. A list_voice_messages egy beszélgetést olvas. A send_voice_message egy üzenetet küld egy olyan számról, amely tud üzenetet küldeni; adjon neki idempotency_key értéket, és az újrapróbálkozást egyszer számlázzák. Azt a kapcsolatot, aki STOP-ot küldött, elutasítja, amíg nem küld START-ot. A mark_voice_message_thread_read törli egy beszélgetés olvasatlanjainak számát.

Csomag, használat és a szolgáltatás

A get_voice_plans a csomagsort és az Ön csomagját olvassa. A set_voice_plan aktiválja, magasabbra vagy alacsonyabbra váltja, tier vagy a csomagazonosító (profile_phone_phone) megadásával; fizetős Xuda-fiók kell hozzá. A get_voice_usage a hónap hívásait és üzeneteit olvassa, a még meglévő költési korláttal. A get_voice_service_status és az activate_voice_service a fiók telefonszolgáltatását olvassa és készíti elő.

Metódusok

Milyen ez az útmutató?

Utoljára frissítve: 2026. november 20.