Agrega automatización con Dialogflow

Elige si quieres administrar agentes con Business Communications Desarrollador Consola o API.

Consola para desarrolladores API .

Obsoleto: Se desactivaron dialogflowAssociation y las APIs relacionadas el 26 de septiembre de 2022.

Dialogflow es una forma de comprensión del lenguaje (CLN) que procesa las entradas del usuario, las asigna y responde con las respuestas adecuadas. Hay dos ediciones de Dialogflow. Mediante la integración de tu agente de Business Messages con Dialogflow ES, puedes crear con facilidad automatización simple para poner en marcha el desarrollo de tus agentes. De integrar en Dialogflow CX, puedes crear automatización avanzada para más para mantener conversaciones complejas.

Los agentes de Business Messages admiten integraciones directas con

• Dialogflow ES: coincidencia de intents y bots de preguntas frecuentes
• Dialogflow CX: coincidencia de intents y transferencia de agentes humanos

Para integrar un agente de Business Messages con otras funciones de Dialogflow ES o Dialogflow CX, consulta la documentación de cada producto.

Cuando un usuario envía un mensaje a un agente que tiene una integración en Dialogflow, Business Messages pasa el mensaje del usuario a Dialogflow y envía el de Dialogflow respuesta al agente en la sección Objeto dialogflowResponse. Puedes configurar agentes para envía automáticamente la respuesta de Dialogflow al usuario sin que se realice ninguna acción en tu de una parte del proyecto. Consulta Respuestas automáticas. para conocer los detalles.

Integración en Dialogflow

Antes de poder aprovechar la automatización basada en Dialogflow a través de Business Messages, debes habilitar la integración en Dialogflow.

Requisitos previos

Para comenzar, necesitas

• a Business Messages agente
• un agente de Dialogflow en la región Global con un idioma raíz de inglés (inglés)

Si no tienes un agente de Dialogflow, crea uno.

Dialogflow ES

Antes de que puedas habilitar la integración en Dialogflow ES, necesitas tu ID del proyecto del agente de Dialogflow. Para ubicar el ID del proyecto,

1. Navega a la Consola de Dialogflow.
2. Selecciona el agente de Dialogflow que deseas conectar a Business Messages. y, luego, haz clic en el ícono de ajustes junto al nombre del agente.
3. En Proyecto de Google, anota el valor del ID del proyecto.

Dialogflow CX

Antes de que puedas habilitar la integración de Dialogflow CX, necesitas tu ID de proyecto y de agente del agente de Dialogflow. Para ubicar estos ID,

1. Navega a la consola de Dialogflow CX.
2. Selecciona tu proyecto de Dialogflow.
3. En el selector de agentes, haz clic en el menú ampliado. junto a tu agente de Dialogflow.
4. Haz clic en Copy name. Esto copia el nombre completo de tu agente en la con el siguiente formato: projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID
5. Anota los valores del ID del proyecto y del ID del agente.

Crea la integración

1. Obtén el correo electrónico de la cuenta de servicio de Dialogflow del socio de dialogflowServiceAccountEmail Reemplazar PARTNER_ID por tu ID de socio

   cURL

   
   # This code gets the partner.
   # Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/partners/get
   
   # Replace the __PARTNER_ID__
   # Make sure a service account key file exists at ./service_account_key.json
   
   curl -X GET \
   "https://businesscommunications.googleapis.com/v1/partners/__PARTNER_ID__" \
   -H "Content-Type: application/json" \
   -H "User-Agent: curl/business-communications" \
   -H "$(oauth2l header --json ./service_account_key.json businesscommunications)"
   get-partner.sh
   

   Node.js

   
   /**
    * This code snippet gets a partner.
    * Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/partners/get
    *
    * This code is based on the https://github.com/google-business-communications/nodejs-businesscommunications Node.js
    * Business Communications client library.
    */
   
   /**
    * Edit the values below:
    */
    const PARTNER_ID = 'EDIT_HERE';
    const PATH_TO_SERVICE_ACCOUNT_KEY = './service_account_key.json';
   
    const businesscommunications = require('businesscommunications');
    const {google} = require('googleapis');
   
    // Initialize the Business Communications API
    const bcApi = new businesscommunications.businesscommunications_v1.Businesscommunications({});
   
    // Set the scope that we need for the Business Communications API
    const scopes = [
      'https://www.googleapis.com/auth/businesscommunications',
    ];
   
    // Set the private key to the service account file
    const privatekey = require(PATH_TO_SERVICE_ACCOUNT_KEY);
   
    async function main() {
      const authClient = await initCredentials();
   
      const partnerName = 'partners/' + PARTNER_ID;
   
      if (authClient) {
        // Setup the parameters for the API call
        const apiParams = {
          auth: authClient,
          name: partnerName,
        };
   
        bcApi.partners.get(apiParams, {}, (err, response) => {
          if (err !== undefined && err !== null) {
            console.dir(err);
          } else {
            // Agent found
            console.log(response.data);
          }
        });
      }
      else {
        console.log('Authentication failure.');
      }
    }
   
    /**
     * Initializes the Google credentials for calling the
     * Business Messages API.
     */
     async function initCredentials() {
      // Configure a JWT auth client
      const authClient = new google.auth.JWT(
        privatekey.client_email,
        null,
        privatekey.private_key,
        scopes,
      );
   
      return new Promise(function(resolve, reject) {
        // Authenticate request
        authClient.authorize(function(err, tokens) {
          if (err) {
            reject(false);
          } else {
            resolve(authClient);
          }
        });
      });
    }
   
    main();
   get-partner.js
   

   Python

   
   """This code gets a partner.
   
   Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/partners/get
   
   This code is based on the https://github.com/google-business-communications/python-businessmessages
   Python Business Messages client library.
   """
   
   from oauth2client.service_account import ServiceAccountCredentials
   from businesscommunications.businesscommunications_v1_client import BusinesscommunicationsV1
   from businesscommunications.businesscommunications_v1_messages import (
       Agent,
       BusinesscommunicationsPartnersGetRequest,
   )
   
   # Edit the values below:
   PARTNER_ID = 'EDIT_HERE'
   SCOPES = ['https://www.googleapis.com/auth/businesscommunications']
   SERVICE_ACCOUNT_FILE = './service_account_key.json'
   
   credentials = ServiceAccountCredentials.from_json_keyfile_name(
       SERVICE_ACCOUNT_FILE, scopes=SCOPES)
   
   client = BusinesscommunicationsV1(credentials=credentials)
   
   partners_service = BusinesscommunicationsV1.PartnersService(client)
   
   partner_name = 'partners/' + PARTNER_ID
   
   partner = partners_service.Get(BusinesscommunicationsPartnersGetRequest(
           name=partner_name
       ))
   
   print(partner)
   get-partner.py
   

2. Copia el correo electrónico de la cuenta de servicio. Esta cuenta conecta tus Business Messages y Dialogflow.

3. En la pestaña Google Cloud Consola, selecciona tu proyecto de Dialogflow.

4. Navega a IAM. permisos.

5. Haz clic en Agregar y, luego, ingresa el correo electrónico de la cuenta de servicio para Miembros nuevos.

