You are viewing the Portuguese (Brazil) site, but your language preference is set to English. Switch to English site →

Menu

Expand
Classifique esta página:

Elastic SIP Trunking

Conecte-se à infraestrutura de comunicações de IP:

Documentação da API REST:

Requirements (Requisitos)

Para usar o Elastic SIP Trunking da Twilio, é preciso verificar se você tem o seguinte:

  • Um elemento de rede habilitado para SIP (por exemplo, Session Border Controller, Servidor de chamadas SIP, IP-PBX, SIP-PRI IAD etc.) com acesso à internet.
  • Largura de banda suficiente para suportar o tráfego de chamadas de pico. A largura de banda de pico pode ser determinada por:

    • Largura de banda de pico do SIP Trunk = Máx. de chamadas simultâneas x 100 kbps

    O valor de 100 kbps reflete a largura de banda necessária para o codec G711 mais espaço suficiente para sobrecarga.

Dashboard (Painel)

Faça login no console e vá para a seção "Elastic SIP Trunking". Seu Painel será exibido e fornecerá uma visão geral de alto nível do uso do Trunking: Minutos, chamadas & custo.

No menu de navegação à esquerda, você verá links para:

  • Visão geral: Comece aqui, revise documentos de tutorial ou acesse preços & recursos.
  • Manage (Gerenciar): Acesso ao Trunks, listas de controle de acesso de IP, listas de credenciais ou informações de rede.

Manage (Gerenciar)

No menu "Manage" (Gerenciar), você terá acesso a todos os aspectos de configuração do seu Trunks. Especificamente, você verá links para:

  • Trunks (Troncos): lista dos SIP Trunks existentes. Criar, excluir e configurar seus troncos.
  • IP Access Control Lists (Listas de controle de acesso de IP): Gerenciar suas listas de controle de acesso de IP (um conjunto de IPs que podem acessar seu domínio SIP).
  • Credential Lists (Lista de credenciais): Gerenciar suas credenciais de usuário (um conjunto de nomes de usuário e senhas que podem acessar seu domínio SIP).
  • Networking Info (Informações de rede): Informações importantes sobre a plataforma da Twilio que você precisará para configurar a infraestrutura de comunicações.

Trunks (Troncos)

O Elastic SIP Trunking da Twilio é uma solução baseada em nuvem que fornece conectividade para infraestrutura de comunicações baseada em IP para se conectar à RPTC, para fazer e receber chamadas telefônicas para o "resto do mundo" com qualquer conexão de banda larga.

Um tronco é composto das seguintes configurações:

Diagrama do Elastic SIP Trunking

  • General (Geral): Forneça um nome fácil para o tronco e veja o identificador exclusivo (Trunk SID).
  • Termination (Terminação): Defina as configurações para colocar o tráfego de saída de sua infraestrutura de comunicações na RPTC.
  • Origination: Defina as configurações para receber tráfego de entrada em seus números Twilio para entregar chamadas à sua infraestrutura de comunicações a partir da RPTC.
  • Números: Permite associar números a um determinado tronco e ver todos os números atualmente associados a um tronco.

No item da barra de navegação [Trunks] (Troncos), você poderá visualizar uma lista completa de seus Elastic SIP Trunks e clicar em cada um para modificar a configuração. Você também poderá excluir um determinado tronco dessa exibição.

Create a Trunk (Criar um tronco)

Na barra de navegação [Trunks] (Troncos) clique em "Create New Trunk" (Criar novo tronco) para criar um novo tronco. Isso também pode ser feito a partir dos [Getting Started] (Primeiros passos).

General settings (Configurações gerais)

Essas configurações se aplicam a todo o tronco, independentemente da direção do seu tráfego.

Friendly Name (Nome amigável)

Forneça um nome fácil para o tronco.

Trunk SID

Este é o identificador exclusivo desse tronco e é atribuído automaticamente quando você cria um tronco.

Call Recording (Gravação de chamadas)

Nessa lista suspensa, você pode ativar a gravação de chamadas para o tronco em questão. Quando ativada, todas as chamadas são gravadas (tráfego de origem e terminação), em um modelo de pagamento por utilização. As opções de gravação para um único canal ou canais duplos podem ser selecionadas. A configuração padrão de um tronco é "Do Not Record" (Não registrar). Você pode selecionar:

  • Do Not Record (Não gravar): A gravação está desabilitada neste tronco.
  • Record from ringing (Gravação a partir do toque sonoro): A gravação começará quando o toque começar a soar.
  • Record from answer (Gravação a partir da resposta): A gravação começará quando uma chamada for atendida.
  • Dual Record from ringing (Gravação dupla a partir do toque sonoro): A gravação começará quando o toque começa a soar e as duas faixas serão visualizadas separadamente.
  • Dual Record from answer (Gravação dupla a partir da resposta): A gravação começará quando uma chamada for atendida e as duas faixas serão visualizadas separadamente.
  • Recording Trim (Corte de gravação): Se ativado, o silêncio será cortado da gravação. Se desativado, o silêncio não será cortado da gravação.

