Comprender la entrega a través de la integración de Dialogflow con el Calendario

1. Antes de comenzar

En este codelab, aprenderás cómo Dialogflow se conecta con sistemas de backend para proporcionar respuestas enriquecidas y dinámicas a las preguntas.

Requisitos previos

Antes de continuar, debes completar los siguientes codelabs:

1. Crea un programador de citas con Dialogflow
2. Integra Dialogflow con Actions on Google
3. Comprende las entidades en Dialogflow

También debes comprender los conceptos y constructos básicos de Dialogflow, que puedes deducir de los siguientes videos que se encuentran en la ruta de aprendizaje Crea un chatbot con Dialogflow.

Qué aprenderás

• Qué es la entrega
• Cómo configurar una cuenta de servicio para el Calendario
• Cómo configurar el Calendario
• Cómo habilitar la entrega en Dialogflow
• Cómo probar las entregas

Qué compilarás

• Entrega con Cloud Functions
• Una integración entre Dialogflow y Calendario

Requisitos

• Un navegador web y una dirección de correo electrónico para acceder a la consola de Dialogflow
• Una Cuenta de Google para acceder al Calendario

2. ¿Qué es la entrega?

La entrega es código que se implementa como un webhook, que le permite a tu agente de Dialogflow llamar a lógicas empresariales para cada intent. Durante una conversación, la entrega te permite usar la información extraída por el procesamiento de lenguaje natural de Dialogflow para generar respuestas dinámicas o activar acciones en tu backend. La mayoría de los agentes de Dialogflow usan entregas.

Los siguientes son algunos ejemplos de cuándo puedes usar las entregas para extender un agente:

• Generar respuestas dinámicas basadas en información buscada en una base de datos
• Para realizar pedidos basados en productos que solicitó un cliente
• Para implementar las reglas y condiciones de victoria en un juego

3. Habilitar la API de Calendar

1. En la consola de Dialogflow, haz clic en .
2. En la pestaña General, desplázate hasta ID del proyecto y, luego, haz clic en Google Cloud .

3. En la consola de Google Cloud, haz clic en el menú de navegación ⁕ > APIs y Servicios > Biblioteca.
4. Busca "API del Calendario de Google" Luego, haz clic en Habilitar para usar la API en tu proyecto de Google Cloud.

4. Configura la cuenta de servicio

1. Haz clic en Menú de navegación ⁕ > APIs y Servicios > Credenciales.
2. Haz clic en Crear credenciales > Cuenta de servicio.

3. En los Detalles de la cuenta de servicio, ingresa "appointment-scheduler". como el Nombre de la cuenta de servicio y, luego, haz clic en Crear.

4. Donde dice Otorga a esta cuenta de servicio acceso al proyecto, haz clic en Continuar para omitirlo.
5. Donde dice Otorgar a los usuarios acceso a esta cuenta de servicio (opcional), haz clic en Crear clave, selecciona JSON y haz clic en Crear.

Se descargará en tu computadora un archivo JSON que necesitarás en las siguientes secciones de configuración.

5. Configuración del Calendario

1. Navega a Calendario y, luego, haz clic en el Menú principal syslog > Agrega otros calendarios > Crear calendario nuevo.

2. Ingresa “Calendario de citas” como el nombre del calendario y haz clic en Crear calendario.
3. Vuelve a cargar la página, haz clic en Calendario de citas, desplázate hasta Compartir con personas específicas y haz clic en Agregar personas.
4. Copia el client_email del archivo JSON que descargaste como parte de la configuración de la cuenta de servicio y pégalo en el diálogo.

5. Haz clic en la lista desplegable Permisos y, luego, en Realizar cambios en los eventos > Enviar.

6. En Configuración, desplázate hasta Integrar calendario y copia el ID del calendario.

Nota: Si ves problemas con los permisos o la opción Realizar cambios en el evento está inhabilitada, cambia el permiso de calendario secundario en la Consola del administrador.

6. Configura la entrega en Dialogflow

Agrega la cuenta de servicio y el ID de calendario a la entrega

1. Navega al agente de Dialogflow AppointmentScheduler y haz clic en Fulfillment.
2. Habilita el Editor intercalado.

3. Actualiza el archivo index.js con el siguiente código:

'use strict';

// Import the Dialogflow module from Google client libraries.
const functions = require('firebase-functions');
const {google} = require('googleapis');
const {WebhookClient} = require('dialogflow-fulfillment');

// Enter your calendar ID below and service account JSON below
const calendarId = "<INSERT YOUR CALENDAR ID>";
const serviceAccount = {<INSERT CONTENTS OF YOUr JSON FILE HERE>}; // Starts with {"type": "service_account",...

// Set up Google Calendar Service account credentials
const serviceAccountAuth = new google.auth.JWT({
 email: serviceAccount.client_email,
 key: serviceAccount.private_key,
 scopes: 'https://www.googleapis.com/auth/calendar'
});