6. En Selecciona un rol, elige Editor del agente en la consola de Dialogflow.

7. Haz clic en Agregar otro rol y selecciona Cliente de la API de Dialogflow.

8. Haz clic en Guardar.

9. Integrar tu proyecto de Dialogflow a tu agente de Business Messages

   Reemplaza AUTO_RESPONSE_STATUS por HABILITADO o INHABILITADO, según sobre si quieres o no que Business Messages responda automáticamente usuarios con respuestas de Dialogflow.

   Dialogflow ES

   cURL

   
   # This code creates a Dialogflow ES integration.
   # Read more: https://developers.google.com/business-communications/business-messages/guides/how-to/integrate/dialogflow?method=api#dialogflow_es
   
   # Replace the __BRAND_ID__, __AGENT_ID__, __DIALOGFLOW_ES_PROJECT_ID__ and __AUTO_RESPONSE_STATUS__
   # Make sure a service account key file exists at ./service_account_key.json
   
   curl -X POST \
   "https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/agents/__AGENT_ID__/integrations" \
   -H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
   -H "Content-Type: application/json"  \
   -H "User-Agent: curl/business-communications" \
   -d '{
      "dialogflowEsIntegration": {
        "dialogflowProjectId": "__DIALOGFLOW_ES_PROJECT_ID__",
        "autoResponseStatus": "__AUTO_RESPONSE_STATUS__"
      }
   }'
   create-integration-dialogflow-es.sh
   

   Node.js

   
   /**
    * This code snippet creates a Dialogflow ES integration.
    * Read more: https://developers.google.com/business-communications/business-messages/guides/how-to/integrate/dialogflow?method=api#dialogflow_es
    *
    * This code is based on the https://github.com/google-business-communications/nodejs-businesscommunications Node.js
    * Business Communications client library.
    */
   
   /**
    * Edit the values below:
    */
    const BRAND_ID = 'EDIT_HERE';
    const AGENT_ID = 'EDIT_HERE';
    const DIALOGFLOW_ES_PROJECT_ID = 'EDIT_HERE'
    const PATH_TO_SERVICE_ACCOUNT_KEY = './service_account_key.json';
   
    const businesscommunications = require('businesscommunications');
    const {google} = require('googleapis');
    const uuidv4 = require('uuid').v4;
   
    // Initialize the Business Communications API
    const bcApi = new businesscommunications.businesscommunications_v1.Businesscommunications({});
   
    // Set the scope that we need for the Business Communications API
    const scopes = [
      'https://www.googleapis.com/auth/businesscommunications',
    ];
   
    // Set the private key to the service account file
    const privatekey = require(PATH_TO_SERVICE_ACCOUNT_KEY);
   
    async function main() {
      const authClient = await initCredentials();
      const agentName = 'brands/' + BRAND_ID + '/agents/' + AGENT_ID;
   
      if (authClient) {
        const integrationObject = {
          dialogflowEsIntegration: {
            dialogflowProjectId: DIALOGFLOW_ES_PROJECT_ID,
            autoResponseStatus: 'ENABLED'
          }
        };
   
        // Setup the parameters for the API call
        const apiParams = {
          auth: authClient,
          parent: agentName,
          resource: integrationObject
        };
   
        bcApi.brands.agents.integrations.create(apiParams, {}, (err, response) => {
          if (err !== undefined && err !== null) {
            console.dir(err);
          } else {
            // Agent created
            console.log(response.data);
          }
        });
      }
      else {
        console.log('Authentication failure.');
      }
    }
   
    /**
     * Initializes the Google credentials for calling the
     * Business Messages API.
     */
     async function initCredentials() {
      // Configure a JWT auth client
      const authClient = new google.auth.JWT(
        privatekey.client_email,
        null,
        privatekey.private_key,
        scopes,
      );
   
      return new Promise(function(resolve, reject) {
        // Authenticate request
        authClient.authorize(function(err, tokens) {
          if (err) {
            reject(false);
          } else {
            resolve(authClient);
          }
        });
      });
    }
   
    main();
   create-integration-dialogflow-es.js
   

   Python

   
   """This code snippet creates a Dialogflow ES integration.
   
   Read more: https://developers.google.com/business-communications/business-messages/guides/how-to/integrate/dialogflow?method=api#dialogflow_es
   
   This code is based on the https://github.com/google-business-communications/python-businessmessages
   Python Business Messages client library.
   """
   
   from oauth2client.service_account import ServiceAccountCredentials
   from businesscommunications.businesscommunications_v1_client import BusinesscommunicationsV1
   from businesscommunications.businesscommunications_v1_messages import (
       BusinesscommunicationsBrandsAgentsIntegrationsCreateRequest,
       DialogflowEsIntegration
   )
   
   # Edit the values below:
   BRAND_ID = 'EDIT_HERE'
   AGENT_ID = 'EDIT_HERE'
   DIALOGFLOW_ES_PROJECT_ID = 'EDIT_HERE'
   SCOPES = ['https://www.googleapis.com/auth/businesscommunications']
   SERVICE_ACCOUNT_FILE = './service_account_key.json'
   
   credentials = ServiceAccountCredentials.from_json_keyfile_name(
       SERVICE_ACCOUNT_FILE, scopes=SCOPES)
   
   client = BusinesscommunicationsV1(credentials=credentials)
   
   integrations_service = BusinesscommunicationsV1.BrandsAgentsIntegrationsService(client)
   
   agent_name = 'brands/' + BRAND_ID + '/agents/' + AGENT_ID
   
   integration = integrations_service.Create(BusinesscommunicationsBrandsAgentsIntegrationsCreateRequest(
     integration=DialogflowEsIntegration(
       autoResponseStatus=DialogflowEsIntegration.AutoResponseStatusValueValuesEnum.ENABLED,
       dialogflowProjectId=DIALOGFLOW_ES_PROJECT_ID
     ),
     parent=agent_name
   ))
   
   print(integration)
   create-integration-dialogflow-es.py
   

   Dialogflow CX

   cURL

   
   # This code creates a Dialogflow CX integration.
   # Read more: https://developers.google.com/business-communications/business-messages/guides/how-to/integrate/dialogflow?method=api#dialogflow_cx
   
   # Replace the __BRAND_ID__, __AGENT_ID__, __DIALOGFLOW_CX_PROJECT_ID__, __DIALOGFLOW_CX_AGENT_ID__ and __AUTO_RESPONSE_STATUS__
   # Make sure a service account key file exists at ./service_account_key.json
   
   curl -X POST \
   "https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/agents/__AGENT_ID__/integrations" \
   -H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
   -H "Content-Type: application/json"  \
   -H "User-Agent: curl/business-communications" \
   -d '{
      "dialogflowCxIntegration": {
        "dialogflowProjectId": "__DIALOGFLOW_CX_PROJECT_ID__",
        "dialogflowAgentId": "__DIALOGFLOW_CX_AGENT_ID__",
        "autoResponseStatus": "__AUTO_RESPONSE_STATUS__"
      }
   }'
   create-integration-dialogflow-cx.sh
   

   Node.js

   
   /**
    * This code snippet creates a Dialogflow CX integration.
    * Read more: https://developers.google.com/business-communications/business-messages/guides/how-to/integrate/dialogflow?method=api#dialogflow_cx
    *
    * This code is based on the https://github.com/google-business-communications/nodejs-businesscommunications Node.js
    * Business Communications client library.
    */
   
   /**
    * Edit the values below:
    */
   const BRAND_ID = 'EDIT_HERE';
   const AGENT_ID = 'EDIT_HERE';
   const DIALOGFLOW_CX_AGENT_ID = 'EDIT_HERE'
   const DIALOGFLOW_CX_PROJECT_ID = 'EDIT_HERE'
   const PATH_TO_SERVICE_ACCOUNT_KEY = './service_account_key.json';
   
   const businesscommunications = require('businesscommunications');
   const {google} = require('googleapis');
   const uuidv4 = require('uuid').v4;
   
   // Initialize the Business Communications API
   const bcApi = new businesscommunications.businesscommunications_v1.Businesscommunications({});
   
   // Set the scope that we need for the Business Communications API
   const scopes = [
     'https://www.googleapis.com/auth/businesscommunications',
   ];
   
   // Set the private key to the service account file
   const privatekey = require(PATH_TO_SERVICE_ACCOUNT_KEY);
   
   async function main() {
     const authClient = await initCredentials();
     const agentName = 'brands/' + BRAND_ID + '/agents/' + AGENT_ID;
   
     if (authClient) {
       const integrationObject = {
         dialogflowCxIntegration: {
           dialogflowProjectId: DIALOGFLOW_CX_PROJECT_ID,
           dialogflowAgentId: DIALOGFLOW_CX_AGENT_ID,
           autoResponseStatus: 'ENABLED'
         }
       };
   
       // Setup the parameters for the API call
       const apiParams = {
         auth: authClient,
         parent: agentName,
         resource: integrationObject
       };
   
       bcApi.brands.agents.integrations.create(apiParams, {}, (err, response) => {
         if (err !== undefined && err !== null) {
           console.dir(err);
         } else {
           // Agent created
           console.log(response.data);
         }
       });
     }
     else {
       console.log('Authentication failure.');
     }
   }
   
   /**
    * Initializes the Google credentials for calling the
    * Business Messages API.
    */
    async function initCredentials() {
     // Configure a JWT auth client
     const authClient = new google.auth.JWT(
       privatekey.client_email,
       null,
       privatekey.private_key,
       scopes,
     );
   
     return new Promise(function(resolve, reject) {
       // Authenticate request
       authClient.authorize(function(err, tokens) {
         if (err) {
           reject(false);
         } else {
           resolve(authClient);
         }
       });
     });
   }
   
   main();
   create-integration-dialogflow-cx.js
   

   Python

   
   """This code snippet creates a Dialogflow CX integration.
   
   Read more: https://developers.google.com/business-communications/business-messages/guides/how-to/integrate/dialogflow?method=api#dialogflow_cx
   
   This code is based on the https://github.com/google-business-communications/python-businessmessages
   Python Business Messages client library.
   """
   
   from oauth2client.service_account import ServiceAccountCredentials
   from businesscommunications.businesscommunications_v1_client import BusinesscommunicationsV1
   from businesscommunications.businesscommunications_v1_messages import (
       BusinesscommunicationsBrandsAgentsIntegrationsCreateRequest,
       DialogflowCxIntegration
   )
   
   # Edit the values below:
   BRAND_ID = 'EDIT_HERE'
   AGENT_ID = 'EDIT_HERE'
   DIALOGFLOW_CX_AGENT_ID = 'EDIT_HERE'
   DIALOGFLOW_CX_PROJECT_ID = 'EDIT_HERE'
   SCOPES = ['https://www.googleapis.com/auth/businesscommunications']
   SERVICE_ACCOUNT_FILE = './service_account_key.json'
   
   credentials = ServiceAccountCredentials.from_json_keyfile_name(
       SERVICE_ACCOUNT_FILE, scopes=SCOPES)
   
   client = BusinesscommunicationsV1(credentials=credentials)
   
   integrations_service = BusinesscommunicationsV1.BrandsAgentsIntegrationsService(client)
   
   agent_name = 'brands/' + BRAND_ID + '/agents/' + AGENT_ID
   
   integration = integrations_service.Create(BusinesscommunicationsBrandsAgentsIntegrationsCreateRequest(
     integration=DialogflowCxIntegration(
       autoResponseStatus=DialogflowCxIntegration.AutoResponseStatusValueValuesEnum.ENABLED,
       dialogflowAgentId=DIALOGFLOW_CX_AGENT_ID,
       dialogflowProjectId=DIALOGFLOW_CX_PROJECT_ID
     ),
     parent=agent_name
   ))
   
   print(integration)
   create-integration-dialogflow-cx.py
   

   Para ver las opciones de formato y valor, consulta Integration

