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