Dialogflow Phone Gateway

La función Dialogflow Phone Gateway proporciona una interfaz telefónica para tu agente. Se usa para crear soluciones de IVR (respuesta de voz interactiva) conversacionales que se integren en el resto de la red del centro de llamadas. Actualmente, puedes seleccionar un número de teléfono alojado en Google. En el futuro, también podrás transferir un número de teléfono existente.

Para obtener información sobre los precios y las cuota de la Phone Gateway, consulta las páginas Precios y Cuotas y límites.

Limitaciones

Esta integración solo admite el uso de un idioma: el idioma predeterminado del agente. Para obtener una lista de los idiomas admitidos, consulta la columna de puerta de enlace telefónica en la página idiomas.

Antes de comenzar

Debes hacer lo siguiente antes de leer esta guía:

  1. Lee los conceptos básicos de Dialogflow.
  2. Realiza los pasos de configuración.

Crea un agente

En los pasos que se brindan en esta guía, damos por sentado determinadas características de tu agente. Por eso, es recomendable que comiences con un agente nuevo. Debes borrar cualquier agente existente en tu proyecto antes de crear uno nuevo. Para borrar un agente existente, haz lo siguiente:

  1. Ve a la Consola de Dialogflow.
  2. Si se te solicita, accede a la consola de Dialogflow. Consulta Descripción general de la consola de Dialogflow para obtener más información.
  3. Selecciona el agente que deseas borrar.
  4. Haz clic en el botón de configuración (settings) junto al nombre del agente.
  5. Desplázate hasta la parte inferior de la pestaña de configuración General.
  6. Haz clic en Borrar este agente.
  7. Ingresa BORRAR en el campo de texto.
  8. Haz clic en Borrar.

Para crear un agente, haz lo siguiente:

  1. Ve a la Consola de Dialogflow.
  2. Si se te solicita, accede a la consola de Dialogflow. Consulta Descripción general de la consola de Dialogflow para obtener más información.
  3. Haz clic en Crear agente en el menú de la barra lateral izquierda. Si ya tienes otros agentes, haz clic en el nombre del agente, desplázate hasta la parte inferior y haz clic en Crear agente nuevo.
  4. Ingresa el nombre del agente, y el idioma y la zona horaria predeterminados.
  5. Si ya creaste un proyecto, ingrésalo. Si deseas permitir que la consola de Dialogflow cree el proyecto, selecciona Crear un proyecto de Google nuevo.
  6. Haz clic en el botón Crear.

Importa el archivo de ejemplo al agente

La importación agregará intents y entidades al agente. Si hay intents o entidades con el mismo nombre que los del archivo importado, se reemplazarán los primeros por los segundos.

Para importar el archivo, sigue estos pasos:

  1. Descarga el archivo telephony-bot.zip.
  2. Ve a la Consola de Dialogflow.
  3. Selecciona el agente.
  4. Haz clic en el botón de configuración settings ubicado junto al nombre del agente.
  5. Selecciona la pestaña Importar y exportar.
  6. Selecciona Importar de ZIP (Import From Zip) y, luego, importa el archivo zip que descargaste.

Habilita las funciones Beta

Asegúrate de que las funciones Beta estén habilitadas:

  1. Ve a la consola de Dialogflow.
  2. Selecciona un agente.
  3. Haz clic en el botón de configuración (settings) junto al nombre del agente.
  4. Desplázate hacia abajo en la pestaña General y asegúrate de que las funciones Beta estén habilitadas.
  5. Si realizaste cambios, haz clic en Guardar.

Configura una puerta de enlace telefónica

Para configurar una puerta de enlace, sigue estos pasos:

  1. Selecciona un proveedor:
    1. Ve a la Consola de Dialogflow.
    2. Selecciona el agente.
    3. Haz clic en Integraciones (Integrations).
    4. Haz clic en Dialogflow Phone Gateway.
  2. Configura Phone Gateway:
    1. Selecciona el idioma.
    2. Selecciona el código de país para el número de teléfono.
    3. Opcional. Selecciona los códigos de área preferidos.
    4. Haz clic en Next (Siguiente).
  3. Selecciona un número:
    1. Elige un número de teléfono de la lista.
    2. Haz clic en Create (Crear).
  4. Finalización:
    1. La puerta de enlace ahora está activa.
    2. De manera opcional, puedes cambiar el entorno.
    3. Guarda el número de teléfono que se visualiza y cierra la ventana de diálogo. Puedes volver a hacer clic en el botón de Integraciones de Dialogflow Phone Gateway para recuperar esta información.

Llama al número de teléfono

Ahora puedes llamar al número de teléfono y seguir las instrucciones de voz sencillas. Las interacciones se definen en el agente.

Examina los intents

Ahora que tienes un agente de telefonía activo, es momento de examinar los intents que importaste. Esto te ayudará a comprender cómo crear tus propios agentes de telefonía.

Bienvenida al emisor de la llamada