La conexión de Business Messages y Dialogflow tardará aproximadamente dos minutos. Para verificar el estado de la integración, obtener el OperationInfo

Actualiza la integración

Para actualizar la configuración de la respuesta automática de tu agente, ejecuta el siguiente comando. Reemplaza AUTO_RESPONSE_STATUS por HABILITADO o INHABILITADA dependiendo de si deseas o no que Business Messages se envíe automáticamente responder a los usuarios con respuestas de Dialogflow.

Dialogflow ES

cURL

# This code updates the Dialogflow association.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/brands.agents/updateDialogflowAssociation

# Replace the __BRAND_ID__ and __AGENT_ID__
# Make sure a service account key file exists at ./service_account_key.json

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/agents/__AGENT_ID__/dialogflowAssociation?updateMask=enableAutoResponse" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "enableAutoResponse": true
}'
update-dialogflow-association.sh

Dialogflow CX

cURL

# This code updates the Dialogflow association.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/brands.agents/updateDialogflowAssociation

# Replace the __BRAND_ID__ and __AGENT_ID__
# Make sure a service account key file exists at ./service_account_key.json

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/agents/__AGENT_ID__/dialogflowAssociation?updateMask=enableAutoResponse" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "enableAutoResponse": true
}'
update-dialogflow-association.sh

Para ver las opciones de formato y valor, consulta Integration

Cambia entre las ediciones de Dialogflow

Un agente de Business Messages solo puede admitir una integración de Dialogflow a la vez. Para cambiar de una edición de Dialogflow a otra, debes quitar las la integración actual antes de crear la nueva.

Precaución: Desde el momento en que quitas una integración hasta que creas otra, Dialogflow no puede procesar mensajes de tu agente de Business Messages. Si el El agente no puede responder durante este período, puedes ajustar la disponibilidad del agente. para tener en cuenta cualquier tiempo de inactividad.

Borra la integración

Si necesitas quitar Dialogflow de tu agente de Business Messages, borra el integración con el siguiente comando.

cURL

# This code deletes an integration.
# Read more: https://developers.google.com/business-communications/business-messages/guides/how-to/integrate/dialogflow?method=api#delete_the_integration

# Replace the __BRAND_ID__, __AGENT_ID__ and __INTEGRATION_ID__
# Make sure a service account key file exists at ./service_account_key.json

curl -X DELETE \
"https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/agents/__AGENT_ID__/integrations/__INTEGRATION_ID__" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)"
delete-integration.sh

