Nvoip · Base de Conhecimento

Como integrar a API Nvoip com Java

Antes de configurar a autenticação OAuth: gere o Client ID e o Client Secret seguindo o manual Como gerar credenciais OAuth da API v3 no Painel Nvoip. Depois, volte a este guia para aplicar os escopos e os campos específicos desta integração.

Repositório: https://github.com/Nvoip/nvoip-java

Pacote Maven: br.com.nvoip:nvoip-java

Instalação Maven

<dependency>
  <groupId>br.com.nvoip</groupId>
  <artifactId>nvoip-java</artifactId>
  <version>1.0.0</version>
</dependency>

Configuração

Use OAuth client_credentials no backend, com um cliente criado na tela Desenvolvedor e os escopos da operação. A API usa https://api.nvoip.com.br/v3; o token é emitido em https://api.nvoip.com.br/auth/oauth2/token. Guarde o token recebido em NVOIP_ACCESS_TOKEN.

A versão 1.0.0 está disponível no Maven Central.

export NVOIP_OAUTH_CLIENT_ID="seu_client_id"
export NVOIP_OAUTH_CLIENT_SECRET="seu_client_secret"
export NVOIP_CALLER="1049"
export NVOIP_TARGET_NUMBER="11999999999"

Primeiros testes

mvn test
mvn -q exec:java

Recursos cobertos

OAuth, chamadas, OTP, WhatsApp templates, SMS e saldo.

Disponibilidade da versão v3

O JAR, o POM, o código-fonte e o Javadoc desta versão estão disponíveis no Maven Central.