SMS-Nachrichten mit Amazon Translate übersetzen

In meinem letzten Beitrag habe ich gezeigt, wie wir die Übersetzung von Textnachrichten mit der Google Translation API. In diesem Beitrag werde ich dieselbe Idee mit AWS Translate fortsetzen.

Übersicht

In diesem Beitrag zeige ich Ihnen, wie Sie eine eingehende Vonage SMS Webhook erstellen und die Nachricht mit der AWS Translate.

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

• AWS-Konto

• 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.

• aws-sdk - Dies ist das offizielle AWS Translate 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 AWS = require("aws-sdk");

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 AWS Translate

Sobald Sie die ersten Elemente eingerichtet haben, können Sie nun einen IAM-Benutzer mit der AWS Translate-Rolle erstellen.

Create New IAM User

Geben Sie dem neuen Benutzer einen Namen, und aktivieren Sie das Kontrollkästchen für Programmable Access.

Set User Details

Als nächstes benötigt der IAM-Benutzer die TranslateFullAccess angehängte Richtlinie. Dadurch erhält der IAM-Benutzer Zugriff auf die Übersetzungsfunktion.

Set User Permissions

Überprüfen Sie die Benutzereinstellungen, und klicken Sie dann auf Create.

Review and Create User

Sobald der Erstellungsprozess abgeschlossen ist, rufen Sie die Access Key ID und Secret Access Key.

Get the Access Key ID and Secret

Erstellen Sie eine neue .env Datei, kopieren Sie den folgenden Text und fügen Sie ihn ein:

AWS_ACCESS_KEY_ID=
AWS_SECRET_ACCESS_KEY=
AWS_REGION=

Verwenden Sie die Anmeldeinformationen des soeben erstellten IAM-Benutzers, geben Sie die Details in der Datei .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 Vonage-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 integrierte 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();
  }

};

Das obige Snippet ist die Methode, die wir an die Routen übergeben werden. Wenn der Webhook für eingehende Nachrichten die Methode POST verwendet, wird er 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.

Die Verwendung des aws-sdk Pakets ist wirklich einfach. Wir instanziieren zunächst die AWS.Translate Klasse, die uns die translate.translateText Methode. Diese wird aufgerufen innerhalb der translateText Methode aufgerufen und verwendet das text Feld aus dem Objekt der eingehenden SMS-Nachricht. Die SourceLanguageCode Sprache wird gesetzt auf autogesetzt, und die TargetLanguageCode Eingabe ist ein beliebiger zweistelliger Code für die Sprache, die übersetzt werden soll in.

function translateText(params) {
  var translate = new AWS.Translate({region: process.env.AWS_REGION})
  var opts = {
    SourceLanguageCode: 'auto',
    TargetLanguageCode: 'en',
    Text: params.text
  };
  translate.translateText(opts, function(err, data) {
    if (err) {
      console.log('error', err);
    }
    else{
      console.log(`Original Text: ${params.text}`);
      console.dir(`Translation: ${data.TranslatedText}`);
    }
  });
}

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

AWS Translate leistet hervorragende Arbeit bei der Erkennung der eingehenden Sprache und der schnellen Verarbeitung der Übersetzung. Viel Spaß und probieren Sie es aus.

Rekapitulation

Das obige Beispiel ist nur eine kleine Einführung in die Übersetzung, aber es sollte ein guter Anfang sein, damit Sie loslegen können. 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, sicher).

Eine vollständige Version dieses Tutorials finden Sie unter https://github.com/nexmo-community/sms-translate-aws-js.

Wenn Sie mehr über unsere Extend-Projekte erfahren möchten, besuchen Sie Integration um mehr zu erfahren.