Troncos SIP

​

Como um tronco funciona

​

Encontre o endereço SIP

curl "https://api.polymorfa.com/platform/sip/endpoint" \
  -H "Authorization: Bearer $POLYMORFA_KEY"

{
  "success": true,
  "data": {
    "status": "hosted",
    "host": "SIP_HOST",
    "transports": [
      { "transport": "udp", "port": 5060, "srtp": "not_supported" },
      { "transport": "tcp", "port": 5060, "srtp": "not_supported" },
      { "transport": "tls", "port": 5061, "srtp": "required" }
    ],
    "rtp": { "protocol": "udp", "portMin": 31000, "portMax": 31099 }
  }
}

• Permita SIP nas portas listadas, nos dois sentidos, entre o seu PBX e os endereços para os quais host resolve.
• Permita UDP nos dois sentidos entre as portas de mídia do seu PBX e o intervalo rtp nos mesmos endereços.
• Prefira tls: ele criptografa a sinalização, e a exigência de SRTP dele criptografa o áudio. udp e tcp transportam os dois sem criptografia.

​

Crie um tronco

curl -X POST "https://api.polymorfa.com/platform/sip-trunks" \
  -H "Authorization: Bearer $POLYMORFA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "PROJECT_ID",
    "name": "Head office PBX",
    "direction": "both",
    "outbound": {
      "targetUri": "sip:whatsapp@pbx.example.com:5061",
      "transport": "tls",
      "authUsername": "polymorfa",
      "authPassword": "PBX_PASSWORD"
    },
    "inbound": {
      "session": "support",
      "allowedAddresses": ["203.0.113.10", "198.51.100.0/28"],
      "allowedDestinations": ["+44", "+1415"]
    },
    "codecs": ["PCMA", "PCMU", "opus"],
    "maxConcurrentCalls": 30
  }'

{
  "success": true,
  "data": {
    "trunk": { "id": "TRUNK_ID", "direction": "both", "revision": 1, "...": "..." },
    "inboundCredentials": {
      "username": "tq7m4k2xmabn5c3dpe6fr2hw",
      "password": "SHOWN_ONCE",
      "realm": "polymorfa"
    }
  }
}

​

Envie chamadas do WhatsApp para o seu PBX

curl -X PUT "https://api.polymorfa.com/platform/sessions/support/call-settings" \
  -H "Authorization: Bearer $POLYMORFA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "inboundRoute": "sip_trunk",
    "sipTrunkId": "TRUNK_ID",
    "sipClaim": true
  }'

• Quando o seu PBX atende, a Polymorfa atende a chamada do WhatsApp como server:sip:<trunkId>. Com sipClaim: true, o atendimento faz o claim da chamada: os outros participantes param de tocar e não podem entrar. Com sipClaim: false, a chamada continua compartilhada e outros participantes podem entrar. Consulte Atender, entrar ou recusar.
• Quando o seu PBX não atende, a chamada do WhatsApp continua tocando para os seus outros participantes até ser atendida ou recusada, ou até a janela de toque terminar.
• Quando o seu PBX desliga, a conexão dele sai. Se o tronco fez o claim da chamada, a chamada termina. Quando a chamada do WhatsApp termina, a Polymorfa desliga o seu PBX.

​

Ligue para o WhatsApp a partir do seu PBX

• o host e uma porta de Encontre o endereço SIP;
• inboundCredentials.username e password para a autenticação digest; e
• o número do WhatsApp a chamar, no formato E.164, como parte de usuário da URI da requisição, por exemplo sip:+14155550100@SIP_HOST. O + inicial é opcional e um prefixo 00 é aceito.

​

Mídia e segurança

• Codecs. PCMU e PCMA (8 kHz) e Opus (48 kHz, mono), na ordem de codecs. Para Opus, anuncie opus/48000/2 no SDP; o áudio continua mono. Se um mapeamento de Opus for inutilizável, um codec PCMU ou PCMA oferecido pode transportar a chamada. O seu PBX precisa oferecer mídia no INVITE inicial; chamadas sem oferta são recusadas com 488. As respostas a chamadas da Polymorfa precisam manter o número de carga RTP de um codec oferecido. Alterações de mídia durante a chamada são recusadas.
• Pacotes. 20 ms de áudio por pacote RTP.
• Criptografia. Com tls, a sinalização é criptografada e a mídia usa SRTP com chaves SDES (AES_CM_128_HMAC_SHA1_80 ou AES_CM_128_HMAC_SHA1_32). Ofertas de RTP simples sobre TLS e ofertas de SRTP sobre UDP ou TCP são recusadas. Use tls quando o seu PBX estiver acessível pela internet.
• Endereços. Envie mídia a partir do endereço na descrição de sessão do seu PBX ou a partir do endereço de onde vem a sua sinalização. A Polymorfa envia a mídia de volta ao endereço de onde chega o seu primeiro pacote de mídia.
• PBX atrás de NAT. Um endereço privado (10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16, 100.64.0.0/10 ou fc00::/7) na descrição de sessão só funciona quando a sua sinalização vem de um endereço público. Nesse caso, a Polymorfa não envia mídia até que o primeiro pacote de mídia do seu PBX chegue desse endereço de sinalização, então o seu PBX precisa começar a enviar mídia.
• Endereços recusados. Descrições de sessão com um endereço de mídia de loopback, link-local, multicast, não especificado ou reservado são recusadas: a chamada do seu PBX recebe 488, e uma chamada para o seu PBX termina com sip_unavailable. Destinos de tronco em endereços privados, de loopback ou link-local são rejeitados.

​

Gerencie os troncos

• PATCH altera apenas os campos que você envia. Omita authPassword para manter a senha armazenada; envie authUsername: null para remover os dois. Envie expectedRevision para recusar a alteração com 409 sip_trunk_revision_conflict quando outra pessoa tiver alterado o tronco antes.
• Mudar direction para outbound remove as credenciais de entrada. Mudar um tronco outbound para inbound ou both cria um novo usuário; faça a rotação das credenciais dele para obter a senha.
• A rotação de credenciais substitui a senha. A senha antiga deixa de funcionar em cerca de um minuto. A rotação retorna 409 state_conflict para troncos outbound.
• Excluir um tronco para o qual uma sessão ainda envia chamadas retorna 409 sip_trunk_in_use. Antes, faça a sessão voltar a usar clients.
• As alterações chegam ao roteamento de chamadas em cerca de um minuto. As chamadas em andamento continuam.
• Quando o projeto de um tronco é desativado, alterar o tronco ou fazer a rotação das credenciais dele retorna 404 resource_not_found. A Polymorfa deixa de enviar chamadas ao tronco e recusa as chamadas do PBX dele em cerca de um minuto. Você ainda pode listar, ler e excluir o tronco.

​

Erros