Node.js

/**
 * This code snippet deletes an integration.
 * Read more: https://developers.google.com/business-communications/business-messages/guides/how-to/integrate/dialogflow?method=api#delete_the_integration
 *
 * This code is based on the https://github.com/google-business-communications/nodejs-businesscommunications Node.js
 * Business Communications client library.
 */

/**
 * Edit the values below:
 */
 const BRAND_ID = 'EDIT_HERE';
 const AGENT_ID = 'EDIT_HERE';
 const INTEGRATION_ID = 'EDIT_HERE';
 const PATH_TO_SERVICE_ACCOUNT_KEY = './service_account_key.json';

 const businesscommunications = require('businesscommunications');
 const {google} = require('googleapis');
 const uuidv4 = require('uuid').v4;

 // Initialize the Business Communications API
 const bcApi = new businesscommunications.businesscommunications_v1.Businesscommunications({});

 // Set the scope that we need for the Business Communications API
 const scopes = [
   'https://www.googleapis.com/auth/businesscommunications',
 ];

 // Set the private key to the service account file
 const privatekey = require(PATH_TO_SERVICE_ACCOUNT_KEY);

 async function main() {
   const authClient = await initCredentials();
   const integrationName = 'brands/' + BRAND_ID + '/agents/' + AGENT_ID + '/integrations/' + INTEGRATION_ID;

   if (authClient) {
     // Setup the parameters for the API call
     const apiParams = {
       auth: authClient,
       name: integrationName,
     };

     bcApi.brands.agents.integrations.delete(apiParams, {}, (err, response) => {
       if (err !== undefined && err !== null) {
         console.dir(err);
       } else {
         // Agent created
         console.log(response.data);
       }
     });
   }
   else {
     console.log('Authentication failure.');
   }
 }

 /**
  * Initializes the Google credentials for calling the
  * Business Messages API.
  */
  async function initCredentials() {
   // Configure a JWT auth client
   const authClient = new google.auth.JWT(
     privatekey.client_email,
     null,
     privatekey.private_key,
     scopes,
   );

   return new Promise(function(resolve, reject) {
     // Authenticate request
     authClient.authorize(function(err, tokens) {
       if (err) {
         reject(false);
       } else {
         resolve(authClient);
       }
     });
   });
 }

 main();
delete-integration.js

Python

"""This code snippet deletes an integration.

Read more: https://developers.google.com/business-communications/business-messages/guides/how-to/integrate/dialogflow?method=api#delete_the_integration

This code is based on the https://github.com/google-business-communications/python-businessmessages
Python Business Messages client library.
"""

from oauth2client.service_account import ServiceAccountCredentials
from businesscommunications.businesscommunications_v1_client import BusinesscommunicationsV1
from businesscommunications.businesscommunications_v1_messages import (
    BusinesscommunicationsBrandsAgentsIntegrationsDeleteRequest
)

# Edit the values below:
BRAND_ID = 'EDIT_HERE'
AGENT_ID = 'EDIT_HERE'
INTEGRATION_ID = 'EDIT_HERE'
SCOPES = ['https://www.googleapis.com/auth/businesscommunications']
SERVICE_ACCOUNT_FILE = './service_account_key.json'

credentials = ServiceAccountCredentials.from_json_keyfile_name(
    SERVICE_ACCOUNT_FILE, scopes=SCOPES)

client = BusinesscommunicationsV1(credentials=credentials)

integrations_service = BusinesscommunicationsV1.BrandsAgentsIntegrationsService(client)

integration_name = 'brands/' + BRAND_ID + '/agents/' + AGENT_ID + '/integrations/' + INTEGRATION_ID

integration = integrations_service.Delete(BusinesscommunicationsBrandsAgentsIntegrationsDeleteRequest(
  name=integration_name
))

print(integration)
delete-integration.py

Para ver las opciones de formato y valor, consulta Integration

Obtén información de integración

Para obtener información sobre una integración, puedes usar Business Communications API, siempre que tengas el valor name de la integración.

Obtén información sobre una sola integración

Para obtener información sobre la integración, ejecuta el siguiente comando.

Nota: Los nombres y los ID de los agentes deben estar codificados en URL. Por ejemplo, si el nombre de un agente o El ID incluye “/”, cambia “/” a “%2F”.

cURL

# This code gets information about an integration.
# Read more: https://developers.google.com/business-communications/business-messages/guides/how-to/integrate/dialogflow?method=api#get_info_for_a_single_integration

# Replace the __BRAND_ID__, __AGENT_ID__ and __INTEGRATION_ID__
# Make sure a service account key file exists at ./service_account_key.json

curl -X GET \
"https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/agents/__AGENT_ID__/integrations/__INTEGRATION_ID__" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)"
get-integration-info.sh

Node.js

/**
 * This code snippet gets information about an integration.
 * Read more: https://developers.google.com/business-communications/business-messages/guides/how-to/integrate/dialogflow?method=api#get_info_for_a_single_integration
 *
 * This code is based on the https://github.com/google-business-communications/nodejs-businesscommunications Node.js
 * Business Communications client library.
 */

/**
 * Edit the values below:
 */
 const BRAND_ID = 'EDIT_HERE';
 const AGENT_ID = 'EDIT_HERE';
 const INTEGRATION_ID = 'EDIT_HERE';
 const PATH_TO_SERVICE_ACCOUNT_KEY = './service_account_key.json';

 const businesscommunications = require('businesscommunications');
 const {google} = require('googleapis');
 const uuidv4 = require('uuid').v4;

 // Initialize the Business Communications API
 const bcApi = new businesscommunications.businesscommunications_v1.Businesscommunications({});

 // Set the scope that we need for the Business Communications API
 const scopes = [
   'https://www.googleapis.com/auth/businesscommunications',
 ];

 // Set the private key to the service account file
 const privatekey = require(PATH_TO_SERVICE_ACCOUNT_KEY);

 async function main() {
   const authClient = await initCredentials();
   const integrationName = 'brands/' + BRAND_ID + '/agents/' + AGENT_ID + '/integrations/' + INTEGRATION_ID;

   if (authClient) {
     // Setup the parameters for the API call
     const apiParams = {
       auth: authClient,
       name: integrationName,
     };

     bcApi.brands.agents.integrations.get(apiParams, {}, (err, response) => {
       if (err !== undefined && err !== null) {
         console.dir(err);
       } else {
         // Agent created
         console.log(response.data);
       }
     });
   }
   else {
     console.log('Authentication failure.');
   }
 }

 /**
  * Initializes the Google credentials for calling the
  * Business Messages API.
  */
  async function initCredentials() {
   // Configure a JWT auth client
   const authClient = new google.auth.JWT(
     privatekey.client_email,
     null,
     privatekey.private_key,
     scopes,
   );

   return new Promise(function(resolve, reject) {
     // Authenticate request
     authClient.authorize(function(err, tokens) {
       if (err) {
         reject(false);
       } else {
         resolve(authClient);
       }
     });
   });
 }

 main();
get-integration-info.js

Python

"""This code snippet gets information about an integration.

Read more: https://developers.google.com/business-communications/business-messages/guides/how-to/integrate/dialogflow?method=api#get_info_for_a_single_integration

This code is based on the https://github.com/google-business-communications/python-businessmessages
Python Business Messages client library.
"""

