Integração CNAM
CNAM sobre SIP
Autorize a sua origem SIP, envie uma transação de consulta e leia a identidade do chamador devolvida.
Escolha o comportamento da consulta
| Nível | Preço público por consulta | O que faz |
|---|---|---|
| Starter | US$ 0,0026 | Utiliza informações de nome de chamador proprietárias e em cache. |
| Standard | US$ 0,0037 | Efetua uma consulta de rede em tempo real para cada pedido. |
| Mixed | US$ 0,004 | Tenta primeiro uma consulta em tempo real e, se não for encontrado nenhum nome, recorre aos dados de Starter. |
O serviço selecionado determina o comportamento da consulta; Mixed não é uma consulta que privilegia a cache. Reveja a tarifa atribuída à sua conta antes de utilizar em produção. Um nome de chamador não é prova de identidade nem de titularidade.
Autorize a sua origem
- Adicione o IP de origem público utilizado pelo seu SBC ou aplicação em Definições de IP de CNAM e associe o serviço pretendido.
- Envie um SIP INVITE para
cnam.multitel.net, utilizando o número de telefone completo como utilizador do request-URI. O transporte publicado é UDP na porta de destino 5060. - Utilize a sua pilha SIP para gerar os cabeçalhos Via, From, To, Contact, Call-ID, CSeq e os restantes cabeçalhos de transação necessários. Não envie apenas a linha de pedido abaixo.
- Conclua corretamente a transação SIP e utilize o nome devolvido apenas se existir um resultado utilizável.
INVITE sip:12025550123@cnam.multitel.net SIP/2.0Este serviço de consulta não aceita registo SIP. A autorização baseia-se no endereço de origem configurado, que pode ser o endereço público do seu gateway NAT.
Leia o resultado da consulta SIP
O serviço devolve o resultado numa resposta SIP 380 com um cabeçalho P-Asserted-Identity. Esta é a transação do resultado da consulta, não uma chamada telefónica atendida. A frase de motivo pode conter o nome devolvido; analise o cabeçalho de identidade em vez de depender de uma frase fixa.
SIP/2.0 380 EXAMPLE CALLER
P-Asserted-Identity: "EXAMPLE CALLER" <sip:12025550123@192.0.2.10>
Content-Length: 0Este excerto omite os cabeçalhos de transação. 192.0.2.10 representa o sistema que efetua o pedido no exemplo. A resposta real tem de ser associada aos Call-ID e CSeq da sua pilha SIP.
- 380 com um nome utilizável
- Leia o nome de apresentação em P-Asserted-Identity, confirme a resposta final do INVITE através da sua pilha SIP e continue o seu fluxo de chamada.
- Sem nome utilizável
- Não use uma mensagem de erro, um valor em branco ou o número consultado como nome de chamador verificado. Mantenha a chamada a funcionar com o seu comportamento habitual para nome desconhecido.
- 403 ou outra rejeição
- Verifique o método do pedido, o domínio de destino, a autorização do IP de origem e o estado da conta/serviço. Não repita um erro de autorização num ciclo rápido.
- Tempo limite excedido
- Distinga as retransmissões da transação SIP de uma nova consulta. Limite as novas tentativas, pois podem gerar outro custo de consulta.
Faturação, novas tentativas e a diferença para a atualização do identificador de chamada
Uma nova consulta pode gerar um custo de consulta. Estas interfaces de consulta não documentam uma chave de idempotência, pelo que uma nova tentativa pode ser uma segunda consulta faturável. Utilize um backoff limitado para falhas de transporte/serviço, resolva primeiro os erros de conta e reconcilie os custos de consulta reportados. Utilize cache apenas durante um período adequado à sua aplicação; os dados de nome de chamador podem mudar.
Uma consulta CNAM lê um nome. Não altera o nome apresentado nas suas chamadas efetuadas. Uma atualização de nome de chamador LIDB é uma operação separada, com campos, autorização, preço e processamento próprios.