Skip to content
Client Java pra API da TotalVoice
Java
Branch: master
Clone or download
jackson
Latest commit 993268e Jan 15, 2020
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
doc
gradle/wrapper
src/main/java/br/com/totalvoice
.gitignore
LICENSE
README.md
build.gradle
gradlew
gradlew.bat
pom.xml
settings.gradle
totalvoice-api-client.iml
totalvoice-java.iml

README.md

totalvoice-java

Client em Java para utilização da API da TotalVoice

Funcionalidades

  • Gerenciamento das chamadas
  • Consulta e envio de SMS
  • Consulta e envio de TTS
  • Consulta e envio de Audio
  • Gerenciamento da Conta
  • Gerenciamento da Central
  • Gerenciamento da DID

Utilização

Para utilizar esta biblioteca, primeiramente você deverá realizar um cadastro no site da Total Voice. Após a criação do cadastro será disponibilizado um AccessToken para acesso a API.

Com o AccessToken em mãos será possível realizar as consultas/cadastros conforme documentação da API

Instalando com o Maven

Basta adicionar este trecho no pom.xml

    <dependencies>
        <dependency>
            <groupId>br.com.totalvoice</groupId>
            <artifactId>totalvoice-java</artifactId>
            <version>1.1.1</version>
        </dependency>
    </dependencies>

Os métodos da API que poderão ser invocados:

  • audio
  • central
  • chamada
  • composto
  • conferencia
  • conta
  • perfil
  • sms
  • tts

A seguir um pequeno exemplo de como pode ser utilizada esta biblioteca.

Realiza uma chamada telefônica entre dois números: A e B
package br.com.totalvoice;

import br.com.totalvoice.api.Chamada;
import org.json.JSONObject;

public class Main {
    
    public static void main(String args[]) {
        
        try {
            TotalVoiceClient client = new TotalVoiceClient("access-token");
            Chamada chamada = new Chamada(client);

            JSONObject result = chamada.ligar("NUMEROA", "NUMEROB");
            System.out.println(result);

        } catch(Exception ex) {
            System.out.println(ex.getMessage());
        }
    }
}
Consulta de chamada pelo ID
package br.com.totalvoice;

import br.com.totalvoice.api.Chamada;
import org.json.JSONObject;

public class Main {
    
    public static void main(String args[]) {
        
        try {
            TotalVoiceClient client = new TotalVoiceClient("access-token");
            Chamada chamada = new Chamada(client);

            JSONObject result = chamada.buscar(123); // ID da chamada
            System.out.println(result);

        } catch(Exception ex) {
            System.out.println(ex.getMessage());
        }
    }
}
Encerrar chamada
package br.com.totalvoice;

import br.com.totalvoice.api.Chamada;
import org.json.JSONObject;

public class Main {
    
    public static void main(String args[]) {
        
        try {
            TotalVoiceClient client = new TotalVoiceClient("access-token");
            Chamada chamada = new Chamada(client);

            JSONObject result = chamada.encerrar(123); // ID da chamada
            System.out.println(result);

        } catch(Exception ex) {
            System.out.println(ex.getMessage());
        }
    }
}
Envio de SMS
package br.com.totalvoice;

import br.com.totalvoice.api.Sms;
import org.json.JSONObject;

public class Main {
    
    public static void main(String args[]) {
        
        try {
            TotalVoiceClient client = new TotalVoiceClient("access-token");
            Sms sms = new Sms(client);

            JSONObject result = sms.enviar("NUMERO", "SUA MENSAGEM");
            System.out.println(result);

        } catch(Exception ex) {
            System.out.println(ex.getMessage());
        }
    }
}
Envio de TTS
package br.com.totalvoice;

import br.com.totalvoice.api.Tts;
import org.json.JSONObject;

public class Main {
    
    public static void main(String args[]) {
        
        try {
            TotalVoiceClient client = new TotalVoiceClient("access-token");
            Tts tts = new Tts(client);

            JSONObject result = tts.enviar("NUMERO", "SUA MENSAGEM");
            System.out.println(result);

        } catch(Exception ex) {
            System.out.println(ex.getMessage());
        }
    }
}
Envio de Audio
package br.com.totalvoice;

