Caller IDs

Um caller ID é um número que seu espaço de trabalho pode apresentar em uma chamada de saída. Bird verifica o header SIP From em cada chamada comparando com os números Bird que este espaço de trabalho pode apresentar e com seus números externos verificados. Chamadas que apresentam um número não elegível são recusadas.

Gerencie caller IDs em Voice > Numbers, que lista todos os números que seu espaço de trabalho pode usar para voz. Um número comprado conosco e um número verificado por você aparecem na mesma lista, uma linha por número. Um número que se enquadra nos dois casos aparece uma vez. Um número comprado conosco fica pronto para ser apresentado assim que você o possui, sem chamada de verificação: possuí-lo é a prova. O procedimento abaixo é para um número que você possui em outro lugar.

Cada linha mostra o nome, o número e seu país, seu Provider, as direções que aceita e para que ele é usado. Um número aguardando o código mostra Verifying; um cujo código expirou ou cujas tentativas se esgotaram mostra Failed. Cada página contém até 25 números. Selecione uma linha para abrir a página desse número.

Registre um número

1. Selecione Add number > Verify a number you own.
2. Digite o número no formato E.164: um + inicial, código do país e número nacional. Um número pode ser registrado apenas uma vez no seu espaço de trabalho.
3. Salve. Uma chamada de verificação é feita para o número imediatamente.
4. Atenda a chamada e ouça o código de seis dígitos.
5. Digite o código no dashboard. Você tem cinco tentativas, e um código aceito altera o status para Verified.

A verificação de caller ID não cobra do seu espaço de trabalho pela chamada de verificação. O registro ainda exige permissão de gerenciamento de Voice e a aprovação da conta para registrar números verificados. Dê um nome ao número depois, na página própria dele. Veja Nomeie um número.

Após a verificação, confira o país para o qual você pretende ligar em Voice > Destinations. A verificação tenta habilitar o país do número verificado, mas países indisponíveis ou uma falha na atualização de configurações podem deixá-lo desabilitado. Um caller ID verificado e um destino habilitado são requisitos separados.

Registre e verifique pela API

Registre um número para iniciar a chamada de verificação e depois envie o código para o ID que o registro retorna. Liste seus caller IDs para encontrar um número registrado no painel. Você também pode renomear ou excluir um caller ID. As leituras exigem voice_management:read; o registro, a verificação, a renomeação e a exclusão exigem voice_management:write. A referência da API inclui exemplos de SDK, Bird na linha de comando e MCP.

Se a chamada de verificação original não pôde ser iniciada, o envio do código pode iniciar outra chamada para o número registrado. Sua organização ainda precisa atender aos requisitos de registro. Se o código expirar ou as tentativas se esgotarem, exclua o caller ID e registre o número novamente, o que faz uma nova chamada de verificação; depois envie o novo código para o ID que esse registro retorna. Se o código for aceito mas a ativação retornar 412 ou 503, a propriedade continua comprovada e o caller ID aparece como verified com outbound_enabled: false. Um 412 significa que a verificação de identidade está incompleta, o que você conclui no painel, ou uma análise ou recusa de elegibilidade, que exige o suporte. Um 503 significa que a avaliação de elegibilidade está pendente ou indisponível, então tente novamente mais tarde. Depois de resolver, envie uma solicitação de verificação vazia para o mesmo ID; não o exclua nem o registre novamente.

Após a verificação, confira seus destinos Voice e habilite o país do número quando houver suporte e for necessário. A verificação tenta habilitá-lo, mas uma verificação bem-sucedida do caller ID pode deixar o destino desabilitado e as chamadas de saída para esse país bloqueadas.

Uma verificação por vez

O registro pode retornar E21036 quando o provedor de verificação já possui um desafio para aquele número pertencente a outro espaço de trabalho ou finalidade. Aguarde essa verificação terminar ou expirar e então registre o número novamente. Uma prova obtida para outro espaço de trabalho não verifica o número no seu.

A mesma recusa se aplica a um número que está ocupado por outro motivo: um código de login ou uma verificação de Trust Hub já em andamento para ele. Se nenhum outro espaço de trabalho está verificando o número, esse geralmente é o motivo, e a espera é a mesma.

Uma verificação que já foi concluída em outro lugar não bloqueia você: o mesmo número pode ser um caller ID verificado em mais de um espaço de trabalho, e cada um o comprova separadamente.

Status

Get a new code registra o número novamente e liga para ele com um novo código. Se a primeira chamada nunca chegou e o número ainda está pendente, remova o caller ID e adicione o número novamente.

Se você lê esses valores a partir de ferramentas próprias, trate os que você reconhece e considere qualquer outro como um status que você não trata, em vez de um erro.

Aviso de verificação e entrega do CLI

Bird realiza a verificação de CLI (Calling Line Identification) para confirmar que um número A é válido e autorizado para uso antes que chamadas de saída possam ser feitas a partir da plataforma. Essa verificação garante que o número é legítimo e está sob controle do cliente.

No entanto, a verificação não garante a entrega ponta a ponta do CLI nem a conexão da chamada quando o CLI não é um número adquirido através do Bird. Operadoras intermediárias e operadoras internacionais aplicam suas próprias regulamentações nacionais e políticas de tráfego, que estão fora do controle do Bird. Isso pode incluir:

• Frameworks de anti-spoofing e autenticação de caller ID (ex.: STIR/SHAKEN nos EUA, diretrizes de CLI da Ofcom no Reino Unido)
• Exigência de que o CLI seja um número registrado localmente ou do próprio país
• Filtragem de spam e fraude aplicada por operadoras de terminação
• Restrições a categorias de tráfego específicas, como jogos de azar, promoções financeiras, cobrança de dívidas ou mensagens políticas
• Bloqueio de chamadas internacionais que apresentam um CLI doméstico (restrições de "origin-based")
• Listas de do-not-originate e bloqueios determinados por reguladores

Por essas razões, Bird pode verificar um CLI, mas não pode garantir que (1) o CLI será preservado e exibido para a parte chamada, ou (2) a chamada será conectada por troncos domésticos ou parceiros e operadoras internacionais Tier 1. Para maximizar as taxas de entrega de CLI e de completamento de chamada, recomendamos usar números adquiridos através do Bird, que são provisionados e roteados em conformidade com os requisitos regulatórios locais.

Nomeie um número

Um nome identifica o número no dashboard e na lista Call from do discador. Ele não é enviado com a chamada.

Selecione o número na lista Numbers para abrir sua página, defina Name e salve. Deixe o campo vazio para exibir apenas o número. A nomeação funciona em qualquer status e não altera o número nem sua verificação.

Verifique um número que você não pode atender

Alguém precisa atender a chamada de verificação e ouvir o código. Se o número normalmente chega a um sistema não atendido, redirecione-o temporariamente para um telefone que você possa atender e depois restaure o encaminhamento. Entre em contato com o suporte se o número não puder receber chamadas.

Remova um caller ID

Use Remove caller ID na linha do número. Remover a verificação elimina essa prova para novas chamadas. Um número mantido pelo seu espaço de trabalho através do Bird pode continuar elegível por meio de sua alocação; um número externo que perde sua prova é recusado com caller_id_not_verified. Chamadas já em andamento continuam, e os registros de chamada existentes não mudam.

Próximos passos