Como integrar a Nvoip com a Loja Integrada

Última atualização: 26/09/2026

Este manual mostra como integrar a Nvoip com a sua loja na Loja Integrada e publicar o widget Fale Conosco da Nvoip na vitrine.

Com o widget, os visitantes da loja falam com você pelo canal que preferirem (WhatsApp, ligação, chat ou e-mail), sem sair do site. Cada contato chega organizado no painel da Nvoip. O widget aparece em todas as páginas da loja, exceto no checkout.

Antes de começar

Acesso de administrador à loja na Loja Integrada.
Loja no plano Crescimento ou superior da Loja Integrada. A Chave API e os códigos personalizados não estão disponíveis nos planos abaixo dele.
Loja com um tema instalado pela Loja de temas da Loja Integrada. O tema padrão novo não aceita códigos personalizados, então o widget não aparece nele.
Verificação em duas etapas ativa na sua conta da Loja Integrada (é exigida para gerar a Chave API).
Uma conta Nvoip ativa, com pelo menos um widget criado em Configurações > Widget no painel da Nvoip. Se ainda não tiver, siga o manual Criando um Widget.

Atenção à troca de tema: se a loja usa o tema padrão novo, será preciso instalar um tema da Loja de temas. Essa troca é definitiva: depois dela, a loja não volta para o tema padrão novo. Confira o visual do tema escolhido antes de instalar.

1. Gerar a Chave API na Loja Integrada

No painel da Loja Integrada, acesse Configurações > Chave para API. A tela Chaves para acesso à API abre.
Se a verificação em duas etapas ainda não estiver ativa, ative-a quando o painel pedir.
Clique em Cadastrar nova chave, dê um nome que identifique o uso (por exemplo, nvoip_widget) e confirme.
Copie o valor da chave. Guarde-a em local seguro: ela dá acesso à sua loja.

Tela Chaves para acesso à API da Loja Integrada com o botão Cadastrar nova chave

Configurações > Chave para API na Loja Integrada (valores das chaves ocultados).

A Nvoip usa a chave só para instalar e remover o código do widget na sua loja. Ela não lê pedidos, produtos nem dados dos seus clientes.

2. Conectar a loja

Abra https://integrations.nvoip.com.br/lojaintegrada/ em uma nova aba do navegador.
Em Endereço da loja, informe o endereço da vitrine (por exemplo, https://sualoja.lojaintegrada.com.br ou o seu domínio próprio).
Em Chave API da loja, cole a chave gerada no passo anterior.
Clique em Conectar loja.

Tela da integração com os campos Endereço da loja e Chave API da loja e o botão Conectar loja

Tela inicial da integração Nvoip para a Loja Integrada.

Se a chave for aceita, a tela mostra o nome e o domínio da loja.

3. Entrar com a sua conta Nvoip

Clique em Conectar a Nvoip. Uma janela de login da Nvoip vai abrir: informe o e-mail e a senha da sua conta (ou use o SSO corporativo, se a sua empresa usa) e autorize o acesso. Se você já estiver logado no painel da Nvoip no mesmo navegador, a conexão é feita direto.

Se a janela de login não abrir, o navegador pode ter bloqueado o pop-up. Libere pop-ups para integrations.nvoip.com.br e clique de novo em Conectar a Nvoip.

4. Escolher o widget e integrar

Na tela Escolher widget, selecione na lista o widget que deve aparecer na loja.
Clique em Integrar.
Aguarde a mensagem Pronto! e clique em Concluir e voltar para a Loja Integrada.

Abaixo da lista, a tela mostra Integrado: seguido do nome do widget publicado na loja. Para trocar o widget, selecione outro e clique em Integrar de novo.

5. Conferir na vitrine

Abra a sua loja e confira o botão de atendimento no canto da página. Ao clicar nele, o cliente vê os canais configurados no widget. A publicação pode levar alguns minutos (até 10) para aparecer na vitrine.

Widget aberto na vitrine da loja com WhatsApp, e-mail, chat e ligação

Widget aberto na vitrine: WhatsApp, e-mail, chat e ligação.

Configurar os canais e o visual do widget

Os ícones, canais (WhatsApp, ligação, chat e e-mail), cores, textos e horários do widget são configurados no painel da Nvoip, em Configurações > Widget. As mudanças salvas ali aparecem na loja automaticamente, sem refazer a integração.

Como remover o widget da loja

Abra https://integrations.nvoip.com.br/lojaintegrada/. Se a tela pedir, conecte de novo a loja (endereço e Chave API) e a conta Nvoip, como nos passos 2 e 3.
Na tela Escolher widget, clique no botão X ao lado de Integrar (Remover widget integrado).

O código do widget é retirado da loja. A tela passa a mostrar Nenhum widget integrado no momento.

Dúvidas frequentes

O widget não aparece na vitrine

Confira se a loja está no plano Crescimento ou superior.
Confira se a loja usa um tema da Loja de temas. No tema padrão novo, o widget não é exibido.
Aguarde até 10 minutos: a vitrine da Loja Integrada guarda as páginas em cache.
Confira se a integração foi concluída: a tela da integração mostra Integrado: com o nome do widget.
Confira no painel da Nvoip se o widget está ativo e com os canais habilitados.
Lembre que o widget não aparece na página de checkout.

A tela da integração mostra a configuração antiga

Uma aba aberta antes pode guardar a configuração anterior. Feche-a e abra https://integrations.nvoip.com.br/lojaintegrada/ em uma nova aba.

Aparece “Sem widgets disponíveis”

A conta Nvoip conectada ainda não tem widget. Crie um em Configurações > Widget no painel da Nvoip e volte à tela da integração.

Não encontro a opção Chave para API

A Chave API só existe a partir do plano Crescimento da Loja Integrada e exige a verificação em duas etapas ativa na conta. Se ainda assim não aparecer, fale com o suporte da Loja Integrada.

O WhatsApp ou a ligação não aparecem no widget

Esses canais dependem da configuração da conta Nvoip. O WhatsApp precisa de um número conectado. A ligação depende de número virtual, saldo e plano. Confira também se o canal está habilitado no widget escolhido.

Suporte

Se precisar de ajuda, fale com o suporte Nvoip:

E-mail: [email protected]
Central de Ajuda: https://suporte.nvoip.com.br/portal/pt/kb
Telefone: (11) 4118-6267
Horário de atendimento: segunda a sexta, das 9h às 18h.