Registro SIP

O que é Registro SIP?

Os endpoints SIP são identificados por seu Endereço de registro (AOR). O AOR é um nome de alto nível atribuído a uma entidade SIP sem considerar o dispositivo ou dispositivos que os nomes podem usar. O formato para um AOR é o seguinte:

sip:user@domain

Os endpoints SIP podem ser acessados por meio de sua localização, que é identificada por um endereço IP, número de porta e protocolo. Para receber chamadas, o autor da chamada precisa saber a localização do computador, para que a chamada entre os dois endpoints possa ser conectada. Como a maioria dos endpoints SIP não tem um endereço IP permanente, fixo e acessível publicamente, eles precisarão se registrar em um servidor central, ou Registrador, para que possam receber chamadas.

Registro SIP é o processo de vinculação do AOR de um endpoint com sua localização. O endpoint SIP envia uma solicitação SIP REGISTER para um Registrador, contendo seu AOR, local, autenticação e outras informações na mensagem. O registrador valida a solicitação e, se permitido, armazena a vinculação associada no serviço de localização do domínio que ele manipula. Em seguida, o registrador atua como o front‐end do serviço de localização para um domínio SIP, mantendo as vinculações de localização de seus endpoints.

Seu domínio SIP de Programmable Voice da Twilio permite registrar dinamicamente seu endpoint SIP com a Twilio, para que você possa fazer e receber chamadas globalmente. Você pode usar esse recurso ativando a opção SIP Registration (Registro SIP) em seu domínio SIP.

Saiba como:

Registrar seu endpoint SIP
Fazer chamadas com seu endpoint SIP registrado
Receber chamadas em seu endpoint SIP registrado
Configurar seu endpoint SIP

Registrar seu endpoint SIP

O Registrador SIP da Twilio é implantado por Locais de borda. As vinculações armazenadas no Registrador SIP são compartilhadas entre locais de borda, de modo que seus endpoints registrados localmente (aqueles registrados com um local de borda especificado) sejam globalmente alcançáveis. Você pode se registrar em qualquer local de borda, mas normalmente se registraria no local de borda que está fisicamente mais próximo do local do dispositivo, pois isso proporcionará o melhor desempenho e qualidade, devido à redução da latência, jitter e perda de pacote. Você também pode alternar entre locais de borda se desejar, por failover, alteração de locais ou outros motivos.

Ao configurar seu dispositivo SIP, você especifica o URI do domínio SIP, incluindo o local de borda da Twilio com o qual deseja se registrar.

{domain-name}.sip.{edge-location}.twilio.com

Se você não especificar um local de borda no URI de registro ou no URI de proxy de saída, o registro assumirá como padrão o datacenter Ashburn, VA, EUA da Twilio.

Seu dispositivo SIP pode incluir opções de configuração para um domínio de registro e um proxy de saída. Se esse for o caso, sugerimos o uso do URI de localização de borda da Twilio para o proxy de saída e do URI de domínio SIP para o domínio de registro.

Por exemplo, se o seu domínio fosse chamado mydomain e você quisesse se registrar em nossa borda de Sydney, você configuraria o seu dispositivo da seguinte maneira:

Domínio de registro: mydomain.sip.twilio.com
Proxy de saída: sip.sydney.twilio.com

Se o seu dispositivo SIP não usar um Proxy de saída em sua configuração, você deverá usar o URI completo mydomain.sip.sydney.twilio.com como o Domínio de registro.

Autenticação de registro de endpoint SIP

Sua solicitação REGISTER será autenticada em relação às Listas de credenciais do usuário que foram mapeadas para este domínio SIP.

O Nome de usuário configurado no endpoint SIP deve corresponder exatamente a um Nome de usuário especificado em uma Lista de credenciais mapeada para este domínio SIP para um registro bem‐sucedido. Alguns endpoints SIP referem‐se a este campo como o Nome de usuário, enquanto outros o chamam de ID de autorização ou o ID de autenticação. A senha ou o segredo usado deve corresponder à senha definida para a mesma credencial.

Intervalos de expiração e atualização do REGISTER de endpoint SIP

O endpoint SIP precisa ser registrado novamente em intervalos periódicos, caso contrário, o registro expirará e será removido do serviço de localização. Isso é comumente configurado usando parâmetros chamados Expiration (Expiração) e/ou Refresh Intervals (Intervalos de atualização), ou similar, na maioria dos endpoints SIP. Esses parâmetros e seus valores padrão variam de acordo com o dispositivo.

Você pode reduzir esses intervalos para um valor mais baixo do que os padrões por motivos de resiliência. O menor valor de expiração de registro que um endpoint SIP pode usar ao se registrar na Twilio é de 600 segundos (10 minutos). Se você definir um valor menor, o REGISTER falhará com um erro SIP "423 Interval too brief". O maior valor de expiração de registro que a Twilio permitirá é de uma hora (3600 segundos). Qualquer valor solicitado maior que esse valor será reduzido para uma hora como parte da negociação do REGISTER.

