Ankündigung des Nexmo Rails Gem

Auf der RailsConf 2016 haben wir das von der Community entwickelte Nexmo Ruby Gem übernommen und zu einer offiziell unterstützten Client-Bibliothek gemacht. Seitdem können Ruby-Entwickler Nexmo noch einfacher in ihre Applications integrieren. Ob Sie nun eine Voice-App, senden oder empfangen eine SMS, erhalten Einblicke in Numbers auf der ganzen Welt, oder mehr, können Sie es mit dem Nexmo Ruby Edelstein tun.

Wir freuen uns, auf der RailsConf 2019 dass wir einen weiteren Schritt unternommen haben, um es für Ruby on Rails-Entwickler noch einfacher zu machen, die gesamte Palette der Nexmo-APIs in ihren Rails-Applikationen zu nutzen, und zwar mit dem neuen Nexmo Rails gem. Das Nexmo Rails-Gem führt einen weiteren Integrationsschritt für Sie aus, indem es eine Nexmo-Client-Instanz initialisiert und sie in Ihrer Anwendung verfügbar macht.

Einrichten des Nexmo Rails Gem

Mit Nexmo können Sie anspruchsvolle Rails-Applikationen erstellen, die unsere breite Palette an Cloud-Kommunikations-APIs nutzen. Das Nexmo Rails Gem macht den Einstieg einfach und unkompliziert. Hier erfahren Sie, wie Sie das Nexmo Rails-Gem installieren:

Gemfile

Fügen Sie zunächst das Nexmo Rails Gem zu Ihrem Gemfile:

# Gemfile

gem 'nexmo-rails'

Führen Sie dann bundle install von Ihrer Befehlszeile aus, um die Abhängigkeit zu installieren.

Vonage API-Konto

Um dieses Tutorial durchzuführen, benötigen Sie ein Vonage API-Konto. Wenn Sie noch keines haben, können Sie sich noch heute anmelden und mit einem kostenlosen Guthaben beginnen. Sobald Sie ein Konto haben, finden Sie Ihren API-Schlüssel und Ihr API-Geheimnis oben auf dem Vonage-API-Dashboard.

Sind Sie bereit, mit dem Bau zu beginnen?

Erleben Sie nahtlose Konnektivität, Echtzeit-Messaging und kristallklare Sprach- und Videoanrufe - alles auf Knopfdruck.

Nexmo API-Anmeldeinformationen

Sie müssen dem Edelstein Ihre Nexmo-API-Zugangsdaten mitteilen, um auf die Funktionen unserer APIs zugreifen zu können. Sobald Sie Ihren Nexmo Account erstellt haben, navigieren Sie zu Ihrem Dashboard und fügen Sie Ihren API-Schlüssel und Ihr API-Geheimnis in der .env Datei im Stammverzeichnis Ihrer Anwendung hinzu:

# .env

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

Einige der Nexmo-APIs erfordern auch eine API-Signatur, einen privaten Schlüssel oder eine Anwendungs-ID. Sie können diese, falls zutreffend, zu Ihrer .env ebenfalls hinzufügen:

# .env

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

Stellen Sie sicher, dass Sie das dotenv-rails gem installiert und die .env Datei zu Ihrem .gitignore hinzugefügt haben, um Ihre Anmeldedaten nicht an die Versionskontrolle zu übergeben.

Initialisieren Sie Ihren Client

Nun sind Sie bereit, einen Nexmo-Client für Ihre Anwendung zu initialisieren. Dies ist einfach, indem Sie den Initialisierer von der Kommandozeile aus starten:

$ rails generate nexmo_initializer

Dadurch wird eine Initialisierungsdatei in /config/initializers/ namens nexmo.rb die die Details enthält, die Ihre Anwendung benötigt, um den Nexmo-Client zu instanziieren. Wenn Sie nun Ihre Rails-Anwendung starten, haben Sie Zugriff auf eine vollständig authentifizierte Nexmo-Instanz, um Textnachrichten zu versenden, Sprachinteraktionen zu erstellen und vieles mehr.

Verwendung Ihres Nexmo-Clients

Nachdem das Nexmo Rails-Gem erfolgreich installiert und der Nexmo-Initialisierer ausgeführt wurde, können Sie den Nexmo-Client nun überall in Ihrer Anwendung verwenden.

Um den Nexmo-Client zu verwenden, referenzieren Sie die Nexmo Instanz, gefolgt von der spezifischen Methode und den Parametern, die Sie verwenden möchten. Um zum Beispiel eine SMS zu versenden, gehen Sie wie folgt vor:

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

Zum Abrufen von Details über eine Nummer mit der standardmäßigen Number Insight API würden Sie Folgendes verwenden:

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

Um nach verfügbaren Numbers in den Vereinigten Staaten zu suchen, müssen Sie Folgendes ausführen:

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

Weitere Informationen über alle verfügbaren Funktionen der Nexmo Ruby-Client-Bibliothek finden Sie auf GitHub. Auf alle Methoden der Ruby-Client-Bibliothek kann mit dem Rails-Gem zugegriffen werden - denken Sie nur daran, den Variablennamen client in den Beispielen der Ruby-Client-Bibliothek durch Nexmo.

Reden wir auf der RailsConf

Wir freuen uns sehr, dies während der RailsConf 2019 in Minneapolis vorzustellen. Wie bereits erwähnt, haben wir auf der RailsConf 2016 in Kansas City das Nexmo Ruby-Juwel vorgestellt, und es ist wirklich sinnvoll, die Tradition neuer und spannender Entwicklungen auf der diesjährigen Konferenz fortzusetzen.

Kommen Sie zu unserem Stand auf der Konferenz. Wir werden dort mit guten Gesprächen und natürlich jeder Menge Werbegeschenke vertreten sein. Wir würden gerne von Ihnen hören, wie Sie Nexmo in Ihren Applications einsetzen oder wie Sie Nexmo in Ihre zukünftige Arbeit einbeziehen wollen. Lassen Sie uns wissen, dass Sie dort sein werden, indem Sie @NexmoDev mit dem Hashtag #railsconf tweetet.