En esta página, se documentan los pasos necesarios para configurar un proyecto de Google Cloud para la integración de telefonía.
Selecciona o crea un Google Cloud proyecto
Los 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, 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 tendrá éxito la primera solicitud para crear el enlace troncal SIP, y fallarán el resto de las solicitudes para crear el enlace troncal SIP en la misma región o nombre de host.
Te recomendamos que uses un proyecto diferente solo para administrar los troncales SIP. Esto permite que un equipo diferente sea responsable de los troncales y, dentro de la IU de Trunk, puede establecer diferentes grupos de SBC para desarrollo, pruebas y producción.
Para usar los servicios que proporciona Google Cloud, debes crear un proyecto. Un proyecto organiza todos tus Google Cloud recursos. Un proyecto consta de un conjunto de colaboradores, API 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 crees 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.
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant 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 obligatorio 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 Phone Numbers 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 a 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 Import notebooks y, luego, selecciona URL como la fuente de datos. Ingresa esta URL del repositorio de GitHub y, luego, haz clic en IMPORT.
- En el campo
PROJECT_ID, ingresa el ID del proyecto Google Cloud que deseas asociar con la integración. Puedes encontrar tus proyectos existentes en el menú desplegable en la parte superior de la página de la consola de 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 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 Create a dummy Dialogflow ES agent…, haz clic en Show code y ejecuta el código sin hacer ningún cambio. Esto crea un agente de Dialogflow ES ficticio y establece su nivel en Enterprise. Se requiere un agente simulado de Dialogflow ES para acceder a los extremos de la API de Dialogflow. Cada proyecto Google Cloud puede tener un solo agente de Dialogflow ES.
- Expande la sección Script to create a
ConversationProfile… para mostrar el código.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 Conversational Agents (Dialogflow CX) con el que deseas asociar 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 del 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 al proyectoGoogle Cloud correcto y que se haya actualizado a la edición Essentials. - Navega a la consola de Agent Assist.
Haz clic en Conversation profiles 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 IA en conversaciones (Dialogflow CX).
(Opcional) Solicita un aumento de la cuota para la duración de las llamadas de la Puerta de enlace telefónica de Dialogflow CX
Las suscripciones a Dialogflow ES Essentials y Conversational Agents (Dialogflow CX) incluyen cuotas estándar disponibles. Si no usas Dialogflow en absoluto, por ejemplo, solo Asistente de agente, 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 la cuota según 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 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. De esta manera, podrás 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 puede ser útil para solucionar problemas y depurar.
¿Qué sigue?
Obtén más información para configurar un SBC.