Telefon
Üzleti számok, amelyek a csapatát csengetik, átirányítással, útválasztással és felvétellel.
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:
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_callsa híváselőzményeket olvassa, a fiókra, egy profilra vagy egy számra. - A
get_voice_call_transcriptegy hívás szövegét olvassa, ha van. - A
get_voice_browser_tokenés acreate_voice_call_intentlehető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 egytoszámra. A Xuda iPhone-alkalmazás a tokenjeit apush_envértékkel kéri (sandboxvagyproduction): 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álaszpush: trueértéket mond. - A
list_voice_transfer_targetsés atransfer_voice_callaz élő hívást a profil egy másik személyére viszi, atakeover_voice_callpedig az AI recepciósról az Ön böngészőjére. - A
send_voice_announcementhí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ő.