Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 los desarrolladores de software que trabajan para operadores de telecomunicaciones.
La API de aprovisionamiento le permite configurar Azure Communications Gateway con los detalles de los clientes y los números asignados a ellos. Si usa la API de aprovisionamiento para la sincronización del servicio de 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 con los requisitos de Operator Connect y Teams Phone Mobile para usar las APIs para administrar sus clientes y números después de lanzar su 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 API de provisionamiento | Propósito |
|---|---|---|
| Enrutamiento directo de Microsoft Teams | Admitido (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 | Recommended | - (Recomendado) Aprovisionamiento directo de clientes de Operator Connect a través de la interoperación con las APIs de Operator Connect (mediante la sincronización del servicio backend). - (Opcional) Configuración de un encabezado personalizado para los mensajes en la red. |
| Teléfono móvil de Teams | Recommended | - (Recomendado) Aprovisionamiento fluido de los clientes de Teams Phone Mobile mediante la interoperación con las API de Operator Connect (utilizando la sincronización del servicio backend). |
| Interconexión en la Nube de Zoom Phone | Soportado (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. |
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 puede usar el Portal de administración de números para el aprovisionamiento sin interrupciones de Operator Connect y Teams Phone Mobile después de iniciar su servicio.
Prerrequisitos
Debe haber completado 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 direcciones IP permitidas (o rangos) se configuró como parte de la 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 de OAuth 2.0 de máquina a máquina. El cliente se autentica y realiza llamadas API autorizadas como tal, sin la interacción de usuarios.
Use los conceptos clave y la información de ejemplos de la referencia de API para obtener información sobre los recursos disponibles en la API y las solicitudes que su organización necesita realizar.
- Cuenta Los recursos de cuenta son descripciones de clientes de operadores (normalmente, una empresa) y configuraciones específicas por cliente para el aprovisionamiento de servicios.
- Los recursos numéricos 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 del 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 la información general del recurso de Puerta de enlace de comunicaciones de Azure 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. Se recomienda asegurarse de 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 referencia de API para obtener detalles completos, incluidos los valores de configuración necesarios.
- Registre el cliente BSS en el mismo entorno 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ó.