from oauth2client.service_account import ServiceAccountCredentials
from businesscommunications.businesscommunications_v1_client import BusinesscommunicationsV1
from businesscommunications.businesscommunications_v1_messages import (
    BusinesscommunicationsBrandsAgentsIntegrationsDeleteRequest
)

# Edit the values below:
BRAND_ID = 'EDIT_HERE'
AGENT_ID = 'EDIT_HERE'
INTEGRATION_ID = 'EDIT_HERE'
SCOPES = ['https://www.googleapis.com/auth/businesscommunications']
SERVICE_ACCOUNT_FILE = './service_account_key.json'

credentials = ServiceAccountCredentials.from_json_keyfile_name(
    SERVICE_ACCOUNT_FILE, scopes=SCOPES)

client = BusinesscommunicationsV1(credentials=credentials)

integrations_service = BusinesscommunicationsV1.BrandsAgentsIntegrationsService(client)

integration_name = 'brands/' + BRAND_ID + '/agents/' + AGENT_ID + '/integrations/' + INTEGRATION_ID

integration = integrations_service.Get(BusinesscommunicationsBrandsAgentsIntegrationsDeleteRequest(
  name=integration_name
))

print(integration)
get-integration-info.py

Para ver las opciones de formato y valor, consulta Integration

Enumerar todas las integraciones de un agente

Si no conoces el nombre de la integración, puedes obtener información de todas de integraciones asociadas con un agente si se omite INTEGRATION_ID valor de una URL de solicitud GET.

Nota: Los nombres y los ID de los agentes deben estar codificados en URL. Por ejemplo, si el nombre de un agente o El ID incluye “/”, cambia “/” a “%2F”.

cURL

# This code lists all integrations for an agent.
# Read more: https://developers.google.com/business-communications/business-messages/guides/how-to/integrate/dialogflow?method=api#list_all_integrations_for_an_agent

# Replace the __BRAND_ID__ and __AGENT_ID__
# Make sure a service account key file exists at ./service_account_key.json

curl -X GET \
"https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/agents/__AGENT_ID__/integrations" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)"
list-integrations.sh

Node.js

/**
 * This code snippet lists all integrations for an agent.
 * Read more: https://developers.google.com/business-communications/business-messages/guides/how-to/integrate/dialogflow?method=api#list_all_integrations_for_an_agent
 *
 * This code is based on the https://github.com/google-business-communications/nodejs-businesscommunications Node.js
 * Business Communications client library.
 */

/**
 * Edit the values below:
 */
 const BRAND_ID = 'EDIT_HERE';
 const AGENT_ID = 'EDIT_HERE';
 const PATH_TO_SERVICE_ACCOUNT_KEY = './service_account_key.json';

 const businesscommunications = require('businesscommunications');
 const {google} = require('googleapis');
 const uuidv4 = require('uuid').v4;

 // Initialize the Business Communications API
 const bcApi = new businesscommunications.businesscommunications_v1.Businesscommunications({});

 // Set the scope that we need for the Business Communications API
 const scopes = [
   'https://www.googleapis.com/auth/businesscommunications',
 ];

 // Set the private key to the service account file
 const privatekey = require(PATH_TO_SERVICE_ACCOUNT_KEY);

 async function main() {
   const authClient = await initCredentials();

   if (authClient) {
     // Setup the parameters for the API call
     const apiParams = {
       auth: authClient,
       parent: 'brands/' + BRAND_ID + '/agents/' + AGENT_ID,
     };

     bcApi.brands.agents.integrations.list(apiParams, {}, (err, response) => {
       if (err !== undefined && err !== null) {
         console.dir(err);
       } else {
         // Agent created
         console.log(response.data);
       }
     });
   }
   else {
     console.log('Authentication failure.');
   }
 }

 /**
  * Initializes the Google credentials for calling the
  * Business Messages API.
  */
  async function initCredentials() {
   // Configure a JWT auth client
   const authClient = new google.auth.JWT(
     privatekey.client_email,
     null,
     privatekey.private_key,
     scopes,
   );

   return new Promise(function(resolve, reject) {
     // Authenticate request
     authClient.authorize(function(err, tokens) {
       if (err) {
         reject(false);
       } else {
         resolve(authClient);
       }
     });
   });
 }

 main();
list-integrations.js

Python

"""This code snippet lists all integrations for an agent.

Read more: https://developers.google.com/business-communications/business-messages/guides/how-to/integrate/dialogflow?method=api#list_all_integrations_for_an_agent

This code is based on the https://github.com/google-business-communications/python-businessmessages
Python Business Messages client library.
"""

from oauth2client.service_account import ServiceAccountCredentials
from businesscommunications.businesscommunications_v1_client import BusinesscommunicationsV1
from businesscommunications.businesscommunications_v1_messages import (
    BusinesscommunicationsBrandsAgentsIntegrationsListRequest
)

# Edit the values below:
BRAND_ID = 'EDIT_HERE'
AGENT_ID = 'EDIT_HERE'
SCOPES = ['https://www.googleapis.com/auth/businesscommunications']
SERVICE_ACCOUNT_FILE = './service_account_key.json'

credentials = ServiceAccountCredentials.from_json_keyfile_name(
    SERVICE_ACCOUNT_FILE, scopes=SCOPES)

client = BusinesscommunicationsV1(credentials=credentials)

integrations_service = BusinesscommunicationsV1.BrandsAgentsIntegrationsService(client)

agent_name = 'brands/' + BRAND_ID + '/agents/' + AGENT_ID

integration = integrations_service.List(
  BusinesscommunicationsBrandsAgentsIntegrationsListRequest(parent=agent_name)
)

print(integration)
list-integrations.py

Para ver las opciones de formato y valor, consulta Integration

Coincidencia de intents

Después de habilitar la integración de Dialogflow para un agente de Business Messages, tu puede usar los intents configurados del proyecto de Dialogflow para comprender responder las preguntas de los usuarios sin tener que escribir código. Para obtener más información intents, consulta la documentación de Dialogflow ES y Dialogflow CX.

Configurar tus intents de Dialogflow para cada opción de conversación que desees a través de la automatización. Los agentes de Business Messages confían en Dialogflow para comprender los mensajes de los usuarios.

Cuando se llama a las APIs de Dialogflow, Business Messages pasa el carga útil del mensaje del usuario a los intents y al webhook de entrega. Cuando se detecta una coincidencia con un mensaje de un usuario con un intent, puedes acceder a esta carga útil en formato Struct, en Campo business_messages_payload en QueryParameters.

La carga útil contiene todos los campos del mensaje para el usuario, excepto DialogflowResponse.

Para Dialogflow CX, Business Messages también pasa un parámetro de sesión llamado channel con el valor google_business_messages a tus intents y puedes hacer referencia a él en tu agente con el siguiente formato: $session.params.channel.

Este parámetro se puede usar para agregar condicionales a tus entregas de Dialogflow a fin de admitir varios canales en el mismo agente de Dialogflow.

Para obtener más información sobre los parámetros de consulta, consulta las referencias de Dialogflow ES y Dialogflow CX.

