SIP programable

Visión general

El SIP programable de Vonage te permite integrar tu infraestructura SIP existente con la poderosa plataforma de comunicaciones conversacionales de Vonage. Esta integración te permitirá conectarte a puntos finales móviles, de telefonía fija, SIP y WebRTC con un trabajo mínimo, incluidos navegadores y aplicaciones móviles. También brindará a tu plataforma la funcionalidad de Voice API, como grabación multicanal, IVR, texto a voz, conectividad WebSocket para integraciones AI y el poder de las conversaciones contextuales.

SIP Connect Workflow

Dominios SIP de Vonage

A Dominio SIP de Vonage contiene la configuración necesaria para conectarte a los terminales SIP de Vonage y vincularlos a tu aplicación de Vonage.

Para desviar una llamada SIP a tu aplicación de Vonage, debes crear un dominio único de Vonage, como por ejemplo yourcompany. El nombre de dominio formará parte del URI SIP; por ejemplo, sip:number@yourcompany.sip-us.vonage.com, y todas las llamadas dirigidas a ese URI SIP se redirigirán a tu aplicación NCCO answer_url.

El método de autenticación se determinará en la configuración de tu dominio de Vonage. Vonage autenticará la solicitud y la reenviará a tu aplicación.

Algunos dominios de ejemplo:

yourcompany.sip-eu.vonage.com
98765@yourcompany.sip-us.vonage.com
12345@yourcompany.sip-ap.vonage.com

Aplicaciones de voz

Para poder utilizar SIP programable, deberás crear una cuenta de Vonage habilitada para voz. Aplicaciones primero y tome nota del ID de la solicitud.

Autenticación: listas de control de acceso

Puedes configurar una lista de control de acceso para tu dominio, de modo que tu aplicación de Vonage solo acepte llamadas procedentes de terminales y dispositivos específicos. Para ello, debes añadir sus direcciones IP a una lista de permitidos.

La API SIP programable

Para aprovisionar un dominio puede utilizar la API SIP programable. El objeto JSON utilizado para aprovisionar un nuevo dominio tiene el siguiente formato:

{
  "name": "yourcompany",
  "application_id": "app_id",
  "acl": [
    "xxx.xxx.xxx.xxx/xx", "yyy.yyy.yyy.yyy"
  ]
}

name debe ser el nombre de dominio deseado, por ejemplo yourcompany, application_id es el identificador de la aplicación de Vonage; por ejemplo, c49f3586-9c3c-458b-89fc-3c8beb58865f. acl es una lista de direcciones IP en notación CIDR como 180.180.180.180/30 y/o dirección IP única 190.190.190.190.

Un ejemplo de JSON podría ser, por tanto:

{
  "name": "yourcompany",
  "application_id": "c49f3586-9c3c-458b-89fc-3c8beb58865f",
  "acl": ["180.180.180.180/30", "190.190.190.190"]
}

Encontrará una descripción completa de la API en la página Referencia API.

Enrutamiento basado en dominios

Las llamadas realizadas a un dominio SIP programable deben gestionarse a nivel regional. Debe utilizar un Request URI con un dominio regional. Tenga en cuenta que un Request URI sin un componente regional en el dominio fallará la llamada.

El siguiente código indicará a Vonage que deseas que esta llamada SIP se gestione en la UE:

sip:number@yourcompany.sip-eu.vonage.com

Los dominios disponibles son los mismos que los registros A:

sip-us.vonage.com: USA
sip-eu.vonage.com: Europe
sip-ap.vonage.com: Asia Pacific

Cabeceras SIP personalizadas

Puedes especificar cualquier encabezado adicional que necesites al enviar una solicitud SIP. Todos los encabezados que se incluyan deben comenzar por X- y se enviará a su answer_url con el prefijo SipHeader_. Por ejemplo, si añades un encabezado de X-UserId con un valor de 1938ND9, Vonage añadirá SipHeader_X-UserId=1938ND9 a la solicitud realizada a su answer_url.

PRECAUCIÓN: Los encabezados que empiezan por X-Nexmo no se envían a su answer_url.

Recibir llamadas de Vonage

Puedes utilizar la Voice API NCCO connect para conectar una llamada a sus terminales SIP.

También puedes enviar encabezados SIP personalizados a tus terminales SIP mediante la Voice API NCCO. connect acción.

La documentación detallada es aquí.

Conexión SIP

Se mantendrá la compatibilidad con la función SIP Connect, que te permite marcar tu número virtual a través del terminal SIP asociado a tu aplicación. Autenticación Digest es el método de autenticación aceptado para SIP Connect.

Para probar esta funcionalidad, haga que su centralita desvíe las llamadas a sip-us.vonage.com. He aquí un ejemplo de cómo hacerlo con una extensión de Asterisk, transmitiendo una cabecera personalizada que se enviará a su answer_url:

exten => 69100,1,SIPAddHeader(X-UserId:ABC123)
exten => 69100,2,Dial(SIP/nexmo/14155550100)

Para más información