Phone
Números de empresa que suenan en su equipo, con transferencia, enrutamiento y grabación.
Phone tiene cincuenta métodos públicos, y la página de Phone del dashboard está construida sobre ellos. Cuarenta y cuatro actúan en nombre de la cuenta cuya clave de API usas. Seis son para los propios operadores de Xuda y necesitan una clave de administrador: la revisión de los registros de cumplimiento de un país y la liquidación del uso y de los registros, además de adopt_voice_number, que asigna a un perfil un número que Xuda ya posee, sin compra.
Envía una solicitud a un método con tu clave:
Alquila un número
Esto es lo que hace Alquilar un número, en el mismo orden.
Mira dónde se pueden alquilar números
get_voice_country_catalog lista los países y los tipos de número que están abiertos. get_voice_compliance_status para un country indica qué más necesita ese país de tu parte antes de poder alquilar un número: sus políticas, la identidad que respalda el número y, en un país regulado, el registro del proveedor de telefonía.
Supera las comprobaciones del país
accept_voice_terms registra las políticas, con cada id que lista el país y el policy_version exacto. get_voice_identity_requirements devuelve los campos que pide el país, update_profile_business_identity los guarda y submit_voice_compliance los envía a revisión. Para un país regulado, upload_voice_compliance_document envía cada documento que pide el proveedor y submit_voice_bundle envía el registro.
Busca y cotiza
search_voice_numbers busca entre los números libres por country y type (local, mobile, tollFree o national), acotado por area_code, un patrón contains o capabilities requeridas. get_voice_number_rates muestra lo que puede hacer el número y lo que cuesta usarlo. quote_voice_number pone precio a un candidato y mantiene ese precio durante un tiempo breve, para que no pueda cambiar durante una compra en curso.
Compra
purchase_voice_number canjea la cotización (quote_id y el mismo phone_number) y cobra el alquiler recurrente. Pasa payment_method_id para elegir la tarjeta con la que se paga.
Libera
release_voice_number devuelve un número. Deja de sonar al instante y se cancela su renovación mensual.
El envío de textos se elige al alquilar un número: solo un número que puede enviar textos puede enviarlos o recibirlos, y no se puede añadir después.
Di cómo contesta una línea
list_voice_numbers lista tus números con el perfil al que está asociado cada uno. Con shared_only: true lista en cambio las líneas que otras personas compartieron contigo y tú aceptaste, cada una con shared_from; nunca cuentan para tu plan. attach_voice_number da un número a un perfil (un número por perfil, y el perfil principal nunca puede tener uno) y detach_voice_number lo quita sin liberarlo.
get_voice_number_setup lee en una sola llamada todo lo que decide cómo contesta un número: el perfil, lo que permite tu plan y las reglas con las listas de opciones que hay detrás. update_voice_number_setup lo guarda. Cada sección solo se toca cuando la envías, así que guardar una nunca restablece otra. La configuración también lleva auto_answer, el Asistente público que atiende la línea y cuándo (always, when_no_answer, when_closed, schedule), que se guarda enviando solo lo que cambia; una elección que no sea uno de tus Asistentes públicos activos se rechaza con assistant_not_public. Los ring.contacts y ring.groups de las reglas son contactos y grupos de contactos del propio espacio de trabajo de la línea a los que también hace sonar (uno que ya no existe se rechaza con voice_answerer_not_found), y shared_with lista las personas con las que se comparte la línea, pendientes o aceptadas. get_profile_answering_rules y update_profile_answering_rules leen y guardan solo las reglas: horario comercial, tiempo de espera del timbre, a quién se hace sonar, desvío a un móvil, buzón de voz y grabación.
Un ajuste que tu plan no incluye se rechaza con voice_plan_upgrade_required, nunca se descarta en silencio. Una bajada de plan surte efecto en la siguiente llamada, y lo que guardaste se conserva para que una mejora lo recupere.
list_voice_profile_members, share_voice_profile y revoke_voice_profile_member deciden quién está en un perfil, y por tanto a quién puede hacer sonar una línea y a quién se puede transferir una llamada. Una línea en sí se comparte mediante los recursos compartidos del equipo (create_share con el tipo de recurso compartido voice_number); un recurso compartido aceptado también hace sonar a esa persona. get_voice_browser_token con answering: true da a un navegador un token por cada línea de otra persona que hace sonar a esta cuenta, para que suene también allí; solo contestan.
Llamadas
list_voice_callslee el historial de llamadas, de la cuenta, de un perfil o de un número.get_voice_call_transcriptlee el texto de una llamada, cuando lo hay.get_voice_browser_tokenycreate_voice_call_intentpermiten que un softphone en el navegador haga una llamada: la intención autoriza una llamada saliente desde un número tuyo a un númeroto. La app de Xuda para iPhone pide sus tokens conpush_env(sandboxoproduction): cada token nombra entonces la credencial push de Twilio de su propia cuenta de Twilio, de modo que una llamada hace sonar el teléfono aunque la app esté cerrada, y la respuesta dicepush: true.list_voice_transfer_targetsytransfer_voice_callpasan una llamada en curso a otra persona del perfil, ytakeover_voice_callsaca una llamada de la recepcionista de IA y la pasa a tu navegador.send_voice_announcementhace una llamada desde uno de tus números y dice un mensaje escrito a quien conteste.
Textos
list_voice_message_threads lista las conversaciones con el último mensaje, el recuento de no leídos y si el contacto se dio de baja. list_voice_messages lee una conversación. send_voice_message envía un texto desde un número que puede enviar textos; dale una idempotency_key y un reintento se factura una sola vez. Un contacto que ha enviado STOP queda rechazado hasta que envíe START. mark_voice_message_thread_read borra el recuento de no leídos de una conversación.
Plan, uso y el servicio
get_voice_plans lee la escalera de planes y el plan en el que estás. set_voice_plan lo activa, mejora o baja, con tier o con el id del plan (profile_phone_phone); necesita una cuenta de pago de Xuda. get_voice_usage lee las llamadas y textos del mes, con el tope de gasto que queda. get_voice_service_status y activate_voice_service leen y preparan el servicio telefónico de la cuenta.