totalvoice-csharp

Client C# para a API da TotalVoice

Funcionalidades

Pré requisitos

.NET Framework 4.6.1 ou .NET Core 2.0
Nuget

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 gerenciador de pacotes Nuget

PM> Install-Package TotalVoice -Version 1.0.1

ou .NET CLI

dotnet add package TotalVoice --version 1.0.1

A seguir alguns exemplos de como pode ser utilizada esta biblioteca.

Realizar uma chamada telefônica entre dois números: A e B

namespace Teste
{
    class Program
    {
        static void Main(string[] args)
        {
            TotalVoiceClient client = new TotalVoiceClient("access-token");
            Chamada chamada = new Chamada(client);
            var json = new {
                numero_origem  = "48988888888",
                numero_destino = "48999999999"
            };
            string response = chamada.Ligar(json);
            System.Diagnostics.Debug.WriteLine(response);
        }
    }
}

Consulta de chamada pelo ID

namespace Teste
{
    class Program
    {
        static void Main(string[] args)
        {
            TotalVoiceClient client = new TotalVoiceClient("access-token");
            Chamada chamada = new Chamada(client);
            string response = chamada.Buscar(123);
            System.Diagnostics.Debug.WriteLine(response);
        }
    }
}

Enviar um SMS

namespace Teste
{
    class Program
    {
        static void Main(string[] args)
        {
            TotalVoiceClient client = new TotalVoiceClient("access-token");
            Sms sms = new Sms(client);
            var json = new {
                numero_destino = "48999999999",
                mensagem = "Mensagem de teste"
            };
            string response = sms.Enviar(json);
            System.Diagnostics.Debug.WriteLine(response);
        }
    }
}

Buscar os dados de um SMS pelo ID

namespace Teste
{
    class Program
    {
        static void Main(string[] args)
        {
            TotalVoiceClient client = new TotalVoiceClient("access-token");
            Sms sms = new Sms(client);
            string response = sms.Buscar(123);
            System.Diagnostics.Debug.WriteLine(response);
        }
    }
}

Enviar um TTS

namespace Teste
{
    class Program
    {
        static void Main(string[] args)
        {
            TotalVoiceClient client = new TotalVoiceClient("access-token");
            Tts tts = new Tts(client);
            var json = new {
                numero_destino = "48999999999",
                mensagem = "Mensagem de TTS"
            };
            string response = tts.Enviar(json);
            System.Diagnostics.Debug.WriteLine(response);
        }
    }
}

Validacao de Numero

namespace Teste
{
    class Program
    {
        static void Main(string[] args)
        {
            TotalVoiceClient client = new TotalVoiceClient("access-token");
            ValidaNumero validacao = new ValidaNumero(client);
            var json = new {
                numero_destino = "48999999999",
                gravar_audio   = true,
                bina           = "48808880804",
                max_tentativas = 1
            };
            string response = validacao.Enviar(json);
            System.Diagnostics.Debug.WriteLine(response);
        }
    }
}

Enviar um Composto

namespace Teste
{
    class Program
    {
        static void Main(string[] args)
        {
            TotalVoiceClient client = new TotalVoiceClient("access-token");
            Composto composto = new Composto(client);
            var json = new {
              numero_destino = "48988888888",
              dados = new[] {
                 new {
                   acao = "tts",
                   acao_dados = new {
                     mensagem = "O número digitado não consta em nosso cadastro. Por gentileza, tente novamente",
                     tipo_voz = "br-Ricardo" 
                   }
                 },
                 new {
                   acao = "audio",
                   acao_dados = new {
                     url_audio = "https://minhaurl.com.br/audio.mp3"
                   }
                 }
              },
              gravar_audio     = false,
              bina             = "48988888888",
              tags             = "clienteX",
              detecta_caixa    = false
           };
           string response = composto.Enviar(json);
           System.Diagnostics.Debug.WriteLine(response);
        }
    }
}

Licença

Esta biblioteca segue os termos de uso da MIT

totalvoice/totalvoice-csharp