Telefon
Företagsnummer som ringer hos ditt team, med vidarekoppling, dirigering och inspelning.
Phone har femtio publika metoder, och instrumentpanelens sida Phone bygger på dem. Fyrtiofyra av dem agerar för det konto vars API-nyckel du använder. Sex är till för Xudas egna operatörer och kräver en admin-nyckel: granskningen av ett lands efterlevnadsposter och avstämningen av användning och registreringar, samt adopt_voice_number, som tilldelar en profil ett nummer som Xuda redan äger utan något köp.
Skicka en förfrågan till en metod med din nyckel:
Hyr ett nummer
Detta är vad Hyr ett nummer gör, i samma ordning.
Se var nummer kan hyras
get_voice_country_catalog listar de länder och nummertyper som är öppna. get_voice_compliance_status för ett country anger vad landet fortfarande kräver av dig innan ett nummer kan hyras: dess policyer, identiteten bakom numret och, i ett reglerat land, telefonleverantörens registrering.
Klara landets kontroller
accept_voice_terms registrerar policyerna, med varje id som landet listar och exakt policy_version. get_voice_identity_requirements returnerar de fält som landet ber om, update_profile_business_identity sparar dem och submit_voice_compliance skickar dem för granskning. För ett reglerat land skickar upload_voice_compliance_document varje dokument som leverantören ber om och submit_voice_bundle skickar registreringen.
Sök och få pris
search_voice_numbers söker bland de lediga numren efter country och type (local, mobile, tollFree eller national), avgränsat med area_code, ett contains-mönster eller obligatoriska capabilities. get_voice_number_rates visar vad numret kan göra och vad användningen kostar. quote_voice_number prissätter en kandidat och håller priset en kort stund, så att det inte kan ändras under ett pågående köp.
Köp
purchase_voice_number löser in offerten (quote_id och samma phone_number) och debiterar den återkommande hyran. Ange payment_method_id för att välja vilket kort som betalar.
Släpp
release_voice_number lämnar tillbaka ett nummer. Det slutar ringa direkt och dess månatliga förnyelse avbryts.
Sms väljs när ett nummer hyrs: bara ett nummer som kan ta emot och skicka sms kan göra det, och det går inte att lägga till senare.
Bestäm hur en linje svarar
list_voice_numbers listar dina nummer med den profil som varje nummer är kopplat till. Med shared_only: true listar den i stället de linjer som andra har delat med dig och som du har godkänt, var och en med shared_from; de räknas aldrig mot din plan. attach_voice_number ger en profil ett nummer (ett nummer per profil, och huvudprofilen kan aldrig ha något) och detach_voice_number tar bort det utan att släppa det.
get_voice_number_setup läser allt som avgör hur ett nummer svarar i ett enda anrop: profilen, vad din plan tillåter och reglerna med de alternativlistor som hör till dem. update_voice_number_setup sparar det. Varje avsnitt ändras bara när du skickar det, så att spara ett återställer aldrig ett annat. Inställningen innehåller också auto_answer, den Publika assistent som svarar på linjen och när (always, when_no_answer, when_closed, schedule), som sparas genom att bara skicka det som ändras; ett val som inte är en av dina aktiva Publika assistenter nekas med assistant_not_public. Reglernas ring.contacts och ring.groups är kontakter och kontaktgrupper i linjens egen arbetsyta som den också ringer (en som inte finns längre nekas med voice_answerer_not_found), och shared_with listar de personer som linjen är delad med, väntande eller godkända. get_profile_answering_rules och update_profile_answering_rules läser och sparar bara reglerna: öppettider, ringtid, vilka som ringas, vidarekoppling till en mobil, röstbrevlåda och inspelning.
En inställning som din plan inte innehåller nekas med voice_plan_upgrade_required, den släpps aldrig tyst. En nedgradering gäller från nästa samtal, och det du sparade ligger kvar så att en uppgradering ger tillbaka det.
list_voice_profile_members, share_voice_profile och revoke_voice_profile_member avgör vilka som är med på en profil, och därmed vilka en linje kan ringa och vilka ett samtal kan kopplas till. En linje delas i sig via teamdelningarna (create_share med delningstypen voice_number); en godkänd delning ringer också den personen. get_voice_browser_token med answering: true ger en webbläsare en token för varje linje som tillhör någon annan och som ringer det här kontot, så att den ringer även där; de kan bara svara.
Samtal
list_voice_callsläser samtalshistoriken, för kontot, en profil eller ett nummer.get_voice_call_transcriptläser texten i ett samtal, när det finns en.get_voice_browser_tokenochcreate_voice_call_intentlåter en webbläsartelefon ringa ett samtal: avsikten ger tillstånd till ett utgående samtal från ett nummer du äger till ettto-nummer. Xuda-appen för iPhone ber om sina tokens medpush_env(sandboxellerproduction): varje token anger då Twilio-pushuppgifterna för sitt eget Twilio-konto, så att ett samtal ringer telefonen även när appen är stängd, och svaret sägerpush: true.list_voice_transfer_targetsochtransfer_voice_callflyttar ett pågående samtal till en annan person på profilen, ochtakeover_voice_callflyttar ett samtal från AI-receptionisten till din webbläsare.send_voice_announcementringer ett samtal från ett av dina nummer och läser upp ett skrivet meddelande för den som svarar.
Sms
list_voice_message_threads listar konversationer med det senaste meddelandet, antalet olästa och om kontakten har valt bort. list_voice_messages läser en konversation. send_voice_message skickar ett sms från ett nummer som kan skicka sms; ge den en idempotency_key så debiteras en återförsökning bara en gång. En kontakt som har skickat STOP nekas tills hen skickar START. mark_voice_message_thread_read nollställer en konversations olästa.
Plan, användning och tjänsten
get_voice_plans läser plantrappan och den plan du har. set_voice_plan aktiverar, uppgraderar eller nedgraderar den, med antingen tier eller plan-id:t (profile_phone_phone); det kräver ett betalt Xuda-konto. get_voice_usage läser månadens samtal och sms, med den utgiftsgräns som återstår. get_voice_service_status och activate_voice_service läser och förbereder kontots telefontjänst.