Numbers

Numbers son un concepto clave que hay que comprender al trabajar con la Voice API de Vonage. Antes de desarrollar tu aplicación de Vonage, debes tener en cuenta los siguientes puntos.

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 contengan 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 sabes cómo dar formato al número, el Number Insight API se puede utilizar 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 Numbers tanto de «telefónica fija» como de «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 llamada es el from valor en el Hacer una llamada API o conectar acciones para la Voice API. También se puede encontrar en el SIP INVITE para SIP Trunking; estará en el PAI encabezado, si se ha establecido; de lo contrario, aparecerá en el 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 que no sea de Vonage tras facilitar la información necesaria que acredite la titularidad. Sujeto a restricciones geográficas, contacto Asistencia para que tu número quede registrado como «Identificador de llamada verificado».
  • Identificador de llamada original de la persona que llama a tu número de Vonage (solo aplicable al tipo de terminal telefónico). Esto resulta útil en casos de desvío de llamadas o 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 tu 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 Panel de control en la página de Aplicaciones, o utilizando el botón API de Numbers. En el caso de SIP Trunking, debes vincular el número a tu dominio SIP a través de la Panel SIP. Puedes vincular varios números a la misma aplicación, y el número al que se haya llamado se transmitirá a tu 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 campo, o como From encabezado en el 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 página de la base de conocimientos de Vonage.