Receber chamadas
Um número que o seu espaço de trabalho possui pode atender uma chamada recebida de três formas: entregá-la a um dos seus trunks SIP, encaminhá-la para um número que você verificou, ou rejeitá-la. A resposta é uma configuração do número, e um número tem exatamente uma resposta por vez.
Todo número começa em rejeitar, então um número que ninguém configurou recusa os chamadores em vez de ficar sem resposta nenhuma.
Pré-requisitos
Antes de apontar um número para uma resposta:
- Um número que pode receber chamadas. Abra Voice > Numbers e verifique a coluna Directions em busca de uma marcação de entrada. Um número que você registrou como caller ID de outra operadora não recebe chamadas aqui: essa operadora roteia as chamadas feitas para ele, então ele não carrega nenhuma resposta.
- Para entrega a um trunk: um trunk SIP com chamadas de entrada ativadas e pelo menos um gateway de entrega.
- Para um encaminhamento: um caller ID verificado para encaminhar.
- Para alterar a configuração pela API ou CLI: uma chave API com o escopo voice_management em nível de escrita. Esse escopo cobre a configuração de voz; o escopo voice cobre tráfego de chamadas e estatísticas, então a leitura do registro de chamadas precisa do outro.
Entregar chamadas a um trunk SIP
A entrega disca para o seu próprio sistema telefônico nos endereços que você declara no trunk. Ative a direção primeiro, porque um número só pode ser apontado para um trunk que já aceita chamadas de entrada.
- Abra Voice > SIP Trunks, abra o trunk e, em Inbound calling, selecione Enable inbound.
- Adicione pelo menos um gateway na mesma seção. Um trunk sem gateway recusa todas as chamadas recebidas nos números que ele atende.
- Abra Voice > Numbers, abra o número e, em Inbound routing, escolha Deliver to a SIP trunk.
- Escolha o trunk e selecione Save. Apenas trunks com chamadas de entrada ativadas aparecem na lista.
A coluna Used for na lista de Numbers passa a mostrar o número como entregue a esse trunk, e a página do próprio trunk lista os números que ele atende.
O que um gateway precisa
Um gateway é um endereço para o qual uma chamada é entregue, e como esse par quer que os dois números da chamada sejam escritos:
| Configuração | O que é |
|---|---|
| URI SIP | O host do seu sistema telefônico, com uma porta opcional, como em sip:pbx.example.com:5060. Informe apenas o host: uma URI com user part é recusada |
| Priority | A ordem em que os gateways são tentados, do menor para o maior |
| Destination format | Como o número discado é escrito para esse par. O padrão é E.164 |
| Origination format | Como o número chamador é escrito para esse par, no cabeçalho P-Asserted-Identity da chamada entregue. O padrão é E.164 |
Gateways com a mesma prioridade dividem as chamadas igualmente, e qualquer um deles pode ser tentado primeiro em uma chamada. Para transferir a entrega a um segundo endereço, atribua a esse gateway um número de prioridade maior: ele é tentado quando o primeiro não atende.
Ambos os formatos de número são templates sobre um placeholder, {number}, que representa o número sem o + inicial. O formato de destino é colocado antes do host da URI SIP, então 1234#{number} entrega uma chamada para +31201234567 como sip:1234#31201234567@pbx.example.com:5060. O padrão para ambos é +{number}, que é E.164. Um formato que não contém nenhum {number} envia todos os números que o trunk atende para um único endereço fixo.
Warning: turning inbound calling off on a trunk, or deleting the trunk, puts every number pointing at it back on reject. Turning inbound back on does not restore them, so each number has to be pointed at a trunk again.
Encaminhar chamadas para outro número
Um encaminhamento atende a chamada recebida e faz uma segunda chamada para um número que você verificou, conectando as duas em seguida.
- Abra Voice > Numbers, abra o número e, em Inbound routing, escolha Forward to another number.
- Escolha o número para encaminhar. A lista contém os seus caller IDs verificados, porque um encaminhamento só pode ter como destino um número que você provou controlar.
- Escolha qual número a chamada encaminhada mostra como chamador e selecione Save.
O destino do encaminhamento é verificado quando você o define e novamente em cada chamada encaminhada. Um caller ID que você remover depois interrompe o encaminhamento em vez de continuar, e as chamadas recebidas passam a ser rejeitadas a partir desse ponto.
A chamada encaminhada toca por 45 segundos antes de ser abandonada, o que é mais do que uma entrega por trunk toca, porque a outra ponta geralmente é o telefone de uma pessoa e não um sistema telefônico.
O encaminhamento faz uma chamada, então as regras de saída se aplicam à segunda perna: encaminhar para um país que você não ativou em Destinations é recusado com destination_not_enabled.
Um encaminhamento, dois registros de chamada
Uma chamada encaminhada produz dois registros que compartilham um session_id:
| Registro | O que é |
|---|---|
| A chamada que chegou | direction é inbound, e route indica que o número estava configurado para encaminhar, para qual número e qual número a perna encaminhada apresentou |
| A chamada encaminhada | direction é outbound, do número que a perna apresentou para o número para o qual você encaminha. Ela não carrega route próprio |
Agrupe-os por session_id para ver a chamada completa. O registro de chegada é o que diz o que o número estava configurado para fazer.
Escolher qual número uma chamada encaminhada mostra como chamador
Uma chamada encaminhada tem dois números que pode apresentar a quem atende, e a escolha altera tanto o que a pessoa vê quanto a probabilidade de uma operadora interferir na chamada:
- Número chamador é o próprio número de quem ligou, então o telefone toca como se a pessoa tivesse discado diretamente e a chamada pode ser retornada pelo registro de chamadas. Como o número não é um que você possui, algumas operadoras, mais frequentemente nos EUA e em partes da Europa, marcam essas chamadas como não verificadas, substituem o número ou as filtram.
- Número discado é o número que o chamador discou, que é um dos seus. Quem atende vê qual dos seus números foi chamado em vez de quem ligou.
Não há padrão. Declare a escolha em cada encaminhamento que você configurar pela API ou CLI.
Quais valores o seu espaço de trabalho pode definir está declarado no próprio número, em forward_as_options no seu inbound_configuration. Apresentar o número discado exige que o seu espaço de trabalho esteja aprovado para fazer chamadas de números que você comprou conosco, e essa aprovação ainda não está disponível, então forward_as_options oferece apenas o número chamador e o encaminhamento apresenta o próprio número de quem ligou. Definir o número discado é recusado até lá.
Em uma leitura, forward_as é o valor que as chamadas realmente carregam, que pode diferir do último valor gravado.
Consultar o que um número fez com uma chamada
O registro de uma chamada recebida carrega um route junto com o seu status, e route é o que o número estava configurado para fazer no momento em que a chamada foi tratada. Alterar a configuração do número depois não muda o que as chamadas passadas dizem.
| route.type | O que o número fez |
|---|---|
| trunk | A chamada foi entregue ao trunk SIP indicado em trunk_id |
| forward | A chamada foi encaminhada para o número em forward_to, apresentando o número em forward_as |
| reject | O número recusou a chamada |
route diz o que o número estava configurado para fazer, não que funcionou. Uma rota trunk em uma chamada que nunca conectou é um número apontado para um trunk que não atendeu a chamada, e o status da chamada é o que carrega o resultado. route está ausente em chamadas de saída e em chamadas registradas antes de o campo existir.
No painel, abra a chamada em Voice > Calls e leia a linha Inbound route, que aponta para o número cujas configurações a decidiram. Pela API, route está em GET /v1/voice/calls/{call_id} e GET /v1/voice/calls, e direction filtra a lista para chamadas recebidas.
Diagnosticar uma chamada recebida recusada
Uma chamada recebida que foi recusada é registrada com o status rejected. Duas coisas diferentes o produzem, e rejection_reason é o que as separa:
- Rejeitada sem rejection_reason. O próprio número recusou a chamada. A chamada não falhou em nenhuma verificação nossa, então não indica motivo, e route diz o que o número estava configurado para fazer. Uma rota reject é um número que ninguém apontou para lugar nenhum, ou um deliberadamente configurado para recusar.
- Rejeitada com um rejection_reason. A chamada falhou em uma de nossas verificações antes de chegar ao seu sistema telefônico. O motivo indica a verificação. Chamadas rejeitadas lista todos os motivos e suas correções.
failed é um status diferente e não significa recusada: significa que a chamada foi tentada e não funcionou, com sip_response_code carregando a resposta que retornou.
Leia route e rejection_reason juntos para distinguir as recusas:
| route e motivo | Causa |
|---|---|
| reject, sem motivo | O número não está apontado para nenhuma resposta. Excluir um trunk, ou desativar suas chamadas de entrada, coloca todos os números apontados para ele de volta aqui, então um número que funcionava antes pode parar aqui |
| trunk, no_route_found | O número está apontado para um trunk, e esse trunk não tem nenhum gateway para entregar a chamada. Adicione um na página do trunk |
| forward, sem motivo | O destino do encaminhamento não é mais um caller ID verificado. Verifique-o novamente em Caller IDs, ou encaminhe para outro número |
| forward, destination_not_enabled | A segunda perna não pôde ser feita para o país do destino de encaminhamento. Ative esse país em Destinations |
Os limites da conta se aplicam também a chamadas recebidas: além do saldo da sua carteira, do limite diário de gastos com voz da sua organização, ou dos limites de concorrência e por segundo, uma chamada recebida é rejeitada com o motivo correspondente. Visão geral de voz cobre os próprios limites.
Verificar o custo de uma chamada recebida
Receber uma chamada é cobrado. A tarifa depende do país e do tipo do número que recebe, e é publicada por país em Receiving calls na página de preços de voz, junto com as tarifas para chamadas que você faz.
Um encaminhamento é cobrado como duas chamadas: a chamada que chegou pela tarifa de recebimento, e a perna que fazemos pela tarifa de saída do número para o qual você encaminha. Uma única taxa de manuseio é cobrada uma vez pela chamada, e não uma vez por perna.
A carteira é verificada antes de uma chamada recebida ser entregue, então um saldo que não pode cobri-la significa que a chamada é rejeitada em vez de ser cobrada de você depois. Custo e faturamento cobre como o tempo faturável, as tarifas e a carteira funcionam para ambas as direções.
Próximos passos
| Página | O que cobre |
|---|---|
| Trunks SIP | Criar um trunk, suas duas direções e controlar quem pode enviar |
| Caller IDs | Registrar um número e provar que você o controla |
| Registro de chamadas | Todos os campos de um registro de chamada e todos os motivos de rejeição |
| Eventos de voz | Receber resultados de chamadas enviados para os seus próprios sistemas |
| Solução de problemas de voz | Diagnosticar uma chamada que não é completada, a partir do sintoma |
Recursos relacionados
Continue com a documentação, guias e exemplos sobre este tópico. Os recursos estão em inglês.