Duração da chamada estendida

A Twilio estendeu a duração máxima da chamadas de Elastic SIP Trunking de 4 para 24 horas. Isso permite que a empresa tenha conversas prolongadas que duram mais de 4 horas. Veja os detalhes aqui.

Secure Trunking (Tronco telefônico seguro)

A criptografia garante que a mídia da chamada e a sinalização associada permaneçam privadas durante a transmissão. O protocolo TLS (Transport Layer Security, segurança da camada de transporte) fornece criptografia para sinalização SIP, e o SRTP (Secure Real-time Transport Protocol, protocolo de transporte seguro em tempo real) fornece criptografia para conteúdo de chamada/pacotes de mídia. Saiba como habilitar e solucionar problemas de TLS neste blog.

O protocolo TLS foi projetado para estabelecer uma conexão segura entre um cliente e um servidor que se comunicam por meio de um canal inseguro. O RFC 5246, o protocolo TLS (Transport Layer Security, segurança da camada de transporte) versão 1.2, especifica a versão 1.2 do protocolo TLS.

Especificações de TLS:

  • Versões de TLS compatíveis: TLSv1.0, TLSv1.1 e TLSv1.2.
  • Cifras compatíveis: ECDHE-ECDSA-AES128-GCM-SHA256,ECDHE-RSA-AES128-GCM-SHA256,ECDHE-ECDSA-AES128-SHA256,ECDHE-RSA-AES128-SHA256,ECDHE-ECDSA-AES256-GCM-SHA384,ECDHE-RSA-AES256-GCM-SHA384,ECDHE-ECDSA-AES256-SHA384,ECDHE-RSA-AES256-SHA384,AES128-GCM-SHA256,AES128-SHA256,AES128-SHA,AES256-GCM-SHA384,AES256-SHA256,AES256-SHA

OBSERVAÇÃO: A Twilio recomenda fortemente o uso da versão 1.2 do TLS

SRTP fornece uma estrutura para a criptografia do RTP & RTCP. O RFC 4568, SDES (Session Description Protocol Security Descriptions, descrições de segurança para o protocolo de descrição de sessão) do SDP (Session Description Protocol, protocolo de descrição da sessão) para fluxos de mídia, define esse protocolo especificamente projetado para trocar material criptográfico usando um atributo de criptografia SDP recém-definido.

Especificações de SRTP:

  • Trunking Origination (Origem de tronco telefônico): somente um único conjunto de criptografia é incluído: AES_CM_128_HMAC_SHA1_80
  • Trunking Termination (Terminação de tronco telefônico): Os conjuntos de criptografia compatíveis incluem AES_CM_128_HMAC_SHA1_80 e AES_CM_128_HMAC_SHA1_32. Os dois podem ser incluídos na ordem de preferência.
  • O parâmetro MKI (Master Key Identifier, identificador de chave primária) opcional não é compatível

Quando o Tronco telefônico seguro estiver habilitado, todas as chamadas não criptografadas serão rejeitadas. Certifique-se de configurar o uso de TLS em [Origination Settings][origination] (Origem da configuração)(Origem) incluindo o parâmetro transport=tls. Se o parâmetro de transporte estiver em qualquer um de seus URIs especificando um transporte diferente (por exemplo, transport=udp), ele será ignorado e o TLS será usado. Por padrão, a porta 5061 é usada para TLS. No entanto, você pode especificar a porta que deseja usar no URI de origem.

Importação do Certificado da CA raiz da Twilio

TLS é usado para criptografar a sinalização SIP entre os pontos de extremidade SIP. Para que isso funcione corretamente, é necessário que determinados dispositivos na rede importem um certificado SSL. A Twilio usa certificados de uma CA (Certificate Authority, autoridade de certificação). Você deve adicionar o seguinte certificado raiz à infraestrutura de comunicações para estabelecer a autenticidade dele na rede. Faça download do certificado da CA da Twilio.

É importante observar que a Twilio usa um certificado curinga que pode ser usado para vários subdomínios de um domínio (*.pstn.twilio.com). Se o elemento de rede não for compatível com certificados curinga, desative a validação do certificado.

O suporte para TLS/SRTP com Asterisk

Asterisk é fornecido por padrão com o driver chan_sip e funciona bem com a Twilio. No entanto, se você tiver algum motivo para executar o driver PJSIP com o Asterisk, observe o seguinte:

  • O Asterisk 13.8 cert2 é padronizado para PJSIP 2.5 e não funciona com o Twilio para fins de TLS/SRTP. As chamadas não criptografadas funcionam
  • Asterisk 13.8 cert2 também pode usar o driver PJSIP mais recente, que no momento é o 2.5.5. A Twilio funciona bem com ele, apesar de exibir a seguinte mensagem no log:

PJSIP 2.5.5 outputs the following error but the call is still shown to work (gera o seguinte erro, mas a chamada ainda funciona).

