Saltar al contenido

Phone

Números de empresa que suenan en su equipo, con transferencia, enrutamiento y grabación.

Abrir Phone
Comprobado con el panel el 19 de noviembre de 2026

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:

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

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_calls lee el historial de llamadas, de la cuenta, de un perfil o de un número.
  • get_voice_call_transcript lee el texto de una llamada, cuando lo hay.
  • get_voice_browser_token y create_voice_call_intent permiten que un softphone en el navegador haga una llamada: la intención autoriza una llamada saliente desde un número tuyo a un número to. La app de Xuda para iPhone pide sus tokens con push_env (sandbox o production): 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 dice push: true.
  • list_voice_transfer_targets y transfer_voice_call pasan una llamada en curso a otra persona del perfil, y takeover_voice_call saca una llamada de la recepcionista de IA y la pasa a tu navegador.
  • send_voice_announcement hace 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.

Métodos

¿Qué te parece esta guía?

Última actualización: 17 de noviembre de 2026