Como usar o Pacote Nuget Ozeki Rest SMS Api

Nuget é o gerenciador de pacotes do framework .NET. Você pode usar um pacote Nuget em qualquer aplicação baseada em .NET. Se você estiver usando o Visual Studio 2019, você pode instalar um pacote Nuget com alguns cliques. Nos vídeos a seguir eu vou mostrar como criar uma aplicação de console em C#, e como usar o pacote nuget Ozeki.Libs.Rest nessa aplicação de console escrita em C#.

  1. Crie uma nova aplicação de console em C# no Visual Studio
  2. Instale o pacote NuGet Ozeki.Libs.Rest
  3. Importe o pacote NuGet instalado anteriormente com using Ozeki.Libs.Rest;
  4. Crie um novo Configuration, Message e um objeto MessageApi usando o pacote Ozeki.Libs.Rest
  5. Usando o objeto MessageApi envie a mensagem criada anteriormente
O que é NuGet?

NuGet é o gerenciador de pacotes oficial para .NET, feito pela Microsoft.

Passo 1 - Como criar uma nova aplicação de console em C#

Vídeo 1 - Como criar uma aplicação de console em C# (Tutorial em vídeo)

Passo 2 - Como instalar o pacote NuGet Ozeki.Libs.Rest

Para instalar um pacote NuGet no Visual Studio, você precisa clicar com o botão direito no ícone do projeto, depois selecionar "Gerenciar Pacotes NuGet" no menu suspenso. Depois disso, você precisa procurar pelo pacote que deseja instalar, neste caso, é o pacote Ozeki.Libs.Rest. Quando você encontrar o pacote Ozeki.Libs.Rest, você precisa instalá-lo clicando no botão "Instalar". Quando estiver instalado, você poderá importar e usar o pacote em seu projeto.

Vídeo 2 - Como instalar o pacote nuget Ozeki.Libs.Rest (Tutorial em vídeo)

Gerenciar Pacotes NuGet

Para acessar o menu onde você pode gerenciar seus Pacotes NuGet, clique com o botão direito no título do projeto no Gerenciador de Soluções. Isso abrirá um submenu onde você pode encontrar o botão 'Gerenciar Pacotes NuGet...' (Figura 1). Clique nele para abrir o instalador de pacotes NuGet.

como instalar um pacote nuget passo 1
Figura 1 - Gerenciar Pacotes NuGet

Instalar o pacote Ozeki.Libs.Rest

Digite o seguinte texto na barra de pesquisa do gerenciador de pacotes NuGet: 'Ozeki.Libs.Rest'. O mecanismo de pesquisa mostrará o pacote que você precisa. Escolha-o clicando nele. Como você pode ver na Figura 2, no lado direito do painel, você encontrará um botão 'Instalar'. Clique nele e ele iniciará o processo de instalação.

como instalar um pacote nuget passo 2
Figura 2 - Instalar o pacote Ozeki.Libs.Rest

O pacote instalado

Agora a lista de pacotes 'instalados', que antes estava vazia, contém um pacote. É o Ozeki.Libs.Rest instalado. Agora você pode começar a usá-lo. Se você quiser instalar mais pacotes no Visual Studio Code, repita o processo, mas procure por outros pacotes.

como instalar um pacote nuget passo 3
Figura 3 - O pacote instalado

Passo 3 - Como usar o pacote Ozeki.Libs.Rest em sua aplicação C#

Para usar o conteúdo do pacote Ozeki.Libs.Rest, você precisa importá-lo usando a seguinte linha de código:

using Ozeki.Libs.Rest;
	

Código 1 - Como importar o pacote nuget Ozeki.Libs.Rest em uma aplicação C#

Criando um programa que usa o Ozeki.Libs.Rest

Neste vídeo, vamos mostrar como usar o pacote NuGet Ozeki.Libs.Rest em uma aplicação C#. O vídeo começará com um editor de código vazio, e você verá a aplicação funcional de envio de SMS no final do vídeo. Você aprenderá como escrever um código que usa o Ozeki.Libs.Rest para enviar mensagens SMS através do Ozeki SMS Gateway. O vídeo é muito detalhado, você pode ver todas as linhas de código que precisa fornecer para ter um sistema funcional. Leva apenas 1:46 para assistir ao vídeo, mas você entenderá o processo até o final.

Vídeo 3 - Como usar o pacote nuget Ozeki.Libs.Rest em uma aplicação C# (Tutorial em vídeo)

O código-fonte do projeto

Na Figura 4, você pode ver o código-fonte do projeto. Como você pode ver, as variáveis 'username' e 'password' contêm as credenciais de login para o usuário HTTP. As variáveis 'Toaddress' e 'Text' contêm o endereço e o texto da mensagem. Se você estiver familiarizado com a linguagem de programação C#, sinta-se à vontade para alterar os valores das variáveis para enviar uma mensagem personalizada.

solução visual studio send sms sln
Figura 4 - SendSms.sln

A saída do programa

Se você executar o seu programa, verá o resultado no 'Debug Console'. Você verá o texto 'Success' e algumas informações sobre a mensagem depois. Isso significa que o envio da mensagem foi bem-sucedido. Pressione qualquer tecla para fechar o console de depuração.

Figura 5 - A saída do programa em C#

Verifique a pasta de enviados

Após concluir o processo, você pode verificar a pasta Enviados no Ozeki SMS Gateway (Figura 6). Lá você verá sua mensagem de teste, junto com outras mensagens enviadas anteriormente. Você pode obter mais informações sobre qualquer mensagem clicando nela.

Figura 6 - A mensagem aparece na pasta Enviados do http_user

Resumo

Este artigo explicou como usar o Pacote Nuget da API REST de SMS da Ozeki. Essa inovação pode ser muito útil se você deseja enviar mensagens de texto a partir do C#.

A sinergia entre os códigos em C# e o Ozeki SMS Gateway garante o melhor desempenho possível. O Ozeki SMS Gateway oferece excelentes capacidades de registro, o que significa que você pode rastrear erros rapidamente e reduzir o tempo de inatividade.

Certifique-se de não parar de ler aqui, visite a página de tutoriais da Ozeki, onde você pode encontrar mais informações sobre tópicos como recebimento em C#. Agora, a única coisa a fazer é baixar o Ozeki SMS Gateway e começar a trabalhar!

More information