Integración con la API de Aprovisionamiento de Azure Communications Gateway (versión preliminar)
En este artículo se explica cuándo es necesario integrar con la API de Aprovisionamiento de Azure Communications Gateway (versión preliminar) y se proporciona información general de alto nivel de introducción. Es para desarrolladores de software que trabajan para operadores de telecomunicaciones.
La API de Aprovisionamiento permite configurar Azure Communications Gateway con los detalles de los clientes y los números que tienen asignados. Si usa la API de Aprovisionamiento para sincronización del servicio back-end, también puede aprovisionar los entornos de Operator Connect y Teams Phone Mobile con los detalles de los clientes empresariales y los números que asigne a ellos. Este aprovisionamiento de flujo permite cumplir los requisitos de Operator Connect y Teams Phone Mobile para usar las API a fin de administrar los clientes y números después de iniciar el servicio.
La API de Aprovisionamiento es una API REST.
Si se integra con la API de aprovisionamiento depende del servicio de comunicaciones elegido.
| Servicio de comunicaciones | Integración de la API de Aprovisionamiento | Propósito |
|---|---|---|
| Microsoft Teams Direct Routing | Compatible (como alternativa al Portal de administración de números) | - Configuración del subdominio asociado a cada cliente de enrutamiento directo. - Generación de registros DNS específicos para cada cliente (según sea necesario en el entorno de Microsoft 365). - Indica que los números están habilitados para el enrutamiento directo. - (Opcional) Configuración de un encabezado personalizado para los mensajes en la red. |
| Conexión con operador | Recomendado | - (Recomendado) Aprovisionamiento de flujo a través de los clientes de Operator Connect a través de la interoperación con las API de Operator Connect (mediante la sincronización del servicio back-end). - (Opcional) Configuración de un encabezado personalizado para los mensajes en la red. |
| Teléfono Teams móvil | Recomendado | - (Recomendado) Aprovisionamiento de flujo a través de los clientes de Teams Phone Mobile a través de la interoperación con las API de Operator Connect (mediante la sincronización del servicio back-end). |
| Emparejamiento en la nube de Zoom Phone | Compatible (como alternativa al Portal de administración de números) | - Indica que los números están habilitados para Zoom. - (Opcional) Configuración de un encabezado personalizado para los mensajes en la red. |
| Versión preliminar de Protección de llamadas de operador de Azure | Compatible (como alternativa al Portal de administración de números) | - Indica que los números están habilitados para Protección de llamadas de operador de Azure. - Aprovisionamiento automático de Protección de llamadas de operador de Azure. |
Sugerencia
El Portal de administración de números de Azure Communications Gateway proporciona una función equivalente para el aprovisionamiento manual. Sin embargo, no se puede usar el Portal de administración de números para el aprovisionamiento exhaustivo del flujo de Operator Connect y Teams Phone Mobile después de iniciar el servicio.
Requisitos previos
Es necesario completar la implementación de Azure Communications Gateway.
Debe tener acceso a una máquina con una dirección IP que tenga permiso para acceder a la API de aprovisionamiento (versión preliminar). Esta lista de permitidos de direcciones IP (o intervalos) se configuró como parte de implementación de Azure Communications Gateway.
Obtenga información sobre la API de aprovisionamiento (versión preliminar) y planee los cambios del cliente de BSS.
Para integrar con la API, debe crear (o actualizar) un cliente BSS que pueda ponerse en contacto con la API de Aprovisionamiento. La API de Aprovisionamiento admite un flujo de autenticación de credenciales de cliente OAuth 2.0 máquina a máquina. El cliente se autentica y realiza llamadas API autorizadas como sí mismas, sin la interacción de los usuarios.
Use la información de los conceptos clave y los Ejemplos en la Referencia de API para obtener información sobre los recursos disponibles en la API y las solicitudes que su organización necesita realizar.
- Los recursos de cuenta son descripciones de los clientes de operador (normalmente, una empresa) y la configuración por cliente para el aprovisionamiento de servicios.
- Los recursos de número pertenecen a una cuenta. Describen números, los servicios que usan los números (por ejemplo, enrutamiento directo de Microsoft Teams) y cualquier configuración adicional por número.
- Los recursos de solicitud de información (RFI) son descripciones de los clientes de operador (normalmente una empresa) que han expresado interés en recibir servicio del operador a través de Operator Connect y Teams Phone Mobile.
La API de aprovisionamiento tiene un límite de velocidad de 100 solicitudes por minuto, que se aplica a todos los recursos. Una solicitud por lotes para actualizar varios recursos cuenta como una solicitud.
Configuración del cliente BSS para conectarse a Azure Communications Gateway
La API de aprovisionamiento (versión preliminar) está disponible en el puerto 443 de provapi.<base-domain>, donde <base-domain> es el dominio base del recurso de Azure Communications Gateway.
Sugerencia
Para buscar el dominio base:
- Inicie sesión en Azure Portal.
- Vaya a Información general del recurso Azure Communications Gateway y seleccione Propiedades.
- Busque el campo denominado Dominio.
El registro DNS tiene un período de vida (TTL) de 60 segundos. Cuando se produce un error en una región, Azure actualiza el registro DNS para hacer referencia a otra región, por lo que los clientes que realizan una nueva búsqueda DNS reciben los detalles de la nueva región. Recomendamos garantizar que los clientes puedan realizar una nueva búsqueda DNS y reintentar una solicitud 60 segundos después de un tiempo de espera o una respuesta 5xx.
Use la sección Introducción de la Referencia de API para configurar Azure y el cliente BSS para permitir que el cliente de BSS acceda a la API de Aprovisionamiento.
En los pasos siguientes se resume la configuración de Azure que necesita. Consulte la sección Introducción de la API Reference para obtener detalles completos, incluidos los valores de configuración necesarios.
- Registre el cliente BSS en el mismo inquilino de Azure que la implementación de Azure Communications Gateway. Este proceso crea un registro de aplicación.
- Asígnese como propietario para el registro de la aplicación.
- Configure el registro de aplicaciones con los ámbitos definidos en la Referencia de API. Esta configuración indica a Azure que la aplicación tiene permiso para acceder a la API de Aprovisionamiento.
- Como administrador del inquilino, permita que la aplicación use los roles de aplicación que asignó.