SMS-Nachrichten übersetzen mit IBM Watson und Vonage

In meinen früheren Beiträgen habe ich gezeigt, wie Sie Textnachrichten mit der Google Translation API und AWS Translate.

Übersicht

In diesem Beitrag zeige ich Ihnen, wie Sie eine eingehende Vonage SMS Webhook erstellt und die Nachricht mit dem IBM Watson Sprachübersetzer.

Um mit der Arbeit beginnen zu können, müssen Sie die folgenden Dinge einrichten:

• IBM Wolke

• Vonage CLI installiert

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.

Ihr Projekt erstellen

Das Setup für dieses Beispiel ist minimal, und Sie brauchen nur ein paar Pakete, um loszulegen.

• ibm-watson - dies ist das offizielle IBM Watson SDK

• express - Web-Framework zur Bereitstellung des Webhooks

• dotenv - ein Paket zum Laden von Umgebungsvariablen

• body-parser - Middleware für Express zur Verarbeitung des eingehenden Webhook-Objekts

Initialisieren Sie das Projekt und installieren Sie dann die oben genannten Anforderungen mit npm oder yarn.

Nach der Installation erstellen Sie ein index.js und .env Datei.

Als nächstes öffnen Sie die Datei index.js Datei und fügen Sie den folgenden Code ein:

'use strict';
require('dotenv').config();

const express = require('express');
const bodyParser = require('body-parser');
const LanguageTranslatorV3 = require('ibm-watson/language-translator/v3');
const { IamAuthenticator } = require('ibm-watson/auth');

const app = express();

app.use(bodyParser.json());
app.use(bodyParser.urlencoded({ extended: true }));

const server = app.listen(3000, () => {
  console.log(`Express server listening on port ${server.address().port} in ${app.settings.env} mode`);
});

Damit wird der Server für die Ausführung des Beispiels eingerichtet.

Installation von Ngrok

Webhooks müssen öffentlich verfügbar sein, damit der Vonage-Dienst die Anwendung bei eingehenden SMS-Nachrichten erreichen kann. Sie können Ihren Code auf einen öffentlich zugänglichen Server schieben, oder Sie können mit ngrok verwenden, damit der öffentliche Datenverkehr Ihre lokale Anwendung erreichen kann.

Sie können mehr über die Installation erfahren ngrok mit diesem Beitrag. Nachdem Sie alles vorbereitet haben, können Sie ngrok mit dem folgenden Befehl starten, um Ihren Tunnel zu erstellen.

Notieren Sie sich die ngrok Adresse, da Sie diese in einem späteren Schritt benötigen werden.

Einrichten von IBM Watson Language Translator

Sobald Sie die ersten Elemente eingerichtet haben, können Sie IBM Watson Language Translator zu Ihrem Account hinzufügen und die für die Ausführung des Beispiels erforderlichen Anmeldedaten erhalten. Folgen Sie diesen Link um die API des Sprachübersetzers zu aktivieren. Wählen Sie ein Projekt aus, und klicken Sie dann auf die Schaltfläche Enable um die API für dieses Projekt zu aktivieren.

Create Language Translator Service

Nach der Erstellung wird Ihnen eine Anleitung für erste Schritte angezeigt. Klicken Sie in der linken Navigationsleiste auf Manage um den folgenden Bildschirm aufzurufen:

IBM Watson Language Translator Manage Screen

Öffnen Sie die .env und kopieren Sie den folgenden Text und fügen Sie ihn ein:

TRANSLATE_IAM_APIKEY=
TRANSLATE_URL=

Mit der Schaltfläche Kopieren Sie die API Key und URL die Sie auf der Seite IBM Watson Translation Manage finden, füllen Sie die .env aus, speichern Sie und fahren Sie fort, um die Vonage-Telefonnummer zu erstellen.

Vonage eingehende SMS-Nachrichten einrichten

In diesem Beispiel wird eine Telefonnummer von Vonage benötigt, um eingehende Nachrichten zu empfangen. Dies können wir mit Hilfe der Vonage CLI direkt von einem Terminal aus.

Virtuelle Rufnummer kaufen

Der erste Schritt besteht darin, eine Nummer zu erwerben (Sie können auch eine andere ISO 3166 Alpha-2 Ländercode nach Bedarf).

Obwohl die eigentliche Route, die in der Anwendung verwendet werden soll, noch nicht eingerichtet ist, werden Sie ihr einen Namen geben /message. Die Telefonnummer muss mit dieser Route verknüpft werden, damit eingehende Nachrichten wissen, wohin sie gehen sollen. Holen Sie den ngrok Hostnamen aus der vorherigen Einrichtung und verwenden Sie ihn hier:

