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 que necesitas para conectarte a los puntos finales SIP de Vonage y vincularte a tu aplicación de Vonage.

Para enrutar 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á el URI SIP, por ejemplo sip:number@yourcompany.sip-us.vonage.comy cualquier llamada enrutada a ese SIP URI será enrutada a su aplicación NCCO answer_url.

El método de autenticación se determinará dentro de tu configuración del 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 sólo acepte llamadas de terminales y dispositivos específicos. Para ello, agrega sus direcciones IP a una lista permitida.

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

{
  "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

Puede especificar cualquier cabecera adicional que necesite cuando envíe una petición SIP. Cualquier cabecera proporcionada debe empezar por X- y se enviará a su answer_url con el prefijo SipHeader_. Por ejemplo, si añade una cabecera de X-UserId con un valor de 1938ND9Vonage añadirá SipHeader_X-UserId=1938ND9 a la solicitud realizada a su answer_url.

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

Recibir llamadas de Vonage

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

También puede enviar cabeceras SIP personalizadas a sus puntos finales SIP utilizando la Voice API NCCO connect acción.

La documentación detallada es aquí.

Conexión SIP

Continuará el soporte de la función SIP Connect, donde podrá marcar su número virtual a través de su punto final SIP que está conectado a su 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