Integreren met de inrichtings-API van Azure Communications Gateway (preview)
In dit artikel wordt uitgelegd wanneer u moet integreren met de Inrichtings-API (preview) van Azure Communications Gateway en een algemeen overzicht biedt van hoe u aan de slag kunt gaan. Het is voor softwareontwikkelaars die voor telecommunicatieoperators werken.
Met de inrichtings-API kunt u Azure Communications Gateway configureren met de details van uw klanten en de nummers die u eraan hebt toegewezen. Als u de inrichtings-API gebruikt voor synchronisatie van back-endservices, kunt u ook de Operator verbinden en Teams Telefoon Mobiele omgevingen inrichten met de details van uw zakelijke klanten en de nummers die u aan hen toewijst. Met deze stroomdoorloopinrichting kunt u voldoen aan de vereiste voor Operator verbinden en Teams Telefoon Mobile om API's te gebruiken om uw klanten en nummers te beheren nadat u uw service hebt gestart.
De inrichtings-API is een REST API.
Of u integreert met de Inrichtings-API, is afhankelijk van de gekozen communicatieservice.
| Communicatieservice | Integratie van inrichtings-API | Doel |
|---|---|---|
| Directe routering van Microsoft Teams | Ondersteund (als alternatief voor de portal voor nummerbeheer) | - Het subdomein configureren dat is gekoppeld aan elke directe routeringsklant. - DNS-records genereren die specifiek zijn voor elke klant (zoals vereist door de Microsoft 365-omgeving). - Geeft aan dat getallen zijn ingeschakeld voor directe routering. - (Optioneel) Een aangepaste header configureren voor berichten naar uw netwerk. |
| Operator verbinden | Aanbevolen | - (Aanbevolen) Stroomdoorloopinrichting van Operator verbinden klanten via interoperation met Operator verbinden API's (met back-endservicesynchronisatie). - (Optioneel) Een aangepaste header configureren voor berichten naar uw netwerk. |
| Teams Telefoon Mobile | Aanbevolen | - (Aanbevolen) Flow-through-inrichting van Teams Telefoon Mobile-klanten via interoperation met Operator verbinden API's (met behulp van back-endservicesynchronisatie). |
| Zoomen Telefoon cloudpeering | Ondersteund (als alternatief voor de portal voor nummerbeheer) | - Geeft aan dat getallen zijn ingeschakeld voor Zoom. - (Optioneel) Een aangepaste header configureren voor berichten naar uw netwerk. |
| Azure Operator Call Protection Preview | Ondersteund (als alternatief voor de portal voor nummerbeheer) | - Hiermee wordt aangegeven dat nummers zijn ingeschakeld voor Azure Operator Call Protection. - Automatische inrichting van Azure Operator Call Protection. |
Tip
De portal voor nummerbeheer van Azure Communications Gateway biedt een equivalente functie voor handmatige inrichting. U kunt de Portal Nummerbeheer echter niet gebruiken voor het grondig inrichten van Operator verbinden en Teams Telefoon Mobile nadat u uw service hebt gestart.
Vereisten
U moet Azure Communications Gateway implementeren hebben voltooid.
U moet toegang hebben tot een computer met een IP-adres dat toegang heeft tot de inrichtings-API (preview). Deze acceptatielijst met IP-adressen (of bereiken) is geconfigureerd als onderdeel van het implementeren van Azure Communications Gateway.
Meer informatie over de inrichtings-API (preview) en het plannen van uw BSS-clientwijzigingen
Als u wilt integreren met de API, moet u een BSS-client maken (of bijwerken) die contact kan opnemen met de inrichtings-API. De inrichtings-API ondersteunt een verificatiestroom voor OAuth 2.0-clientreferenties van machine-naar-machine. Uw client verifieert en voert geautoriseerde API-aanroepen uit als zichzelf, zonder tussenkomst van gebruikers.
Gebruik de belangrijkste concepten en voorbeelden in de API-verwijzing voor meer informatie over de resources die beschikbaar zijn via de API en de aanvragen die uw organisatie moet indienen.
- Accountresources zijn beschrijvingen van operatorklanten (meestal een onderneming) en instellingen per klant voor serviceinrichting.
- Nummerbronnen horen bij een account. Ze beschrijven getallen, de services waarvan de getallen gebruikmaken (bijvoorbeeld directe routering van Microsoft Teams) en eventuele extra configuraties per getal.
- RFI-resources (Request for Information) zijn beschrijvingen van operatorklanten (meestal een onderneming) die interesse hebben getoond in het ontvangen van de service van de operator via Operator verbinden en Teams Telefoon Mobile.
De inrichtings-API heeft een frequentielimiet van 100 aanvragen per minuut, toegepast op alle resources. Een batchaanvraag voor het bijwerken van meerdere resources telt als één aanvraag.
Uw BSS-client configureren om verbinding te maken met Azure Communications Gateway
De inrichtings-API (preview) is beschikbaar op poort 443 van provapi.<base-domain>, waar <base-domain> is het basisdomein van de Azure Communications Gateway-resource.
Tip
Ga als volgende te werk om het basisdomein te vinden:
- Meld u aan bij het Azure-portaal.
- Navigeer naar het overzicht van uw Azure Communications Gateway-resource en selecteer Eigenschappen.
- Zoek het veld met de naam Domein.
De DNS-record heeft een time-to-live (TTL) van 60 seconden. Wanneer een regio mislukt, werkt Azure de DNS-record bij om naar een andere regio te verwijzen, zodat clients die een nieuwe DNS-zoekopdracht maken de details van de nieuwe regio ontvangen. We raden u aan ervoor te zorgen dat clients een nieuwe DNS-zoekopdracht kunnen maken en een aanvraag 60 seconden na een time-out of een 5xx-antwoord opnieuw kunnen proberen.
Gebruik de sectie Aan de slag van de API-verwijzing om Azure en uw BSS-client te configureren om de BSS-client toegang te geven tot de inrichtings-API.
De volgende stappen geven een overzicht van de Azure-configuratie die u nodig hebt. Zie de sectie Aan de slag van de API-verwijzing voor volledige details, inclusief vereiste configuratiewaarden.
- Registreer uw BSS-client in dezelfde Azure-tenant als uw Azure Communications Gateway-implementatie. Met dit proces maakt u een app-registratie.
- Wijs uzelf toe als eigenaar voor de app-registratie.
- Configureer de app-registratie met de bereiken die zijn gedefinieerd in de API-verwijzing. Deze configuratie geeft aan Azure aan dat uw toepassing toegang heeft tot de Inrichtings-API.
- Sta de toepassing toe als beheerder voor de tenant de app-rollen te gebruiken die u hebt toegewezen.