Numbers

Numbers es un concepto clave que debes comprender al trabajar con Vonage Voice API. Los siguientes puntos deben tenerse en cuenta antes de desarrollar tu aplicación de Vonage.

Formato

Dentro de Vonage Voice (API o SIP Trunking) todos los números están en formato E.164. Esto significa que los Numbers:

  • Omitir tanto la inicial + y el código de acceso internacional como 00 o 001.
  • No contener caracteres especiales, como un espacio, () o -

Por ejemplo, un número estadounidense tendría el formato 14155550101. Un número del Reino Unido tendría el formato 447700900123.

Si no está seguro de cómo formatear el número, el botón Number Insight API puede utilizarse para encontrar información correcta sobre un número.

Números de Vonage

Vonage ofrece números de alquiler ubicados en muchos países del mundo. En algunos países, los números pueden estar habilitados solo para SMS o voz, o en otros, admitirán ambos.

Vonage también puede proporcionar números en las gamas "fijo" y "móvil" para muchos países. Puedes buscar y alquilar un número disponible:

Identificador de llamadas salientes

Al realizar una llamada saliente, el identificador de llamadas es el from valor en el Hacer una llamada API o conecte acciones para Voice API. También se puede encontrar en el SIP INVITE para SIP Trunking; estará en la carpeta PAI si está activada, de lo contrario estará en la cabecera From cabecera. Puede utilizar los siguientes Numbers como ID de llamada:

  • Un número de Vonage asociado a tu Account sin limitación de llamadas salientes (consulta el campo Limitaciones en Comprar Numbers o consulte con el servicio de asistencia).
  • Un número de no-Vonage tras facilitar la información requerida sobre la prueba de propiedad. Sujeto a restricciones geográficas, contacto Asistencia para registrar su número como Verified Caller ID.
  • Identificador de llamadas original de la parte que llama a tu número de Vonage (sólo aplicable para el tipo de terminal telefónico). Esto es útil para el desvío de llamadas o el seguimiento de llamadas. Por ejemplo, cuando recibes una llamada de 15551111111 a tu número de Vonage 15552222222puede realizar una llamada saliente con acción de conexión a un número 15553333333 utilizando el identificador de llamadas original 15551111111 como número de origen.

Nota: Esta función sólo es compatible con llamadas nacionales, es decir, los tres números deben estar en el mismo país y no estar sujetos a restricciones impuestas por las autoridades reguladoras locales.

Cualquier otro número utilizado como identificador de llamadas provocará el bloqueo de la llamada.

Identificador de llamadas entrantes

Para utilizar un número que hayas alquilado a Vonage con tu aplicación de voz, debes vincular ese número a la aplicación a través de la opción Cuadro de mandos en la página de Aplicaciones, o utilizando el botón API de Numbers. Para SIP Trunking, debe vincular el número a su dominio SIP a través de la opción Panel SIP. Puede vincular varios números a la misma aplicación, y el número al que se llamó se pasará a su answer_url en el to o en el parámetro To en SIP INVITE para SIP Trunking.

Al recibir una llamada, el identificador de llamada se enviará en el Respuesta webhook como el from o como From en la cabecera SIP INVITE para SIP Trunking.

{
  "from": "442079460000",
  "to": "447700900000",
  "uuid": "aaaaaaaa-bbbb-cccc-dddd-0123456789ab",
  "conversation_uuid": "CON-aaaaaaaa-bbbb-cccc-dddd-0123456789ab"
}

Vonage intenta presentarte el identificador de llamadas de la persona que llama a tu aplicación de Vonage en formato internacional. Sin embargo, ocasionalmente, la red de origen puede darle un formato incorrecto. Vonage pasa el número recibido del proveedor de números. Puedes obtener más información sobre el identificador de llamadas entrantes en nuestro resumen de las funciones de voz en la base de conocimientos de Vonage.