SIP programável

Visão geral

O SIP Programável da Vonage permite que você integre sua infraestrutura SIP existente à poderosa plataforma de comunicações conversacionais da Vonage. Essa integração permitirá que você se conecte a terminais móveis, fixos, SIP e WebRTC com o mínimo de esforço, incluindo navegadores e aplicativos móveis. Ela também trará para a sua plataforma funcionalidades da Voice API, como gravação multicanal, IVR, conversão de texto em fala, conectividade WebSocket para integrações de IA e o poder das conversas contextuais.

SIP Connect Workflow

Domínios SIP da Vonage

A Domínio SIP da Vonage contém a configuração necessária para se conectar aos terminais SIP da Vonage e vinculá-los ao seu aplicativo da Vonage.

Para encaminhar uma chamada SIP para o seu aplicativo da Vonage, você precisa criar um domínio exclusivo da Vonage, como, por exemplo, yourcompany. O nome de domínio formará o URI SIP, por exemplo sip:number@yourcompany.sip-us.vonage.com, e todas as chamadas encaminhadas para esse URI SIP serão encaminhadas para o seu aplicativo NCCO answer_url.

O método de autenticação será definido na configuração do domínio da Vonage. A Vonage autenticará a solicitação e a encaminhará para o seu aplicativo.

Alguns exemplos de domínios:

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

Aplicativo de voz

Para poder usar o SIP programável, você precisará criar um Vonage com funcionalidade de voz Applications Primeiro, anote o ID do aplicativo.

Autenticação - Listas de Controle de Acesso

Você pode configurar uma Lista de Controle de Acesso para o seu domínio, de modo que seu aplicativo da Vonage só aceite chamadas de terminais e dispositivos específicos. Para isso, basta adicionar os endereços IP desses terminais e dispositivos a uma lista de permissões.

A API SIP programável

Para configurar um domínio, você pode usar a API SIP programável. O objeto JSON utilizado para configurar um novo domínio tem o seguinte formato:

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

name deveria ser o nome de domínio desejado, por exemplo: yourcompany, application_id é o ID do aplicativo da Vonage, por exemplo c49f3586-9c3c-458b-89fc-3c8beb58865f. acl é uma lista de endereços IP na notação CIDR, como 180.180.180.180/30 e/ou um único endereço IP 190.190.190.190.

Um exemplo de JSON poderia ser, portanto:

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

Uma descrição completa da API está disponível no Referência da API.

Roteamento Baseado em Domínio

As chamadas feitas para um domínio SIP programável devem ser tratadas em nível regional. É necessário utilizar um URI de solicitação com um domínio regional. Esteja ciente de que um URI de solicitação sem um componente regional no domínio resultará na falha da chamada.

O código a seguir indicará à Vonage que você deseja que essa chamada SIP seja processada na UE:

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

Os domínios disponíveis são os mesmos dos registros A:

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

Cabeçalhos SIP personalizados

Você pode especificar quaisquer cabeçalhos adicionais necessários ao enviar uma solicitação SIP. Todos os cabeçalhos fornecidos devem começar com X- e será enviado para o seu answer_url com o prefixo SipHeader_. Por exemplo, se você adicionar um cabeçalho com o texto X-UserId com um valor de 1938ND9, a Vonage irá adicionar SipHeader_X-UserId=1938ND9 em resposta ao pedido feito ao seu answer_url.

ATENÇÃO: Cabeçalhos que começam com X-Nexmo não são enviadas para o seu answer_url.

Recebendo chamadas da Vonage

Você pode usar a Voice API NCCO connect ação para conectar uma chamada aos seus terminais SIP.

Você também pode enviar cabeçalhos SIP personalizados para seus terminais SIP usando a Voice API NCCO connect ação.

A documentação detalhada está aqui.

SIP Connect

O suporte ao recurso SIP Connect continuará, permitindo que você disque para o seu número virtual por meio do seu terminal SIP conectado ao seu aplicativo. Autenticação por hash é o método de autenticação aceito para o SIP Connect.

Para testar essa funcionalidade, configure seu PBX para encaminhar as chamadas para sip-us.vonage.com. Aqui está um exemplo de como fazer isso com uma extensão do Asterisk, transmitindo um cabeçalho personalizado que será enviado para o seu answer_url:

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

Mais informações