En este documento, se describen los pasos necesarios para configurar un proyecto deGoogle Cloud para la integración de telefonía.
Selecciona o crea un proyecto de Google Cloud
Los enlaces troncales SIP se conectan a un proyecto solo por motivos de comunicación, pero su efecto no se limita a un proyecto específico.
Por ejemplo, puedes tener tres proyectos diferentes (desarrollo, pruebas y producción). Si se usa el mismo enlace troncal SIP para toda la comunicación de SBC a GTP, solo se realizará correctamente la primera solicitud para crear el enlace troncal SIP, y el resto de las solicitudes para crear el enlace troncal SIP en la misma región y nombre de host fallarán.
Puedes usar un proyecto diferente con el único propósito de administrar los enlaces troncales SIP. Esto permite que un equipo diferente administre los troncos y, dentro de la IU del tronco, puedes establecer diferentes grupos de SBC para el desarrollo, las pruebas y la producción.
Para usar los servicios que proporciona Google Cloud, debes crear un proyecto. Un proyecto organiza todos tus recursos de Google Cloud . Un proyecto consta de un conjunto de colaboradores, APIs habilitadas (y otros recursos), herramientas de supervisión, datos de facturación y controles de autenticación y control de acceso. Puedes crear un proyecto, o puedes crear varios proyectos y usarlos para organizar tus recursos de Google Cloud en una jerarquía de recursos. Cuando creas un proyecto, toma nota del ID del proyecto. Necesitarás este ID para realizar llamadas a la API. Para obtener más información sobre los proyectos, consulta la documentación de Resource Manager.
En la consola de Google Cloud , en la página del selector de proyectos, selecciona o crea un proyecto de Google Cloud .
Roles necesarios para seleccionar o crear un proyecto
- Selecciona un proyecto: Para seleccionar un proyecto, no se requiere un rol de IAM específico. Puedes seleccionar cualquier proyecto en el que se te haya otorgado un rol.
-
Crea un proyecto: Para crear un proyecto, necesitas el rol de creador de proyectos
(
roles/resourcemanager.projectCreator), que contiene el permisoresourcemanager.projects.create. Obtén más información para otorgar roles.
Permisos
- En la consola de Google Cloud , ve a IAM y administración > IAM.
- Selecciona una cuenta de servicio existente o crea una nueva, y asígnale el rol
Dialogflow API Admin. Este rol es obligatorio para la integración de telefonía.
Acceso a la API de números de teléfono
Para usar los métodos de la API de números de teléfono, se requiere un acceso especial. Comunícate con tu representante de Google para obtener más información.
Configura Dialogflow, el perfil de conversación y el número de teléfono
En esta sección, se describe cómo crear un perfil de conversación de IA conversacional con un número de teléfono asociado de la Plataforma de telefonía de Google (GTP).
- Ve a Colab Enterprise. Si se te solicita, habilita las APIs de Compute Engine, Dataform y Vertex.
- Selecciona Importar notebooks y, luego, URL como la fuente de datos. Ingresa la URL del repositorio de GitHub y, luego, selecciona Importar.
- En el campo
PROJECT_ID, ingresa el ID del proyecto de Google Cloud que deseas asociar con la integración. Busca tus proyectos existentes en el menú que se encuentra en la parte superior de la página en la consola deGoogle Cloud . - Ingresa la región que elegiste en el campo
REGION. Se admiten todas las regiones de Dialogflow. - Deja el campo
JWTcomo está o ingresa tu valor deJWTaquí. Si se deja en blanco, se usa el SSO de forma predeterminada. - Haz clic en el botón de reproducción de la sección Project de la parte superior para ejecutar esa sección de código. Cuando se te solicite, permite que el notebook acceda a tus credenciales de Google.
- Expande la sección Configura la IA conversacional para SIP/SIPREC. En Crea un agente ficticio de Dialogflow ES…, haz clic en Mostrar código y ejecuta el código sin realizar ningún cambio. Esto crea un agente ficticio de Dialogflow ES y establece su nivel en Enterprise. Se requiere un agente ficticio de Dialogflow ES para acceder a los endpoints de API de Dialogflow. Cada proyecto de Google Cloud puede tener un solo agente de Dialogflow ES.
- Expándela para mostrar el código en la sección Secuencia de comandos para crear un
ConversationProfile….CONVERSATION_PROFILE_NAME: Puede ser cualquier cadena. Puedes usar el valor predeterminado o ingresar uno propio.SECURITY_SETTINGS: Puede ser cualquier cadena. Puedes usar el valor predeterminado o ingresar uno propio.PHONE_NUMBER_COUNTRY_CODE: Ingresa el código de país que quieres asociar con tu número de teléfono de GTP.CX_AGENT_NAME: Ingresa el nombre del agente de Dialogflow CX con el que deseas que se asocie el perfil de conversación generado.
- Ejecuta el código. El resultado incluirá el nombre del
ConversationProfilegenerado, la configuración de seguridad y el número de teléfono de GTP. - Ve a la consola de Dialogflow ES para
verificar que se haya creado un agente llamado
Dummy_ES_agent. Haz clic en Configuración para verificar que el agente esté asociado con el proyecto de Google Cloud correcto y que se haya actualizado a la edición Essentials. - Ve a la
consola de Agent Assist.
Haz clic en Perfiles de conversación en el menú de navegación para verificar que se haya creado un perfil de conversación con el
CONVERSATION_PROFILE_NAMEque ingresaste. - Ve a la consola de Estadísticas de IA conversacional. Verifica que se hayan importado todas las transcripciones de conversaciones asociadas con tu agente de Dialogflow CX.
(Opcional) Solicita un aumento de la cuota para la duración de las llamadas de Dialogflow CX Phone Gateway
Las suscripciones a Dialogflow ES Essentials y Dialogflow CX incluyen cuotas estándar disponibles. Si no usas Dialogflow en absoluto, como solo usar Agent Assist, Transcripción o Grabación de llamadas, tu cuota predeterminada es la misma que la cuota de Dialogflow ES Essentials.
Si es necesario, puedes solicitar un aumento de cuota en función de tu tráfico estimado. En la mayoría de los casos de uso, la cuota estándar es suficiente para la configuración y las pruebas, pero las aplicaciones de entorno de ejecución requieren un aumento. Consulta la página de cuotas de Dialogflow para obtener detalles sobre las cuotas y las instrucciones para solicitar un aumento.
Habilita el registro de auditoría para la API de Dialogflow (opcional)
Para habilitar el registro de auditoría de la API de Dialogflow (dialogflow.googleapis.com) para la lectura de administrador, la lectura de datos y la escritura de datos, usa esta función para ver todas las llamadas individuales a la API de IA conversacional que se realizaron y las credenciales que se usaron para la autorización y el consumo. Esto te permite solucionar problemas y depurar problemas de manera más eficaz.
¿Qué sigue?
- Obtén más información para configurar un SBC.