Entrega de la compilación con la biblioteca cliente de Actions on Google para Node.js (Dialogflow)

La biblioteca cliente de Actions on Google para Node.js es la forma recomendada de acceder y, además, interactuar con la plataforma de Actions on Google si creas un webhook de entrega en JavaScript.

Introducción

La biblioteca cliente de Node.js es una biblioteca de entregas para Actions on Google que proporciona estas características:

• Admite todas las funciones de Actions on Google, incluidas las respuestas de texto y rich media, el acceso a la cuenta, el almacenamiento de datos, las transacciones y mucho más.
• Proporciona una capa idiomática de abstracción en JavaScript que une la API de webhook HTTP/JSON de conversación.
• Controla los detalles de bajo nivel de la comunicación entre tu entrega y la plataforma de Actions on Google.
• Se puede instalar con herramientas de administración de paquetes conocidos, como npm o yarn.
• Te permite implementar con facilidad tu webhook de entrega en plataformas de computación sin servidores, como Cloud Functions para Firebase o AWS Lambda. También puedes alojar tu webhook de entregas en un proveedor de servicios en la nube o en un entorno autoadministrado y alojado.
• Es compatible con Node.js v6.0.0 y versiones posteriores.

Puedes usar la biblioteca cliente junto con la integración de Dialogflow para Actions on Google o el SDK de Actions.

Para ver muestras de código completas sobre el uso de la biblioteca cliente, puedes visitar la página de muestras.

Ver la referencia de la API

La referencia de la API se aloja en la página de GitHub de la biblioteca cliente de Actions on Google para Node.js.

También puedes generar una copia local de la referencia si ejecutas el siguiente comando desde el directorio en el que descargaste el código de biblioteca cliente:

yarn docs

Los documentos generados estarán disponibles en la carpeta docs del directorio en el que descargaste el código de biblioteca cliente.

Comprende el funcionamiento

Antes de usar la biblioteca cliente, es útil comprender cómo tu webhook de entrega usa la biblioteca cliente para procesar las solicitudes de usuario que Actions on Google envía a la entrega.

Cuando creas un webhook de entrega en JavaScript, puedes implementar y alojar tu código en un entorno de computación sin servidores, como Cloud Functions para Firebase o AWS Lambda. También puedes alojar el código tú mismo sin trabajo adicional mediante el marco de trabajo web Express.

Nota: Si deseas ejecutar tu webhook de entrega en algún otro entorno, puedes usar la función genérica StandardHandler. Puedes llamar a esta función con app.handler, que toma un objeto JSON y encabezados como entradas y genera un objeto JSON y un código de estado en una promesa.

Dentro del entorno de ejecución, el webhook de entrega puede llamar a funciones en la biblioteca cliente para procesar las solicitudes de los usuarios y enviar respuestas a Actions on Google a fin de procesarlas en el resultado del usuario.

A continuación, se resumen brevemente las tareas clave que maneja tu webhook de entrega con la ayuda de la biblioteca cliente:

Figura 1: Arquitectura de alto nivel de la biblioteca cliente de Node.js

1. Recepción de solicitudes del usuario: Cuando un usuario realiza una consulta al Asistente de Google, la plataforma de Actions on Google envía una solicitud HTTP a tu webhook de entrega. La solicitud incluye una carga útil de JSON que contiene el intent y otros datos, como el texto sin procesar de la entrada del usuario y las capacidades de la superficie del dispositivo del usuario. Para obtener más ejemplos del contenido de carga útil de JSON, consulta las guías de formato de webhook de Dialogflow y de formato de webhook de conversación.
2. Detección de formato de llamada de marcos de trabajo: para los marcos de trabajo compatibles, la biblioteca cliente detecta automáticamente el formato de llamada del marco de trabajo (por ejemplo, si la solicitud provino del marco de trabajo web Express o de AWS Lambda) y sabe cómo manejar la comunicación con la plataforma de Actions on Google sin problemas.
3. Procesamiento del controlador de servicios: La biblioteca cliente representa la API de webhook HTTP/JSON de conversación para el SDK de Dialogflow y Actions como una función de servicio. El webhook de entrega usa el servicio adecuado para crear una instancia app global. La instancia app actúa como un controlador para las solicitudes HTTP y comprende el protocolo específico del servicio.
4. Procesamiento de conversaciones: la biblioteca cliente representa la información por conversación como un objeto Conversation adjunto a la instancia app. Tu webhook de entrega puede usar el objeto Conversation para recuperar datos almacenados de manera conversacional o información de estado, enviar respuestas a los usuarios o cerrar el micrófono.
5. Procesamiento de middleware:la biblioteca cliente te permite crear tu propio middleware de servicios de conversación, que consiste en una o más funciones que defines que la biblioteca cliente se ejecuta de forma automática antes de llamar al controlador del intent. Tu webhook de entrega puede usar tu middleware para agregar propiedades o clases de ayuda al objeto Conversation.
6. Procesamiento del controlador de intents: La biblioteca cliente te permite definir controladores para intents que el webhook de entrega entiende. Para Dialogflow, la biblioteca cliente enruta la solicitud al controlador de intents correcto mediante la asignación a la string exacta del nombre del intent definido en la consola de Dialogflow. Para el SDK de Actions, se enruta según la propiedad intent que se envía desde Actions on Google.
7. Envío de respuestas a los usuarios: Para crear respuestas, el webhook de entrega llama a la función Conversation#ask(). Se puede llamar a la función ask() varias veces para compilar la respuesta de forma incremental. La biblioteca cliente serializa la respuesta en una solicitud HTTP con una carga útil JSON y la envía a Actions on Google. La función close() tiene un comportamiento similar a ask(), pero cierra la conversación.

