Como instalar a Nvoip na Tray e configurar o widget
Última atualização: 08/09/2026
A integração Nvoip com a Tray permite instalar um widget de atendimento na vitrine da loja virtual. O processo começa no administrador da loja Tray: você autoriza o aplicativo, conecta sua conta Nvoip, escolhe o widget e clica em Integrar.
O visitante verá os canais configurados no widget escolhido, como chat, WhatsApp, telefone e e-mail, conforme a disponibilidade na sua conta. Este manual mostra o caminho pelo painel Nvoip e pela Tray, a seleção do widget, a conferência na vitrine e a solução dos erros mais comuns.
Antes de começar
- Tenha acesso administrativo à loja Tray e permissão para instalar aplicativos.
- Tenha uma conta Nvoip e acesso às suas configurações de atendimento.
- Crie e configure o widget que deseja exibir na loja.
- Prepare os canais, horários e destinos do atendimento na Nvoip.
- Identifique o domínio correto da loja Tray.
O aplicativo instala o widget escolhido. Ele não configura automaticamente todos os canais da Nvoip e não substitui um sistema de sincronização de produtos, estoque ou pedidos. Serviços de telefonia e mensageria seguem as condições da sua conta.
Passo 1 — Escolher por onde começar
Você pode iniciar pelo catálogo Nvoip ou diretamente no administrador Tray. Nos dois casos, a autorização da loja acontece na Tray.
Pelo painel Nvoip
- Abra Integrações no Painel Nvoip.
- Busque Tray.
- Clique em Ver integração e abra a aba Configuração.
- No campo Domínio da sua loja Tray, informe o endereço HTTPS da loja. Exemplo de formato: https://sualoja.com.br.
- Clique em Abrir minha loja Tray.
- Entre no administrador Tray, se solicitado, e confira se está na loja correta.
O domínio é usado para abrir o administrador da loja. Esse campo não recebe senha ou chave de integração. Não informe endereço de produto, página de checkout ou domínio de outra loja.
Diretamente pela Tray
- Entre no administrador da sua loja Tray.
- Abra Aplicativos → Instalar novos aplicativos.
- Busque Nvoip e abra a ficha do aplicativo.
- Se ele já estiver instalado, use Meus aplicativos → Nvoip → Acessar.
Também é possível consultar a ficha oficial do aplicativo Nvoip na Tray. Se a busca não localizar o aplicativo, confira primeiro se ele já aparece em Meus aplicativos.
A ficha pode apresentar informações comerciais próprias, como Preço sob consulta. Confira as condições mostradas pela Tray e os serviços da sua conta Nvoip antes de concluir uma contratação. A identificação do plano no catálogo Nvoip não substitui essas condições.
Passo 2 — Autorizar a integração com a loja
- Na ficha do aplicativo Nvoip, clique em Instalar.
- Confirme que a autorização se refere à loja desejada.
- Leia as permissões apresentadas pela Tray.
- Autorize a integração quando estiver de acordo.
- Aguarde o redirecionamento para a configuração Nvoip.
Comece pela sua loja. Abrir a página genérica da integração sem o contexto da Tray pode mostrar a mensagem de que não foi possível identificar a loja. Nesse caso, retorne a Aplicativos no administrador Tray e reabra o Nvoip por lá. Não é necessário montar um link técnico de autorização manualmente.
Passo 3 — Conectar a conta Nvoip
- Na página do aplicativo, use Conectar a NVOIP quando a conta ainda não estiver conectada.
- Faça login com a conta Nvoip que contém o widget desejado.
- Conclua a verificação de segurança, se solicitada.
- Confira as permissões apresentadas na autorização Nvoip e prossiga quando estiver de acordo.
- Aguarde o retorno à página de seleção do widget.
Se a lista de widgets já estiver disponível, a sessão pode estar conectada. Confira se os widgets pertencem à conta esperada antes de integrar. Você não precisa fornecer a senha da Tray ao painel Nvoip nem copiar chaves da loja.
Passo 4 — Selecionar o widget e clicar em Integrar
- Abra o campo Selecionar widget para integração.
- Escolha o widget preparado para sua loja.
- Clique em Integrar uma vez e aguarde a resposta.
- Confira a mensagem de sucesso de instalação ou atualização.
Na captura, widget 2 é apenas o nome usado na loja de demonstração. Na sua operação, escolha o widget que contém os canais e destinos corretos. A confirmação pode incluir um identificador de script; você não precisa copiar esse número ou editar código para concluir a instalação.
Se a operação ainda estiver em andamento, aguarde. Em caso de erro, leia a mensagem antes de repetir o clique. Não instale manualmente uma segunda cópia do widget no tema para tentar corrigir a primeira.
Passo 5 — Conferir o widget na vitrine
- Abra a página inicial pública da loja, preferencialmente em outra aba.
- Aguarde o carregamento. Se necessário, role a página ou interaja com ela conforme o comportamento do widget.
- Localize o ícone Nvoip e abra o menu de atendimento.
- Confira se os canais configurados aparecem.
- Repita em uma página de categoria ou produto e em um celular.
- Confira se o widget não encobre botões importantes da loja e se aparece apenas uma vez.
As capturas de seleção e vitrine foram feitas na loja de testes em 08/09/2026. O tema, a posição do widget e os canais exibidos dependem da sua loja e da configuração escolhida.
A aparência é a primeira conferência. Para confirmar o atendimento, combine um teste com a equipe e use um contato sob seu controle. Abra o canal desejado, conclua a interação e verifique se ela chega ao destino correto na Nvoip. Ligações e mensagens podem utilizar serviços tarifados da sua conta.
Alterar o widget da loja
- Entre na Tray e abra Aplicativos → Meus aplicativos → Nvoip → Acessar.
- No aplicativo, selecione o novo widget.
- Clique em Integrar e aguarde a confirmação de atualização.
- Reabra a vitrine e confira os canais e a identidade visual.
Para mudar a aparência ou os canais de um widget, ajuste primeiro sua configuração na Nvoip. Se a mudança for a escolha de outro widget, atualize também a seleção no aplicativo Tray.
Remover o widget ou reinstalar o aplicativo
Na tela de seleção, há um botão X ao lado de Integrar para remover a integração do widget. Use-o somente quando quiser interromper sua exibição e confira a mensagem de confirmação. Abra a vitrine em seguida para verificar o resultado.
Se o objetivo for remover o aplicativo da loja, use as opções de gerenciamento da Tray em Meus aplicativos. Planeje a interrupção com a equipe e confira a ausência do widget na vitrine. Caso exista uma instalação manual antiga no tema, ela precisa ser identificada separadamente.
Ao reinstalar, volte ao administrador Tray, autorize o aplicativo, conecte a conta Nvoip, selecione o widget e clique em Integrar. Não presuma que reinstalar sozinho restaure a configuração anterior.
Solução de problemas
| Situação | Como resolver |
|---|---|
| Nvoip não aparece na busca da Tray | Confira Meus aplicativos; se já estiver instalado, use Acessar. Consulte a ficha oficial e confirme que está na loja correta |
| Não foi possível identificar a loja | Reabra pelo administrador Tray; uma página genérica sem contexto da loja não conclui a autorização |
| Não há widgets na lista | Confira a conta Nvoip usada no login, a existência de um widget e as permissões do usuário |
| A sessão expirou | Reabra o aplicativo pela Tray e conecte novamente a conta Nvoip quando solicitado |
| Integrar retorna erro | Registre a mensagem e o horário; confira a autorização e procure o suporte se persistir |
| Houve sucesso, mas o widget não aparece | Confirme a loja e o widget escolhidos; recarregue a vitrine, confira páginas diferentes e eventuais bloqueios de scripts |
| O widget aparece duas vezes | Verifique se existe uma cópia instalada manualmente no tema ou por outro aplicativo; evite adicionar um terceiro código |
| Um canal não aparece | Confira se ele está habilitado no widget e disponível na conta Nvoip |
| O canal abre, mas o contato não chega | Revise o destino, o horário, a fila e a configuração do canal na Nvoip |
Perguntas frequentes
Preciso editar o código da loja Tray?
No caminho pelo aplicativo, você seleciona o widget e usa Integrar. A instalação não exige colar o código manualmente no tema.
Posso instalar pela Nvoip sem entrar na Tray?
O cartão Nvoip facilita o acesso ao administrador da loja. A instalação e a autorização da loja continuam sendo concluídas na Tray.
Quais canais aparecem no widget?
Os canais configurados no widget selecionado e disponíveis na sua conta. A imagem deste guia é um exemplo, não uma ativação automática de todos os serviços.
Já tenho o aplicativo instalado. Preciso instalar novamente?
Comece por Meus aplicativos → Nvoip → Acessar. Para trocar o widget, use a seleção e Integrar. Reinstalar não é necessário apenas para abrir a configuração.
O botão Integrar confirma que o atendimento funciona?
Ele confirma a operação de integração apresentada pela aplicação. Confira também a vitrine e faça uma interação controlada com a equipe para verificar o canal de atendimento.
Posso usar o mesmo procedimento para Mercado Livre ou OLX?
São integrações diferentes. A Tray instala o widget na sua loja; Mercado Livre e OLX recebem eventos dos marketplaces e usam entradas específicas no Fluxo Nvoip.
Precisa de ajuda?
Abra o Suporte Técnico no painel Nvoip e informe o domínio da loja, a etapa em que ocorreu a falha, o horário e a mensagem apresentada. Inclua uma captura sem senhas, tokens ou informações pessoais desnecessárias.
Veja também como usar a área de Integrações, como instalar a Nvoip na Nuvemshop, o manual do Mercado Livre e o manual da OLX.