Nvoip · Base de Conhecimento

Como integrar a Nvoip com n8n pelo painel

Última atualização: 23/10/2026

Este manual explica como conectar o n8n à API v3 da Nvoip usando Client ID e Client Secret. O nó Nvoip emite o primeiro token e renova o acesso automaticamente quando ele vence.

Antes de continuar, consulte Como gerar credenciais OAuth da API v3 no Painel Nvoip para entender armazenamento, escopos e gerenciamento da credencial.

Antes de começar

Você precisa de:

  • acesso ao Painel Nvoip e à área Integrações;
  • permissão para criar credenciais da API;
  • um ambiente n8n em que seja possível instalar ou atualizar o nó da Nvoip;
  • o pacote @nvoip/n8n-nodes-nvoip na versão 0.2.0 ou mais recente.

Gerar a credencial pelo card do n8n

  1. No Painel Nvoip, acesse Integrações.
  2. Pesquise por n8n e abra o card da integração.
  3. Clique em Gerar credencial do n8n.
  4. Copie o Client ID e o Client Secret.
  5. Guarde os valores em local seguro antes de fechar a janela.

O Client Secret aparece uma única vez. O Painel cria uma credencial client_credentials chamada n8n com estes escopos:

  • call:make;
  • call:query;
  • sms:send;
  • whatsapp:send;
  • whatsapp:templates.

Se o seu usuário não puder criar a credencial, peça ao administrador da conta para liberar o acesso à API ou gerar a credencial. Quando um revendedor estiver operando uma conta selecionada, cada cliente deve gerar a própria credencial; a credencial da revenda não deve ser compartilhada com clientes.

Instalar ou atualizar o nó no n8n

  1. No n8n, instale ou atualize o pacote @nvoip/n8n-nodes-nvoip.
  2. Confirme que a versão instalada é 0.2.0 ou mais recente.
  3. Adicione o nó Nvoip ao workflow.
  4. Em Authentication, escolha Client ID and Secret (Automatic Renewal).
  5. Crie a credencial Nvoip Client Credentials API.
  6. Cole o Client ID e o Client Secret gerados no Painel.

Não use o modo antigo de colar um access token. Um token legado pode continuar funcionando até vencer, mas não será renovado automaticamente.

Testar antes de ativar o workflow

  1. Salve a credencial no n8n.
  2. Comece com uma consulta sem efeito externo permitida pelos escopos.
  3. Confirme que o token foi obtido e que os dados pertencem à conta esperada.
  4. Configure os nós de SMS, WhatsApp ou chamada somente depois da autenticação funcionar.
  5. Faça o primeiro envio real apenas para um destino controlado e autorizado.

O n8n solicita um token na primeira execução e outro quando o anterior vence. Não é necessário copiar um novo token nem reconectar o workflow.

Gerenciar ou remover o acesso

Para desativar ou excluir a credencial, acesse Desenvolvedor, localize Nvoip API v3 (OAuth2.0) e identifique a credencial n8n pelo Client ID.

Antes de desativar ou excluir, pare ou atualize os workflows que usam a credencial. Se precisar trocá-la, crie a substituta, valide o workflow e somente depois desative a anterior.

Solução de problemas

O botão para gerar a credencial não está disponível

Confirme o acesso à API do usuário e se a operação está na conta própria. Clientes de revenda devem gerar a credencial dentro do próprio painel ou seguir a orientação do revendedor.

O Client Secret foi perdido

Ele não pode ser recuperado. Gere uma nova credencial, atualize o n8n e depois desative ou exclua a anterior.

O n8n autentica, mas a operação retorna HTTP 403

Confira se a operação faz parte dos escopos concedidos e se o canal está habilitado na conta. Não amplie a credencial sem revisar a necessidade do workflow.

O workflow antigo parou depois de 24 horas

Ele provavelmente usa um access token colado manualmente. Atualize o nó para 0.2.0 ou mais recente e configure Client ID and Secret (Automatic Renewal).

Nunca publique Client ID, Client Secret ou access token no workflow exportado, em repositórios, tickets, prints ou logs.