import br.com.totalvoice.api.Audio;
import org.json.JSONObject;

public class Main {
    
    public static void main(String args[]) {
        
        try {
            TotalVoiceClient client = new TotalVoiceClient("access-token");
            Audio audio = new Audio(client);

            JSONObject result = audio.enviar("NUMERO", "http://foo.bar/audio.mp3");
            System.out.println(result);

        } catch(Exception ex) {
            System.out.println(ex.getMessage());
        }
    }
}
Configurações de central telefonica
package br.com.totalvoice;

import br.com.totalvoice.api.Central;
import org.json.JSONObject;

public class Main {
    
    public static void main(String args[]) {
        
        try {
            TotalVoiceClient client = new TotalVoiceClient("access-token");
            Central central = new Central(client);

            JSONObject result = central.buscarRamal(123); // ID do Ramal
            System.out.println(result);

        } catch(Exception ex) {
            System.out.println(ex.getMessage());
        }
    }
}
Gerenciamento dos dados da Conta
package br.com.totalvoice;

import br.com.totalvoice.api.Conta;
import org.json.JSONObject;

public class Main {
    
    public static void main(String args[]) {
        
        try {
            TotalVoiceClient client = new TotalVoiceClient("access-token");
            Conta conta = new Conta(client);

            JSONObject result = conta.buscarConta(123);
            System.out.println(result);

        } catch(Exception ex) {
            System.out.println(ex.getMessage());
        }
    }
}
Consulta saldo da minha Conta
package br.com.totalvoice;

import br.com.totalvoice.api.Perfil;
import org.json.JSONObject;

public class Main {
    
    public static void main(String args[]) {
        
        try {
            TotalVoiceClient client = new TotalVoiceClient("access-token");
            Perfil perfil = new Perfil(client);

            JSONObject result = perfil.consultaSaldo();
            System.out.println(result);

        } catch(Exception ex) {
            System.out.println(ex.getMessage());
        }
    }
}
Caso você necessite utilizar seu próprio endereço configurado na Total Voice

Basta informar o segundo parâmetro ao instânciar o Client

package br.com.totalvoice;

import br.com.totalvoice.api.Perfil;
import org.json.JSONObject;

public class Main {
    
    public static void main(String args[]) {
        
        try {
            TotalVoiceClient client = new TotalVoiceClient("access-token", "https://meuhost.com.br");
            Perfil perfil = new Perfil(client);

            JSONObject result = perfil.consultaSaldo();
            System.out.println(result);

        } catch(Exception ex) {
            System.out.println(ex.getMessage());
        }
    }
}
Listando DID's do Estoque
package br.com.totalvoice;

import br.com.totalvoice.api.Did;
import org.json.JSONObject;

public class Main {
    
    public static void main(String args[]) {
        
        try {
            TotalVoiceClient client = new TotalVoiceClient("access-token");
            Did did = new Did(client);

            JSONObject result = did.estoque();
            System.out.println(result);

        } catch(Exception ex) {
            System.out.println(ex.getMessage());
        }
    }
}
Adquirindo DID
package br.com.totalvoice;

import br.com.totalvoice.api.Did;
import org.json.JSONObject;

public class Main {
    
    public static void main(String args[]) {
        
        try {
            TotalVoiceClient client = new TotalVoiceClient("access-token");
            Did did = new Did(client);

            JSONObject result = did.adquirir(1); // ID do DID
            System.out.println(result);

        } catch(Exception ex) {
            System.out.println(ex.getMessage());
        }
    }
}
Listando seus DID's
package br.com.totalvoice;

import br.com.totalvoice.api.Did;
import org.json.JSONObject;

public class Main {
    
    public static void main(String args[]) {
        
        try {
            TotalVoiceClient client = new TotalVoiceClient("access-token");
            Did did = new Did(client);

            JSONObject result = did.listar();
            System.out.println(result);

        } catch(Exception ex) {
            System.out.println(ex.getMessage());
        }
    }
}

Mais informações sobre os métodos disponíveis podem ser encontrados na documentação da API

Licença

Esta biblioteca segue os termos de uso da MIT

You can’t perform that action at this time.