const calendar = google.calendar('v3');
process.env.DEBUG = 'dialogflow:*'; // enables lib debugging statements

const timeZone = 'America/Los_Angeles';
const timeZoneOffset = '-07:00';

// Set the DialogflowApp object to handle the HTTPS POST request.
exports.dialogflowFirebaseFulfillment = functions.https.onRequest((request, response) => {
 const agent = new WebhookClient({ request, response });
 console.log("Parameters", agent.parameters);
 const appointment_type = agent.parameters.appointment_type;
 function makeAppointment (agent) {
   // Calculate appointment start and end datetimes (end = +1hr from start)
   const dateTimeStart = new Date(Date.parse(agent.parameters.date.split('T')[0] + 'T' + agent.parameters.time.split('T')[1].split('-')[0] + timeZoneOffset));
   const dateTimeEnd = new Date(new Date(dateTimeStart).setHours(dateTimeStart.getHours() + 1));
   const appointmentTimeString = dateTimeStart.toLocaleString(
     'en-US',
     { month: 'long', day: 'numeric', hour: 'numeric', timeZone: timeZone }
   );
    // Check the availability of the time, and make an appointment if there is time on the calendar
   return createCalendarEvent(dateTimeStart, dateTimeEnd, appointment_type).then(() => {
     agent.add(`Ok, let me see if we can fit you in. ${appointmentTimeString} is fine!.`);
   }).catch(() => {
     agent.add(`I'm sorry, there are no slots available for ${appointmentTimeString}.`);
   });
 }

// Handle the Dialogflow intent named 'Schedule Appointment'.
 let intentMap = new Map();
 intentMap.set('Schedule Appointment', makeAppointment);
 agent.handleRequest(intentMap);
});

//Creates calendar event in Google Calendar
function createCalendarEvent (dateTimeStart, dateTimeEnd, appointment_type) {
 return new Promise((resolve, reject) => {
   calendar.events.list({
     auth: serviceAccountAuth, // List events for time period
     calendarId: calendarId,
     timeMin: dateTimeStart.toISOString(),
     timeMax: dateTimeEnd.toISOString()
   }, (err, calendarResponse) => {
     // Check if there is a event already on the Calendar
     if (err || calendarResponse.data.items.length > 0) {
       reject(err || new Error('Requested time conflicts with another appointment'));
     } else {
       // Create event for the requested time period
       calendar.events.insert({ auth: serviceAccountAuth,
         calendarId: calendarId,
         resource: {summary: appointment_type +' Appointment', description: appointment_type,
           start: {dateTime: dateTimeStart},
           end: {dateTime: dateTimeEnd}}
       }, (err, event) => {
         err ? reject(err) : resolve(event);
       }
       );
     }
   });
 });
}

4. Reemplaza <INSERT YOUR CALENDAR ID> por el ID del calendario que copiaste en la sección anterior.
5. Reemplaza <INSERT CONTENTS OF YOUR JSON FILE HERE> por el contenido de tu archivo JSON.
6. (Opcional) Cambia const timeZone y const timeZoneOffset según la zona horaria del Calendario de citas.
7. Haz clic en Implementar.

Nota: Si adaptaste tu entrega en Dialogflow a tu zona horaria, debes modificarla nuevamente a la hora universal coordinada para que funcione con el frontend.

Habilita la respuesta de entrega

1. Navega a la consola de Dialogflow y haz clic en Intents.
2. Haz clic en Schedule Appointment Intent.
3. Desplázate hacia abajo hasta Fulfillment (Entrega) y activa Enable webhook call for the intent (Habilitar llamadas de webhook para el intent).

4. Haz clic en Guardar.
5. Haz clic en Implementar.

7. Probar el chatbot

Puedes probar tu chatbot en el simulador de Actions o usar la integración web o de Google Home que aprendiste anteriormente.

1. Usuario: "Establece una cita para el registro de vehículo a las 2 p.m. mañana".
2. Chatbot: "De acuerdo, déjame ver si podemos ayudarte. El 24 de abril a las 2 p.m. está bien".

3. El Calendario reserva la respuesta.

8. Limpia

Si planeas completar otros codelabs de Dialogflow, omite esta sección por ahora y vuelve a ella más tarde.

Borra el agente de Dialogflow

1. Haz clic en junto a tu agente existente.

2. En la pestaña General, desplázate hasta la parte inferior y haz clic en Delete This Agent.
3. Escribe Borrar en el diálogo y haz clic en Borrar.

9. Felicitaciones

Creaste un chatbot en Dialogflow y lo integraste con el Calendario. Ya eres un desarrollador de chatbots.

Más información

Para obtener más información, consulta las muestras de código en la página de Dialogflow GitHub.