Siirry sisältöön

Puhelin

Yrityksen numerot, jotka soivat tiimillesi, siirrolla, reitityksellä ja nauhoituksella.

Avaa Puhelin
Tarkistettu koontinäyttöä vasten 19. marraskuuta 2026

Puhelimella on viisikymmentä julkista menetelmää, ja hallintapaneelin Puhelin-sivu on rakennettu niiden varaan. Neljäkymmentäneljä toimii sen tilin puolesta, jonka API-avainta käytät. Kuusi on Xudan omille operaattoreille ja vaatii ylläpitäjän avaimen: maan vaatimustenmukaisuustietueiden tarkastus sekä käytön ja rekisteröintien selvitys, sekä adopt_voice_number, joka liittää profiiliin numeron, jonka Xuda jo omistaa, ilman ostoa.

Lähetä pyyntö menetelmälle avaimellasi:

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

Vuokraa numero

Tämä on se, mitä Vuokraa numero tekee, samassa järjestyksessä.

Katso, missä numeroita voi vuokrata

get_voice_country_catalog listaa maat ja numerotyypit, jotka ovat auki. get_voice_compliance_status maalle country kertoo, mitä kyseinen maa vielä vaatii sinulta ennen kuin numeron voi vuokrata: sen käytännöt, numeron takana olevan henkilöllisyyden ja säännellyssä maassa puhelinoperaattorin rekisteröinnin.

Selvitä maan tarkistukset

accept_voice_terms tallentaa käytännöt, kaikilla maan listaamilla tunnuksilla ja tarkalla policy_version-arvolla. get_voice_identity_requirements palauttaa kentät, joita maa pyytää, update_profile_business_identity tallentaa ne ja submit_voice_compliance lähettää ne tarkastettaviksi. Säännellyssä maassa upload_voice_compliance_document lähettää jokaisen asiakirjan, jota operaattori pyytää, ja submit_voice_bundle lähettää rekisteröinnin.

Hae ja pyydä tarjous

search_voice_numbers hakee vapaita numeroita country- ja type-arvoilla (local, mobile, tollFree tai national), rajattuna arvolla area_code, contains-kuviolla tai vaadituilla capabilities-arvoilla. get_voice_number_rates näyttää, mitä numero voi tehdä ja mitä käyttö maksaa. quote_voice_number hinnoittelee yhden ehdokkaan ja pitää hinnan lyhyen aikaa, jotta se ei voi liikkua käynnissä olevan oston alla.

Osta

purchase_voice_number lunastaa tarjouksen (quote_id ja sama phone_number) ja veloittaa toistuvan vuokran. Anna payment_method_id valitaksesi kortin, joka maksaa.

Vapauta

release_voice_number antaa numeron takaisin. Se lakkaa soimasta heti ja sen kuukausittainen uusiutuminen peruutetaan.

Tekstiviestit valitaan numeroa vuokrattaessa: vain numero, joka voi lähettää tekstiviestejä, voi lähettää tai vastaanottaa niitä, eikä sitä voi lisätä myöhemmin.

Päätä, miten linja vastaa

list_voice_numbers listaa numerosi ja profiilin, johon kukin on liitetty. Arvolla shared_only: true se listaa sen sijaan linjat, jotka muut ovat jakaneet kanssasi ja jotka olet hyväksynyt, kukin arvolla shared_from; ne eivät koskaan lasketa pakettiisi. attach_voice_number antaa numeron profiilille (yksi numero profiilia kohden, eikä pääprofiililla voi koskaan olla yhtään) ja detach_voice_number ottaa sen pois vapauttamatta sitä.

