nvoip-java

SDK e exemplos oficiais da Nvoip para integrar a API v2 com OAuth, chamadas, OTP, WhatsApp, SMS e saldo em Java.

Requisitos

• Java 11+
• Maven 3.8+

Instalacao

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

Configuração

cp .env.example .env

Ou exporte:

export NVOIP_NUMBERSIP="seu_numbersip"
export NVOIP_USER_TOKEN="seu_user_token"
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"

Build

mvn -q -DskipTests package

Exemplos

java -cp target/classes br.com.nvoip.examples.Main auth-token
java -cp target/classes br.com.nvoip.examples.Main balance
java -cp target/classes br.com.nvoip.examples.Main send-sms
java -cp target/classes br.com.nvoip.examples.Main create-call
java -cp target/classes br.com.nvoip.examples.Main send-otp
java -cp target/classes br.com.nvoip.examples.Main check-otp
java -cp target/classes br.com.nvoip.examples.Main wa-list
java -cp target/classes br.com.nvoip.examples.Main wa-send

Destinatário WhatsApp

O exemplo mantém NVOIP_WA_DESTINATION para telefone. Para o contrato tipado, use NVOIP_WA_RECIPIENT_TYPE=phone|bsuid|parent_bsuid e NVOIP_WA_RECIPIENT_VALUE, sem destination. BSUID é opaco; não use @username nem o coloque em campo de telefone. Exemplos mascarados: US.MASKED_BSUID_001 e PARENT.MASKED_BSUID_001.

SDK web

Para o fluxo de popup com telefone e código, use em conjunto o repositório nvoip-web-sdk. Este repo cobre o consumo server-side da API.

Links oficiais

• Site da Nvoip
• Documentação da API
• Página da API
• Workspace Postman
• Hub de exemplos