Nota: Ten en cuenta que la plataforma Actions on Google tiene ciertas restricciones en las respuestas que el desarrollador envía de vuelta, como la cantidad de objetos SimpleResponse enviados a través de la función ask(). Debido a que esto es independiente de la biblioteca cliente, deberías probar el simulador de Actions para verificar si hay errores de validación en tus respuestas.

Configura el entorno de desarrollo local

Antes de implementar tu webhook de entrega, asegúrate de instalar la biblioteca cliente.

Instala la biblioteca cliente

La manera más fácil de instalar la biblioteca cliente en tu entorno de desarrollo local es usar un administrador de paquetes, como npm o yarn.

Para instalarlo, ejecuta uno de estos comandos desde la terminal:

• Si usas npm: npm install actions-on-google
• En caso de usar un hilo: yarn add actions-on-google

Configura las carpetas de tu proyecto

Según dónde planeas implementar el webhook de entrega (Cloud Functions de Google para Firebase, AWS Lambda o Express hospedado por ti mismo), es posible que debas crear una estructura de carpetas del proyecto específica para guardar tus archivos.

Por ejemplo, si usas Cloud Functions para Firebase, puedes configurar las carpetas de proyecto necesarias mediante los pasos que se describen en Configura Node.js y Firebase CLI, además de Inicializa Firebase para Cloud Functions. En el caso de Cloud Functions para Firebase, por lo general, escribes el webhook de entrega en el archivo /functions/index.js.

Compila una instancia de app

Actions on Google usa formatos de mensajería específicos para intercambiar solicitudes y respuestas con tu webhook de entrega, según si compilas una acción conversacional con Dialogflow o el SDK de Actions, o bien si compilas una acción de casa inteligente.

Para representar estos diferentes protocolos de solicitud y respuesta, la biblioteca cliente proporciona tres funciones de servicio:

• dialogflow
• actionssdk
• smarthome

Los dos servicios de conversación (el SDK de Dialogflow y Actions) usan el protocolo de webhook de conversación, pero cada servicio une los mensajes de manera diferente.

Usas un servicio para crear una instancia de app. La instancia app encapsula el estado global y la lógica de entrega de tu webhook y controla la comunicación entre Actions on Google y tu entrega mediante el protocolo específico del servicio.

Puedes configurar las propiedades de la instancia de app y llamar a sus métodos para dirigir el comportamiento del webhook de entrega. También puedes conectar la instancia app con facilidad en un entorno de computación sin servidores, como Cloud Functions para Firebase, que acepta funciones de JavaScript como controladores para las solicitudes HTTP.

Para compilar una instancia app en tu webhook de entrega, sigue estos pasos:

