Traduire des SMS à l'aide d'Amazon Translate

Dans mon article précédent, j'ai montré comment nous pouvions configurer la traduction de messages texte avec l Google Translation API. Je vais poursuivre cette idée dans cet article en utilisant AWS Translate.

Vue d'ensemble

Dans ce billet, je vous montre comment créer un SMS entrant de Vonage entrant et traduire le message en anglais à l'aide de l'outil AWS Translate.

Pour commencer, vous aurez besoin des éléments suivants :

• Account AWS

• Vonage CLI installé

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.

Créez votre projet

L'installation pour cet exemple est minimale, et vous n'avez besoin que de quelques paquets pour commencer.

• aws-sdk - C'est le SDK officiel d'AWS Translate

• express - cadre web pour servir le webhook

• dotenv - un paquet pour charger les variables d'environnement

• body-parser - middleware pour Express afin de gérer l'objet webhook entrant

Initialiser le projet et installer les exigences ci-dessus en utilisant npm ou yarn.

Une fois installé, créez un index.js et .env fichier.

Ensuite, ouvrez le fichier index.js et placez le code suivant à l'intérieur :

'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`);
});

Cela permet de configurer le serveur pour qu'il exécute l'exemple.

Installation de ngrok

Les webhooks doivent être accessibles au public afin que le service Vonage puisse accéder à l'application lors de la réception de messages SMS entrants. Vous pouvez pousser votre code vers un serveur accessible au public, ou vous pouvez utiliser ngrok pour permettre au trafic public d'atteindre votre application locale.

Vous pouvez en savoir plus sur l'installation ngrok avec ce billet. Une fois que tout est prêt, vous pouvez démarrer ngrok en utilisant la commande suivante pour créer votre tunnel.

Notez l'adresse, car vous en aurez besoin dans une étape ultérieure. ngrok car vous en aurez besoin dans une étape ultérieure.

Configuration d'AWS Translate

Une fois les éléments initiaux configurés, vous pouvez maintenant créer un utilisateur IAM avec le rôle AWS Translate.

Create New IAM User

Donnez un nom au nouvel utilisateur et cochez la case pour Programmable Access.

Set User Details

Ensuite, l'utilisateur IAM aura besoin de la TranslateFullAccess attachée. L'utilisateur IAM aura ainsi accès à la fonctionnalité de traduction.

Set User Permissions

Examinez les paramètres de l'utilisateur, puis cliquez sur Create.

Review and Create User

Une fois le processus de création terminé, récupérez les fichiers Access Key ID et Secret Access Key.

Get the Access Key ID and Secret

Créez un nouveau fichier .env puis copiez et collez le texte suivant :

AWS_ACCESS_KEY_ID=
AWS_SECRET_ACCESS_KEY=
AWS_REGION=

En utilisant les informations d'identification de l'utilisateur IAM qui vient d'être créé, remplissez les détails dans le fichier, enregistrez et continuez pour créer le numéro de téléphone Vonage. .env enregistrez et continuez à créer le numéro de téléphone de Vonage.

Configuration des messages SMS entrants de Vonage

Cet exemple nécessite un numéro de téléphone de vonage pour recevoir des messages entrants. Nous pouvons le faire en utilisant le CLI de Vonage de Vonage à partir d'un terminal.

Acheter un numéro de téléphone virtuel

La première étape consistera à acheter un numéro (n'hésitez pas à utiliser un autre numéro ISO 3166 alpha-2 si nécessaire).

Bien que l'itinéraire à utiliser dans l'application ne soit pas encore défini, vous le nommerez /message. Le numéro de téléphone doit être lié à cet itinéraire pour que les messages entrants sachent où aller. Récupérez le ngrok nom d'hôte de la configuration précédente et utilisez-le ici :

Le webhook de Vonage est désormais configuré pour l'acheminement des SMS entrants.

Terminer l'application

Pour ce tutoriel, il ne reste plus qu'à créer la route Express pour gérer les données entrantes et quelques petites fonctions pour effectuer la traduction.

Construire le Webhook

Tout d'abord, nous devons créer le code du webhook. Vonage dispose d'une fonction intégrée permettant de définir le comportement par défaut des SMS. Dans le panneau des paramètres vous pouvez modifier la méthode HTTP utilisée par défaut. La mienne est réglée sur POST-JSON. Je vous recommande d'utiliser ce paramètre si possible, mais le code utilisé dans cet exemple traitera les trois options au cas où vous ne seriez pas en mesure de modifier ce paramètre.

Default Vonage SMS HTTP Method

Ouvrez le fichier index.js et, en bas, collez le code suivant :

// 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();
  }

};

L'extrait ci-dessus est la méthode que nous passerons dans les routes. Si le webhook des messages entrants utilise POST il utilisera req.bodyet il utilisera req.query pour l'option GET pour l'option Tant que la charge utile entrante est correctement configurée, l'objet sera envoyé à la méthode translateText pour afficher la traduction.

Vous pouvez maintenant ajouter l'itinéraire et les méthodes HTTP à l'application.

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

Le code ci-dessus créera les fichiers GET et POST pour traiter les messages entrants du webhook SMS. Si une autre méthode est utilisée, une réponse 405 - Method Not Allowed sera renvoyée.

Le webhook est prêt à être utilisé et la dernière étape est la traduction proprement dite.

Méthode de traduction

Dans l'étape précédente, nous appelons translateText. Cette étape créera cette méthode.

L'utilisation du paquet aws-sdk est très simple. Nous commençons par instancier la classe AWS.Translate qui nous fournira la méthode translate.translateText ce qui nous donne la méthode Celle-ci est appelée à l'intérieur de translateText et utilise le champ text de l'objet SMS entrant. La langue SourceLanguageCode est fixé à autoet l'entrée TargetLanguageCode est un code à deux lettres pour la langue à traduire en.

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}`);
    }
  });
}

Vous pouvez maintenant tester la fonctionnalité en démarrant le serveur et en envoyant un message texte au numéro que vous avez acheté précédemment.

AWS Translate fait un travail remarquable en détectant la langue d'arrivée et en traitant la traduction rapidement. Amusez-vous et essayez-le.

Récapitulation

L'exemple ci-dessus n'est qu'une petite introduction à la traduction, mais il devrait constituer un bon point de départ. À partir de là, vous pouvez traduire le message entrant, puis le message sortant dans la bonne langue (un futur article de blog, bien sûr).

Vous trouverez une version complète de ce tutoriel à l'adresse suivante https://github.com/nexmo-community/sms-translate-aws-js.

Si vous souhaitez en savoir plus sur les projets Extend que nous avons, vous pouvez visiter le site suivant intégration pour en savoir plus.