Requisitos previos

Cuando creas modelos de CLN en Dialogflow, puedes configurar diferentes tipos de respuesta para un intent. Business Messages admite la respuesta predeterminada, que pueden incluir lo siguiente:

• Texto
• Carga útil personalizada
• Transferencia de agentes humanos (solo Dialogflow CX)

Una carga útil personalizada debe coincidir con una respuesta de mensaje JSON de Business Messages válida un objeto. Cuando se configuran respuestas de carga útil personalizadas para un intent, Business Messages ignora los siguientes campos:

• name
• messageId
• representative

Consulta los siguientes ejemplos de respuestas.

Texto con sugerencias

{
  "text": "Hello World!",
  "fallback": "Hello World!\n\nReply with \"Hello\" or \"Hi!\"",
  "suggestions": [
    {
      "reply": {
        "text": "Hello",
        "postbackData": "hello-formal"
      }
    },
    {
      "reply": {
        "text": "Hi!",
        "postbackData": "hello-informal"
      }
    }
  ]
}

Tarjeta enriquecida

{
  "fallback": "Hello, world!\nSent with Business Messages\n\nReply with \"Suggestion #1\" or \"Suggestion #2\"",
  "richCard": {
    "standaloneCard": {
      "cardContent": {
        "title": "Hello, world!",
        "description": "Sent with Business Messages.",
        "media": {
          "height": "TALL",
          "contentInfo":{
            "altText": "Google logo",
            "fileUrl": "https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png",
            "forceRefresh": "false"
          }
        },
        "suggestions": [
          {
            "reply": {
              "text": "Suggestion #1",
              "postbackData": "suggestion_1"
            }
          },
          {
            "reply": {
              "text": "Suggestion #2",
              "postbackData": "suggestion_2"
            }
          }
        ]
      }
    }
  }
}

Carrusel de tarjeta enriquecida

{
  "fallback": "Card #1\nThe description for card #1\n\nCard #2\nThe description for card #2\n\nReply with \"Card #1\" or \"Card #2\"",
  "richCard": {
    "carouselCard": {
      "cardWidth": "MEDIUM",
      "cardContents": [
        {
          "title": "Card #1",
          "description": "The description for card #1",
          "suggestions": [
            {
              "reply": {
                "text": "Card #1",
                "postbackData": "card_1"
              }
            }
          ],
          "media": {
            "height": "MEDIUM",
            "contentInfo": {
              "fileUrl": "https://my.files/cute-dog.jpg",
              "forceRefresh": false
            }
          }
        },
        {
          "title": "Card #2",
          "description": "The description for card #2",
          "suggestions": [
            {
              "reply": {
                "text": "Card #2",
                "postbackData": "card_2"
              }
            }
          ],
          "media": {
            "height": "MEDIUM",
            "contentInfo": {
              "fileUrl": "https://my.files/elephant.jpg",
              "forceRefresh": false
            }
          }
        }
      ]
    }
  }
}

Transferencia del agente humano

{
  "metadata": {}
}

Bots de preguntas frecuentes

Después de habilitar una integración en Dialogflow ES para un agente de Business Messages, puedes hacer lo siguiente: puede crear un bot de preguntas frecuentes. Cuando proporciones preguntas y respuestas como un documento de conocimiento compatible, Business Messages y Dialogflow crean el la infraestructura necesaria para comprender y responder a las preguntas de los usuarios sin tener que escribir código.

Para ver un bot de Preguntas frecuentes en acción, chatea con el equipo de Preguntas frecuentes de Business Messages bot.

Nota: Dialogflow CX no es compatible con bots de Preguntas frecuentes.

Requisitos previos

Antes de crear un bot de preguntas frecuentes, debes tener las preguntas y respuestas disponibles como Un documento de conocimiento (máx. 50 MB): Un archivo HTML disponible públicamente o un archivo CSV.

En general, los documentos de conocimiento

• Puede incluir Markdown limitado en las respuestas, como se especifica en Contenido enriquecido. texto.
• El tamaño máximo debe ser de 50 MB.
• No debe superar los 2,000 pares de preguntas y respuestas.
• No admitas preguntas duplicadas con respuestas diferentes.

Para los archivos HTML,

• Para que los archivos de las URL públicas existan en el índice de búsqueda, el indexador de Búsqueda de Google debe haberlos rastreado. Puedes verificar esto con el Centro de ayuda de Search Console Ten en cuenta que el indexador no mantiene actualizado tu contenido. Debes especificar y actualizarlo cuando cambie el contenido de origen.
• Dialogflow quita las etiquetas HTML del contenido cuando se crean respuestas. Porque de esto, es mejor evitar las etiquetas HTML y usar texto sin formato cuando sea posible.
• No se admiten los archivos con un solo par de pregunta/respuesta.

Para los archivos CSV,

• Los archivos deben tener preguntas en la primera columna y respuestas en la segunda. sin encabezado.
• Los archivos deben usar comas como delimitadores.

Crea un bot de preguntas frecuentes

Para crear un bot de preguntas frecuentes, primero debes crear una base de conocimiento que almacene todos los datos de tu bot y, luego, agrega uno o más documentos con pares de preguntas y respuestas a en tu base de conocimiento.

Crear una base de conocimiento

Para crear una base de conocimiento, ejecuta el siguiente comando. Reemplazar BRAND_ID, AGENT_ID y INTEGRATION_ID por los valores únicos del name del documento. Reemplazar KNOWLEDGE_BASE_DISPLAY_NAME por una cadena de identificación de tu es tu mejor opción.

Nota: Almacena el valor name de la base de conocimiento. Lo necesitarás más adelante.

Después de crear una base de conocimiento, puedes crear documentos dentro de él.

cURL

# This code creates a knowledge base.
# Read more: https://developers.google.com/business-communications/business-messages/guides/how-to/integrate/dialogflow?method=api#create-knowledge-base

# Replace the __BRAND_ID__, __AGENT_ID__, __INTEGRATION_ID__ and __KNOWLEDGE_BASE_DISPLAY_NAME__
# Make sure a service account key file exists at ./service_account_key.json

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/agents/__AGENT_ID__/integrations/__INTEGRATION_ID__?updateMask=dialogflowEsIntegration.dialogflowKnowledgeBases" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "dialogflowEsIntegration": {
    "dialogflowKnowledgeBases": [
      {
        "displayName": "__KNOWLEDGE_BASE_DISPLAY_NAME__"
      }
    ]
  }
}'
create-knowledgebase.sh

Para ver las opciones de formato y valor, consulta DialogflowKnowledgebase

Crea un documento de conocimiento

Para crear un documento de conocimiento, ejecuta el siguiente comando.

Agrega el documento a la lista de documentos existentes o, si no hay ninguno, crea una lista nueva existe todavía. Una lista de documentos existentes debe incluir el name del documento. de la solicitud.

Nota: Solo se puede agregar un documento a la vez. No incluir ningún otro cambios de integración cuando se agrega un documento.

Archivo HTML público

Reemplaza las siguientes variables:

• BRAND_ID, AGENT_ID y INTEGRATION_ID con los valores únicos de name de la integración
• KNOWLEDGE_BASE_DISPLAY_NAME y DOCUMENT_DISPLAY_NAME con para identificar cadenas que elijas

