Gå til indhold

Telefon

Forretningsnumre, der ringer til dit team, med viderestilling, routing og optagelse.

Åbn Telefon
Kontrolleret mod dashboardet den 19. november 2026

Telefon har halvtreds offentlige metoder, og dashboardets side Telefon er bygget på dem. Fireogfyrre handler for den konto, hvis API-nøgle du bruger. Seks er til Xudas egne operatører og kræver en admin-nøgle: gennemgangen af et lands compliance-records og afregningen af forbrug og registreringer, plus adopt_voice_number, som tildeler et nummer, Xuda allerede ejer, til en profil uden køb.

Send en forespørgsel til en metode med din nøgle:

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

Lej et nummer

Det er det, Lej et nummer gør, i samme rækkefølge.

Se, hvor numre kan lejes

get_voice_country_catalog viser de lande og nummertyper, der er åbne. get_voice_compliance_status for et country siger, hvad det land stadig kræver af dig, før et nummer kan lejes: dets politikker, identiteten bag nummeret og, i et reguleret land, teleudbyderens registrering.

Gennemfør landets kontroller

accept_voice_terms registrerer politikkerne, med hvert id, landet viser, og den præcise policy_version. get_voice_identity_requirements returnerer de felter, landet beder om, update_profile_business_identity gemmer dem, og submit_voice_compliance sender dem til gennemgang. For et reguleret land sender upload_voice_compliance_document hvert dokument, udbyderen beder om, og submit_voice_bundle sender registreringen.

Søg og få et tilbud

search_voice_numbers søger i de ledige numre efter country og type (local, mobile, tollFree eller national), indsnævret med area_code, et contains-mønster eller påkrævede capabilities. get_voice_number_rates viser, hvad nummeret kan, og hvad brug koster. quote_voice_number prissætter én kandidat og holder den pris i en kort tid, så den ikke kan flytte sig under et køb i gang.

Køb

purchase_voice_number indløser tilbuddet (quote_id og det samme phone_number) og trækker den tilbagevendende leje. Send payment_method_id for at vælge det kort, der betaler.

Frigiv

release_voice_number giver et nummer tilbage. Det holder straks op med at ringe, og dets månedlige fornyelse annulleres.

Sms vælges, når et nummer lejes: kun et nummer, der kan sende sms, kan sende eller modtage dem, og det kan ikke føjes til senere.

Sig, hvordan en linje svarer

list_voice_numbers viser dine numre med den profil, hver er knyttet til. Med shared_only: true viser den i stedet de linjer, andre delte med dig, og som du accepterede, hver med shared_from; de tæller aldrig med mod din plan. attach_voice_number giver et nummer til en profil (ét nummer pr. profil, og hovedprofilen kan aldrig have et) og detach_voice_number tager det af uden at frigive det.

get_voice_number_setup læser alt, der afgør, hvordan ét nummer svarer, i ét kald: profilen, hvad din plan tillader, og reglerne med de bagvedliggende lister af valg. update_voice_number_setup gemmer det. Hver sektion røres kun, når du sender den, så en gemning nulstiller aldrig en anden. Opsætningen bærer også auto_answer, den offentlige assistent, der besvarer linjen, og hvornår (always, when_no_answer, when_closed, schedule), gemt ved kun at sende det, der ændres; et valg, der ikke er en af dine aktive offentlige assistenter, afvises med assistant_not_public. Reglernes ring.contacts og ring.groups er kontakter og kontaktgrupper i linjens eget arbejdsområde, som den også ringer til (en, der er væk, afvises med voice_answerer_not_found), og shared_with viser de personer, linjen er delt med, ventende eller accepterede. get_profile_answering_rules og update_profile_answering_rules læser og gemmer kun reglerne: åbningstider, ringetiden, hvem der ringes til, viderestilling til en mobil, telefonsvarer og optagelse.

En indstilling, din plan ikke indeholder, afvises med voice_plan_upgrade_required, aldrig droppet i stilhed. En nedgradering træder i kraft ved næste opkald, og det, du gemte, bliver, så en opgradering bringer det tilbage.

list_voice_profile_members, share_voice_profile og revoke_voice_profile_member afgør, hvem der er på en profil, og dermed hvem en linje kan ringe til, og hvem et opkald kan viderestilles til. En linje deles selv gennem teamdelingerne (create_share med deletypen voice_number); en accepteret deling ringer også til den person. get_voice_browser_token med answering: true giver en browser ét token for hver af en andens linjer, der ringer til denne konto, så den også ringer der; de besvarer kun.

Opkald

  • list_voice_calls læser opkaldshistorikken, for kontoen, en profil eller ét nummer.
  • get_voice_call_transcript læser teksten i ét opkald, når der er en.
  • get_voice_browser_token og create_voice_call_intent lader en browser-softphone foretage et opkald: intentionen autoriserer ét udgående opkald fra et nummer, du ejer, til et to-nummer. Xuda-appen til iPhone beder om sine tokens med push_env (sandbox eller production): hvert token navngiver så Twilio-push-legitimationen fra sin egen Twilio-konto, så et opkald ringer til telefonen, selv når appen er lukket, og svaret siger push: true.
  • list_voice_transfer_targets og transfer_voice_call flytter et levende opkald til en anden person på profilen, og takeover_voice_call flytter et opkald fra AI-receptionisten til din browser.
  • send_voice_announcement foretager et opkald fra et af dine numre og siger en skrevet besked højt til den, der svarer.

Sms

list_voice_message_threads viser samtaler med den sidste besked, antallet af ulæste og om kontakten har fravalgt. list_voice_messages læser én samtale. send_voice_message sender én sms fra et nummer, der kan sende sms; giv den en idempotency_key, og et nyt forsøg faktureres én gang. En kontakt, der har sendt STOP, afvises, indtil vedkommende sender START. mark_voice_message_thread_read nulstiller en samtales antal ulæste.

Plan, forbrug og tjenesten

get_voice_plans læser planstigen og den plan, du er på. set_voice_plan aktiverer, opgraderer eller nedgraderer den, med enten tier eller plan-id'et (profile_phone_phone); det kræver en betalt Xuda-konto. get_voice_usage læser månedens opkald og sms, med den udgiftsgrænse, der er tilbage. get_voice_service_status og activate_voice_service læser og forbereder kontoens telefontjeneste.

Metoder

Hvordan er denne guide?

Sidst opdateret den 19. november 2026