Traducir mensajes SMS con IBM Watson y Vonage

En mis entradas anteriores, mostré cómo puedes traducir mensajes de texto con la API de traducción de Google y AWS Translate.

Visión general

En este post, te muestro cómo crear un SMS entrante de Vonage y traducir el mensaje al inglés utilizando el traductor de idiomas de IBM Watson.

Para empezar, necesitarás configurar los siguientes elementos:

• Nube de IBM

• Vonage CLI instalado

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.

Cree su proyecto

La configuración de este ejemplo es mínima y sólo necesitas un par de paquetes para ponerte en marcha.

• ibm-watson - este es el SDK oficial de IBM Watson

• express - web framework para servir el webhook

• dotenv - un paquete para cargar variables de entorno

• body-parser - middleware para que Express gestione el objeto webhook entrante

Inicialice el proyecto y luego instale los requisitos anteriores utilizando npm o yarn.

Una vez instalado, cree una cuenta index.js y .env archivo.

A continuación, abra el archivo index.js y pon el siguiente código dentro:

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

Esto configurará el servidor para ejecutar el ejemplo.

Instalación de Ngrok

Los webhooks deben estar disponibles públicamente para que el servicio de Vonage pueda llegar a la aplicación cuando se reciban mensajes SMS entrantes. Podrías enviar tu código a un servidor disponible públicamente, o puedes usar ngrok para permitir que el tráfico público llegue a tu aplicación local.

Puede obtener más información sobre la instalación ngrok con este post. Después de que tengas todo listo puedes iniciar ngrok usando el siguiente comando para crear tu túnel.

Anote la dirección ngrok dirección, ya que la necesitará en un paso posterior.

Configuración de IBM Watson Language Translator

Una vez configurados los elementos iniciales, puede añadir IBM Watson Language Translator a su Account y obtener las credenciales necesarias para ejecutar el ejemplo. Siga este enlace para habilitar Language Translator API. Seleccione un proyecto y, a continuación, haga clic en el botón Enable para activar la API en ese proyecto.

Create Language Translator Service

Una vez creado, aparecerá un tutorial de introducción. En el menú de la izquierda, haga clic en Manage para localizar la siguiente pantalla:

IBM Watson Language Translator Manage Screen

Abra primero el archivo .env y copia y pega lo siguiente:

TRANSLATE_IAM_APIKEY=
TRANSLATE_URL=

Utilizando la función Copiar el API Key y URL que se encuentran en la página IBM Watson Translation Manage, rellena los .env detalles del archivo, guarda y continúa para crear el número de teléfono de Vonage.

Cómo configurar los mensajes SMS entrantes de Vonage

Este ejemplo requiere un número de teléfono de Vonage para recibir mensajes entrantes. Podemos hacerlo utilizando la CLI de Vonage desde una terminal.

Comprar un número de teléfono virtual

El primer paso será adquirir un número (siéntase libre de utilizar un ISO 3166 alfa-2 según sea necesario).

Aunque la ruta real a utilizar en la aplicación no está configurada, le darás un nombre /message. Es necesario vincular el número de teléfono a esta ruta para que los mensajes entrantes sepan a dónde dirigirse. Obtenga el ngrok nombre de host de la configuración anterior y utilícelo aquí:

Ahora tenemos el webhook configurado como un lugar para que los mensajes SMS entrantes sean enrutados.

Finalizar la solicitud

Todo lo que queda para este tutorial es crear la ruta Express para manejar los datos entrantes y un par de pequeñas funciones para realizar realmente la traducción.

Crear el Webhook

En primer lugar, debemos crear el código del webhook. Vonage tiene una función integrada para configurar el comportamiento predeterminado de los SMS. En el panel de configuración puedes cambiar el método HTTP por defecto. El mío es POST-JSON. Yo recomendaría usar esta configuración si es posible, sin embargo el código usado en este ejemplo manejará las tres opciones en caso de que no puedas modificar esta configuración.

Default Vonage SMS HTTP Method

Abra el archivo index.js y, en la parte inferior, pegue el siguiente código:

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

};

El fragmento anterior es el método que pasaremos a las rutas. Si el mensaje entrante utiliza POST utilizará req.bodyy utilizará req.query para la opción GET opción . Siempre que la carga útil de entrada esté configurada correctamente, el objeto se enviará junto con el método translateText para mostrar la traducción.

Ahora puede añadir la ruta y los métodos HTTP a la aplicación.

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

El código anterior creará los archivos GET y POST para gestionar cualquiera de los mensajes SMS entrantes. Si se utiliza cualquier otro método, se devolverá una 405 - Method Not Allowed se devolverá una respuesta.

El webhook está listo y la pieza final son las traducciones propiamente dichas.

Método de traducción

En el paso anterior llamamos translateText. Este paso creará ese método.

Utilizando el paquete ibm-watson instanciamos primero la clase LanguageTranslatorV3 que nos dará el método translate método Éste se llama dentro del método translateText y utiliza el campo text del objeto de mensaje SMS entrante. El campo modelId es cualquier código de dos letras para el idioma a traducir.

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

Ahora puedes probar la funcionalidad iniciando el servidor y enviando un mensaje de texto al número que compraste anteriormente.

El objeto de respuesta completa de IBM Watson Language Translator también tiene muchos detalles, por lo que podría cambiar la respuesta para incluir console.dir(translationResult, {depth: null}) para ver la carga útil completa.

Recapitulemos

El ejemplo anterior es sólo una pequeña introducción a la traducción utilizando el servicio IBM Watson Translation. Desde aquí puedes traducir el mensaje entrante y, a continuación, traducir también el mensaje saliente al idioma correcto (futura entrada del blog, seguro).

Puede encontrar una versión completa de este tutorial en GitHub de la comunidad de Vonage.

Si quieres saber más sobre los proyectos Extend que tenemos, puedes visitar https://developer.vonage.com/extend.