Crear un servidor webhook

Cuando se recibe una llamada entrante, Vonage realiza una solicitud a una URL de acceso público de tu elección, que denominamos answer_url. Necesitas crear un servidor webhook que sea capaz de recibir esta petición y devolver un OCN que contiene un connect que desviará la llamada al del usuario app. En este tutorial, el nombre de la usuaria de destino está fijado por defecto como «Alice».

Nuevo proyecto

Crea un nuevo directorio de proyecto en la ubicación que prefieras y accede a él:

Dentro de la carpeta, inicializa un nuevo proyecto Node.js ejecutando este comando:

Añadir dependencias

A continuación, instale las dependencias necesarias:

Crear el archivo del servidor

Dentro de la carpeta de tu proyecto, crea un archivo llamado server.js y añade el código tal y como se muestra a continuación; asegúrate de sustituir SUBDOMAIN con un valor real. El valor utilizado formará parte de las URL que establecerás como webhooks en el siguiente paso.

'use strict';

const subdomain = 'SUBDOMAIN';

const express = require('express')
const app = express();
app.use(express.json());

app.get('/voice/answer', (req, res) => {
  console.log('NCCO request:');
  console.log(`  - caller: ${req.query.from}`);
  console.log('---');
  res.json([ 
    { 
      "action": "talk", 
      "text": "Please wait while we connect you."
    },
    { 
      "action": "connect", 
      "from": req.query.from,
      "endpoint": [ 
        { "type": "app", "user": "Alice" } 
      ]
    }
  ]);
});

app.all('/voice/event', (req, res) => {
  console.log('EVENT:');
  console.dir(req.body);
  console.log('---');
  res.sendStatus(200);
});

if(subdomain == "SUBDOMAIN") {
  console.log('\n\t🚨🚨🚨 Please change the SUBDOMAIN value');
  return false;
}
app.listen(3000);

const localtunnel = require('localtunnel');
(async () => {
  const tunnel = await localtunnel({ 
      subdomain: subdomain, 
      port: 3000
    });
  console.log(`App available at: ${tunnel.url}`);
})();

El código del servidor anterior consta de dos partes:

El servidor Express

La primera parte crea un Express y lo hace disponible localmente en el puerto 3000. El servidor expone 2 rutas:

1. /voice/answer es el answer_url que mencionamos anteriormente. Devuelve un NCCO como JSON respuesta que contiene información para conectarse a un usuario de la aplicación.

2. El segundo, /voice/eventestablecerás como destino para que Vonage te notifique todo lo que ocurra durante la llamada - - a esto lo llamamos el event_url.

El localtunnel integración

La segunda parte del código del servidor anterior, expone la función Express para que sea accesible por los servidores de Vonage.

Iniciar el servidor

Ahora puedes iniciar el servidor ejecutando, en la terminal, el siguiente comando:

Aparecerá un mensaje indicándote que el servidor ya está disponible:

App available at: https://SUBDOMAIN.loca.lt

Por favor, ten a mano la ventana de la terminal, ya que necesitarás la URL en el siguiente paso.