get_voice_number_setup lukee kaiken, mikä ratkaisee, miten yksi numero vastaa, yhdellä kutsulla: profiilin, mitä pakettisi sallii ja säännöt niiden taustalla olevine vaihtoehtolistoineen. update_voice_number_setup tallentaa sen. Jokaiseen osioon kosketaan vain, kun lähetät sen, joten yhden tallentaminen ei koskaan nollaa toista. Määritys sisältää myös auto_answer-arvon, Julkisen avustajan, joka vastaa linjalle, ja milloin (always, when_no_answer, when_closed, schedule), tallennettuna lähettämällä vain se, mikä muuttuu; valinta, joka ei ole yksi livenä olevista Julkisista avustajistasi, evätään arvolla assistant_not_public. Sääntöjen ring.contacts ja ring.groups ovat linjan oman työtilan yhteystietoja ja yhteystietoryhmiä, joille se soittaa myös (poistettu evätään arvolla voice_answerer_not_found), ja shared_with listaa ihmiset, joiden kanssa linja on jaettu, odottavat tai hyväksytyt. get_profile_answering_rules ja update_profile_answering_rules lukevat ja tallentavat säännöt yksinään: aukioloajat, soiton aikakatkaisun, kenelle soitetaan, välityksen matkapuhelimeen, vastaajan ja tallennuksen.

Asetus, jota pakettisi ei sisällä, evätään arvolla voice_plan_upgrade_required, sitä ei koskaan pudoteta hiljaa. Paketin alentaminen tulee voimaan heti seuraavassa puhelussa, ja tallentamasi pysyy paikallaan, joten päivitys tuo sen takaisin.

list_voice_profile_members, share_voice_profile ja revoke_voice_profile_member päättävät, ketkä ovat profiilissa, ja siten kenelle linja voi soittaa ja kenelle puhelun voi siirtää. Itse linja jaetaan tiimijakojen kautta (create_share jakotyypillä voice_number); hyväksytty jako soittaa myös sille ihmiselle. get_voice_browser_token arvolla answering: true antaa selaimelle yhden tokenin jokaiselle jonkun toisen linjalle, joka soi tälle tilille, joten se soi myös siellä; he vain vastaavat.

Puhelut

  • list_voice_calls lukee puheluhistorian tilille, profiilille tai yhdelle numerolle.
  • get_voice_call_transcript lukee yhden puhelun tekstin, kun sellainen on.
  • get_voice_browser_token ja create_voice_call_intent antavat selainpuhelimen soittaa: aikomus valtuuttaa yhden ulossoiton omistamastasi numerosta to-numeroon. Xudan iPhone-sovellus pyytää tokeninsa arvolla push_env (sandbox tai production): jokainen token nimeää silloin oman Twilio-tilinsä Twilio-push-tunnistetiedon, joten puhelu soittaa puhelimeen, vaikka sovellus olisi suljettu, ja vastaus sanoo push: true.
  • list_voice_transfer_targets ja transfer_voice_call siirtävät käynnissä olevan puhelun toiselle profiilin ihmiselle, ja takeover_voice_call siirtää puhelun pois tekoälyvastaanottajalta selaimeesi.
  • send_voice_announcement soittaa yhdestä numerostasi ja puhuu kirjoitetun viestin sille, joka vastaa.

Tekstiviestit

list_voice_message_threads listaa keskustelut viimeisen viestin, lukemattomien määrän ja tiedon kanssa, onko yhteystieto kieltäytynyt. list_voice_messages lukee yhden keskustelun. send_voice_message lähettää yhden tekstiviestin numerosta, joka voi lähettää tekstiviestejä; anna sille idempotency_key, ja uudelleenyritys laskutetaan kerran. Yhteystieto, joka on lähettänyt STOP, evätään, kunnes hän lähettää START. mark_voice_message_thread_read tyhjentää keskustelun lukemattomien määrän.

Paketti, käyttö ja palvelu

get_voice_plans lukee pakettiportaat ja paketin, jossa olet. set_voice_plan ottaa sen käyttöön, päivittää tai alentaa sen, joko tier-arvolla tai paketin tunnuksella (profile_phone_phone); se vaatii maksullisen Xuda-tilin. get_voice_usage lukee kuukauden puhelut ja tekstiviestit sekä jäljellä olevan kulukaton. get_voice_service_status ja activate_voice_service lukevat ja valmistelevat tilin puhelinpalvelun.

Menetelmät

Millainen tämä opas on?

Päivitetty viimeksi 19. marraskuuta 2026