Como usar o Nvoip BNTC em qualquer site

Como usar o Nvoip BNTC em qualquer site

O Nvoip BNTC significa Best Number to Call, ou melhor número para ligar. Ele permite exibir automaticamente o telefone mais adequado para cada visitante do site.

Quando usar

  • Quando sua empresa tem números em várias cidades, estados ou países.
  • Quando você quer mostrar um DDD local para aumentar a confiança do visitante.
  • Quando precisa ter grupos de telefone, como vendas, suporte ou campanhas.
  • Quando quer usar 0800 ou 4003 apenas em páginas específicas.

Versões disponíveis

  • Plugin WordPress: indicado para sites WordPress, com painel de configuração e snippets como {nvoip_bntc}.
  • Versão web: indicada para qualquer site HTML, landing page ou aplicação web.

Se o seu site usa WordPress, siga o tutorial específico do plugin: Como usar o Nvoip BNTC no WordPress.

Como instalar em qualquer site

  1. Baixe o pacote Nvoip BNTC Web na central de downloads.
  2. Envie o arquivo dist/nvoip-bntc-web.js para o seu site.
  3. Configure os números antes de carregar o script.
  4. Coloque o snippet no ponto em que o telefone deve aparecer.
<script>
  window.NvoipBNTC = {
    defaultNumber: "551141186267",
    format: "national",
    cacheHours: 24,
    ipFallback: true,
    numbers: [
      {
        phone: "551141186267",
        label: "São Paulo",
        city: "São Paulo",
        state: "SP",
        country: "BR",
        areaCode: "11",
        lat: -23.5505,
        lng: -46.6333,
        group: "default",
        priority: 10
      }
    ]
  };
</script>
<script src="/dist/nvoip-bntc-web.js" defer></script>

Como inserir o telefone no HTML

<a href="tel:{nvoip_bntc}">
  <span data-nvoip-bntc>{nvoip_bntc}</span>
</a>

Para grupos diferentes, use o nome do grupo:

<a href="tel:{nvoip_bntc:vendas}">
  <span data-nvoip-bntc data-bntc-group="vendas">{nvoip_bntc:vendas}</span>
</a>

Campos principais da configuração

  • defaultNumber: número exibido quando nenhuma regra local for encontrada.
  • format: formato de exibição. Exemplos: national, e164, spaces ou raw.
  • numbers: lista de números locais com país, estado, cidade, DDD, latitude e longitude.
  • specialNumbers: números especiais como 0800 ou 4003.
  • group: grupo do snippet. Se não informar, será usado default.

Regras especiais

Use specialNumbers para configurar números nacionais ou promocionais.

  • mode: fallback usa o número especial apenas quando não houver número local melhor.
  • mode: override permite que o número especial tenha prioridade quando as regras baterem.
  • allowedPaths limita o número a páginas específicas, como /contato ou /precos.
  • eligibleAreaCodes limita o número a DDDs específicos.

Depuração

Adicione ?nvoip_bntc_debug=1 no final da URL para abrir o painel de debug. Ele mostra permissão de geolocalização, dados detectados e número escolhido.

Também é possível simular uma latitude e longitude:

?nvoip_bntc_lat=-21.7642&nvoip_bntc_lng=-43.3496

Fallback por IP

Quando o visitante não autoriza a geolocalização do navegador, a versão web pode consultar uma base pública de localização por IP para estimar cidade, estado, país, latitude e longitude. Para desativar, configure ipFallback: false.

Download

Acesse a central de downloads e escolha Nvoip BNTC Web:

https://www.nvoip.com.br/downloads/

    • Related Articles

    • Como usar o Nvoip BNTC no WordPress

      O Nvoip BNTC significa Best Number to Call, ou melhor número para ligar. No WordPress, ele funciona como um plugin que substitui snippets como {nvoip_bntc} pelo telefone mais adequado para cada visitante. Quando usar o plugin WordPress Quando seu ...
    • Como usar o Nvoip Web SDK para OTP e 2FA

      Este artigo mostra como usar o Nvoip Web SDK para adicionar validação por OTP e 2FA em uma aplicação web. Importante: nunca exponha Napikey, User Token, client secret, access token ou qualquer credencial da Nvoip no navegador. O SDK deve chamar um ...
    • Como usar o Nvoip IP Provisioner para configurar telefones IP e ATAs

      O Nvoip IP Provisioner e um aplicativo Windows gratuito para ajudar na configuracao inicial de telefones IP e ATAs em rede local. Antes de comecar Use um computador Windows na mesma rede local do telefone ou ATA. Confirme que a interface web do ...
    • Instalando o Click to Call

      O Click to Call da Nvoip é uma extensão disponível na Chrome Web Store, desenvolvida para facilitar a comunicação diretamente a partir de páginas web por meio da Nvoip. Sua principal funcionalidade é identificar automaticamente números de telefone ...
    • Como usar o relatório de chat no painel da Nvoip

      Este artigo explica como consultar o Relatório de Chat no painel da Nvoip e quais informações usar para acompanhar atendimentos. Antes de começar: acesse Relatórios > Chat. Usuários secundários precisam da permissão de relatório de chat. O que ...