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 Número de teléfono RTPC. Para ello, hay que extraer el número de destino del to parámetro de consulta y devolverlo en tu respuesta.

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ñadir el código como se muestra a continuación - por favor, asegúrese de reemplazar NUMBER con tu número de Vonage (en E.164 ), así como 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 vonageNumber = 'NUMBER';

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

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

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

if(vonageNumber == "NUMBER") {
  console.log('\n\t🚨🚨🚨 Please change the NUMBER value');
  return false;
}

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 antes. Devuelve un JSON que contiene el número de destino de la llamada.

   Fíjate en que el number se extrae del req.query.to que Vonage envía como parte de la solicitud. Luego, la NCCO creada dinámicamente reenvía la llamada al teléfono de destino utilizando un connect acción.

2. El segundo, /voice/eventestablecerás como destino que Vonage te notifique todo lo que ocurra durante la llamada, lo que 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.