Além disso, você desejará definir um intervalo de Refresh (Atualização) para ocorrer antes do intervalo de Expiration (Expiração) definido ou correrá o risco de o registro do endpoint SIP expirar. Você deve definir isso como um valor menor que a Expiration (Expiração) definida. Uma configuração típica é metade do valor. Por exemplo, se você definir sua Expiration (Expiração) como 600 segundos, você definirá sua Refresh (Atualização) como algo como 300 segundos.

Se o seu dispositivo tiver apenas um parâmetro para cobrir ambas as configurações, isso normalmente será tratado como uma configuração de Expiration (Expiração), e a configuração de Refresh (Atualização) será automaticamente deduzida para ser inferior a esse valor para impedir que o registro expire.

Limites

Certifique‐se de estar ciente dos seguintes limites de Registro SIP de Programmable Voice.

Há um máximo de 100 domínios SIP permitidos por conta.
Há um máximo de 10 registros de endpoint ativos permitidos por Endereço de registro (AOR); a 11a tentativa de ativação de registro para o mesmo AOR será rejeitada.
Há um máximo de 100 Listas de credenciais permitidas por domínio SIP, com um máximo de 1000 usuários por lista.
O número máximo de registros de endpoints ativos permitidos por domínio SIP é baseado em uma combinação de máximo de Listas de credenciais por domínio, máximo de usuários da Lista de credenciais por lista e máximo de registros de endpoints ativos por limites AOR. Se todas as configurações forem maximizadas, serão permitidos 1 milhão de registros de endpoints ativos por domínio SIP.
O número máximo de registros de endpoints ativos permitidos por conta é baseado na combinação de máximo de domínios SIP por conta, máximo de listas de credenciais por domínio, máximo de usuários da lista de credenciais por lista e máximo de registros de endpoints ativos por limites AOR. Se todas as configurações forem maximizadas, serão permitidos 100 milhões de registros de endpoints ativos por conta.

Receber chamadas em seu endpoint SIP registrado

Para que seu endpoint SIP receba chamadas da Twilio, você usará os mesmos métodos de chamada do TwiML ou da API REST que usa atualmente. Consulte recebendo SIP da Twilio para obter detalhes sobre API REST e & TwiML.

Chamar um endpoint SIP registrado funciona da mesma forma que chamar qualquer outro URI SIP, apenas você estará usando o AOR de seu endpoint SIP registrado. Lembre‐se de que as chamadas precisam ser iniciadas pelo seu aplicativo, assim como qualquer outra chamada SIP de Programmable Voice.

Ao chamar seu endpoint SIP registrado, você deve usar o URI do domínio SIP geral, omitindo o local de borda do URI, ou seja:

{username}@{domain-name}.sip.twilio.com

Por exemplo, você pode comprar um número de telefone da Twilio e, quando esse número for chamado, ele tocará seus endpoints SIP

Etapas:

Compre um número de telefone da Twilio no código de país/área desejado. O número deve ser provisionado na mesma (subconta) que o domínio SIP habilitado para Registro
Crie um TwiML Bin com o seguinte. Substitua myusername e mysipdomain pelas suas informações.

<Response>
  <Dial>
    <Sip>myusername@mysipdomain.sip.twilio.com</Sip>
  </Dial>
</Response>

myusername e mysipdomain no exemplo do TwiML acima devem corresponder ao nome de usuário e ao nome de domínio usados para registrar seu endpoint SIP. Se o dispositivo não estiver registrado ativamente, a chamada não será concluída e você receberá um alerta do debugger.

Ao chamar um SIP AOR registrado, a Twilio chamará todos os endpoints SIP registrados usando esse AOR em paralelo em todos os locais de borda, o que significa que todos esses endpoints tocarão simultaneamente. Por exemplo, se você registrar os endpoints maria@mysipdomain.sip.sydney.twilio.com, maria@mysipdomain.sip.tokyo.twilio.com e maria@mysipdomain.sip.singapore.twilio.com, uma chamada para maria@mysipdomain.sip.twilio.com enviará a chamada para cada um dos locais de borda e todos os três endpoints tocarão simultaneamente.

Para compatibilidade com versões anteriores, as regiões us1 e us1-ix ainda são permitidas, mas somente ao chamar endpoints SIP especificamente registrados no datacenter Ashburn, VA, EUA (pela Internet pública ou Twilio Interconnect, respectivamente). Qualquer outra região ou borda especificada ao chamar um endpoint SIP registrado retornará um erro. É altamente recomendável que você ajuste qualquer código legado para que não use mais o domínio regional ao chamar um endpoint SIP registrado.