Jetzt haben wir den Webhook als Ort für die Weiterleitung eingehender SMS-Nachrichten eingerichtet.

Beenden Sie die Anwendung

Alles, was in diesem Tutorial noch zu tun ist, ist die Erstellung der Express-Route für die eingehenden Daten und ein paar kleine Funktionen für die eigentliche Übersetzung.

Erstellen Sie den Webhook

Zunächst müssen wir den Webhook-Code erstellen. Vonage verfügt über eine eingebaute Funktion zur Einstellung des Standardverhaltens bei SMS. Im Einstellungsbereich können Sie die Standard HTTP Methode ändern. Meine ist eingestellt auf POST-JSON. Ich würde empfehlen, diese Einstellung zu verwenden, wenn möglich, aber der Code in diesem Beispiel wird alle drei Optionen behandeln, falls Sie nicht in der Lage sind, diese Einstellung zu ändern.

Default Vonage SMS HTTP Method

Öffnen Sie die index.js Datei, und fügen Sie unten den folgenden Code ein:

// Reading the inbound SMS messages
const handleRoute = (req, res) => {

  let params = req.body;

  if (req.method === "GET") {
    params = req.query
  }

  if (!params.to || !params.msisdn) {
    res.status(400).send({'error': 'This is not a valid inbound SMS message!'});
  } else {
    translateText(params);
    res.status(200).end();
  }

};

Der obige Ausschnitt ist die Methode, die wir an die Routen übergeben werden. Wenn die eingehende Nachricht die Methode POST verwendet, wird sie req.bodyverwendet, und es wird req.query für die GET Option. Solange die eingehende Nutzlast richtig eingestellt ist, wird das Objekt an die translateText Methode weitergeleitet, um die Übersetzung anzuzeigen.

Jetzt können Sie die Route und die entsprechenden HTTP Methoden zur Anwendung hinzufügen.

app.route('/message')
  .get(handleRoute)
  .post(handleRoute)
  .all((req, res) => res.status(405).send());

Der obige Code erzeugt die GET und POST Methoden, um entweder die eingehende SMS-Webhook-Nachricht zu verarbeiten. Wenn eine andere Methode verwendet wird, wird eine 405 - Method Not Allowed Antwort zurückgegeben werden.

Der Webhook ist einsatzbereit und das letzte Stück sind die eigentlichen Übersetzungen.

Methode der Übersetzung

Im vorherigen Schritt rufen wir translateText. In diesem Schritt wird diese Methode erstellt.

Unter Verwendung des ibm-watson Paket instanziieren wir zunächst die LanguageTranslatorV3 Klasse, die uns die translate Methode. Diese wird innerhalb der translateText Methode aufgerufen und verwendet das text Feld aus dem Objekt für eingehende SMS-Nachrichten. Die modelId Eingabe ist ein beliebiger zweistelliger Code für die Sprache, in die übersetzt werden soll.

const languageTranslator = new LanguageTranslatorV3({
  version: '2017-09-21',
  authenticator: new IamAuthenticator({
    apikey: process.env.TRANSLATE_IAM_APIKEY,
  }),
  url: process.env.TRANSLATE_URL,
});

function translateText(params) {
  const translateParams = {
    text: params.text,
    modelId: 'en-es',
  };

  languageTranslator.translate(translateParams)
    .then(data => {
      console.log(`Original Text ${params.text}`);
      console.dir(`Translation ${data.result.translations[0].translation}`)
    })
    .catch(err => {
      console.log('error:', err);
    });
}

Jetzt können Sie die Funktionalität testen, indem Sie den Server starten und eine Textnachricht an die zuvor erworbene Nummer senden.

Das vollständige Antwortobjekt des IBM Watson Language Translator enthält ebenfalls viele Details, so dass Sie die Antwort so ändern können, dass sie Folgendes enthält console.dir(translationResult, {depth: null}) ändern, um die vollständige Nutzlast zu sehen.

Rekapitulation

Das obige Beispiel ist nur eine kleine Einführung in die Übersetzung mit dem IBM Watson Translation Service. Von hier aus können Sie die eingehende Nachricht übersetzen und dann auch die ausgehende Nachricht in die richtige Sprache übersetzen (ein zukünftiger Blog-Beitrag, ganz sicher).

Eine fertige Version dieses Tutorials finden Sie auf dem Vonage Gemeinschaft GitHub.

Wenn Sie mehr über unsere Extend-Projekte erfahren möchten, besuchen Sie https://developer.vonage.com/extend.