Traducir mensajes SMS con Azure Translator Text

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

Visión general

En este post, te muestro cómo crear un SMS entrantes de Vonage entrante de Vonage y traducir el mensaje al inglés usando el Azure Traductor de Texto.

Para empezar, necesitarás tener configurados los siguientes elementos:

• Azure

• 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

Sólo necesitarás un par de paquetes para ponerte manos a la obra.

• @azure/ms-rest-js-Este es el SDK de Azure y le ayudará con las credenciales.

• @azure/cognitiveservices-translatortext-este es el SDK de Azure Translator Text

• 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 CognitiveServicesCredentials = require("@azure/ms-rest-js");
const { TranslatorTextClient } = require("@azure/cognitiveservices-translatortext");

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

Se requieren webhooks disponibles públicamente para que Vonage pueda comunicarse con la aplicación para recibir 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 del texto de Azure Translator

A continuación, puede configurar el servicio Azure Translator Text en el portal Azure. Comience por abrir el portal y haga clic en Create New Resource.

Azure Portal Home Page

En la siguiente pantalla, busque Translator Text y haga clic en el resultado para acceder a la página de información del texto del traductor. Haga clic en Create para iniciar el proceso.

Translator Text Create Resource Screen

Rellene el nombre, seleccione Pay As You Go y el grupo de recursos y, a continuación, haga clic en Create en la parte inferior de la página.

Translator Text Create Resource Details

El proceso de creación tarda unos instantes, así que relájate un poco hasta que termine.

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

TEXT_TRANSLATION_SUBSCRIPTION_KEY=
TEXT_TRANSLATION_ENDPOINT=https://api.cognitive.microsofttranslator.com/translate

Obtenga la clave y el punto final de la página de inicio rápido y actualice el archivo .env con esa información.

Durante mis pruebas, intenté utilizar el punto final de servicios presentado en el panel de control, pero no tuve suerte para que funcionara correctamente. La URL anterior es el punto final global que funcionará si tiene los mismos problemas.

Translator Text Resource Quickstart

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 directamente desde tu terminal.

Comprar un número de teléfono virtual

En primer lugar, compra un número directamente a Vonage (no dudes en usar otro 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 el webhook de Vonage está configurado para enrutar los mensajes SMS entrantes.

Finalizar la solicitud

El único paso ahora es crear la ruta Express y las funciones para gestionar el mensaje SMS entrante y las traducciones.

Crear el Webhook

Primero podemos configurar el controlador de ruta. Vonage permite configurar un comportamiento de webhook de SMS predeterminado. En el panel de configuración puedes cambiar el método HTTP por defecto. El mío está configurado en POST-JSONy recomiendo usar esta configuración. Si no puedes modificar tu configuración, el código utilizado aquí manejará las tres opciones.

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

};

Este manejador se pasará directamente a la /message ruta. Si el método HTTP del mensaje entrante es POSTel manejador utiliza req.bodyy utiliza req.query para la opción GET opción. A continuación, comprueba la carga útil entrante asegurándose de que contiene la información correcta y envía el objeto al 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.

Inicialmente obtendrá sus credenciales utilizando CognitiveServicesCredentials.ApiKeyCredentials. Esto tendrá que ser pasado como primer parámetro al constructor TranslatorTextClient constructor.

Después de crear el clientutilice el método translate para traducir el texto. El primer argumento es una matriz de idiomas a los que desea traducir el texto, lo que le permite traducir a varios idiomas. El servicio detectará automáticamente el idioma entrante si puede. El segundo argumento es una matriz de objetos para el texto que desea traducir.

function translateText(params) {
  const creds = new CognitiveServicesCredentials.ApiKeyCredentials({ inHeader: { 'Ocp-Apim-Subscription-Key': process.env.TEXT_TRANSLATION_SUBSCRIPTION_KEY } });
  const client = new TranslatorTextClient(creds, process.env.TEXT_TRANSLATION_ENDPOINT);

  client.translator
    .translate(["en"], [{text:params.text}])
    .then(result => {
      console.log(`Original Text: ${params.text}`);
      console.log(`Translation: ${result[0].translations[0].text}`)
    })
    .catch(err => {
      console.error("error:", err);
    });
}

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

El objeto Azure Translator Text full response también tiene muchos detalles, por lo que puede cambiar la respuesta para incluir console.dir(translationResult, {depth: null}) para ver la carga útil completa.

Recapitulemos

Azure Translator Text es una gran herramienta para traducir tus mensajes entrantes de Vonage. Este ejemplo solo araña la superficie pero debería ser un buen comienzo. Puedes aventurarte en varias direcciones desde aquí usando esto como punto de partida. Déjame saber qué ideas tienes para usar estos dos servicios juntos.

Puede encontrar una versión completa de este tutorial en https://github.com/nexmo-community/sms-azure-translate-js.

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