1. Llama a la función require() para importar el módulo de “actions-on-google” y carga el servicio que desees. Por ejemplo, en el siguiente fragmento, se muestra cómo podrías cargar el servicio dialogflow y algunos elementos usados para compilar respuestas y asignarlos a una constante llamada dialogflow:

   // Import the service function and various response classes
   const {
     dialogflow,
     actionssdk,
     Image,
     Table,
     Carousel,
   } = require('actions-on-google');

   Aquí, actions-on-google hace referencia a una dependencia que se especifica en un archivo package.json de la carpeta de tu proyecto (puedes consultar este archivo package.json de ejemplo para ver un ejemplo).

   Cuando obtienes una instancia de app, tienes la opción de especificar las clases que representan las respuestas enriquecidas, los intents auxiliares y otras funciones de Actions on Google que desees usar. Para ver la lista completa de clases válidas que puedes cargar, consulta la documentación de referencia de los módulos de respuesta a conversaciones y intents auxiliares.

   Nota: La biblioteca cliente se actualiza con frecuencia. Consulta las últimas notas de la versión para conocer los cambios de la API.

2. Llama al servicio que cargaste para crear una instancia de app. Por ejemplo:

   const app = dialogflow();

3. Para configurar la instancia app en la inicialización, puedes proporcionar un objeto options como el primer argumento cuando llames al servicio. (Consulta DialogflowOptions para obtener más detalles). Por ejemplo, en el siguiente fragmento, se muestra cómo registrar la carga útil JSON sin procesar de la solicitud o respuesta del usuario mediante la configuración de la marca { debug: true }:

const app = dialogflow({
  debug: true
});

Configura controladores para eventos

Para procesar eventos relacionados con Actions on Google creados por la biblioteca cliente durante el ciclo de vida de la interacción del usuario con tu acción, usarás la biblioteca cliente para compilar controladores que procesen solicitudes de usuarios y envíen respuestas.

Puedes crear funciones que actúen como controladores para estos tipos principales de eventos que la biblioteca cliente reconoce:

• Eventos de intents: Los intents son identificadores únicos que Actions on Google envía a tu entrega cada vez que un usuario solicita alguna funcionalidad específica. Si usas Dialogflow, esto corresponde a que Dialogflow haga coincidir una consulta del usuario con un intent en tu agente de Dialogflow.
• Eventos de error: Cuando se produce un error de JavaScript o de la biblioteca cliente, puedes usar la función catch de la instancia app para procesar la excepción de error de manera adecuada. Debes implementar una sola función catch para manejar todos los errores que le interesan a tu entrega.
• Eventos de resguardo: Un evento de resguardo se produce cuando el usuario envía una consulta que Actions on Google no puede reconocer. Puedes usar la función fallback de la instancia app para registrar un controlador de resguardo genérico que se activará si no hay coincidencias con un controlador de intents para la solicitud de entrega entrante. Debes implementar una sola función fallback para controlar todos los eventos de resguardo. Si usas Dialogflow, Dialogflow puede activar un intent de resguardo específico cuando no coincide ningún otro intent. Debes crear el controlador del intent correspondiente para ese intent de resguardo.

Cada vez que el usuario envía una solicitud a tu acción, la instancia de app crea un objeto Conversation que representa esa sesión de conversación. Se accede a este objeto mediante el nombre de variable conv que se pasa en la función del controlador de intents como el primer argumento de función. Por lo general, usarás el objeto conv en tus controladores para enviar una respuesta al usuario.

Las consultas de usuario también pueden incluir parámetros que tu acción puede extraer y usar para definir mejor las respuestas.

• Si usas el SDK de Actions, define parámetros en el paquete de acciones. Para ver un ejemplo de cómo puedes extraer parámetros de los intents, consulta la muestra de código de Eliza.
• Si usas Dialogflow, puedes acceder a los valores de los parámetros a través de la variable params. Para ver ejemplos del manejo de intents con parámetros en Dialogflow, consulta Contextos y parámetros de acceso.

Configura controladores para intents

Para configurar el controlador de un intent, llama a la función intent() de tu instancia de app. Por ejemplo, si usas Dialogflow, esta es la función DialogflowApp#intent(). En los argumentos, especifica el nombre del intent y proporciona una función de controlador.

Si usas Dialogflow, no necesitas configurar controladores para cada intent en tu agente. En cambio, puedes aprovechar el controlador de respuestas integrado de Dialogflow para manejar automáticamente los intents sin implementar tus propias funciones del controlador. Por ejemplo, el intent de bienvenida predeterminado se puede delegar a Dialogflow de esta manera.

En el siguiente ejemplo, se muestran los controladores de intent para los intents "greeting" (adiós) y "bye" (adiós). Sus funciones de controlador anónimos toman un argumento conv y envían una respuesta de string simple al usuario a través de la función conv.ask():

