Annonce de la Gem Rails Nexmo

Lors de la RailsConf 2016, nous avons adopté la gemme Ruby Nexmo et l'avons rendue officiellement supportée. et en avons fait une bibliothèque client officiellement supportée. Depuis lors, les développeurs Ruby ont pu intégrer Nexmo dans leurs Applications avec plus de facilité. Que vous cherchiez à créer une In-App Voice, envoyer ou recevoir un SMS, obtenir des des informations sur les Numbers dans le monde entier, ou plus encore, vous pouvez le faire avec la gemme Nexmo Ruby.

Nous sommes ravis de partager à RailsConf 2019 que nous avons franchi une nouvelle étape pour permettre aux développeurs Ruby on Rails d'utiliser encore plus facilement la suite complète d'API Nexmo dans leurs applications Rails avec le nouveau Nexmo Rails gem. La gem Nexmo Rails effectue une autre étape d'intégration pour vous en initialisant une instance de client Nexmo et en la rendant disponible dans toute votre application.

Mise en place de la Gem Rails Nexmo

Nexmo vous permet de créer des applications Rails sophistiquées en utilisant notre large gamme d'API de communications dans le cloud. La gemme Nexmo Rails permet de démarrer de manière simple et directe. Voici comment installer la gem Nexmo Rails :

Fichier de gemmes

Tout d'abord, ajoutez la gem Nexmo Rails à votre fichier Gemfile:

# Gemfile

gem 'nexmo-rails'

Ensuite, exécutez bundle install à partir de votre ligne de commande pour installer la dépendance.

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.

Références de l'API Nexmo

Vous devez fournir au gem vos identifiants API Nexmo pour accéder aux fonctionnalités de nos API. Une fois que vous avez créé votre compte Nexmo, accédez à votre tableau de bord et ajoutez votre clé d'API et votre secret d'API au fichier .env dans le dossier racine de votre application :

# .env

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

Certaines des Applications Nexmo nécessitent également une signature d'API, une clé privée ou un identifiant d'application. Vous pouvez les ajouter, le cas échéant, à votre fichier .env également :

# .env

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

Assurez-vous d'avoir installé la gem dotenv-rails et que vous avez ajouté le fichier .env à votre fichier .gitignore afin de ne pas livrer vos informations d'identification au contrôle de version.

Initialiser votre client

Vous êtes maintenant prêt à initialiser un client Nexmo pour votre application. Ceci est facilement réalisable en lançant l'initialisateur à partir de votre ligne de commande :

$ rails generate nexmo_initializer

Cela crée un fichier d'initialisation dans /config/initializers/ appelé nexmo.rb qui contient les détails dont votre application a besoin pour instancier le client Nexmo. Désormais, lorsque vous démarrez votre application Rails, vous avez accès à une instance Nexmo entièrement authentifiée pour commencer à envoyer des messages texte, créer une interactivité vocale, et bien plus encore.

Utilisation de votre client Nexmo

Maintenant que votre Nexmo Rails gem a été installé avec succès et que vous avez exécuté l'initialisateur Nexmo, vous pouvez commencer à utiliser le client Nexmo n'importe où dans votre application.

Pour utiliser le client Nexmo, faites référence à l'instance Nexmo suivie de la méthode spécifique et des paramètres que vous souhaitez utiliser. Par exemple, pour envoyer un SMS, procédez comme suit :

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

Pour récupérer les détails d'un numéro à l'aide de l'API Number Insight standard, vous devez procéder comme suit :

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

Pour rechercher les numéros de téléphone disponibles aux États-Unis, vous devez procéder comme suit :

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

Plus d'informations sur toutes les fonctionnalités disponibles dans la bibliothèque du client Nexmo Ruby sont disponibles sur GitHub. Toutes les méthodes de la bibliothèque client Ruby sont accessibles avec la gem Rails - n'oubliez pas de remplacer le nom de la variable client dans les exemples de la bibliothèque client Ruby par Nexmo.

Parlons-en à RailsConf

Nous sommes ravis de partager cela lors de la RailsConf 2019 à Minneapolis. Comme mentionné précédemment, c'est lors de la RailsConf 2016 à Kansas City que nous avons dévoilé la gemme Ruby Nexmo, et il est vraiment significatif de poursuivre la tradition de nouveaux développements passionnants lors de la conférence de cette année.

Venez trouver notre stand à la conférence. Nous y serons avec de bonnes conversations et, bien sûr, de nombreux cadeaux. Nous aimerions savoir comment vous utilisez Nexmo dans vos Applications ou comment vous envisagez d'intégrer Nexmo dans vos travaux futurs. Faites-nous savoir que vous serez là en en tweetant @NexmoDev avec le hashtag #railsconf.