Nexmo Rails Gem

Ya en la RailsConf 2016, adoptamos la gema Nexmo Ruby impulsada por la comunidad y la convertimos en una biblioteca cliente con soporte oficial. Desde entonces, los desarrolladores de Ruby han podido integrar Nexmo en sus aplicaciones con mayor facilidad. Ya sea que estuvieras buscando crear una aplicación Voice, enviar o recibir un SMS, obtener información sobre Numbers de todo el mundo, o más, puedes hacerlo con la gema Nexmo Ruby.

Estamos muy contentos de compartir en RailsConf 2019 que hemos dado un paso más para facilitar aún más a los desarrolladores de Ruby on Rails el uso del conjunto completo de APIs de Nexmo en sus aplicaciones Rails con la nueva gema Nexmo Rails. La gema Nexmo Rails realiza otro paso de integración para usted inicializando una instancia de cliente Nexmo y haciéndola disponible en toda su aplicación.

Configuración de la gema Nexmo Rails

Nexmo le permite crear sofisticadas aplicaciones Rails utilizando nuestra amplia gama de API de comunicaciones en la nube. La gema Nexmo Rails hace que empezar sea sencillo y directo. Aquí está cómo instalar la gema Nexmo Rails:

Gemfile

En primer lugar, añade la gema Nexmo Rails a tu directorio Gemfile:

# Gemfile

gem 'nexmo-rails'

A continuación, ejecute bundle install desde la línea de comandos para instalar la dependencia.

Vonage API Account

To complete this tutorial, you will need a Vonage API account. If you don’t have one already, you can sign up today and start building with free credit. Once you have an account, you can find your API Key and API Secret at the top of the Vonage API Dashboard.

Ready to start building?

Experience seamless connectivity, real-time messaging, and crystal-clear voice and video calls—all at your fingertips.

Credenciales de la API Nexmo

Debe proporcionar a la gema sus credenciales de API de Nexmo para acceder a la funcionalidad de nuestras API. Una vez que hayas creado tu Account Nexmo, navega a tu dashboard y añade tu API key y API secret al archivo .env en la carpeta raíz de tu aplicación:

# .env

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

Algunas de las API de Nexmo también requieren una firma de API, una clave privada o un ID de aplicación. Puede añadirlos, si procede, a su .env también:

# .env

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

Asegúrese de haber instalado la gema dotenv-rails y añadido el archivo .env a su archivo .gitignore para no enviar tus credenciales al control de versiones.

Inicializar el cliente

Ahora está listo para inicializar un cliente Nexmo para su aplicación. Esto se hace fácilmente ejecutando el inicializador desde la línea de comandos:

$ rails generate nexmo_initializer

Esto crea un archivo inicializador en /config/initializers/ llamado nexmo.rb que contiene los detalles que tu aplicación necesita para instanciar el cliente Nexmo. Ahora, cuando inicies tu aplicación Rails, tendrás acceso a una instancia de Nexmo totalmente autenticada para empezar a enviar mensajes de texto, crear interactividad de voz y mucho más.

Uso del cliente Nexmo

Ahora que tu gema Nexmo Rails se ha instalado correctamente y has ejecutado el inicializador de Nexmo, puedes empezar a utilizar el cliente Nexmo en cualquier lugar dentro de tu aplicación.

Para utilizar el cliente Nexmo, haga referencia a la instancia Nexmo seguido del método específico y los parámetros que desea utilizar. Por ejemplo, para enviar un SMS, haga lo siguiente:

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

Para obtener información detallada sobre un número utilizando la API estándar de Number Insight, utilice lo siguiente:

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

Para buscar números de teléfono disponibles en Estados Unidos, debe ejecutar lo siguiente:

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

Puede encontrar más información sobre todas las funciones disponibles en la biblioteca de clientes Ruby de Nexmo en GitHub. Se puede acceder a todos los métodos de la biblioteca de clientes Ruby con la gema Rails, simplemente recuerda sustituir el nombre de la variable client en los ejemplos de la biblioteca cliente Ruby por Nexmo.

Hablemos en la RailsConf

Estamos tan emocionados de compartir esto durante RailsConf 2019 en Minneapolis. Como se mencionó anteriormente, fue durante RailsConf 2016 en Kansas City que dimos a conocer la gema Nexmo Ruby, y es realmente significativo continuar con la tradición de nuevos y emocionantes desarrollos en la conferencia de este año.

Visite nuestro stand en la conferencia. Estaremos allí con una buena conversación y, por supuesto, un montón de botín. Nos encantaría saber cómo está utilizando Nexmo en sus aplicaciones o cómo está pensando en incorporar Nexmo en futuros trabajos. Háganos saber que usted estará allí por tuiteando @NexmoDev con el hashtag #railsconf.