Fazer chamadas com seu endpoint SIP registrado

As chamadas SIP de seu Endpoint registrado para seu domínio SIP da Twilio são tratadas como qualquer chamada SIP recebida nesse domínio. Depois que o INVITE for autenticado, a Twilio chamará o URL do Voice configurado no domínio SIP. Consulte enviar SIP para Twilio para obter detalhes.

Normalmente, seu endpoint SIP enviaria seus INVITEs para o domínio específico de borda com o qual ele se registrou, mas eles podem ser enviados para qualquer local de borda da Twilio:

{domain-name}.sip.{edge-location}.twilio.com

Testar a conectividade do endpoint SIP do Voice com seu domínio SIP

Por exemplo, você pode configurar o URL do domínio SIP do Voice com o seguinte para verificar a conectividade com a Twilio. É um aplicativo simples que enviará uma mensagem breve e reproduzirá algumas músicas.

http://demo.twilio.com/docs/voice.xml

Como fazer chamadas do endpoint SIP para a rede telefônica pública

Nesta seção, resumimos algumas maneiras diferentes de fazer a ponte de chamadas de seu endpoint SIP registrado para a rede telefônica pública usando Programmable Voice.

Usar modelos de TwiML Bin aprimorados para chamar um celular/telefone fixo na rede telefônica pública

A Twilio tem modelos de TwiML Bins aprimorados que extraem o nome de usuário dos URI SIP From (De) e To (Para) no SIP INVITE no trecho da chamada principal que pode ser usado para criar uma resposta dinâmica do TwiML.

O exemplo abaixo mostra como o campo To (Para) do trecho de chamada principal é preenchido com o nome de usuário do campo To (Para) do SIP INVITEs do trecho de chamada principal.

<Response>
  <Dial callerId="+14087998994">{{#e164}}{{To}}{{/e164}}</Dial>
</Response>

Observação 1: Ao discar um número usando seu endpoint SIP, ele deve estar em E.164. (como +14157012311 ou +441562720212) A ferramenta Twilio Lookup é útil para determinar formatos internacionais E.164.

Observação 2: O callerId deve ser um número verificado no Console da Twilio.

O próximo exemplo leva um passo adiante definindo dinamicamente o callerId com base no autor da chamada de endpoint SIP. Como no exemplo anterior, o autor da chamada deve estar no formato E.164 e deve ser verificado no Console da Twilio.

<Response>
  <Dial callerId="{{#e164}}{{From}}{{/e164}}">{{#e164}}{{To}}{{/e164}}</Dial>
</Response>

O campo From (De) acima corresponde ao nome de usuário do URI SIP encontrado no campo From (De) no SIP INVITE. Esse nome de usuário também corresponde ao nome de usuário que o endpoint SIP usa para autenticar‐se que deve ser configurado na Lista de credenciais de Registro SIP no Console.

Configurar seu endpoint SIP

A Twilio oferece suporte ao Registro SIP padrão. A seção abaixo inclui exemplos de guias de configuração para ajudá‐lo a começar. Pode haver endpoints SIP que não se comportam de acordo com o padrão e que não são compatíveis.

Os seguintes guias de configuração destinam-se a ajudar você a conectar seus endpoints SIP a Twilio.

Esteja ciente de que, devido ao grande número de versões, variações, complementos e opções para muitos desses sistemas, as configurações que você vê podem ser diferentes daquelas mostradas em nossos Guias de configuração. Como tal, esses documentos destinam-se a ser diretrizes gerais, em vez de modelos de configuração. Presumimos que você esteja familiarizado com sua rede, infraestrutura SIP e como eles funcionam.

A Twilio não pode fornecer suporte direto para produtos de terceiros. Você deve entrar em contato com o fabricante do endpoint SIP para obter assistência na configuração de tais produtos.

Se você deseja compartilhar seu guia de configuração de endpoint SIP para nos ajudar a melhorar esta seção para outros usuários, envie-os ou quaisquer correções para os guias existentes para sip.interconnectionguides@twilio.com.

A Twilio oferece suporte ao Registro SIP padrão. A seção abaixo inclui exemplos de guias de configuração para ajudá-lo a começar. Pode haver endpoints SIP que não se comportam de acordo com o padrão e que não são compatíveis.

Precisa de ajuda?

Às vezes, todos nós precisamos; a programação é difícil. Receba ajuda agora da nossa equipe de suporte, ou confie na sabedoria da multidão navegando pelo Stack Overflow Collective da Twilio ou buscando a tag Twilio no Stack Overflow.

Precisa de ajuda?

Obrigado pelo seu feedback!

Obrigado pelo seu feedback!