En esta página se describen los pasos necesarios para configurar un Google Cloud proyecto para la integración de telefonía.
Selecciona o crea un Google Cloud proyecto
Los troncales SIP se conectan a un proyecto únicamente 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 troncal SIP para todas las comunicaciones de SBC a GTP, solo se completará la primera solicitud para crear el troncal SIP y fallarán el resto de las solicitudes para crear el troncal SIP en la misma región o nombre de host.
Recomendamos usar un proyecto diferente únicamente para gestionar los troncales SIP. De esta forma, otro equipo puede encargarse de los troncales y, en la interfaz de usuario de Trunk, puede establecer diferentes grupos de SBCs para desarrollo, pruebas y producción.
Para usar los servicios que ofrece Google Cloud, debes crear un proyecto. Un proyecto organiza todos tus Google Cloud recursos. Un proyecto consta de un conjunto de colaboradores, APIs habilitadas (y otros recursos), herramientas de monitorización, información de facturación y controles de autenticación y acceso. Puedes crear un proyecto o varios y usarlos para organizar tus Google Cloud recursos en una jerarquía de recursos. Cuando crees un proyecto, anota el ID del proyecto. Necesitará este ID para hacer 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, ve a IAM y administración -> IAM.
- Selecciona una cuenta de servicio o crea una, y asegúrate de que tenga asignado el rol
Dialogflow API Admin. Este rol es necesario para la integración de telefonía.
Acceso a la API de número de teléfono
Para usar los métodos de la API de números de teléfono, se necesita un acceso especial. Ponte en contacto con tu representante de Google para obtener más información.
Configurar 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).
- Ve a Colab Enterprise. Si se te pide, habilita las APIs Compute Engine, Dataform y Vertex.
- Haz clic en Importar cuadernos y, a continuación, selecciona URL como fuente de datos. Introduce esta URL del repositorio de GitHub y haz clic en IMPORT.
- En el campo
PROJECT_ID, introduce el ID del proyecto Google Cloud que quieras asociar a la integración. Puedes encontrar tus proyectos en el menú desplegable de la parte superior de la página de la consola de Cloud. - Introduce la región que hayas elegido en el campo
REGION. Se admiten todas las regiones de Dialogflow. - Deje el campo
JWTtal cual o introduzca su valor deJWT. Si se deja en blanco, se usará el SSO de forma predeterminada. - Haz clic en el botón de reproducción de la sección Proyecto de la parte superior para ejecutar esa sección del código. Cuando se te pida, permite que el cuaderno acceda a tus credenciales de Google.
- Despliega la sección Configurar 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 hacer ningún cambio. De esta forma, se crea un agente de Dialogflow ES ficticio y se asigna el nivel Enterprise. Se necesita un agente de Dialogflow ES ficticio para acceder a los endpoints de la API de Dialogflow. Cada proyecto puede tener un solo agente de Dialogflow ES. Google Cloud
- Despliega la sección Script para crear un
ConversationProfile... para ver el código.CONVERSATION_PROFILE_NAME: puede ser cualquier cadena. Puedes usar el valor predeterminado o introducir el tuyo.SECURITY_SETTINGS: puede ser cualquier cadena. Puedes usar el valor predeterminado o introducir el tuyo.PHONE_NUMBER_COUNTRY_CODE: introduce el código de país que quieras asociar a tu número de teléfono de GTP.CX_AGENT_NAME: introduce el nombre del agente de Conversational Agents (Dialogflow CX) al que quieras asociar el perfil de conversación generado.
- Ejecuta el código. El resultado incluirá el nombre del
ConversationProfilegenerado, los ajustes de seguridad y el número de teléfono de GTP. - Ve a la consola de Dialogflow ES
para comprobar que se ha 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. - Ve a la consola de Asistente.
En el menú de la izquierda, haz clic en Perfiles de conversación para comprobar que se ha creado un perfil de conversación con el
CONVERSATION_PROFILE_NAMEque has introducido. - Ve a la consola de estadísticas de IA conversacional. Verifica que se hayan importado todas las transcripciones de conversaciones asociadas a tu agente de Conversational Agents (Dialogflow CX).
Opcional: Solicitar un aumento de la cuota de duración de las llamadas de la pasarela de telefonía de Dialogflow CX
Las suscripciones a Dialogflow ES Essentials y Conversational Agents (Dialogflow CX) incluyen cuotas estándar. Si no usas Dialogflow en absoluto (por ejemplo, solo Asistente de agente, Transcripción o Grabación de llamadas), tu cuota predeterminada será la misma que la de Dialogflow ES Essentials.
Si lo necesitas, puedes solicitar un aumento de la cuota en función del tráfico estimado. En la mayoría de los casos prácticos, 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 información detallada sobre las cuotas y las instrucciones para solicitar un aumento.
(Opcional) Habilitar el registro de auditoría de la API de Dialogflow
También puedes habilitar registros de auditoría para la API Dialogflow (dialogflow.googleapis.com) en las operaciones de lectura de administrador, lectura de datos y escritura de datos. De esta forma, podrás ver todas las llamadas individuales a la API Conversational AI que se han hecho y las credenciales que se han usado para la autorización y el consumo. Esto puede ser útil para solucionar problemas y depurar.
Siguientes pasos
Consulta cómo configurar un SBC.