Integrera med Azure Communications Gateways etablerings-API (förhandsversion)
Den här artikeln förklarar när du behöver integrera med Azure Communications Gateways etablerings-API (förhandsversion) och ger en översikt över hur du kommer igång på hög nivå. Den är avsedd för programvaruutvecklare som arbetar för teleoperatörer.
Med etablerings-API:et kan du konfigurera Azure Communications Gateway med information om dina kunder och de nummer som du har tilldelat dem. Om du använder etablerings-API:et för serverdelstjänstsynkronisering kan du även etablera Operatörsanslutning- och Teams Telefon Mobile-miljöer med information om dina företagskunder och de nummer som du allokerar till dem. Med den här genomströmningsetablering kan du uppfylla kraven för Operatörsanslutning och Teams Telefon Mobile att använda API:er för att hantera kunder och nummer när du har lanserat tjänsten.
Etablerings-API:et är ett REST-API.
Om du integrerar med etablerings-API:et beror på din valda kommunikationstjänst.
| Kommunikationstjänst | Etablering av API-integrering | Syfte |
|---|---|---|
| Direktroutning för Microsoft Teams | Stöds (som alternativ till nummerhanteringsportalen) | – Konfigurera den underdomän som är associerad med varje direktdirigeringskund. – Generera DNS-poster som är specifika för varje kund (som krävs av Microsoft 365-miljön). – Anger att tal är aktiverade för direktdirigering. – (Valfritt) Konfigurera en anpassad rubrik för meddelanden till nätverket. |
| Operatörsanslutning | Rekommenderat | - (Rekommenderas) Genomströmningsetablering av Operatörsanslutning kunder via samverkan med Operatörsanslutning API:er (med hjälp av synkronisering av serverdelstjänsten). – (Valfritt) Konfigurera en anpassad rubrik för meddelanden till nätverket. |
| Teams Telefon Mobile | Rekommenderat | – (Rekommenderas) Genomströmningsetablering av Teams Telefon Mobile-kunder via samverkan med Operatörsanslutning API:er (med hjälp av synkronisering av serverdelstjänsten). |
| Zooma Telefon molnpeering | Stöds (som alternativ till nummerhanteringsportalen) | – Anger att tal är aktiverade för Zoom. – (Valfritt) Konfigurera en anpassad rubrik för meddelanden till nätverket. |
| Förhandsversion av Samtalsskydd för Azure-operatör | Stöds (som alternativ till nummerhanteringsportalen) | – Anger att nummer är aktiverade för Azure Operator Call Protection. – Automatisk etablering av Azure Operator Call Protection. |
Dricks
Azure Communications Gateways nummerhanteringsportal tillhandahåller motsvarande funktion för manuell etablering. Du kan dock inte använda number management-portalen för flödesbaserad etablering av Operatörsanslutning och Teams Telefon Mobile när du har lanserat tjänsten.
Förutsättningar
Du måste ha slutfört Distribuera Azure Communications Gateway.
Du måste ha åtkomst till en dator med en IP-adress som har behörighet att komma åt etablerings-API:et (förhandsversion). Den här listan över IP-adresser (eller intervall) konfigurerades som en del av distributionen av Azure Communications Gateway.
Lär dig mer om etablerings-API:et (förhandsversion) och planera dina BSS-klientändringar
För att integrera med API:et måste du skapa (eller uppdatera) en BSS-klient som kan kontakta etablerings-API:et. Etablerings-API:et stöder ett autentiseringsflöde för autentiseringsuppgifter från dator till dator med OAuth 2.0-klientautentiseringsuppgifter . Klienten autentiserar och gör auktoriserade API-anrop som sig själv, utan interaktion med användarna.
Använd information om nyckelbegrepp och exempel i API-referensen för att lära dig mer om de resurser som är tillgängliga via API:et och de begäranden som din organisation behöver göra.
- Kontoresurser är beskrivningar av operatörskunder (vanligtvis ett företag) och inställningar per kund för tjänstetablering.
- Nummerresurser tillhör ett konto. De beskriver tal, de tjänster som talen använder (till exempel Microsoft Teams Direct Routing) och eventuell extra konfiguration per nummer.
- Begäran om informationsresurser (RFI) är beskrivningar av operatörskunder (vanligtvis ett företag) som har uttryckt intresse för att ta emot tjänsten från operatören via Operatörsanslutning och Teams Telefon Mobile.
Etablerings-API:et har en hastighetsgräns på 100 begäranden per minut, som tillämpas på alla resurser. En batchbegäran om att uppdatera flera resurser räknas som en begäran.
Konfigurera BSS-klienten för att ansluta till Azure Communications Gateway
Etablerings-API:et (förhandsversion) är tillgängligt på port 443 i provapi.<base-domain>, där <base-domain> är basdomänen för Azure Communications Gateway-resursen.
Dricks
Så här hittar du basdomänen:
- Logga in på Azure-portalen.
- Gå till Översikt över din Azure Communications Gateway-resurs och välj Egenskaper.
- Leta upp fältet med namnet Domän.
DNS-posten har en time-to-live (TTL) på 60 sekunder. När en region misslyckas uppdaterar Azure DNS-posten så att den refererar till en annan region, så klienter som gör en ny DNS-sökning får information om den nya regionen. Vi rekommenderar att du ser till att klienter kan göra en ny DNS-sökning och försöka igen 60 sekunder efter en timeout eller ett 5xx-svar.
Använd avsnittet Komma igång i API-referensen för att konfigurera Azure och BSS-klienten så att BSS-klienten får åtkomst till etablerings-API:et.
Följande steg sammanfattar den Azure-konfiguration som du behöver. Se avsnittet Komma igång i API-referensen för fullständig information, inklusive nödvändiga konfigurationsvärden.
- Registrera din BSS-klient i samma Azure-klientorganisation som din Azure Communications Gateway-distribution. Den här processen skapar en appregistrering.
- Tilldela dig själv som ägare för appregistreringen.
- Konfigurera appregistreringen med de omfång som definierats i API-referensen. Den här konfigurationen anger för Azure att ditt program har behörighet att komma åt etablerings-API:et.
- Som administratör för klientorganisationen tillåter du att programmet använder de approller som du har tilldelat.