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:

Usar SIP com o Twilio Voice

Antes de começar

Antes de usar a Interface SIP, você deve se inscrever em uma conta da Twilio (se ainda não tiver uma). Para se inscrever em uma conta, clique aqui.

Visão geral

Conecte sua infraestrutura de comunicações a Twilio e comece a criar aplicativos de Programmable Voice, como centrais de atendimento e URAs, com os poderosos e flexíveis recursos de voz da Twilio. Você pode se conectar a Twilio através da Internet pública ou, alternativamente, através de uma conexão privada usando Interconnect da Twilio. O SIP do Programmable Voice permite rotear suas chamadas de voz com alcance global para qualquer telefone fixo, celular, navegador, aplicativo móvel ou qualquer outro endpoint SIP.

O diagrama a seguir mostra a posição do Twilio Cloud nos fluxos de chamada.

Programmable Voice SIP Diagram

O que é SIP?

O Protocolo de iniciação de sessão (SIP) é um protocolo de comunicação padronizado que foi amplamente adotado para gerenciar sessões de comunicação multimídia para chamadas de voz e vídeo. O SIP pode ser usado para estabelecer conectividade entre suas infraestruturas de comunicação, como um PBX local ou virtual e a plataforma de comunicação da Twilio.

Enviar SIP para Twilio

O produto Interface SIP do Programmable Voice da Twilio permite que você use sua infraestrutura de comunicações SIP existente para iniciar sessões SIP com o Twilio Cloud. A Interface SIP usa a linguagem TwiML da Twilio e/ou as APIs REST da Twilio para criar aplicativos de voz avançados. Saiba como começar a conectar sua infraestrutura de comunicações SIP à Twilio Cloud.

Receber SIP da Twilio

O produto Interface SIP de Programmable Voice da Twilio permite que seus aplicativos de voz avançados iniciem sessões SIP a partir do Twilio Cloud em direção à sua infraestrutura de comunicações SIP existente usando a linguagem TwiML da Twilio e/ou as APIs REST da Twilio. Saiba como começar a conectar o Twilio Cloud à sua infraestrutura de comunicações SIP.

Limites

Certifique‐se de estar ciente dos seguintes limites de domínio SIP de Programmable Voice.

Recursos

Registro SIP

A Twilio permite registrar seus telefones SIP ou endpoints SIP com a Twilio. O Registro SIP é usado para identificar o local dos endpoints SIP. Portanto, o usuário pode receber chamadas independentemente do local físico do endpoint SIP.

Esse recurso permite que seus endpoints SIP possam enviar uma solicitação REGISTER para a Twilio. Para obter detalhes, consulte aqui.

Transferências de chamadas usando SIP REFER da Twilio

A transferência de chamadas permite mover uma chamada ativa de um endpoint para outro. No SIP, isso é feito usando o método SIP REFER.

A Twilio oferece suporte a inicialização do método SIP REFER da Twilio para sua infraestrutura de comunicações IP, aproveitando o verbo <Refer>.

Cabeçalho personalizado do SIP

O cabeçalho personalizado do SIP permite que você envie cabeçalhos personalizados.

Cabeçalho UUI (User-to-User Information, informações de usuário para usuário)

O cabeçalho UUI permite que você envie informações contextuais pela chamada SIP. Você pode verificar Enviar SIP com UUI e Receber SIP com UUI para obter mais detalhes sobre UUI.

DTMF

A Twilio suporta RFC-2833 para envio e recebimento de DTMF.

Codec de mídia

A Twilio suporta codecs G.711 μ-law (PCMU) e A-law (PCMA) para mídia. Esses são os codecs mais populares usados pelas operadoras, portanto a transcodificação é desnecessária.

Proteger o tráfego SIP usando TLS

A criptografia garante que a sinalização da chamada permaneça privada durante a transmissão. TLS (Segurança da camada de transporte) fornece criptografia para sinalização SIP.

Para habilitar o TLS, certifique‐se de ter importado o Certificado da CA raiz da Twilio. Não há mais nenhuma configuração necessária para TLS e você pode começar a enviar pela porta 5061 imediatamente. A funcionalidade TLS/porta 5061 está sempre ativa e não requer uma alternância manual, como mídia segura. Para parar de usar o TLS, basta enviar o SIP para a porta 5060 ou remover o parâmetro transport=tls.

A Interface SIP suporta as seguintes configurações para TLS:

  • 5060 (sem TLS, sem mídia segura)
  • 5061 (TLS, sem mídia segura)
  • 5061 (TLS, mídia segura)