• PUBLIC_URL con el conocimiento URL pública del documento

cURL

# This code creates a knowledge base document from an HTML document and adds it to the knowledge base.
# Read more: https://developers.google.com/business-communications/business-messages/guides/how-to/integrate/dialogflow?method=api#create-document

# Replace the __BRAND_ID__, __AGENT_ID__, __INTEGRATION_ID__, __KNOWLEDGE_BASE_DISPLAY_NAME__, __DOCUMENT_DISPLAY_NAME__ and __PUBLIC_URL__
# Make sure a service account key file exists at ./service_account_key.json

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/agents/__AGENT_ID__/integrations/__INTEGRATION_ID__?updateMask=dialogflowEsIntegration.dialogflowKnowledgeBases" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "dialogflowEsIntegration": {
    "dialogflowKnowledgeBases": [
      {
        "displayName": "__KNOWLEDGE_BASE_DISPLAY_NAME__",
        "documents": [
          {
            "displayName": "__DOCUMENT_DISPLAY_NAME__",
            "faqUrl": "__PUBLIC_URL__"
          }
        ]
      }
    ]
  }
}'
create-knowledgebase-document-html.sh

Archivo CSV local

Reemplaza las siguientes variables:

• BRAND_ID, AGENT_ID y INTEGRATION_ID con los valores únicos de name de la integración
• KNOWLEDGE_BASE_DISPLAY_NAME y DOCUMENT_DISPLAY_NAME con para identificar cadenas que elijas

• CSV_RAW_BYTES con el archivo CSV archivo como una cadena codificada en base64

cURL

# This code creates a knowledge base document from a CSV document and adds it to the knowledge base.
# Read more: https://developers.google.com/business-communications/business-messages/guides/how-to/integrate/dialogflow?method=api#create-document

# Replace the __BRAND_ID__, __AGENT_ID__, __INTEGRATION_ID__, __KNOWLEDGE_BASE_DISPLAY_NAME__, __DOCUMENT_DISPLAY_NAME__ and __CSV_RAW_BYTES__
# Make sure a service account key file exists at ./service_account_key.json

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/agents/__AGENT_ID__/integrations/__INTEGRATION_ID__?updateMask=dialogflowEsIntegration.dialogflowKnowledgeBases" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "dialogflowEsIntegration": {
    "dialogflowKnowledgeBases": [
      {
        "displayName": "__KNOWLEDGE_BASE_DISPLAY_NAME__",
        "documents": [
          {
            "displayName": "__DOCUMENT_DISPLAY_NAME__",
            "rawContent": "__CSV_RAW_BYTES__"
          }
        ]
      }
    ]
  }
}'
create-knowledgebase-document-csv.sh

Para ver las opciones de formato y valor, consulta DialogflowKnowledgebase

Agregar un documento a una base de conocimiento lleva unos dos minutos. Para verificar el estado del documento, obtén el estado OperationInfo

Cómo borrar un documento de conocimiento

Si necesitas quitar pares de preguntas y respuestas de tu agente de Business Messages, sigue estos pasos: borra el documento de conocimiento que los contiene con el siguiente comando.

Nota: Solo se puede borrar un documento a la vez.

Ejecuta el siguiente comando para borrar un solo documento existente. Reemplazar BRAND_ID, AGENT_ID y INTEGRATION_ID por los valores únicos del name del documento. Reemplazar KNOWLEDGE_BASE_DISPLAY_NAME por la cadena adecuada

Nota: La base de conocimiento displayName y el documento displayName no se pueden actualizados.

cURL

# This code deletes a knowledge base document.
# Read more: https://developers.google.com/business-communications/business-messages/guides/how-to/integrate/dialogflow?method=api#delete_a_knowledge_document

# Replace the __BRAND_ID__, __AGENT_ID__, __INTEGRATION_ID__ and __KNOWLEDGE_BASE_DISPLAY_NAME__
# To delete all knowledge bases, set dialogflowKnowledgeBases to an empty list. Otherwise, the list should contain all existing knowledgebases except the one you would like to remove.
# Make sure a service account key file exists at ./service_account_key.json

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/agents/__AGENT_ID__/integrations/__INTEGRATION_ID__?updateMask=dialogflowEsIntegration.dialogflowKnowledgeBases" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "dialogflowEsIntegration": {
    "dialogflowKnowledgeBases": [
      {
        "displayName": "__KNOWLEDGE_BASE_DISPLAY_NAME__"
      }
    ]
  }
}'
delete-knowledgebase-document.sh

Para ver las opciones de formato y valor, consulta DialogflowKnowledgebase

Respuestas automáticas

Si habilitas la respuesta automática durante la integración de Dialogflow, Business Mensajes responde automáticamente al usuario a través de Dialogflow. Tu empresa El agente de Mensajes responde con la coincidencia de nivel de confianza más alta. Con un Integración en Dialogflow ES, si hay coincidencias con una respuesta de preguntas frecuentes y una basado en intención personalizado, Business Messages responde con la coincidencia que tiene nivel de confianza.

Business Messages marca todos los mensajes de respuesta automática como provenientes de BOT representantes. Si tu agente admite agentes humanos, Business Messages suspenderá las respuestas automáticas después del REPRESENTATIVE_JOINED eventos y reanuda las respuestas automáticas después de eventos REPRESENTATIVE_LEFT. Consulta Handoff de un bot a un agente humano.

Responder automáticamente con una pregunta frecuente

Con una integración en Dialogflow ES, si una respuesta a las preguntas frecuentes tiene el mayor nivel de confianza a nivel de servicio, Business Messages asigna la respuesta a un mensaje de texto. Si hay un elemento respuesta relacionada pero diferente disponible, el mensaje muestra el mensaje "Ver otro respuesta" sugerencia. Si no es así, el mensaje incluirá una pregunta y una respuestas en las que se pregunta si el mensaje cumplió con la solicitud del usuario.

Nota: Dialogflow CX no es compatible con bots de Preguntas frecuentes.

Respuesta automática con una respuesta de intent

Las respuestas de intent pueden incluir una o más de las siguientes respuestas.

• Dialogflow ES: texto, Carga útil personalizada
• Dialogflow CX: texto, Carga útil personalizada, Transferencia a un agente humano

Si la respuesta de un intent tiene la coincidencia de nivel de confianza más alto, ocurre lo siguiente: aplica.

• Si la respuesta tiene al menos un valor de texto, Business Messages asignará este de salida a un mensaje de texto.
• Si la respuesta tiene al menos una carga útil personalizada con una cuenta válida de objetos JSON de Mensajes, Business Messages crea un mensaje con el objeto JSON proporcionado.
• Si la respuesta tiene al menos una respuesta de traspaso de un agente humano, consulta Responder automáticamente con una solicitud de agente humano.

Debido a que Dialogflow puede incluir múltiples respuestas dentro de una coincidencia de intent, Business Messages envía cada mensaje de texto, carga útil personalizada o transferencia de agente en vivo. como un mensaje independiente. Si un intent tiene varios mensajes pero algunos tienen errores de formato, Business Messages solo envía mensajes como respuestas automáticas.

