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/