Para chamadas em que o TLS está ativo, isso fará com que determinadas funcionalidades se comportem de forma diferente:

  • Os PCAPs SIP do console produzirão apenas um arquivo em branco.
  • Os metadados da chamada continuarão disponíveis, como por exemplo, códigos de erro principais, hora de início, hora de término, de/para.
  • O SIP Refer funcionará conforme esperado usando TLS.

Ao enviar tráfego SIP TLS para a Twilio, você precisará garantir que sua infraestrutura esteja usando o domínio em vez do ip do próximo salto. Essa é uma configuração incorreta comum e causará um erro 403 que não estará visível na sua conta da Twilio. O tráfego deve ser enviado ao domínio {example}.sip.{region}.twilio.com, em vez de um endereço IP para associar o tráfego à sua conta da Twilio.

Mídia segura

A mídia segura usa criptografia para garantir que a mídia da chamada e a sinalização associada permaneçam privadas durante a transmissão. O Secure Real-Time Protocol (SRTP) fornece criptografia para mídia. Para obter detalhes, consulte aqui.

Especificações de TLS/SRTP

  • SIP TLS
    • Versões: A Twilio suporta TLSv1.0, TLSv1.1 e TLSv1.2.

      OBSERVAÇÃO: Para melhor atender aos requisitos de segurança, descontinuamos o TLSv1.0 e o TLSv1.1 para chamadas SIP inbound e outbound, bem como o registro SIP.
      Se sua infraestrutura SIP exigir o uso do TLSv1.0 ou do TLSv1.1, você poderá configurar sua conta da Twilio para permitir essas versões obsoletas em seu console em Voice → Settings (Configurações) → Allow Depreated SIP/TLS Versions (Permitir versões SIP/TLS obsoletas). Se esta configuração estiver ativada, seus endpoints SIP poderão usar as versões anteriores TLSv1.0 e TLSv1.1 para sinalização SIP enviada ou recebida da Twilio. Se desativada, somente TLSv1.2 não obsoleto é permitido.
      A Twilio recomenda enfaticamente o uso do TLS versão 1.2 ao conectar sua infraestrutura SIP.

    • Cifras: 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
    • Se você estiver usando TwiML para enviar SIP da Twilio, para habilitar a criptografia, você deve usar o parâmetrotransport=tls em seu substantivo SIP no seu verbo Dial.
    • Por padrão, a porta 5061 é usada para TLS. No entanto, você pode especificar a porta que deseja usar no URI.
  • Mídia segura
    • Enviar SRTP para Twilio: A Twilio oferece suporte aos seguintes conjuntos de criptografia: AES_CM_128_HMAC_SHA1_80 e AES_CM_128_HMAC_SHA1_32. Ambos podem ser incluídos na sua ordem de preferência.
    • Receber SRTP da Twilio: Apenas um único conjunto de criptografia será anunciado: AES_CM_128_HMAC_SHA1_80
  • A importação do certificado de CA raiz da Twilio O TLS é usado para criptografar a sinalização SIP entre os endpoints SIP. Para que isso funcione corretamente, é necessário que determinados dispositivos na rede importem um certificado CA. 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. Baixe o certificado de CA do Twilio.

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

    A CA raiz da Twilio contém uma cadeia de certificados assinada por várias Autoridades de Certificação. Você deve importar o arquivo PEM inteiro em vez de certificados individuais.

    A Twilio não oferece suporte à importação de certificados raiz de terceiros neste momento. Para usar o Twilio Voice com TLS, a CA raiz da Twilio deve ser usada.

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

Se você configurar seus URIs de interface SIP para usar esquemas sips, esse URIs de sips serão tratados como se fossem URIs sip 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.

Endereços IP

Prepare a infraestrutura de comunicações para garantir que a infraestrutura SIP tenha conectividade com o Twilio Cloud e vice‐versa. Para garantir que a sua infraestrutura de comunicações não bloqueie a comunicação, você deve atualizar sua lista de endereços IP permitidos. Recomendamos que você permita todos os intervalos de endereços IP e portas a seguir em seu firewall para sinalização SIP e tráfego de mídia RTP.

Isso é importante se você tiver números em diferentes regiões, bem como para fins de disponibilidade (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).

Consulte os endereços IP SIP da Twilio para ver a lista completa.

Glossário

Infraestrutura de comunicações

Um termo amplo para se referir a IP-PBX, SBC, telefones por IP e etc...

Endpoint SIP

Telefone por IP ou cliente soft com o qual um usuário inicia uma chamada VoIP

URI SIP

Equivalente a um número de telefone SIP e tem o formato, sip:username@SIPDomain

Domínio SIP da Twilio

Ele assume o formato {example}.sip.{region}.twilio.com onde {example} é especificado pelo cliente e {region} é o data center onde o registrador está localizado. Inicialmente apenas us1.

Classifique esta página:

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.

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