Skip to content

totalvoice/totalvoice-java

Repository files navigation

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