Responder automáticamente con una solicitud de agente humano

Dialogflow CX admite el transferencia de agentes humanos respuesta. Indica que la conversación debe transferirse a una persona representativo y te permite pasar metadatos personalizados para tu transferencia procedimiento. Si la respuesta de un intent tiene la coincidencia con el nivel de confianza más alto y incluye transferencia a un agente humano, Business Messages envía una evento solicitado por un agente en vivo a tu webhook. Para administrar este evento, consulta Transferencia del bot al agente humano.

Nota: Dialogflow ES no admite respuestas de transferencia de agentes en vivo.

Respuesta automática con un mensaje alternativo

Si Dialogflow no obtiene una coincidencia de nivel de confianza alto, Business Messages envía una respuesta de resguardo. Los resguardos se manejan de forma diferente en Dialogflow ES Dialogflow CX

Dialogflow ES

En el caso de los bots de Preguntas frecuentes, si no hay una respuesta a preguntas frecuentes, Business Messages envía un mensaje de resguardo que no pudo encontrar una respuesta.

Para intents configurados, si no hay una coincidencia con una respuesta de intent, Business Mensajes envía una respuesta de intent de resguardo. Puedes usar el texto alternativo que proporciona Dialogflow o configurar de resguardo con texto adicional y cargas útiles personalizadas.

Este es un ejemplo de una respuesta de intent de resguardo que tu webhook pueden recibir:

{
  "intentResponses": [
    {
      "intentName": "projects/df-integration/agent/intents/12345",
      "intentDisplayName": "Default Fallback Intent",
      "intentDetectionConfidence": "1.0",
      "fulfillmentMessages": [
        {
          "text": "One more time?"
        }
      ]
    }
  ]
}

Dialogflow prepropaga intent_name y intent_display_name.

Dialogflow CX

Dialogflow CX controla las respuestas de intents de resguardo como eventos integrados. Si no hay una coincidencia con una respuesta a un intent, Business Messages envía una mensaje de resguardo del evento predeterminado “No-match” en Dialogflow. Puedes usar el texto de resguardo que proporciona Dialogflow o configurarlo con texto adicional, cargas útiles personalizadas y opciones de transferencia de agentes humanos.

Este es un ejemplo de una respuesta de intent de resguardo que webhook puede recibir lo siguiente:

{
  "intentResponses": [
    {
      "intentName": "sys.no-match-default",
      "intentDisplayName": "Default Fallback Intent",
      "intentDetectionConfidence": "0.3",
      "fulfillmentMessages": [
        {
          "text": "I missed that, say that again?"
        }
      ]
    }
  ]
}

Business Messages codifica intent_name y intent_display_name.

Campos específicos de Dialogflow

Después de habilitar la integración en Dialogflow, el usuario envía un mensaje al agente recibe incluyen el dialogflowResponse . Tu webhook recibe cargas útiles para todos los mensajes de usuario, independientemente de si Business Messages respondió automáticamente al mensaje en tu nombre. Para comprobar si hay una respuesta automática, consulta el valor de la autoResponded y decidir si debes responder al usuario.

Dialogflow ES

...
"dialogflowResponse": {
  "queryText": "TEXT",
  "intentResponse": {
    "intentName": "INTENT_ID",
    "intentDisplayName": "INTENT_NAME",
    "intentDetectionConfidence": "CONFIDENCE_NUMERIC",
    "fulfillmentMessages": [{
      "text": "FULFILLMENT_TEXT",
      "jsonPayload": "JSON",
      "error": "ERROR_STATUS",
    }],
  "faqResponse": {
    "userQuestion": "USER_QUESTION",
    "answers": [{
      "faqQuestion": "FAQ_QUESTION",
      "faqAnswer": "FAQ_ANSWER",
      "matchConfidenceLevel": "CONFIDENCE_LEVEL",
      "matchConfidence": "CONFIDENCE_NUMERIC",
    }],
  },
  "autoResponded": "BOOLEAN",
  "autoRespondedMessages": [{
    "message": "MESSAGE_JSON",
    "responseSource": "SOURCE",
  }],
},
...

Campo	Descripción
queryText	Es el texto de la consulta conversacional original. Si la ortografía es automática está habilitada la corrección para el modelo de Dialogflow, queryText contiene la entrada del usuario corregida.
intentName	El identificador único del intent coincidente.
intentDisplayName	Es el nombre del intent coincidente.
intentDetectionConfidence	La calificación de confianza numérica de la coincidencia entre queryText y intentName.
text	Una respuesta de texto.
jsonPayload	Una respuesta de carga útil personalizada. Esta cadena coincide con el valor definida en Dialogflow. Si la carga útil no tiene un archivo JSON válido de Business Messages del objeto, error describe el problema.
error	Una descripción de un error con un mensaje de entrega de intent.
userQuestion	La pregunta que hizo el usuario, según el análisis de Dialogflow.
faqQuestion	Una pregunta de Dialogflow coincidió con la pregunta del usuario.
faqAnswer	Una respuesta de Dialogflow coincidió con la pregunta del usuario.
matchConfidenceLevel	El nivel de confianza en la coincidencia entre userQuestion y faqQuestion.
matchConfidence	La calificación de confianza numérica en la coincidencia entre userQuestion y faqQuestion.
autoResponded	Si Business Messages respondió automáticamente o no al usuario con una respuesta de Dialogflow.
message	La carga útil de la respuesta automática.
responseSource	Es la fuente de la respuesta automática. Consulta ResponseSource

Dialogflow CX

...
"dialogflowResponse": {
  "queryText": "TEXT",
  "intentResponse": {
    "intentName": "INTENT_ID",
    "intentDisplayName": "INTENT_NAME",
    "intentDetectionConfidence": "CONFIDENCE_NUMERIC",
    "fulfillmentMessages": [{
      "text": "FULFILLMENT_TEXT",
      "jsonPayload": "JSON",
      "error": "ERROR_STATUS",
      "liveAgentHandoff": {
        "metadata": {}
      }
    }],
  "autoResponded": "BOOLEAN",
  "autoRespondedMessages": [{
    "message": "MESSAGE_JSON",
    "responseSource": "SOURCE",
  }],
},
...

Campo	Descripción
queryText	Es el texto de la consulta conversacional original. Si la ortografía es automática está habilitada la corrección para el modelo de Dialogflow, queryText contiene la entrada del usuario corregida.
intentName	El identificador único del intent coincidente.
intentDisplayName	Es el nombre del intent coincidente.
intentDetectionConfidence	La calificación de confianza numérica de la coincidencia entre queryText y intentName.
text	Una respuesta de texto.
jsonPayload	Una respuesta de carga útil personalizada. Esta cadena coincide con el valor definida en Dialogflow. Si la carga útil no tiene un archivo JSON válido de Business Messages del objeto, error describe el problema.
error	Una descripción de un error con un mensaje de entrega de intent.
liveAgentHandoff	Metadatos personalizados para el procedimiento de traspaso de tu agente humano.
autoResponded	Si Business Messages respondió automáticamente o no al usuario con una respuesta de Dialogflow.
message	La carga útil de la respuesta automática.
responseSource	Es la fuente de la respuesta automática. Consulta ResponseSource