Nvoip · Base de Conhecimento

Como instalar o app Nvoip na Nuvemshop

Como instalar o app Nvoip na Nuvemshop

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

Este manual mostra como instalar o app Nvoip Widget na sua loja Nuvemshop, conectar a sua conta Nvoip e publicar o widget de atendimento na vitrine.

Com o app, os visitantes da loja falam com você pelo canal que preferirem (WhatsApp, chat, ligação ou e-mail), sem sair do site. Cada contato chega organizado no painel da Nvoip. A instalação não altera o tema da loja e não exige código.

Antes de começar

  • Acesso de administrador à loja Nuvemshop.
  • Uma conta Nvoip ativa. O plano Free serve: veja os planos.
  • Pelo menos um widget criado no Painel Nvoip, em Configurações > Widget, com os canais que devem aparecer na loja. Se ainda não tiver, siga o manual Criando um Widget.
Permissões: o app pede à Nuvemshop apenas a permissão de Scripts, usada para colocar o widget na vitrine. Ele não lê produtos, pedidos nem dados de clientes da loja.

1. Instalar o app na Nuvemshop

  1. No painel de administração da Nuvemshop, clique em Aplicativos e depois em Loja de aplicativos.
  2. Procure por Nvoip Widget e clique em Instalar aplicativo.
  3. Leia as permissões e clique em Aceitar e começar a usar.

Depois da instalação, o app aparece na lista de aplicativos da loja com o status Ativada. Para abrir o app mais tarde, clique em Nvoip Widget nessa lista.

Lista de aplicativos da Nuvemshop com o Nvoip Widget ativado
Aplicativos da loja: o Nvoip Widget instalado e ativado.

2. Conectar a sua conta Nvoip

Na tela do app, clique em Conectar a NVOIP.

Tela inicial do app com o botão Conectar a NVOIP
Tela inicial do app Nvoip na Nuvemshop.

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 clique em Entrar. Se você já estiver logado no Painel Nvoip no mesmo navegador, a conexão é feita direto, sem pedir login.

Janela de login da Nvoip aberta pelo app
Janela de login da Nvoip durante a conexão.
Se a janela de login não abrir, o navegador pode ter bloqueado o pop-up. Libere pop-ups para a página do app e clique de novo em Conectar a NVOIP.

3. Escolher o widget

Com a conta conectada, o app mostra a tela Escolher widget:

  • Loja: o endereço da vitrine onde o widget será publicado. Se a loja usa domínio próprio, clique em Alterar URL para conferir.
  • Widget da sua conta Nvoip: a lista de widgets da conta, com nome e número (ID).
  • Se a loja já tem um widget integrado, ele aparece em verde, logo abaixo, com o nome.
Tela Escolher widget com a URL da loja e a lista de widgets
Tela Escolher widget: orientações, loja de destino e lista de widgets.

Selecione o widget que vai aparecer na loja. O app confirma qual widget e qual loja você escolheu. Nada é publicado até você clicar em Integrar.

Dica: dê ao widget um nome que identifique a loja, como “Atendimento da minha loja”. Para conferir a prévia e os canais, use o link Configurações → Widget no Painel Nvoip, que abre numa nova aba.

4. Integrar

Clique em Integrar. O widget passa a aparecer na vitrine na próxima visita, sem aprovação manual.

Widget selecionado e botão Integrar
Widget selecionado, confirmação da loja e botão Integrar.
  • Para trocar o widget, selecione outro e clique em Integrar de novo.
  • Para tirar o widget da loja, clique no ícone de lixeira ao lado do botão Integrar (Remover widget integrado).
  • Para desconectar a conta Nvoip do app, use Logout, no fim da tela.

5. Conferir na vitrine

Abra a sua loja e confira o botão de atendimento no canto inferior direito. Ao clicar nele, o cliente vê os canais configurados no widget.

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.

Mudanças feitas depois no Painel Nvoip (canais, cores, textos, páginas e horários) aparecem na loja automaticamente, sem reinstalar o app.

Solução de problemas

O widget não aparece na vitrine

  • Confira se a integração foi concluída: a tela do app mostra o widget integrado em verde.
  • Confira no Painel Nvoip se o widget está ativo e com os canais habilitados.
  • Veja as regras de exibição do widget: ele pode estar configurado para aparecer só em algumas páginas ou horários.
  • O widget carrega logo após a página abrir. Role a página ou aguarde alguns segundos.
  • Confira se o app continua instalado e ativado em Aplicativos, na Nuvemshop.

Aparece “Sem widgets disponíveis”

A conta Nvoip conectada ainda não tem widget. Crie um em Configurações > Widget no Painel Nvoip, volte ao app e atualize a página.

Aparece “Sua sessão expirou”

Clique em Conectar a NVOIP e entre de novo com a sua conta.

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.