SIP programmable

Vue d'ensemble

Le SIP programmable de Vonage vous permet d'intégrer votre infrastructure SIP existante à la puissante plateforme de communications conversationnelles de Vonage. Cette intégration vous permettra de vous connecter à des points d'extrémité mobiles, terrestres, SIP et WebRTC avec un minimum de travail, notamment des navigateurs et des applications mobiles. Elle apportera également à votre plateforme des fonctionnalités Voice API, telles que l'enregistrement multicanal, le SVI, la synthèse vocale, la connectivité WebSocket pour les intégrations AI, et la puissance des conversations contextuelles.

SIP Connect Workflow

Domaines SIP de Vonage

A Domaine SIP de Vonage contient la configuration dont vous avez besoin pour vous connecter aux terminaux SIP de Vonage et établir un lien avec votre application Vonage.

Pour acheminer un appel SIP vers votre application Vonage, vous devez créer un domaine Vonage unique, tel que yourcompany. Le nom de domaine formera l'URI SIP, par exemple sip:number@yourcompany.sip-us.vonage.comet tous les appels acheminés vers cet URI SIP seront acheminés vers votre application NCCO answer_url.

La méthode d'authentification sera déterminée dans votre configuration du domaine Vonage. Vonage authentifiera la demande et la transmettra à votre application.

Quelques exemples de domaines :

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

Applications vocales

Pour pouvoir utiliser le SIP programmable, vous devez créer un compte de messagerie vocale Vonage Applications et notez l'ID de l'Application.

Authentification - Listes de contrôle d'accès

Vous pouvez configurer une liste de contrôle d'accès pour votre domaine afin que votre application Vonage n'accepte que les appels provenant de terminaux et d'appareils spécifiques. Pour ce faire, ajoutez leurs adresses IP à une liste d'autorisation.

L'API SIP programmable

Pour provisionner un domaine, vous pouvez utiliser l'API SIP programmable. L'objet JSON utilisé pour provisionner un nouveau domaine a le format suivant :

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

name doit être le nom de domaine souhaité, par exemple yourcompany, application_id est l'identifiant de l'application Vonage, par exemple c49f3586-9c3c-458b-89fc-3c8beb58865f. acl est une liste d'adresses IP en notation CIDR comme 180.180.180.180/30 et/ou une seule adresse IP 190.190.190.190.

Un exemple de JSON pourrait donc être le suivant :

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

Une description complète de l'API est disponible sur le site Web de la Commission européenne. Référence API.

Routage par domaine

Les appels effectués vers un domaine SIP programmable doivent être traités au niveau régional. Vous devez utiliser un Request URI avec un domaine régional. Sachez qu'un Request URI sans composant régional dans le domaine fera échouer l'appel.

Le code suivant indiquera à Vonage que vous souhaitez que cet appel SIP soit traité dans l'UE :

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

Les domaines disponibles sont les mêmes que les enregistrements A :

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

En-têtes SIP personnalisés

Vous pouvez spécifier tout en-tête supplémentaire dont vous avez besoin lors de l'envoi d'une requête SIP. Tous les en-têtes fournis doivent commencer par X- et sera envoyé à votre answer_url avec un préfixe de SipHeader_. Par exemple, si vous ajoutez un en-tête de X-UserId avec une valeur de 1938ND9Vonage ajoutera SipHeader_X-UserId=1938ND9 à la demande faite à votre answer_url.

ATTENTION : Les en-têtes qui commencent par X-Nexmo ne sont pas envoyées à votre answer_url.

Recevoir des appels de Vonage

Vous pouvez utiliser la Voice API NCCO connect pour connecter un appel à vos terminaux SIP.

Vous pouvez également envoyer des en-têtes SIP personnalisés à vos points d'extrémité SIP à l'aide de l'API Voice NCCO connect action.

La documentation détaillée est ici.

SIP Connect

La prise en charge de la fonction SIP Connect se poursuivra et vous pourrez composer votre numéro virtuel via votre point d'extrémité SIP qui est attaché à votre application. Authentification Digest est la méthode d'authentification acceptée pour SIP Connect.

Pour tester cette fonctionnalité, demandez à votre PBX de renvoyer les appels vers sip-us.vonage.com. Voici un exemple de cette opération avec une extension Asterisk, transmettant un en-tête personnalisé qui sera envoyé à votre answer_url:

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

Plus d'informations