Sep 27 13:03:56] ERROR[10886]: pjproject:0 :     tlsc0x7f217c03 RFC 5922 (section 7.2) does not allow TLS wildcard certificates. Advise your SIP provider, please! 

O link a seguir é o guia de instalação de uma versão não agrupada do PJSIP. Altere a versão para a 2.5.5 nas etapas.

Como instalar o driver de canal PJSIP

Transferência de chamada via SIP REFER

Quando a transferência de chamada estiver habilitada, a Twilio consome um SIP REFER de entrada da infraestrutura de comunicações e cria uma mensagem INVITE (CONVIDAR) para o endereço no cabeçalho Refer-To (Consultar). Acesse aqui para obter mais detalhes.

Media Settings (Configurações de mídia)

Symmetric RTP (RTP simétrico)

Em geral, a infraestrutura de comunicações IP deve usar seu endereço IP público no SDP, e esse será o ÚNICO destino para o qual a Twilio enviará mídia. No entanto, se você estiver passando por um NAT não compatível com SIP, é possível que não saiba seu IP público e seu SDP incluirá seu endereço IP privado, normalmente gerando problemas de áudio unilateral. A Twilio consegue resolver isso travando o fluxo de mídia RTP de entrada e enviando RTP para esse destino com a ativação do RTP simétrico.

Quando o RTP simétrico está ativado, a Twilio detecta a origem do fluxo RTP remoto e começa a enviar RTP para esse destino em vez de enviar para aquele negociado no SDP. Observe que essa configuração é mais vulnerável a ataques ao RTP.

Quando o RTP simétrico está desativado, a Twilio envia o RTP para o destino negociado no SDP. Essa configuração é considerada mais segura e, portanto, recomendada.

Termination Settings (Configurações de terminação)

Definir suas configurações de terminação permitirá que você coloque o tráfego de saída de sua infraestrutura de comunicações para a RPTC. Para usar um tronco para terminação, ele deve ter um URI SIP de terminação e pelo menos um esquema de autenticação (Listas de controle de acesso de IP e/ou Listas de credenciais).

Elastic SIP Trunking Termination

URI de terminação

Configure um nome de domínio SIP para identificar exclusivamente seu URI SIP de terminação para este tronco. Este URI será usado pela sua infraestrutura de comunicações para direcionar o tráfego SIP para a Twilio.

  • {example}.pstn.twilio.com

A Twilio recomenda que você use um traço em vez de um ponto para melhorar a legibilidade do seu domínio. No entanto, em alguns casos, você pode preferir um subdomínio como a.b.pstn.twilio.com do domínio de nível superior b.pstn.twilio.com

Um subdomínio como a.b.pstn.twilio.com pode ser criado observando os seguintes requisitos:

  • O domínio de nível superior (b.pstn.twilio.com) deve ser criado primeiro
  • O domínio de nível superior (b.pstn.twilio.com) deve ser criado pela mesma conta ou pela conta principal

Configure um tronco em sua infraestrutura de comunicações (por exemplo, IP-PBX ou SBC)

Configure um tronco em sua infraestrutura de comunicação e aponte-o {example}.pstn.twilio.com para o tráfego de saída em direção ao Twilio.

URIs de terminação localizados

Se você deseja se conectar manualmente a uma localização de borda geográfica específica mais próxima do local da sua infraestrutura de comunicações, você pode fazer isso apontando sua infraestrutura de comunicações para qualquer um dos seguintes URIs SIP de terminação localizados:

  • {example}.pstn.ashburn.twilio.com (North America Virginia)
  • {example}.pstn.umatilla.twilio.com (North America Oregon)
  • {example}.pstn.dublin.twilio.com (Europe Ireland)
  • {example}.pstn.frankfurt.twilio.com (Europe Frankfurt)
  • {example}.pstn.singapore.twilio.com (Asia Pacific Singapore)
  • {example}.pstn.tokyo.twilio.com (Asia Pacific Tokyo)
  • {example}.pstn.sao-paulo.twilio.com (South America São Paulo)
  • {example}.pstn.sydney.twilio.com (Asia Pacific Sydney)

Você pode encontrar a lista de URIs localizados legados aqui. Por exemplo: {example}.pstn.us1.twilio.com

Redundância com URIs de terminação

O Elastic SIP Trunking da Twilio usa um FQDN ({example}.pstn.twilio.com) como um URI de terminação usado pela infraestrutura de comunicações para direcionar o tráfego SIP para a Twilio. Conforme explicado na seção anterior, os URIs de terminação localizados estão disponíveis.

Por exemplo, {example}.pstn.ashburn.twilio.com, esse FQDN específico é resolvido no seguinte Registro-A de DNS:

Tipo Endereços IP TTL
A 54.172.60.3 10 min
A 54.172.60.0 10 min
A 54.172.60.2 10 min
A 54.172.60.1 10 min

