En esta página, se documentan los pasos necesarios para configurar un Google Cloud proyecto para la integración de telefonía.
Selecciona o crea un Google Cloud proyecto
Los enlaces troncales SIP se conectan a un proyecto solo por motivos de comunicación, pero su impacto no se limita a un proyecto específico.
Por ejemplo, es posible que tengas 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 o nombre de host fallarán.
Recomendamos que se use un proyecto diferente con el único propósito de administrar los enlaces troncales SIP. Esto permite que un equipo diferente sea responsable de los enlaces troncales y, dentro de la IU de Trunk, puedan 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 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 Google Cloud consola de, en la página del selector de proyectos, selecciona o crea un Google Cloud proyecto.
Roles necesarios para seleccionar o crear un proyecto
- Seleccionar 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.
-
Crear un proyecto: Para crear un proyecto, necesitas el rol de creador de proyectos
(
roles/resourcemanager.projectCreator), que contiene elresourcemanager.projects.createpermiso. Obtén información para otorgar roles.
Permisos
- En la Google Cloud consola, navega a IAM y administración -> IAM.
- Selecciona una cuenta de servicio existente o crea una nueva y asegúrate de que tenga asignado el rol de
Dialogflow API Admin. Este rol es necesario para la integración de telefonía.
Acceso a la API de número de teléfono
El uso de los métodos de la API de número de teléfono requiere 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 explica el proceso para 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).
- Navega a Colab Enterprise Si se te solicita, habilita las APIs de Compute Engine, Dataform y Vertex.
- Haz clic en Importar notebooks y, luego, selecciona URL como la fuente de datos. Ingresa la URL del repositorio de GitHub, y, luego, haz clic en IMPORT.
- En el campo
PROJECT_ID, ingresa el ID del proyecto que deseas asociar con la integración. Google Cloud Puedes encontrar tus proyectos existentes en el menú desplegable en la parte superior de la página en la consola de Cloud. - Ingresa la región elegida en el campo
REGION. Se admiten todas las regiones de Dialogflow. - Deja el campo
JWTcomo está o ingresa tu valorJWTaquí. Si se deja en blanco, se usa SSO de forma predeterminada. - Haz clic en el botón de reproducción en la sección Proyecto superior para ejecutar esa sección del código. Cuando se te solicite, permite que el notebook acceda a tus credenciales de Google.
- Expande la sección Configuración de la IA conversacional para SIP/SIPREC. En Crea un agente de Dialogflow ES ficticio…, haz clic en Mostrar código y ejecuta el código sin realizar ningún cambio. Esto crea un agente de Dialogflow ES ficticio y establece su nivel en Enterprise. Se requiere un agente de Dialogflow ES ficticio para acceder a los extremos de la API de Dialogflow. Cada Google Cloud proyecto puede tener un solo agente de Dialogflow ES.
- Expande 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 el tuyo.SECURITY_SETTINGS: Puede ser cualquier cadena. Puedes usar el valor predeterminado o ingresar el tuyo.PHONE_NUMBER_COUNTRY_CODE: Ingresa el código de país que deseas 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. - Navega 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 Google Cloud proyecto correcto y que se haya actualizado a la Essentials edición. - Navega a la
consola de Agent Assist.
Haz clic en Perfiles de conversación en el menú de la izquierda para verificar que se haya creado un perfil de conversación con el
CONVERSATION_PROFILE_NAMEque ingresaste. - Navega a la consola de Conversational AI Insights. Verifica que se hayan importado todas las transcripciones de conversaciones asociadas con tu agente de Dialogflow CX.
(Opcional) Solicita un aumento de cuota para la duración de la llamada de la puerta de enlace telefónica de Dialogflow CX
Las suscripciones a Dialogflow ES Essentials y Dialogflow CX incluyen cuotas estándar disponibles. Si no usas Dialogflow en absoluto, por ejemplo, solo Agent Assist, Transcription o Call Recording, tu cuota predeterminada es la misma que la cuota de Dialogflow ES Essentials.
Tienes la opción de solicitar un aumento de cuota si es necesario según el 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 tiempo 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.
(Opcional) Habilita el registro de auditoría para la API de Dialogflow
De manera opcional, puedes habilitar el registro de auditoría para la API de Dialogflow (dialogflow.googleapis.com) para lectura de administración, lectura de datos y escritura de datos. Si lo haces, podrás ver todas las llamadas individuales a la API de IA conversacional realizadas y las credenciales que se usan para la autorización y el consumo. Esto puede ser útil para solucionar problemas y depurar.
¿Qué sigue?
Obtén información para configurar un SBC.