Números de Telefone
Para que o seu agente de voz atenda chamadas telefónicas reais, precisa de ligar números de telefone. Esta secção cobre tudo sobre a aquisição, configuração e gestão de números de telefone na plataforma Hanc.AI.
Visão Geral
Obter Números de Telefone
Pode obter números de telefone diretamente através da plataforma Hanc.AI:
- Números de telefone disponíveis em mais de 100 países
- Encaminhamento de chamadas fiável
- Números locais, móveis, nacionais e gratuitos — além de números de chamada WhatsApp
- Números instantâneos, sem papelada, na Áustria, Alemanha, Suíça, EUA e Canadá
- Um fluxo self-serve guiado para todos os outros países, usando os seus próprios documentos regulatórios
- Sem necessidade de contas externas
Propriedades do Número de Telefone
Cada número de telefone tem as seguintes propriedades:
| Propriedade | Descrição |
|---|---|
| phone_number | O número em formato E.164 (ex.: +4312345678) |
| formatted_number | Formato legível por humanos (ex.: +43 1 234 5678) |
| name | Rótulo personalizado para o número |
| country | Código do país (ex.: AT, DE, US) |
| area_code | Parte do indicativo do número |
| provider | Fornecedor do número de telefone |
| inbound_agent_id | Agente atribuído para atender chamadas recebidas |
| outbound_agent_id | Agente atribuído para chamadas efetuadas |
Estados do Número de Telefone
| Estado | Descrição |
|---|---|
| ACTIVE | O número está ativo e pode receber/efetuar chamadas |
| INACTIVE | O número está em pausa, não gere chamadas |
| DELETED | O número foi removido |
Estados de Importação
Ao importar números:
| Estado | Descrição |
|---|---|
| IMPORTED | Número importado com sucesso e pronto a usar |
| PENDING | Importação em curso |
Começar com Números de Telefone
Opção A: Comprar Números Através da Hanc.AI
- Vá a Phone Numbers na barra lateral
- Clique em "Buy Number"
- Selecione um país e tipo de número
- Complete a compra
- O número é configurado automaticamente
O ecrã de compra começa por três cartões — Basic, Advanced e Trunk SIP. Esta escolha vem primeiro porque decide o que o número pode fazer:
| O que obtém | Países | Preço | |
|---|---|---|---|
| Basic | Apenas chamadas recebidas. Comprado e ativo de imediato, sem documentos. | Os cinco países que fornecemos diretamente: Áustria, Alemanha, Suíça, Estados Unidos e Canadá | Preço mensal normal |
| Advanced | Chamadas recebidas e efetuadas — indispensável se o agente tiver de ligar, conduzir campanhas ou transferir para fora. | Todos os países onde vendemos | Preço normal + €2/mês |
| Trunk SIP | Usar um número que já possui, através do seu operador. | Onde quer que o seu operador chegue | Sem custo de número da nossa parte |
Escolha Basic se quiser um número que atenda hoje. Escolha Advanced se o agente alguma vez tiver de fazer uma chamada. Escolha Trunk SIP se já tem números e um operador que lhe serve.
Por baixo do modo, o ecrã mostra todos os tipos de número do país escolhido — local, móvel, nacional e grátis — com qualquer opção indisponível claramente desativada em vez de escondida. O preço mensal está ao lado de cada tipo e já inclui o suplemento Advanced quando esse modo está selecionado.
A quantidade de papelada que faz depende do país:
Instantâneo, sem papelada
Na Áustria, Alemanha e Suíça, a Hanc.AI fornece o número sob a sua própria cobertura regulatória, pelo que não há documentos a submeter. Os EUA e o Canadá também não exigem documentos. Escolha um número, complete a compra, e fica ativo.
Self-serve guiado para todos os outros países
Para qualquer outro país, a maioria dos operadores exige documentos regulatórios (como prova de morada local ou registo comercial). A Hanc.AI acompanha-o no processo:
- Escolha o número e inicie o fluxo guiado.
- Submeta os seus próprios documentos regulatórios para esse país.
- Guarde o seu progresso como rascunho em qualquer momento e retome mais tarde — não tem de terminar de uma só vez.
- Se faltar algo ou algo estiver incorreto, recebe uma explicação em linguagem simples de exatamente o que corrigir, para que nunca fique na dúvida.
Assim que os seus documentos forem aceites, o número é provisionado e configurado automaticamente.
Acompanhar os seus processos
Tudo o que submete fica guardado como processo regulatório — um por país e tipo de número — em Números de telefone → Processos regulatórios. A tabela mostra o país, se se registou como empresa ou particular, o tipo de número, a data de início e o estado:
| Estado | O que significa | O que fazer |
|---|---|---|
| Rascunho | Começou e parou a meio. Nada foi enviado. | Continuar retoma onde ficou |
| Em análise | Submetido. O operador está a verificar — normalmente alguns dias úteis. | Esperar. Não há forma de acelerar |
| Aprovado | Aceite. | Compre números desse tipo nesse país: o processo é reutilizado automaticamente, sem nova submissão |
| Rejeitado | Algo não satisfez o operador. | Abra Ver para saber o motivo |
Ver abre o processo: os dados de identificação introduzidos e cada documento carregado. Em caso de rejeição, o motivo aparece por baixo do documento exato que a causou — e não como uma falha vaga da submissão inteira. É a diferença entre «volte a submeter tudo» e «a sua fatura tem mais de três meses, envie uma recente».
Um processo aprovado é reutilizável. Comprar um segundo número do mesmo tipo no mesmo país não recomeça as formalidades: o assistente reconhece o processo aprovado e passa diretamente à escolha do número.
Eliminar um processo retira-o da sua lista. Se ainda não estiver em análise, é também eliminado junto do operador. Um processo em análise não pode ser retirado — os operadores não o permitem — por isso desaparece da sua lista enquanto a análise segue o seu curso.
A aprovação leva dias, não minutos. Se sabe que vai precisar de um número italiano no próximo mês, submeta o processo agora: depois de aprovado, a compra em si leva um minuto.
Também pode obter um número WhatsApp para que o seu agente atenda chamadas diretamente dentro do WhatsApp. O tipo de número e o seu preço mensal são mostrados à partida no ecrã de compra antes de avançar. Veja Números de Chamada WhatsApp abaixo.
Opção B: Ligar o Seu Próprio Operador SIP
Traga o seu próprio fornecedor SIP — a HANC fala SIP nativamente e encaminha as chamadas para o seu agente de voz.
Operadores suportados
| Fornecedor | Notas |
|---|---|
| sipgate | SIP trunking UE. Auto-importação de números via API (Personal Access Token com numbers:read). |
| Placetel | Operador VoIP alemão. Configuração manual. |
| TENIOS | SIP trunks europeus. Configuração manual. |
| easybell | Operador SIP alemão. Credenciais do Kundencenter. |
| Zadarma | Números globais. Chave API opcional para auto-importação. |
| Twilio (BYO) | Traga a sua própria conta Twilio. Account SID + Auth Token. |
| Telnyx | SIP e DIDs orientados a API em todo o mundo. |
| SIP trunk personalizado | Qualquer outro fornecedor — forneça host, porta, transporte, utilizador, palavra-passe manualmente. |
Como ligar
- Vá a Phone Numbers na barra lateral.
- Clique em "Connect SIP".
- Escolha o seu operador na lista de fornecedores.
- Introduza as credenciais que o seu fornecedor lhe deu (utilizador/palavra-passe SIP; para alguns operadores, uma chave/segredo de API opcional para auto-importar números).
- Clique em Connect. A plataforma regista o SIP e, onde suportado, sincroniza a lista de números que pode importar.
- Escolha quais números descobertos importar, ou adicione um número manualmente por E.164 (ex.:
+15054079172). - Atribua um agente inbound e/ou outbound a cada número importado.
As ligações de operador SIP partilham o mesmo fluxo de compliance/consentimento das campanhas outbound — KYC do operador e consentimento do cliente final. Até a sua conta ser aprovada, o botão Connect SIP abre uma vitrine listando os operadores suportados e um CTA de pedido de acesso. Contacte support@hanc.ai a partir do modal de vitrine para o ativar; a aprovação é geralmente no mesmo dia útil.
Para operadores sem auto-configuração via API, após a importação o assistente mostra-lhe os passos exatos para configurar o encaminhamento de chamadas dentro do portal do seu fornecedor. Siga esses passos uma vez por número — o agente trata de tudo o resto.
Tipos de Número de Telefone
O ecrã de compra lista todos os tipos abaixo para o país que escolher. Os tipos que não são oferecidos para esse país aparecem desativados (a cinzento) em vez de escondidos, para que possa ver o panorama completo de relance.
Números Locais
Números de telefone associados a uma área específica:
| Exemplo | Cobertura |
|---|---|
| +43 1 xxx xxxx | Viena, Áustria |
| +49 30 xxx xxxx | Berlim, Alemanha |
| +41 44 xxx xxxx | Zurique, Suíça |
Melhor para: Negócios locais, presença regional
Números Móveis
Números que aparecem como telemóveis:
Melhor para: Sensação de serviço pessoal, capacidade de SMS
Números Nacionais
Números não geográficos que representam o seu negócio num país inteiro em vez de numa cidade ou área:
Melhor para: Marcas de âmbito nacional que não querem sinalizar uma única região
Números Gratuitos
Números onde o interlocutor não paga:
| Exemplo | País |
|---|---|
| 0800 xxx xxx | Áustria/Alemanha |
| 1-800-xxx-xxxx | EUA |
Melhor para: Apoio ao cliente, alcance nacional
Números Advanced
Advanced não é um tipo de número: é o que o número está autorizado a fazer. Um número Basic atende chamadas; um número Advanced também as faz. Escolha Advanced se o agente tiver de devolver chamadas, lançar campanhas ou transferir para uma linha externa.
Custa €2/mês acima do preço normal do número e está disponível em todos os países onde vendemos números, não apenas nos cinco em que o Basic é oferecido.
Na dúvida, escolha Advanced. A capacidade de saída não pode ser acrescentada mais tarde a um número Basic: seria preciso comprar um número novo e reatribuir o agente.
Números de Chamada WhatsApp
Obtenha um número WhatsApp e o seu agente de voz atende chamadas diretamente dentro do WhatsApp — os clientes ligam-lhe através da app que já usam. O tipo de número e o preço mensal são mostrados à partida na compra, por isso não há surpresas.
Melhor para: Negócios cujos clientes preferem contactá-los no WhatsApp
Verificação de Números e Proteção Contra Fraude
Para proteger a sua conta e manter o encaminhamento de chamadas limpo, a Hanc.AI verifica os números antes de poderem ser usados — tanto o número com que regista a sua conta como os números-alvo que marca em campanhas outbound.
Números de risco são rejeitados à partida
Antes de qualquer código de verificação ser enviado, a Hanc.AI filtra o número. Se não puder ser usado com segurança, é informado de imediato — "este número não pode ser usado, tente outro" — em vez de esperar por um código que nunca funcionará. Os números rejeitados nesta fase incluem:
- Números de tarifa premium e de custo partilhado (risco de fraude de tarifação)
- Números estruturalmente inválidos que não formam um número real e marcável
- Linhas fixas que a consulta de número assinala como inalcançáveis para verificação
Verificação de linha fixa por chamada de voz
Onde um código SMS normal não pode ser entregue — normalmente linhas fixas — a Hanc.AI recorre a uma chamada de voz que lê um código de uso único (OTP), para que possa ainda assim verificar uma linha fixa válida.
Códigos no seu idioma
Os códigos de verificação e as chamadas de voz chegam no idioma da sua interface, para que a mensagem que recebe corresponda ao idioma em que usa a Hanc.AI.
Atribuir Agentes a Números
Agente Inbound
O agente que atende chamadas recebidas:
- Vá a Phone Numbers
- Clique num número
- Em Inbound Agent, selecione o seu agente
- Guarde
Agente Outbound
O agente usado para chamadas efetuadas a partir deste número:
- Vá a Phone Numbers
- Clique num número
- Em Outbound Agent, selecione o seu agente
- Guarde
Vários Números, Um Agente
Pode atribuir o mesmo agente a vários números:
Vários Agentes, Vários Números
Ou agentes diferentes para números diferentes:
Gestão de Números
Ver Todos os Números
Vá a Phone Numbers para ver:
- Todos os seus números
- Agentes atribuídos
- Estado
- Fornecedor
Editar Definições do Número
- Clique no número
- Modifique as definições (nome, agentes atribuídos, estado)
- Guarde as alterações
Remover Número
- Clique no número
- Clique em Delete ou Remove
- Confirme a remoção
Remover um número pode resultar na perda permanente desse número. Poderá ser atribuído a outra pessoa se for libertado.
Mover um Número para Outro Workspace
Quando cria um número dentro do seu workspace principal e quer entregá-lo a um workspace de cliente (ou vice-versa), pode transferi-lo sem o libertar de volta ao fornecedor.
- Vá a Phone Numbers
- Na linha que quer mover, clique no ícone de seta (tooltip: Move to another workspace)
- No modal "Move phone number to another workspace", escolha o destino no dropdown (ou Home para o retirar de qualquer workspace)
- Confirme
Após a mudança:
- O número desaparece da lista do workspace de origem e aparece no destino
- Quaisquer atribuições de agente podem ser desligadas se o agente atribuído não viver no workspace de destino — reatribua a um agente do novo lado após a mudança (o modal avisa-o disto antes de confirmar)
- Se tanto o agente como o número acabarem no mesmo workspace, a atribuição é preservada
Dica: se está a mover tanto um agente como um número que funcionam em conjunto, o caminho mais simples é mover o agente primeiro — os números de telefone associados ao agente viajam com ele automaticamente.
Manter o seu número atual
Não é preciso transferir o seu número para a Hanc.AI para lhe pôr um agente em cima. Mantenha a linha que já divulga e reencaminhe-a para o seu número Hanc: quem liga marca o que sempre marcou, e o agente atende.
O reencaminhamento define-se no seu telefone ou junto do seu operador, não aqui. Na maioria das redes móveis, faz-se marcando um código curto. Substitua numero pelo seu número Hanc em formato internacional (+436641234567):
| Quando reencaminhar | Ativar | Desativar | Verificar |
|---|---|---|---|
| Todas as chamadas — o agente atende tudo | **21*numero# | ##21# | *#21# |
| Se ocupado — já está em linha | **67*numero# | ##67# | *#67# |
| Se não atender | **61*numero# | ##61# | *#61# |
| Se inacessível — telefone desligado ou sem rede | **62*numero# | ##62# | *#62# |
| As três condicionais de uma vez | **004*numero# | ##004# | — |
| Desativar tudo | — | ##002# | — |
Marque o código como um número e prima chamar. A rede responde com uma breve confirmação.
Escolher o atraso. Com **61* pode indicar quanto tempo toca antes de o agente atender: acrescente os segundos, **61*+436641234567*20# toca 20 segundos primeiro. Os valores permitidos vão de 5 a 30 segundos, de cinco em cinco. Vinte segundos é uma boa definição: chega para atender se estiver livre, e é curto o suficiente para quem ligou não desligar.
Qual escolher:
- Todas as chamadas se o agente for a primeira linha e você só receber o que ele transferir.
- As três condicionais se atende pessoalmente quando pode e quer que o agente apanhe o resto. É a escolha típica de uma pequena empresa: ninguém vai parar ao voicemail.
- Só se ocupado, se apenas quiser deixar de perder o segundo chamador.
Os códigos acima pertencem à norma GSM e funcionam em redes móveis. Um fixo ou uma central de empresa oferece normalmente o reencaminhamento nas suas próprias definições ou no portal web: o princípio é idêntico, muda apenas a forma de o ativar.
Quando o seu operador reencaminha uma chamada, cobra-lhe o troço do seu número até ao número Hanc, às tarifas dele. É separado do que a chamada custa no seu plano Hanc.
Cenários de Encaminhamento de Chamadas
Simples: Um Número, Um Agente
Configuração mais comum:
Com Fallback
Se o agente não conseguir gerir:
Encaminhamento por Departamento
Números diferentes para propósitos diferentes:
Boas Práticas
Seleção de Número
- Escolha números locais para negócios locais
- Use números gratuitos para linhas de apoio ao cliente
- Considere números móveis para serviços pessoais
- Tenha um número de reserva para emergências
Configuração
- Teste os números antes de entrar em produção
- Defina números de fallback para falhas do agente
- Rotule os números claramente na sua conta
Operações
- Monitorize os volumes de chamadas por número
- Acompanhe as taxas de sucesso por número
- Reveja periodicamente — remova números não usados
Resolução de Problemas
As chamadas não estabelecem ligação
Verifique:
- O estado do número é ACTIVE
- A integração do número de telefone está ligada
- Há um agente atribuído ao número
- O agente está ativo (não em pausa)
Má qualidade de áudio
Causas possíveis:
- Problemas de rede
- Região do fornecedor
- Qualidade do telefone do cliente
Soluções:
- Verifique a página de estado da plataforma
- Teste com telefones diferentes
Chamadas a ir para o agente errado
Verifique:
- A definição de agente inbound do número
- Sem webhooks em conflito
- O número correto apresentado no painel
Custos
Utilização da Hanc.AI
A Hanc.AI usa faturação baseada em créditos:
- Todos os planos incluem agentes ilimitados
- As chamadas são faturadas por minuto a partir do seu saldo de créditos
- Os números de telefone têm um custo mensal (cobrado dos créditos)
- As taxas por minuto variam consoante o plano (veja Faturação)
Tópicos Relacionados
- Agentes de Voz IA — Criar agentes para números de telefone
- Integrações — Configuração de números de telefone e integrações
- Analítica — Estatísticas de chamadas por número