Para cada local de borda temos 3-4 endereços IP que são usados para fins de confiabilidade (consulte endereços IP)(/docs/api/sip-trunking/getting-started#ip-addresses). Cada um desses endereços IP representa uma borda pública exclusiva para nossos serviços de Elastic SIP Trunking na nuvem Twilio, distribuídos em várias zonas de disponibilidade para fins de confiabilidade.

É altamente recomendável que você não se vincule a um único endereço IP, mas sim utilize todos os endereços IP e faça failover caso um IP não esteja respondendo.

Uma estratégia comum implantada internamente é, se não houver resposta a um INVITE (CONVITE), vá para o próximo IP após quatro segundos. Também instruímos nossas operadoras a usarem essa mesma estratégia conosco. Uma única máquina por trás de um único IP sempre falha em algum momento. Portanto, a solução geral deve levar isso em consideração e se proteger contra essas falhas.

Além disso, se houver uma interrupção completa do Ashburn, é recomendável que você faça failover para outro local de borda (por exemplo, se você estiver se conectando ao ashburn, faça failover para umatilla). Lembre-se de que o local de borda, por sua vez, resolve para três ou quatro endereços IP diferentes para fins de confiabilidade.

Authentication (Autenticação)

Configure os detalhes de autenticação para garantir a segurança/autenticidade do tráfego de terminação. Você deve configurar no mínimo uma ACL (Access Control List, lista de controle de acesso) ou autenticação de credencial. Se você configurar ambas, as ACLs and credentials serão aplicadas.

É altamente recomendável que você configure as credenciais do usuário. As ACLs de IP por si só não protegem contra certos tipos de ataques.

Para criar uma nova ACL:

  • Clique em "Create IP Access Control List" (Criar lista de controle de acesso de IP) na seção "Authentication" (Autenticação).
  • Dê à Lista de controle de acesso um nome amigável que descreva o que é essa lista de Ips. Algo como "Dallas Datacenter IPs".
  • Adicione IPs à sua nova lista de controle de acesso de IP (esses devem ser os endereços IP usados para o tráfego SIP de saída pelos elementos de borda da infraestrutura de comunicação, por exemplo, SBC).
  • Dê aos seus IPs um nome amigável que descreva o que é esse IP, por exemplo "Production SBC".
  • Clique em "Create ACL" (Criar ACL)

Para criar uma nova lista de credenciais:

  • Clique em "Create Credential List" (Criar lista de credenciais) na seção "Authentication" (Autenticação).
  • Dê à lista de credenciais um nome fácil que descreva o usuário que você está autenticando. Algo como "Admin, Twilio".
  • Insira um nome de usuário (esse deve ser o nome de usuário usado para a autenticação de resumo para o tráfego SIP de saída pelos elementos de borda da infraestrutura de comunicações, por exemplo, SBC).
  • Digite a senha correspondente para esse usuário.
  • Clique em "Create Credentials List" (Criar lista de credenciais)

Se você estiver usando credenciais de usuário, seu SIP INVITE receberá uma mensagem 407 Proxy Authentication Required solicitando as credenciais de usuário adequadas.

Ao final desta etapa, seu tronco conseguirá processar chamadas de terminação provenientes da infraestrutura de comunicações, via Twilio, para a RPTC.

Números de ID do autor da chamada permitidos em chamadas de terminação

Você deve especificar um número de ID do autor da chamada que corresponda ao número virtual DID da Twilio em sua conta, ou um número de ID do autor da chamada verificado no Console ou com a API do ID do autor da chamada de saída.

Se um número de ID do autor da chamada não for especificado no campo From (De) do SIP INVITE (CONVITE SIP), o Remote-Party-ID ou o P-Asserted-Identity serão usados.

Em contas de teste, além de usar um ID do autor da chamada verificado, você só pode ligar para números que também são verificados. Para remover essa restrição, faça upgrade na sua conta pelo Console.

Como fazer sua primeira chamada de terminação

INVITE sip:+15108675309@{example}.pstn.ashburn.twilio.com SIP/2.0

Certifique-se de que todos os números de telefone enviados via SIP para a Twilio estejam sempre
no formato E.164 (por exemplo,+12128675309). Se o formato E.164 não for usado, a
chamada será rejeitada com uma resposta SIP 400 Bad Request.

Certifique-se de que o número formatado E.164 sempre inclua +. Esse prefixo de símbolo de adição é obrigatório.

Origination settings (Configurações de origem)

A definição de suas configurações de origem permitirá que você receba o tráfego de entrada da RPTC para um número Twilio, entregue à sua infraestrutura de comunicações . Com números de telefone disponíveis em mais de 100 países, a Twilio oferece um SIP Trunk verdadeiramente global. No mínimo um número Twilio deve ser associado a esse tronco se você estiver configurando-o para origem.

Elastic SIP Trunking Origination

As configurações de origem definidas nesta seção se aplicarão a todos os números associados a esse tronco.

URI SIP de origem

Configure seu URI SIP de origem, que identifica o ponto de entrada do elemento de rede em sua infraestrutura de comunicação (por exemplo IP-PBX, SBC). A parte do host do URI SIP pode ser um endereço IP ou um FQDN (Fully Qualified Domain Name, nome de domínio totalmente qualificado).

  • sip:172.56.42.132
  • sip:mysbc.com

O Twilio preencherá automaticamente a parte do usuário do URI SIP com base no número Twilio para o qual a chamada da RPTC está destinada. Por exemplo, se a chamada da RPTC for recebida para o número Twilio 14158675309, que está associado a esse tronco, o URI resultante enviado à sua infraestrutura de comunicações será:

  • sip:+14158675309@172.56.42.132
  • sip:+14158675309@mysbc.com

Como alternativa, você também pode configurar uma parte específica do usuário (por exemplo, "anniebp") dentro do URI SIP de origem. Observe que o mesmo URI será usado para todos os Números associados a esse tronco. Portanto, se a chamada da RPTC for recebida para o número Twilio +14158675309, que está associado a esse tronco, o URI resultante para sua infraestrutura de comunicações ainda será o seguinte para todos os números de telefone:

  • sip:anniebp@172.56.42.132
  • sip:anniebp@mysbc.com

Observação: O número Twilio discado (+14158675309) sempre será transmitido em um cabeçalho SIP Diversion para chamadas de origem de tronco telefônico.

X-headers

É possível enviar qualquer cabeçalho SIP começando com o prefixo X-, anexando-os ao URI SIP de origem. Por exemplo, você pode configurar: sip:+14158675309@mysbc.com?X-myheader=foo para enviar X-myheader:foo em todas as chamadas de origem.

O transport parâmetro

Por padrão, a Twilio envia solicitações SIP de origem para a infraestrutura de comunicações via UDP. Isso pode ser personalizado para ser enviado por TCP em vez de UDP. Para alterá-lo, use o parâmetro de transporte no URI SIP de origem:

  • sip:anniebp@172.56.42.132;transport=tcp

Como alternativa, você pode personalizá-lo para usar TLS para sinalização SIP. Ao usar o TLS, a porta padrão é a 5061. No entanto, uma porta diferente pode ser especificada. Para alterá-la, use o parâmetro de transporte no URI SIP de origem e, se preferir, especifique um número de porta diferente:

  • sip:anniebp@172.56.42.132:5062;transport=tls

Observação: A Twilio NÃO oferece suporte às configurações de URI de origem do Elastic SIP Trunking usando o esquema de URI sips para ativar a criptografia completa. No entanto, oferecemos suporte a sip esquemas de URL usando transport=tls para criptografia ponto a ponto.

Se você configurar os URIs do Elastic SIP Trunking Origination URIs para usar esquemas sips, esses sips URIs serão tratados como se fossem sip URIs usando transporte TLS. A Twilio ajustará o URI internamente para, em vez disso, ser roteado usando o esquema sip e transport=tls nas mensagens outbound, o que resulta em criptografia ponto a ponto entre a Twilio e o equipamento do cliente.

A Twilio recomenda não usar esquemas sips em configurações SIP da Twilio, pois isso pode causar um comportamento possivelmente indesejado, devido à maneira como processamos esses URIs. Em vez disso, sugerimos o uso de esquemas sip com transporte TLS. Este método, junto com a segurança de nossa arquitetura de voz e Super Network, é uma forma eficaz de adicionar criptografia às suas conexões SIP da Twilio.

O parâmetro edge

Para especificar a [borda] geográfica(/docs/global-infrastructure/edge-locations) da qual a Twilio enviará o tráfego SIP de origem para a infraestrutura de comunicações, inclua o parâmetro edge em seu URI SIP de origem. Por exemplo, se o parâmetro edge=dublin estiver incluído em seu URI SIP de origem, a Twilio enviará o tráfego SIP do local de borda Europa Irlanda:

  • sip:anniebp@172.56.42.132;edge=dublin

Se o parâmetro edge não for especificado, a Twilio enviará o tráfego SIP de origem do local de borda por onde a chamada RPTC entra.

Observação: permita endereços IP do local de borda da Twilio para sinalização SIP e tráfego de mídia RTP.

Esse parâmetro era chamado de region e ainda é compatível. Veja uma lista de identificadores de regiões legadas aqui. Por exemplo: sip:anniebp@172.56.42.132;region=ie1

Como usar URIs SIP de várias origens

É possível configurar até 10 (dez) URIs SIP de origem com diferentes prioridades & pesos.

O campo de prioridade determina a precedência do uso do URI SIP. A Twilio sempre usará o URI SIP com o valor de prioridade de número mais baixo primeiro e fará fallback para outros URIs SIP de valor igual ou superior se a sessão para esse URI SIP falhar.

Se um serviço tiver vários URIs SIP de origem com o mesmo valor de prioridade, a Twilio usará o campo de peso para determinar qual URI SIP usar. O valor de peso é relevante somente em relação a outros URIs SIP com o mesmo valor de prioridade.

Priority classifica a importância do URI. Os valores variam de 0 a 65535, onde o número mais baixo representa a maior importância. Weight é usado para determinar o compartilhamento de carga quando mais de um URI tem a mesma prioridade. Seus valores variam de 1 a 65535. Quanto maior o valor, maior a carga fornecida a um URI.

É possível habilitar ou desabilitar um URI SIP de origem. Quando um URI SIP de origem está habilitado, ele está ativo na seleção de rota. Se não estiver habilitado, ele não será usado para rotear o tráfego para a infraestrutura de comunicações.

No exemplo a seguir, os campos de prioridade e peso são usados para fornecer uma combinação de balanceamento de carga e serviços de failover.

URI SIP de origem Prioridade Peso
sip:mysbc1.com 10 60
sip:mysbc2.com 10 20
sip:mysbc3.com 10 20
sip:mysbc-backup.com 20 10

Os três primeiros URIs SIP compartilham uma prioridade de 10, de modo que o valor do campo de peso é usado pelo Twilio para determinar qual servidor contatar. A soma dos três valores é 100, portanto, sip:mysbc1.com será usado 60% do tempo. Cada um dos URIs SIP sip:mysbc2.com e sip:mysbc3.com será usado para 20% das solicitações. Se sip:mysbc1.com não estiver disponível, essas duas máquinas restantes compartilharão a carga igualmente, já que cada uma delas será selecionada 50% do tempo.

Se os três servidores com prioridade 10 não estiverem disponíveis, o registro com o próximo valor de prioridade mais baixo será escolhido, ou seja, sip:mysbc-backup.com. Observação: se algum destes códigos de status SIP retornar ("2xx", "400", "404", "405", "410", "416", "482", "484", "486", "6xx"), a Twilio não fará failover para o próximo URI SIP de origem. Se não houver resposta SIP de um determinado servidor, a Twilio fará o failover após quatro segundos.

Disaster Recovery URL (URL de recuperação de desastres)

No caso de um desastre que impeça que suas chamadas sejam entregues ao URI SIP de origem acima, você pode configurar um URL de recuperação de desastres apontando para um aplicativo criado na poderosa ferramenta de script do Twilio chamada TwiML. Você pode usar o TwiML para criar um aplicativo que gerenciará chamadas conforme exigido pelo seu plano de recuperação de desastres, incluindo a replicação da funcionalidade do PBX (por exemplo, URA).

  • http://fallback.mycompany.com/index

Para obter mais informações sobre como criar seu aplicativo TwiML, consulte [Início rápido Twilio][início rápido] e Guia da API TwiML. Observe que quando as chamadas são redirecionadas para o URL de recuperação de desastres, há cobrança de taxas normais do Twilio Voice: consulte voice pricing.

Pesquisas de CNAM

O acrônimo CNAM significa Caller ID Name (nome de ID do autor da chamada, em português). O CNAM é usado para exibir o nome de quem está ligando ao lado do número de telefone, a fim de ajudar os usuários a identificar facilmente o autor da chamada.

Quando você habilita a CNAM Lookup (Pesquisa de CNAM), o nome de ID do autor da chamada é inserido no SIP INVITE (CONVITE SIP) com os campos "From" (De), "Contact" (Contato) e, se aplicável, "P-Asserted-Identity" para cada autor da chamada.

Observe que as pesquisas do CNAM para números dos EUA e Canadá são cobradas por consulta, mesmo que os dados não estejam disponíveis. Atualmente, a solicitação de pesquisa de nome de ID do autor da chamada para números internacionais retorna valores nulos, mas não são faturadas.

Habilite esse recurso usando o console da Twilio:

Para habilitar a pesquisa de CNAM usando o console, faça login no console e vá para a seção "Elastic SIP Trunking".

Depois de selecionar um tronco, vá para as configurações "Origination" (Origem) no submenu à esquerda. Nessas configurações haverá um botão para habilitar a pesquisa de CNAM. Você saberá que a configuração foi habilitada quando o botão ficar azul e a palavra "ENABLED" (HABILITADO) aparecer.

  • A Pesquisa de CNAM deve ser habilitada por tronco
  • A Pesquisa de CNAM só é compatível com números de telefone dos EUA e Canadá
  • A Pesquisa de CNAM é faturada por pesquisa bem-sucedida (isso inclui o caso em que o Nome não está disponível para um número nos bancos de dados nacionais de CNAM). Sabe-se que muitos números AT&T não são publicados nos bancos de dados nacionais de CNAM.
  • A Pesquisa de CNAM é cobrada por pesquisa bem-sucedida, mesmo que a chamada em si falhe

Redirecionamento de chamadas

O redirecionamento de chamadas permite redirecionar uma chamada de origem de tronco telefônico. A infraestrutura de comunicações pode redirecionar um INVITE (CONVITE) recebido ao responder com um SIP 302 (movido temporariamente). Essa resposta contém um campo de cabeçalho de contato com os novos endereços que devem ser usados nas tentativas.

  • O Twilio oferece suporte a um único redirecionamento por chamada:
    • Se um destino redirecionado também enviar uma resposta SIP 302 para outro destino, o Twilio falhará a chamada.
    • A Twilio honra o primeiro URI da resposta SIP 302: Vários URIs no cabeçalho Contact SIP, exceto o primeiro ou vários cabeçalhos Contact SIP exceto o primeiro serão ignorados.
  • Redirecionamentos de chamada para domínios Twilio (*.sip.twilio.com ou *.pstn.twilio.com) não são compatíveis
  • Se a chamada for para um endpoint SIP registrado, o redirecionamento não será permitido
  • O parâmetro edge não é compatível com um URI de contato SIP 302. A chamada redirecionada usa o mesmo local de borda de saída da chamada original
  • O parâmetro tnx não é compatível com um URI de contato SIP 302. A chamada redirecionada usará a mesma conexão Interconnect que a chamada original
  • Se [Secure Trunking] (#securetrunking) foi usado para o INVITE original, a chamada redirecionada também usará TLS/SRTP
  • Se Call Recording foi usado para o INVITE original, a chamada redirecionada também será gravada

SIP Diversion Headers

Trunking Origination

Quando o Twilio receber o tráfego de entrada em seus números Twilio da RPTC PSTN para ser direcionado para a infraestrutura de comunicações, ele adicionará um cabeçalho Diversion SIP anotando o número Twilio que foi discado. Este cabeçalho serve como um registro histórico que indica que a chamada foi desviada do número discado para o URI SIP de origem do tronco SIP. Um exemplo do que este cabeçalho Diversion pode parecer é mostrado abaixo.

Diversion: <sip:+14155550000@twilio.com>

Trunking Termination

Quando o Twilio recebe tráfego de saída de sua infraestrutura de comunicações para a RPTC, sua mensagem SIP pode, às vezes, incluir cabeçalhos Diversion SIP se a chamada tiver sido encaminhada anteriormente. A Twilio encaminhará os cabeçalhos Diversion SIP recebidos às operadoras.

Em breve!

Para combater qualquer adição maliciosa de cabeçalhos Diversion, a Twilio verificará todos os cabeçalhos Diversion recebidos que contenham o domínio da Twilio. A Twilio verificará se o número de telefone incluído no cabeçalho corresponde a um associado à sua conta da Twilio (um número da Twilio de propriedade da conta ou um ID do autor da chamada verificado). Se a plataforma falhar nessa verificação, a Twilio removerá a plataforma.

Números

Nesta aba, você pode:

  • Comprar um novo número Twilio para o tronco
  • Visualizar todos os números Twilio atualmente associados a esse tronco
  • Associar um número Twilio existente a esse tronco
  • Desassociar um número Twilio desse tronco

Visualizar todos os números Twilio atualmente associados a esse tronco

Na seção "Numbers" (Números), você pode ver todos os números atualmente
associados a esse tronco. Lembre-se de que todos esses números compartilham as mesmas
origens & configurações gerais.

Você pode clicar em um determinado número para visualizar/modificar a configuração.

Comprar um novo número Twilio para o tronco

É necessário no mínimo um número de telefone Twilio para poder receber
chamadas vindas da RPTC para a sua infraestrutura de comunicações pelo
tronco da Twilio.

Verifique se todas as alterações de configuração de tronco foram salvas e, na seção
"Numbers" (Números) selecione "Buy a Number" (Comprar um número).

Selecione o código do país e procure os números disponíveis que correspondam a qualquer padrão
(por exemplo, +14158675309) que você queira colocar no seu número.

Depois de encontrar o número Twilio que gostaria de comprar, finalize a compra
e continue a configuração do número.

Você será direcionado para a visualização do número, onde será possível modificar a configuração
desse número.

Na seção "Voice" (Voz), selecione o botão de opção "SIP Trunking" e na lista suspensa
abaixo selecione o SIP Trunk desejado que você gostaria de associar
a este número. Não se esqueça de salvar as alterações da configuração.

Associar um número Twilio existente a esse tronco

Na seção "Numbers" (Números), selecione "Associate a Number with this Trunk" (Associar um número a este tronco), o que
exibirá uma lista de todos os seus números Twilio existentes. Clique naquele que
deseja associar a este tronco.

Você será direcionado para a visualização do número, onde será possível modificar a configuração
deste número. Na seção "Voice" (Voz), selecione o botão de opção "SIP Trunking"
e, na lista suspensa abaixo, selecione o SIP Trunk
ao qual deseja associar esse número. Não se esqueça de salvar as alterações da
configuração.

Desassociar um número Twilio desse tronco

Você pode desassociar um número de um tronco de várias maneiras:

  • Na seção "Numbers" (Números) de um determinado tronco, você pode desassociar diretamente um
    número de telefone da lista de números exibida clicando no botão da lixeira.
  • Alterando a configuração "Voice" (Voz) de um determinado número para um tronco diferente
    ou configurando-o com um aplicativo ou URL
  • Excluindo o tronco associado a esse número

Observe que ao fazer isso, o número é desassociado do tronco, mas
não é liberado de sua conta.

Os números de telefone Twilio são cobrados mensalmente. A menos que
você esteja ativamente usando um número ou queira manter um número reservado para uso futuro, você pode
reduzir seus custos liberando seus números não utilizados. Para liberar o
número, vá para a seção "Voice and Messaging" (Voz e mensagens), clique em "Numbers" (Números) e
libere o número desejado nessa página.

Receber sua primeira chamada de origem

Faça sua primeira chamada de teste discando o número Twilio do tronco, por exemplo, +14158675309, e garanta que a extensão da infraestrutura de comunicações correspondente emita o toque.

Excluir um tronco

Você pode excluir um tronco da seguinte forma:

  • Na seção "Trunks" (Troncos), usando a lista de troncos exibida. Observe que quando você fizer isso, todos os números associados a esse tronco serão automaticamente desassociados dele, mas não serão liberados. Para liberá-los, vá para a seção "Voice and Messaging" (Voz e mensagens), clique em "Numbers" (Números) e libere os números desejados por meio desta seção.
  • Em qualquer uma das telas de configuração específica do tronco, você terá a opção para "Delete this Trunk" (Excluir este tronco).

Observe que quando você fizer isso, todos os números associados anteriormente a este tronco serão automaticamente desassociados dele, mas não serão liberados da sua conta. Os números de telefone Twilio são cobrados mensalmente. A menos que você esteja ativamente usando um número ou queira manter um número reservado para uso futuro, você pode reduzir seus custos liberando seus números não utilizados. Para liberar o número, vá para a seção "Voice and Messaging" (Voz e mensagens), clique em "Numbers" (Números) e libere o número desejado nessa seção.

Sua rede

Prepare a infraestrutura de comunicações para garantir que a infraestrutura SIP tenha conectividade com o Twilio e vice-versa.

  • Configure seus URIs de terminação para o tronco Twilio, usando, de modo opcional, um URIs de terminação localizados se você deseja se conectar manualmente a uma localização de borda geográfica específica da plataforma da Twilio.
  • Permita todos os endereços IP de sinalização e mídia da Twilio e as portas no firewall.
  • Configure sua infraestrutura para que ela não esteja registrada neste tronco.
  • Garanta que a infraestrutura envie um valor mínimo de 20 para Max-Forwards a fim de garantir que sua chamada seja processada com êxito.
  • Certifique-se de que todos os números de telefone enviados pelo SIP para a Twilio estejam sempre no formato E.164.
  • Opcionalmente, configure a infraestrutura de comunicações para emitir mensagens SIP OPTIONS (OPÇÕES SIP) como um mecanismo de ping para seu Elastic SIP Trunk (envie a solicitação de mensagem para: o URI de terminação que você criou [example.pstn.twilio.com]); a plataforma Twilio responde adequadamente. Mantenha o Ping inferior a 1 nas SIP OPTIONS (OPÇÕES SIP) a cada 10-15 segundos, para evitar que as solicitações sejam banidas pela nossa plataforma.

Implantação por trás de um NAT

Se você estiver implantando por trás de um NAT, sem um controlador de seção de borda, é importante manter a vinculação de tradução NAT aberta.

  • Ao usar o UDP para fins de sinalização, envie periodicamente o SIP OPTIONS (OPÇÕES SIP) para a Twilio, que responderá com 200OK.
  • Ao usar o TCP ou o TLS para fins de sinalização, envie periodicamente o SIP OPTIONS (OPÇÕES SIP) para a Twilio, ou a conexão persistente CR-LF. Para isso, envie periodicamente um CRLF duplo (o "ping") e espere até receber um CRLF único (o " pong") da Twilio. O último tem a menor sobrecarga.
  • No caso do RTP, isso geralmente apresente menos problemas, pois os pacotes de mídia são enviados com mais frequência.

Endereços IP

Você DEVE permitir TODOS os seguintes intervalos de endereços IP e portas da Twilio em seu firewall para fins de sinalização SIP e tráfego de mídia RTP. Isso é importante se você tiver números em diferentes locais de borda e para fins de resiliência (por exemplo, se os gateways da Virgínia, na América do Norte, estiverem desativados, os gateways do Oregon, na América do Norte, serão usados). A Twilio não garante de qual local de borda a mídia sairá sem usar o parâmetro edge, pois ele pode depender de qual gateway RPTC-SIP entrega a chamada para determinado local de borda da Twilio.

Consulte os [endereços IP][ipaddresses] do Elastic SIP Trunking da Twilio para ver a lista completa.

Para obter mais informações sobre como configurar a infraestrutura com o Elastic SIP Trunk da Twilio, consulte as guias de configuração do SIP Trunking.

Classifique esta página:
Loading Code Sample...
        
        
        

        Obrigado pelo seu feedback!

        Selecione o(s) motivo(s) para seu feedback. As informações adicionais que você fornece nos ajudam a melhorar nossa documentação:

        Enviando seu feedback...
        🎉 Obrigado pelo seu feedback!
        Algo deu errado. Tente novamente.

        Obrigado pelo seu feedback!

        thanks-feedback-gif