app.intent('Default Welcome Intent', (conv) => {
  conv.ask('How are you?');
});

app.intent('bye', (conv) => {
  conv.close('See you later!');
});

Ten en cuenta que la función close() es similar a ask(), excepto que este cierra el micrófono y la conversación termina.

Si deseas obtener más información sobre cómo compilar controladores para intents, consulta Cómo compilar tu controlador de intents.

Configura controladores para eventos de error

Para configurar los controladores de errores, llama a la función catch() de tu instancia de app. (Por ejemplo, si usas Dialogflow, esta es la función DialogflowApp#catch()).

En el siguiente ejemplo, se muestra un controlador de errores de captura simple que envía el error al resultado de la consola y envía una respuesta de string simple para enviar una solicitud al usuario a través de la función conv.ask():

app.catch((conv, error) => {
  console.error(error);
  conv.ask('I encountered a glitch. Can you say that again?');
});

Configura controladores para eventos de resguardo

A fin de establecer un controlador de resguardo genérico cuando no hay coincidencias de intents para la solicitud entrante que se debe realizar, llama a la función fallback() de la instancia app. (Por ejemplo, si usas Dialogflow, esta es la función DialogflowApp#fallback()).

En el siguiente ejemplo, se muestra un controlador de resguardo simple que envía una respuesta de string simple para solicitarle al usuario a través de la función conv.ask():

app.fallback((conv) => {
  conv.ask(`I couldn't understand. Can you say that again?`);
});

Compila tu controlador de intents

En esta sección, se describen algunos casos prácticos comunes en los que implementas controladores de intents con la biblioteca cliente. Para ver cómo la biblioteca cliente coincide con el intent, consulta la sección "Procesamiento del controlador de intents" en Comprende cómo funciona.

Parámetros de acceso y contextos

Si usas Dialogflow, puedes definir parámetros y contextos en tu agente de Dialogflow para mantener la información del estado y controlar el flujo de la conversación.

Los parámetros son útiles para capturar palabras, frases o valores importantes en las consultas de los usuarios. Dialogflow extrae los parámetros correspondientes de las consultas de los usuarios en el entorno de ejecución y puedes procesar estos valores de parámetros en tu webhook de entrega para determinar cómo responder a los usuarios.

Cada vez que el usuario envía una solicitud a tu acción, la instancia de DialogflowApp crea un objeto parameters que representa los valores de parámetros que Dialogflow extrajo de esa solicitud. Se accede a este objeto mediante el nombre de variable params.

En el siguiente fragmento, se muestra cómo puedes acceder a la propiedad name desde el objeto params cuando el usuario envía una solicitud:

app.intent('Default Welcome Intent', (conv, params) => {
  conv.ask(`How are you, ${params.name}?`);
});

A continuación, se muestra un fragmento alternativo que hace lo mismo. Las llaves ({}) realizan la desestructuración de JavaScript para tomar la propiedad name del objeto parameters y usarla como una variable local:

app.intent('Default Welcome Intent', (conv, {name}) => {
  conv.ask(`How are you, ${name}?`);
});

En el siguiente fragmento, el nombre del parámetro es full-name, pero está desestructurado y se asigna a una variable local llamada name:

app.intent('Default Welcome Intent', (conv, {'full-name': name}) => {
  conv.ask(`How are you, ${name}?`);
});

Los contextos son una característica avanzada de Dialogflow. Puedes usar contextos para administrar el estado de la conversación, el flujo y la ramificación. La biblioteca cliente proporciona acceso a un contexto a través del objeto DialogflowConversation#contexts. En el siguiente fragmento, se muestra cómo puedes establecer un contexto de manera programática en tu webhook de entrega y cómo recuperar el objeto de contexto:

app.intent('intent1', (conv) => {
  const lifespan = 5;
  const contextParameters = {
    color: 'red',
  };
  conv.contexts.set('context1', lifespan, contextParameters);
  // ...
  conv.ask('...');
});

app.intent('intent2', (conv) => {
  const context1 = conv.contexts.get('context1');
  const contextParameters = context1.parameters;
  // ...
  conv.ask('...');
});

app.intent('intent3', (conv) => {
  conv.contexts.delete('context1');
  // ...
  conv.ask('...');
});

Accede a los resultados de los intents auxiliares

Para mayor comodidad, la biblioteca cliente proporciona clases de intent auxiliares que unen tipos comunes de datos del usuario que las acciones solicitan con frecuencia. Estas incluyen clases que representan los resultados de los diversos intents auxiliares de Actions on Google. Utiliza intents auxiliares cuando quieres que Asistente de Google maneje partes de la conversación en las que el usuario debe proporcionar entradas para continuar la conversación.

Ejemplo: Resultados del asistente de confirmación

El intent de ayuda de confirmación te permite solicitar una confirmación de sí o no del usuario y obtener la respuesta resultante. En el siguiente fragmento, se muestra cómo el webhook puede personalizar su respuesta en función de los resultados que muestra el intent auxiliar de confirmación. Para ver un ejemplo más completo, consulta la documentación de referencia de la clase Confirmation.

// Create Dialogflow intent with `actions_intent_CONFIRMATION` event
app.intent('get_confirmation', (conv, input, confirmation) => {
  if (confirmation) {
    conv.close(`Great! I'm glad you want to do it!`);
  } else {
    conv.close(`That's okay. Let's not do it now.`);
  }
});

Ejemplo: Resultados de carrusel

En el siguiente fragmento, se muestra cómo el webhook de entrega puede personalizar su respuesta en función de la entrada del usuario en un carrusel. El componente de carrusel permite que tu acción presente una selección de opciones para que elijan los usuarios. Para ver un ejemplo más completo, consulta la documentación de referencia de la clase Carousel.

app.intent('carousel', (conv) => {
  conv.ask('Which of these looks good?');
  conv.ask(new Carousel({
    items: {
      car: {
        title: 'Car',
        description: 'A four wheel vehicle',
        synonyms: ['automobile', 'vehicle'],
      },
      plane: {
        title: 'Plane',
        description: 'A flying machine',
        synonyms: ['aeroplane', 'jet'],
      }
    }
  }));
});

// Create Dialogflow intent with `actions_intent_OPTION` event
app.intent('get_carousel_option', (conv, input, option) => {
  if (option === 'one') {
    conv.close(`Number one is a great choice!`);
  } else {
    conv.close(`Number ${option} is a great choice!`);
  }
});

Configura objetos de respuesta de conversación

La biblioteca cliente proporciona clases de respuesta de conversación que representan respuestas enriquecidas o elementos multimedia que tu acción puede enviar. Por lo general, envías estas respuestas o elementos cuando los usuarios no necesitan proporcionar ninguna entrada para continuar la conversación.

Ejemplo: Imagen

En el siguiente fragmento, se muestra cómo el webhook de entrega puede enviar un Image en una respuesta que la biblioteca adjuntará de forma automática a una respuesta BasicCard:

app.intent('Default Welcome Intent', (conv) => {
  conv.ask('Hi, how is it going?');
  conv.ask(`Here's a picture of a cat`);
  conv.ask(new Image({
    url: '/web/fundamentals/accessibility/semantics-builtin/imgs/160204193356-01-cat-500.jpg',
    alt: 'A cat',
  }));
});

Realiza llamadas a funciones asíncronas

La biblioteca cliente de Actions on Google para Node.js está diseñada para la programación asíncrona. Tu controlador de intents puede mostrar una promesa que se resuelve cuando tu webhook de entrega termina de generar una respuesta.

En el siguiente fragmento, se muestra cómo puedes realizar una llamada a una función asíncrona para mostrar un objeto de promesa y, luego, responder con un mensaje si tu webhook de entrega recibe el intent "saludo". En este fragmento, la promesa garantiza que tu webhook de entrega muestre una respuesta conversacional solo después de que se haya resuelto la promesa para la llamada a la API externa.

En este ejemplo, usamos una API falsa para obtener los datos meteorológicos.

/**
 * Make an external API call to get weather data.
 * @return {Promise<string>}
 */
const forecast = () => {
  // ...
};

app.intent('Default Welcome Intent', (conv) => {
  return forecast().then((weather) => {
    conv.ask('How are you?');
    conv.ask(`Today's weather is ${weather}.`);
  });
});

El siguiente fragmento de código optimizado tiene el mismo efecto, pero usa la función async await que se introdujo en ECMA 2017 (versión 8 de Node.js). Si quieres usar este código con Cloud Functions para Firebase, asegúrate de usar la versión correcta de las herramientas de Firebase y de configurar el servicio correctamente.

app.intent('Default Welcome Intent', async (conv) => {
  const weather = await forecast();
  conv.ask('How are you?');
  conv.ask(`Today's weather is ${weather}.`);
});

Nota: Cuando se usa Cloud Functions para Firebase, las variables globales se pueden almacenar en caché entre ejecuciones de funciones. Para obtener más información, lee sobre la vida útil de instancia de función en la documentación de Google Cloud.

Almacena datos de conversaciones

La biblioteca cliente permite que tu webhook de entrega guarde datos en conversaciones para su uso futuro. Los objetos clave que puedes usar para el almacenamiento de datos son los siguientes:

• DialogflowConversation#data o ActionsSdkConversation#data: guarda los datos en formato JSON durante la duración de una sola sesión de conversación entre el usuario y tu acción.
• Conversation#user.storage: guarda los datos en formato JSON en varias sesiones de conversación.

En el siguiente fragmento, se muestra cómo el webhook de entrega puede almacenar datos en una propiedad arbitraria que definiste (someProperty) y adjuntar al objeto Conversation#user.storage. Para ver un ejemplo más completo, consulta la documentación de referencia de la clase Conversation#user.storage.

app.intent('Default Welcome Intent', (conv) => {
  conv.user.storage.someProperty = 'someValue';
  conv.ask('...');
});

Puedes usar el objeto Conversation#user para obtener información sobre el usuario, como un identificador de string y datos personales. Algunos campos, como conv.user.name.display y conv.user.email, requieren que se solicite conv.ask(new Permission) para NAME y conv.ask(new SignIn) para el Acceso con Google, respectivamente.

const {Permission} = require('actions-on-google');
app.intent('Default Welcome Intent', (conv) => {
  if (conv.user.last.seen) {
    conv.ask('Welcome back! How are you?');
  } else {
    conv.ask('Nice to meet you! How are you doing?');
  }
});

app.intent('permission', (conv) => {
  conv.ask(new Permission({
    context: 'To greet you personally',
    permissions: 'NAME',
  }));
});

// Create Dialogflow intent with `actions_intent_PERMISSION` event
app.intent('get_permission', (conv, input, granted) => {
  if (granted) {
    conv.close(`Hi ${conv.user.name.display}!`);
  } else {
    // User did not grant permission
    conv.close(`Hello!`);
  }
});

Escalamiento con middleware

Puedes extender la biblioteca cliente a través de middleware.

La capa middleware consiste en una o más funciones que defines, que la biblioteca cliente ejecuta automáticamente antes de llamar al controlador del intent. Usar una capa de middleware te permite modificar la instancia de Conversation y agregar funciones adicionales.

Los servicios del SDK de Dialogflow y Actions exponen una función app.middleware() que te permite agregar propiedades o clases de ayuda a la instancia Conversation.

En el siguiente fragmento, se muestra un ejemplo de cómo puedes usar middleware:

class Helper {
  constructor(conv) {
    this.conv = conv;
  }

  func1() {
    this.conv.ask(`What's up?`);
  }
}

app.middleware((conv) => {
  conv.helper = new Helper(conv);
});

app.intent('Default Welcome Intent', (conv) => {
  conv.helper.func1();
});

Exporte su aplicación

Si deseas exponer tu webhook de entrega para un framework web o una plataforma de procesamiento sin servidores, debes exportar el objeto app como un webhook de acceso público. La biblioteca cliente admite la implementación en varios entornos listos para usar.

En los siguientes fragmentos, se muestra cómo exportar app en diferentes entornos de ejecución:

Ejemplo: Cloud Functions para Firebase

const functions = require('firebase-functions');
// ... app code here
exports.fulfillment = functions.https.onRequest(app);

Ejemplo: editor intercalado de Dialogflow

const functions = require('firebase-functions');

// ... app code here

// Exported function name must be 'dialogflowFirebaseFulfillment'
exports.dialogflowFirebaseFulfillment = functions.https.onRequest(app);

Ejemplo: Servidor Express autoalojado (simple)

const express = require('express');
const bodyParser = require('body-parser');  

// ... app code here

express().use(bodyParser.json(), app).listen(3000);

Ejemplo: Servidor Express autoalojado (varias rutas)

const express = require('express');
const bodyParser = require('body-parser');

// ... app code here

const expressApp = express().use(bodyParser.json());

expressApp.post('/fulfillment', app);

expressApp.listen(3000);

Ejemplo: Puerta de enlace de API de AWS Lambda

// ... app code here

exports.fulfillment = app;