Anunciando a gem Nexmo para Rails

Na RailsConf 2016, adotamos a gem Nexmo Ruby, desenvolvida pela comunidade, e a transformamos em uma biblioteca cliente oficialmente suportada. Desde então, os desenvolvedores Ruby têm conseguido integrar o Nexmo em suas Applications com mais facilidade. Seja para criar um Voice app, enviar ou receber um SMS, obtenha informações sobre números em todo o mundo ou muito mais, você pode fazer isso com a gem Nexmo Ruby.

Estamos animados em compartilhar na RailsConf 2019 que demos mais um passo para tornar ainda mais fácil para os desenvolvedores de Ruby on Rails utilizarem o conjunto completo de APIs da Nexmo em suas Applications Rails com a nova gem Nexmo Rails. A gem Nexmo Rails realiza mais uma etapa de integração para você, inicializando uma instância do cliente Nexmo e disponibilizando-a em toda a sua aplicação.

Configurando a gem Nexmo para Rails

A Nexmo permite que você crie aplicativos Rails sofisticados utilizando nossa ampla gama de APIs de comunicação em nuvem. A gem Nexmo Rails torna o início do trabalho simples e direto. Veja a seguir como instalar a gem Nexmo Rails:

Gemfile

Primeiro, adicione a gem Nexmo Rails ao seu Gemfile:

# Gemfile

gem 'nexmo-rails'

Em seguida, execute bundle install na linha de comando para instalar a dependência.

Credenciais da API da Nexmo

Você precisa fornecer à gem suas credenciais da API da Nexmo para acessar as funcionalidades das nossas APIs. Depois de criar seu Account na Nexmo, acesse seu painel e adicione sua chave de API e seu segredo de API ao .env arquivo na pasta raiz do seu aplicativo:

# .env

NEXMO_API_KEY= # Your API key
NEXMO_API_SECRET= # Your API secret

Algumas das APIs da Nexmo também exigem uma assinatura de API, uma chave privada ou um ID de aplicativo. Você pode adicioná-los, se for o caso, ao seu .env também:

# .env

NEXMO_API_SIGNATURE= # Your API signature
NEXMO_PRIVATE_KEY= # Path to your private key file
NEXMO_APPLICATION_ID= # Your application ID

Certifique-se de ter instalado o dotenv-rails gem e adicionou o .env arquivo ao seu .gitignore para não enviar suas credenciais para o controle de versão.

Inicialize seu cliente

Agora você está pronto para inicializar um cliente Nexmo para seu aplicativo. Isso é feito facilmente executando o inicializador na linha de comando:

$ rails generate nexmo_initializer

Isso cria um arquivo inicializador em /config/initializers/ chamado nexmo.rb que contém os detalhes necessários para que seu aplicativo instancie o cliente Nexmo. Agora, ao iniciar seu aplicativo Rails, você terá acesso a uma instância do Nexmo totalmente autenticada para começar a enviar mensagens de texto, criar interações de voz e muito mais.

Como usar seu cliente Nexmo

Agora que a gem Nexmo Rails foi instalada com sucesso e você executou o inicializador do Nexmo, você pode começar a usar o cliente Nexmo em qualquer parte do seu aplicativo.

Para usar o cliente Nexmo, chame a Nexmo instância, seguida do método específico e dos parâmetros que você deseja usar. Por exemplo, para enviar um SMS, você faria o seguinte:

Nexmo.sms.send(from: '14155550100', to: '14155550101', text: 'Hello world')

Para obter detalhes sobre um número usando a Number Insight API, você deve seguir os passos a seguir:

Nexmo.number_insight.standard(number: '14155550100')

Para pesquisar números de telefone disponíveis nos Estados Unidos, você deve executar o seguinte:

Nexmo.numbers.search(country: 'US')

Mais informações sobre todas as funcionalidades disponíveis na biblioteca cliente do Nexmo para Ruby podem ser encontradas em GitHub. Todos os métodos da biblioteca cliente Ruby podem ser acessados com a gem do Rails — basta lembrar de substituir o nome da variável client nos exemplos da biblioteca cliente Ruby por Nexmo.

Vamos conversar na RailsConf

Estamos muito animados em compartilhar isso durante a RailsConf 2019 em Minneapolis. Como mencionamos anteriormente, foi durante a RailsConf 2016 em Kansas City que lançamos a gem Nexmo Ruby, e é realmente significativo dar continuidade à tradição de novidades empolgantes na conferência deste ano.

Venha visitar nosso estande na conferência. Estaremos lá para uma boa conversa e, é claro, com muitos brindes. Adoraríamos saber como você está usando o Nexmo em suas Applications ou como pensa em incorporá-lo em projetos futuros. Avise-nos que você estará lá enviando um tweet para @NexmoDev com a hashtag #railsconf.