Cuando llamaste al número, el agente te saludó y te dio una lista de opciones. Si deseas ver cómo se configuró ese comportamiento, sigue estos pasos:

  1. Ve a la Consola de Dialogflow.
  2. Selecciona el agente.
  3. Haz clic en Intents (Intents).
  4. Haz clic en Intent de bienvenida predeterminado.
  5. Desplázate hasta la sección Eventos. Verás que figuran los eventos Bienvenida (WELCOME) y Bienvenida a la telefonía (TELEPHONY_WELCOME). Esto significa que todos los tipos de eventos de bienvenida activarán este intent. Como alternativa, podrías crear intents individuales, cada uno destinado a un evento de bienvenida específico.
  6. Desplázate hasta la sección Respuestas y haz clic en la pestaña TELEFONÍA.
  7. Verás que la respuesta Sintetizar la voz contiene el mensaje de bienvenida que escuchaste cuando llamaste al número.

Respuesta al comando de prueba

Después de responder con "test" (“probar”), el agente te presentó una nueva lista de opciones. Si deseas ver cómo se configuró ese comportamiento, sigue estos pasos:

  1. Haz clic en Intents (Intents).
  2. Haz clic en Probar intent de telefonía (Test Telephony Intent).
  3. Desplázate hasta la sección Respuestas y haz clic en la pestaña TELEFONÍA.
  4. Verás que la respuesta Sintetizar la voz contiene la respuesta que escuchaste después de decir "test" (“probar”).

Configuración del contexto

Después de decir "test" (“probar”), puedes ejecutar dos comandos: “transfer” ("transferir") o “terminate” ("finalizar"). No se trata de una limitación de los agentes de telefonía; es solo la forma en que se definió este intent. Los intents asociados con estos comandos se proporcionan con contexto. Si deseas ver cómo se configuró ese comportamiento, sigue estos pasos:

  1. Desplázate hacia la sección Contexto (Context) en la parte superior.
  2. Observa el contexto de salida TestTelephonyIntent-followup.
  3. Haz clic en Intents (Intents).
  4. Haz clic en el botón de expansión junto a Probar intent de telefonía (Test Telephony Intent).
  5. Haz clic en Probar intent de telefonía - Finalizar (Test Telephony Intent - Terminate).
  6. Desplázate hacia la sección Contexto (Context) en la parte superior.
  7. Observa el contexto de entrada TestTelephonyIntent-followup.

Finaliza de la llamada

Cuando respondiste "terminate" (“finalizar”), el agente se despidió y finalizó la llamada. Si deseas ver cómo se configuró ese comportamiento, sigue estos pasos:

  1. Desplázate hacia la sección Frases de entrenamiento (Training phrases) y observa las frases que se usan para finalizar la llamada.
  2. Desplázate hasta la sección Respuestas y haz clic en la pestaña TELEFONÍA.
  3. Verás que la respuesta Sintetizar la voz (Synthesize speech) contiene la frase “adiós” (goodbye).
  4. Verás que la opción Configurar este intent como fin de la conversación (Set this intent as end of conversation) está habilitada. Cuando es así, Dialogflow finaliza la llamada telefónica después de reproducir todos los otros mensajes de audio.

Mensajes de respuesta enriquecidos de telefonía

En los intents de este ejemplo, se usan mensajes de respuesta enriquecidos para las respuestas de telefonía. A continuación, se muestran los tipos que puedes usar:

  • Reproducir audio: reproduce el archivo de audio provisto.
  • Sintetizar la voz: sintetiza y reproduce audio a partir del texto provisto. Como alternativa, puedes habilitar la opción Usar respuesta de la pestaña PREDETERMINADO como primera respuesta para que se sintetice una respuesta de voz a partir de la respuesta predeterminada. Si solo defines las respuestas predeterminadas y no habilitas la opción Usar respuesta de la pestaña PREDETERMINADO como primera respuesta, solo se sintetizará audio a partir del texto propagado en QueryResult.fulfillment_text (la propagación se hace con una respuesta de texto seleccionada de forma aleatoria).
  • Transferir llamada: transfiere al emisor a otro número.

Configuración de agentes para telefonía

Puedes controlar varios aspectos de la síntesis de voz. Consulta Configuración de agentes.

Usa el simulador de Dialogflow

Cuando pruebas o experimentas con un agente de telefonía, no necesitas realizar una llamada telefónica. Puedes interactuar con el agente y recibir respuestas de audio a través del simulador de Dialogflow:

  1. Escribe “hola” y presiona la tecla Intro.
  2. Cambia la Respuesta predeterminada (Default Response) a TELEFONÍA (TELEPHONY)
  3. Haz clic en el botón Reproducir audio (Play Audio) para escuchar la respuesta del agente.
  4. Continúa la conversación con el agente.

Números gratuitos

Puedes solicitar un número de teléfono con un código de área 833. Ten en cuenta que los números gratuitos tienen un precio más alto.

Eventos

Esta integración invoca los siguientes eventos:

Evento Descripción
TELEPHONY_WELCOME Se activa cuando alguien llama al número de teléfono asociado a tu agente de Dialogflow.