Telefon
Forretningsnumre, der ringer til dit team, med viderestilling, routing og optagelse.
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:
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_callslæser opkaldshistorikken, for kontoen, en profil eller ét nummer.get_voice_call_transcriptlæser teksten i ét opkald, når der er en.get_voice_browser_tokenogcreate_voice_call_intentlader en browser-softphone foretage et opkald: intentionen autoriserer ét udgående opkald fra et nummer, du ejer, til etto-nummer. Xuda-appen til iPhone beder om sine tokens medpush_env(sandboxellerproduction): 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 sigerpush: true.list_voice_transfer_targetsogtransfer_voice_callflytter et levende opkald til en anden person på profilen, ogtakeover_voice_callflytter et opkald fra AI-receptionisten til din browser.send_voice_announcementforetager 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.