Rychlý start: Konfigurace hlasového směrování prostřednictvím kódu programu
Konfigurujte pravidla pro odchozí hlasové směrování pro přímé směrování Azure Communication Services.
Požadavky
- Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
- Aktivní prostředek komunikační služby. Vytvořte prostředek komunikační služby.
- Plně kvalifikovaný název domény (FQDN) a číslo portu řadiče pro ohraničení relace (SBC) v provozním telefonním systému.
- Ověřený název domény plně kvalifikovaného názvu domény SBC.
Poznámka:
Další příklady použití najdete na SipRoutingClient
GitHubu.
Přidání kontroleru ohraničení relace
V levém podokně v části Hlasové hovory – PSTN vyberte Přímé směrování. Na kartě Řadič ohraničení relace vyberte Konfigurovat.
Zadejte plně kvalifikovaný název domény a signalizační port pro SBC. Mezi požadavky na plně kvalifikovaný název domény SBC patří:
- Doménová část plně kvalifikovaného názvu domény musí být ověřená, než ji můžete přidat do konfigurace přímého směrování, jak je uvedeno výše v požadavcích.
- Certifikát SBC musí odpovídat názvu. Podporují se certifikáty se zástupnými znaky.
- Pro plně kvalifikovaný název domény nemůžete používat
*.onmicrosoft.com
domény a*.azure.com
domény.
Úplný seznam požadavků najdete v tématu Požadavky na infrastrukturu přímého směrování Azure.
Vyberte Další. Pokud je všechno správně nastavené, měl by se na webu Azure Portal zobrazit stav SBC jako Aktivní .
Důležité
Před umístěním nebo příjmem hovorů se ujistěte, že je stav SBC online.
Vytvoření pravidel hlasového směrování
Zadejte název hlasové trasy, zadejte číselný vzor pomocí regulárních výrazů a vyberte SBC pro daný vzor. Tady je několik příkladů základních regulárních výrazů:
^\+\d+$
: Odpovídá telefonnímu číslu s jednou nebo více číslicemi, které začínají znaménkem plus.^\+1(\d{10})$
: Odpovídá telefonnímu číslu s 10 číslicemi za+1
.^\+1(425|206)(\d{7})$
: Odpovídá telefonnímu číslu začínajícímu číslem+1425
nebo+1206
číslicemi, za kterým následuje sedm číslic.^\+0?1234$
: Odpovídá jak telefonním číslu, tak+01234
+1234
telefonním číslu.
Další informace o regulárníchvýrazch
Pro jeden vzor můžete vybrat více sbc. V takovém případě je algoritmus směrování zvolí v náhodném pořadí. Můžete také zadat přesný číselný vzor více než jednou. Vyšší řádek má vyšší prioritu. Pokud nejsou k dispozici všechny sbc přidružené k danému řádku, vybere se další řádek. Tímto způsobem vytvoříte složité scénáře směrování.
Odebrání konfigurace přímého směrování
Odstranění hlasové trasy:
- V levém podokně přejděte v části Hlasové hovory do veřejné telefonní sítě na přímé směrování.
- Na kartě Hlasové trasy zaškrtněte políčka pro trasu (nebo trasy), kterou chcete odstranit.
- Vyberte Odstranit.
Odstranění SBC:
- V levém podokně přejděte v části Hlasové hovory do veřejné telefonní sítě na přímé směrování.
- Na kartě Řadiče ohraničení relace vyberte Konfigurovat.
- Zrušte zaškrtnutí polí plně kvalifikovaného názvu domény a portu pro SBC, které chcete odebrat, a pak vyberte Další.
- Na kartě Hlasové trasy zkontrolujte konfiguraci směrování hlasu. V případě potřeby proveďte změny a pak vyberte Uložit.
Když odeberete SBC, který je přidružený ke hlasové trase, můžete pro trasu zvolit jinou SBC na kartě Hlasové trasy . Hlasová trasa bez SBC se odstraní.
Požadavky
- Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
- Aktivní prostředek služby Communication Services a připojovací řetězec. Vytvořte prostředek komunikační služby.
- Nejnovější verze klientské knihovny .NET Core pro váš operační systém.
- Plně kvalifikovaný název domény (FQDN) a číslo portu řadiče pro ohraničení relace (SBC) v provozním telefonním systému.
- Ověřený název domény plně kvalifikovaného názvu domény SBC.
Konečný kód
Najděte finalizovaný kód pro tento rychlý start na GitHubu.
Další příklady použití najdete také na SipRoutingClient
GitHubu.
Vytvoření aplikace v jazyce C#
V okně konzoly (například příkazový řádek, PowerShell nebo Bash) pomocí dotnet new
příkazu vytvořte novou konzolovou aplikaci:
dotnet new console -o DirectRoutingQuickstart
Tento příkaz vytvoří jednoduchý projekt "Hello World" C# s jedním zdrojovým souborem: Program.cs.
Změňte adresář na nově vytvořenou složku aplikace a pomocí dotnet build
příkazu zkompilujte aplikaci:
cd DirectRoutingQuickstart
dotnet build
Nainstalujte balíček .
I když jste stále v adresáři aplikace, pomocí příkazu nainstalujte klientskou knihovnu dotnet add package
Azure Communication Telefon Numbers pro .NET:
dotnet add package Azure.Communication.PhoneNumbers --version 1.1.0
Přidejte do horní části souboru Program.cs direktivuusing
, která zahrnuje obory názvů:
using Azure.Communication.PhoneNumbers.SipRouting;
Ověření klienta
Ověřování klientů telefonních čísel pomocí připojovací řetězec z prostředku Azure Communication Services:
// Get a connection string to the Azure Communication Services resource.
var connectionString = "<connection_string>";
var client = new SipRoutingClient(connectionString);
Nastavení konfigurace přímého směrování
V požadavcích jste ověřili vlastnictví domény. Dalším postupem je vytvoření kmenů (přidání sbc) a vytvoření hlasových tras.
Vytvoření nebo aktualizace kmenů
Přímé směrování služeb Azure Communication Services umožňuje komunikaci pouze s registrovanými sbcs. Pokud chcete zaregistrovat SBC, potřebujete jeho plně kvalifikovaný název domény a port:
// Register your SBCs by providing their fully qualified domain names and port numbers.
var usSbcFqdn = "sbc.us.contoso.com";
var euSbcFqdn = "sbc.eu.contoso.com";
var sbcPort = 5061;
var usTrunk = new SipTrunk(usSbcFqdn, sbcPort);
var euTrunk = new SipTrunk(euSbcFqdn, sbcPort);
await client.SetTrunksAsync(new List<SipTrunk> { usTrunk, euTrunk });
Vytvoření nebo aktualizace tras
Zadejte pravidla směrování pro odchozí volání. Každé pravidlo se skládá ze dvou částí: vzoru regulárního výrazu, který by měl odpovídat vytočení telefonního čísla, a plně kvalifikovaného názvu domény registrovaného kmene, kde je hovor směrován.
Pořadí tras určuje prioritu tras. První trasa, která odpovídá regulárnímu výrazu, se vybere pro volání.
V tomto příkladu vytvoříte jednu trasu pro čísla, která začínají +1
, a druhou trasu pro čísla začínající pouze +
:
var usRoute = new SipTrunkRoute("UsRoute", "^\\+1(\\d{10})$", trunks: new List<string> { usSbcFqdn });
var defaultRoute = new SipTrunkRoute("DefaultRoute", "^\\+\\d+$", trunks: new List<string> { usSbcFqdn, euSbcFqdn });
await client.SetRoutesAsync(new List<SipTrunkRoute> { usRoute, defaultRoute });
Aktualizace konfigurace přímého směrování
Vlastnosti konkrétního kmene můžete aktualizovat přepsáním záznamu pomocí stejného plně kvalifikovaného názvu domény. Můžete například nastavit novou hodnotu portu SBC:
var usTrunk = new SipTrunk("sbc.us.contoso.com", 5063);
await client.SetTrunkAsync(usTrunk);
Stejnou metodu použijete k vytvoření a aktualizaci pravidel směrování. Při aktualizaci tras odešlete všechny v jedné aktualizaci. Nová konfigurace směrování plně přepíše předchozí konfiguraci.
Odebrání konfigurace přímého směrování
Nemůžete upravit ani odebrat jednu hlasovou trasu. Měli byste přepsat celou konfiguraci směrování hlasu. Tady je příklad prázdného seznamu, který odebere všechny trasy a kmeny:
//delete all configured voice routes
await client.SetRoutesAsync(new List<SipTrunkRoute>());
//delete all trunks
await client.SetTrunksAsync(new List<SipTrunk>());
Následující příklad můžete použít k odstranění jednoho kmene (SBC), pokud ho nepoužívají žádné hlasové trasy. Pokud je SBC uvedený v libovolné hlasové trase, nejprve tuto trasu odstraňte.
await client.DeleteTrunkAsync("sbc.us.contoso.com");
Požadavky
- Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
- Java Development Kit (JDK) verze 8 nebo novější.
- Apache Maven
- Nasazený prostředek komunikační služby a připojovací řetězec. Vytvořte prostředek komunikační služby.
- Plně kvalifikovaný název domény (FQDN) a číslo portu řadiče pro ohraničení relace (SBC) v provozním telefonním systému.
- Ověřený název domény plně kvalifikovaného názvu domény SBC.
Konečný kód
Najděte finalizovaný kód pro tento rychlý start na GitHubu.
Další příklady použití najdete také na SipRoutingClient
GitHubu.
Vytvoření aplikace Java
Otevřete terminál nebo příkazové okno. Přejděte do adresáře, do kterého chcete vytvořit aplikaci v Javě. Potom spuštěním příkazu vygenerujte projekt Java z šablony maven-archetype-quickstart :
mvn archetype:generate -DgroupId=com.communication.quickstart -DartifactId=communication-quickstart -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.4 -DinteractiveMode=false
Úloha generate
vytvořila adresář se stejným názvem jako artifactId
hodnota. V tomto adresáři obsahuje adresář src/main/java zdrojový kód projektu, adresář src/test/java obsahuje zdroj testu a soubor pom.xml je projektový objektový model (POM).
Nainstalujte balíček .
Otevřete soubor pom.xml v textovém editoru. Do skupiny závislostí přidejte následující prvky závislostí:
<dependencies>
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-communication-phonenumbers</artifactId>
<version>1.1.0</version>
</dependency>
</dependencies>
Nastavení architektury aplikace
Z adresáře projektu:
- Přejděte do adresáře /src/main/java/com/communication/quickstart .
- Otevřete soubor App.java v editoru.
- Nahraďte příkaz
System.out.println("Hello world!");
. - Přidat
import
direktivy
Začněte následujícím kódem:
import com.azure.communication.phonenumbers.siprouting.SipRoutingAsyncClient;
import com.azure.communication.phonenumbers.siprouting.SipRoutingClientBuilder;
import com.azure.communication.phonenumbers.siprouting.models.SipTrunk;
import com.azure.communication.phonenumbers.siprouting.models.SipTrunkRoute;
import static java.util.Arrays.asList;
public class App
{
public static void main( String[] args ) throws IOException
{
System.out.println("Azure Communication Services - Direct Routing Quickstart");
// Quickstart code goes here
}
}
Ověření klienta
Pomocí SipRoutingClientBuilder
ověřování Microsoft Entra můžete použít:
// You can find your endpoint and access key from your resource in the Azure portal
String endpoint = "https://<RESOURCE_NAME>.communication.azure.com";
SipRoutingAsyncClient sipRoutingAsyncClient = new SipRoutingClientBuilder()
.endpoint(endpoint)
.credential(new DefaultAzureCredentialBuilder().build())
.buildClient();
Případně k ověření použijte koncový bod a přístupový klíč z komunikačního prostředku:
// You can find your connection string from your resource in the Azure portal
String connectionString = "endpoint=https://<RESOURCE_NAME>.communication.azure.com/;accesskey=<ACCESS_KEY>";
SipRoutingAsyncClient sipRoutingAsyncClient = new SipRoutingClientBuilder()
.connectionString(connectionString)
.buildClient();
Nastavení konfigurace přímého směrování
V požadavcích jste ověřili vlastnictví domény. Dalším postupem je vytvoření kmenů (přidání sbc) a vytvoření hlasových tras.
Vytvoření nebo aktualizace kmenů
Přímé směrování služeb Azure Communication Services umožňuje komunikaci pouze s registrovanými sbcs. Pokud chcete zaregistrovat SBC, potřebujete jeho plně kvalifikovaný název domény a port:
sipRoutingAsyncClient.setTrunksWithResponse(asList(
new SipTrunk("sbc.us.contoso.com", 5061),
new SipTrunk("sbc.eu.contoso.com", 5061)
)).block();
Vytvoření nebo aktualizace tras
Zadejte pravidla směrování pro odchozí volání. Každé pravidlo se skládá ze dvou částí: vzoru regulárního výrazu, který by měl odpovídat vytočení telefonního čísla, a plně kvalifikovaného názvu domény registrovaného kmene, kde je hovor směrován.
Pořadí tras určuje prioritu tras. První trasa, která odpovídá regulárnímu výrazu, se vybere pro volání.
V tomto příkladu vytvoříte jednu trasu pro čísla, která začínají +1
, a druhou trasu pro čísla začínající pouze +
:
sipRoutingAsyncClient.setRoutes(asList(
new SipTrunkRoute("UsRoute", "^\\+1(\\d{10})$").setTrunks(asList("sbc.us.contoso.com")),
new SipTrunkRoute("DefaultRoute", "^\\+\\d+$").setTrunks(asList("sbc.us.contoso.com", "sbc.eu.contoso.com"))
)).block();
Aktualizace konfigurace přímého směrování
Vlastnosti konkrétního kmene můžete aktualizovat přepsáním záznamu pomocí stejného plně kvalifikovaného názvu domény. Můžete například nastavit novou hodnotu portu SBC:
sipRoutingClient.setTrunk(new SipTrunk("sbc.us.contoso.com", 5063));
Stejnou metodu použijete k vytvoření a aktualizaci pravidel směrování. Při aktualizaci tras odešlete všechny v jedné aktualizaci. Nová konfigurace směrování plně přepíše předchozí konfiguraci.
Odebrání konfigurace přímého směrování
Nemůžete upravit ani odebrat jednu hlasovou trasu. Měli byste přepsat celou konfiguraci směrování hlasu. Tady je příklad prázdného seznamu, který odebere všechny trasy a kmeny.
Přidejte dva importy:
import java.util.Collections;
import java.util.List;
Pomocí následujícího kódu odstraňte konfiguraci přímého směrování:
//delete all configured voice routes
System.out.println("Delete all routes");
List<SipTrunkRoute> routes = Collections.<SipTrunkRoute> emptyList();
sipRoutingAsyncClient.setRoutes(routes).block();
//delete all trunks
System.out.println("Delete all trunks");
List<SipTrunk> trunks = Collections.<SipTrunk> emptyList();
sipRoutingAsyncClient.setTrunksWithResponse(trunks).block();
Následující příklad můžete použít k odstranění jednoho kmene (SBC), pokud ho nepoužívají žádné hlasové trasy. Pokud je SBC uvedený v libovolné hlasové trase, nejprve tuto trasu odstraňte.
sipRoutingClient.deleteTrunk("sbc.us.contoso.com");
Spuštění kódu
Přejděte do adresáře, který obsahuje soubor pom.xml , a zkompilujte projekt pomocí následujícího mvn
příkazu:
mvn clean compile
Pak sestavte balíček:
mvn package
Spuštěním následujícího mvn
příkazu spusťte aplikaci:
mvn exec:java -Dexec.mainClass="com.communication.quickstart.App" -Dexec.cleanupDaemonThreads=false
Požadavky
- Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
- Aktivní prostředek služby Communication Services a připojovací řetězec. Vytvořte prostředek komunikační služby.
- Verze LTS active LTS a maintenance LTS node.js pro váš operační systém.
- Plně kvalifikovaný název domény (FQDN) a číslo portu řadiče pro ohraničení relace (SBC) v provozním telefonním systému.
- Ověřený název domény plně kvalifikovaného názvu domény SBC.
Konečný kód
Najděte finalizovaný kód pro tento rychlý start na GitHubu.
Další příklady použití najdete také na SipRoutingClient
GitHubu.
Vytvoření aplikace Node.js
Otevřete terminál nebo příkazové okno, vytvořte pro aplikaci nový adresář a přejděte na něj:
mkdir direct-routing-quickstart && cd direct-routing-quickstart
Spuštěním npm init -y
vytvořte soubor package.json s výchozím nastavením:
npm init -y
Vytvořte soubor s názvem direct-routing-quickstart.js v kořenovém adresáři, který jste vytvořili. Přidejte do něj následující fragment kódu:
async function main() {
// quickstart code will go here
}
main();
Nainstalujte balíček .
npm install
Pomocí příkazu nainstalujte klientskou knihovnu Azure Communication Services Telefon Numbers pro JavaScript:
npm install @azure/communication-phone-numbers --save
Tato --save
možnost přidá knihovnu jako závislost do souboru package.json .
Ověření klienta
Importujte SipRoutingClient
z klientské knihovny a vytvořte instanci pomocí svého připojovací řetězec. Kód načte připojovací řetězec pro prostředek z proměnné prostředí s názvem COMMUNICATION_SERVICES_CONNECTION_STRING
. Zjistěte, jak spravovat připojovací řetězec vašeho prostředku.
Do souboru direct-routing-quickstart.js přidejte následující kód:
const { SipRoutingClient } = require('@azure/communication-phone-numbers');
// This code demonstrates how to fetch your connection string
// from an environment variable.
const connectionString = process.env['COMMUNICATION_SERVICES_CONNECTION_STRING'];
// Instantiate the phone numbers client
const sipRoutingClient = new SipRoutingClient(connectionString);
Nastavení konfigurace přímého směrování
V požadavcích jste ověřili vlastnictví domény. Dalším postupem je vytvoření kmenů (přidání sbc) a vytvoření hlasových tras.
Vytvoření nebo aktualizace kmenů
Přímé směrování služeb Azure Communication Services umožňuje komunikaci pouze s registrovanými sbcs. Pokud chcete zaregistrovat SBC, potřebujete jeho plně kvalifikovaný název domény a port:
await client.setTrunks([
{
fqdn: 'sbc.us.contoso.com',
sipSignalingPort: 5061
},{
fqdn: 'sbc.eu.contoso.com',
sipSignalingPort: 5061
}
]);
Vytvoření nebo aktualizace tras
Zadejte pravidla směrování pro odchozí volání. Každé pravidlo se skládá ze dvou částí: vzoru regulárního výrazu, který by měl odpovídat vytočení telefonního čísla, a plně kvalifikovaného názvu domény registrovaného kmene, kde je hovor směrován.
Pořadí tras určuje prioritu tras. První trasa, která odpovídá regulárnímu výrazu, se vybere pro volání.
V tomto příkladu vytvoříte jednu trasu pro čísla, která začínají +1
, a druhou trasu pro čísla začínající pouze +
:
await client.setRoutes([
{
name: "UsRoute",
description: "route's description",
numberPattern: "^\+1(\d{10})$",
trunks: [ 'sbc.us.contoso.com' ]
},{
name: "DefaultRoute",
description: "route's description",
numberPattern: "^\+\d+$",
trunks: [ 'sbc.us.contoso.com', 'sbc.eu.contoso.com']
}
]);
Aktualizace konfigurace přímého směrování
Vlastnosti konkrétního kmene můžete aktualizovat přepsáním záznamu pomocí stejného plně kvalifikovaného názvu domény. Můžete například nastavit novou hodnotu portu SBC:
await client.setTrunk({
fqdn: 'sbc.us.contoso.com',
sipSignalingPort: 5063
});
Stejnou metodu použijete k vytvoření a aktualizaci pravidel směrování. Při aktualizaci tras odešlete všechny v jedné aktualizaci. Nová konfigurace směrování plně přepíše předchozí konfiguraci.
Odebrání konfigurace přímého směrování
Nemůžete upravit ani odebrat jednu hlasovou trasu. Měli byste přepsat celou konfiguraci směrování hlasu. Tady je příklad prázdného seznamu, který odebere všechny trasy a kmeny:
//delete all configured voice routes
console.log("Deleting all routes...");
await client.setRoutes([]);
//delete all trunks
console.log("Deleting all trunks...");
await client.setTrunks([]);
Následující příklad můžete použít k odstranění jednoho kmene (SBC), pokud ho nepoužívají žádné hlasové trasy. Pokud je SBC uvedený v libovolné hlasové trase, nejprve tuto trasu odstraňte.
await client.deleteTrunk('sbc.us.contoso.com');
Spuštění kódu
node
Pomocí příkazu spusťte kód, který jste přidali do direct-routing-quickstart.js
souboru:
node direct-routing-quickstart.js
Požadavky
- Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
- Python 3.7+.
- Nasazený prostředek komunikační služby a připojovací řetězec. Vytvořte prostředek komunikační služby.
- Plně kvalifikovaný název domény (FQDN) a číslo portu řadiče pro ohraničení relace (SBC) v provozním telefonním systému.
- Ověřený název domény plně kvalifikovaného názvu domény SBC.
Konečný kód
Najděte finalizovaný kód pro tento rychlý start na GitHubu.
Další příklady použití najdete také na SipRoutingClient
GitHubu.
Vytvoření aplikace v Pythonu
Otevřete terminál nebo příkazové okno. Vytvořte pro aplikaci nový adresář a přejděte na něj:
mkdir direct-routing-quickstart && cd direct-routing-quickstart
Pomocí textového editoru vytvořte soubor s názvem direct_routing_sample.py v kořenovém adresáři projektu a přidejte následující kód:
import os
from azure.communication.phonenumbers.siprouting import SipRoutingClient, SipTrunk, SipTrunkRoute
try:
print('Azure Communication Services - Direct Routing Quickstart')
# Quickstart code goes here
except Exception as ex:
print('Exception:')
print(ex)
Zbývající kód rychlého startu přidáte v následujících částech.
Nainstalujte balíček .
I když jste stále v adresáři aplikace, pomocí příkazu nainstalujte klientskou knihovnu pip install
azure Communication Services Správa istrace pro Python:
pip install azure-communication-phonenumbers==1.1.0
Ověření klienta
S SipRoutingClient
, můžete použít ověřování Microsoft Entra. Použití objektu DefaultAzureCredential
je nejjednodušší způsob, jak začít s ID Microsoft Entra a můžete ho pip install
nainstalovat pomocí příkazu:
pip install azure-identity
Vytvoření objektu DefaultAzureCredential
vyžaduje, abyste měli AZURE_CLIENT_ID
, AZURE_CLIENT_SECRET
a AZURE_TENANT_ID
již nastaven jako proměnné prostředí s odpovídajícími hodnotami z vaší registrované aplikace Microsoft Entra. Rychlý způsob, jak získat tyto proměnné prostředí, najdete v tématu Ověřování pomocí Microsoft Entra ID.
Po instalaci azure-identity
knihovny můžete pokračovat v ověřování klienta:
import os
from azure.communication.phonenumbers.siprouting import SipRoutingClient
from azure.identity import DefaultAzureCredential
# You can find your endpoint from your resource in the Azure portal
endpoint = 'https://<RESOURCE_NAME>.communication.azure.com'
try:
print('Azure Communication Services - Direct Routing Quickstart')
credential = DefaultAzureCredential()
sip_routing_client = SipRoutingClient(endpoint, credential)
except Exception as ex:
print('Exception:')
print(ex)
Případně můžete k ověření použít koncový bod a přístupový klíč z komunikačního prostředku:
import os
from azure.communication.phonenumbers.siprouting import SipRoutingClient
# You can find your connection string from your resource in the Azure portal
connection_string = 'https://<RESOURCE_NAME>.communication.azure.com/;accesskey=<YOUR_ACCESS_KEY>'
try:
print('Azure Communication Services - Direct Routing Quickstart')
sip_routing_client = SipRoutingClient.from_connection_string(connection_string)
except Exception as ex:
print('Exception:')
print(ex)
Nastavení konfigurace přímého směrování
V požadavcích jste ověřili vlastnictví domény. Dalším postupem je vytvoření kmenů (přidání sbc) a vytvoření hlasových tras.
Vytvoření nebo aktualizace kmenů
Zaregistrujte sbcs zadáním plně kvalifikovaných názvů domén a čísel portů:
new_trunks = [SipTrunk(fqdn="sbc.us.contoso.com", sip_signaling_port=1234), SipTrunk(fqdn="sbc.eu.contoso.com", sip_signaling_port=1234)]
sip_routing_client.set_trunks(new_trunks)
Vytvoření nebo aktualizace tras
Zadejte pravidla směrování pro odchozí volání. Každé pravidlo se skládá ze dvou částí: vzoru regulárního výrazu, který by měl odpovídat vytočení telefonního čísla, a plně kvalifikovaného názvu domény registrovaného kmene, kde je hovor směrován.
Pořadí tras určuje prioritu tras. První trasa, která odpovídá regulárnímu výrazu, se vybere pro volání.
V tomto příkladu vytvoříte jednu trasu pro čísla, která začínají +1
, a druhou trasu pro čísla začínající pouze +
:
us_route = SipTrunkRoute(name="UsRoute", description="Handle US numbers '+1'", number_pattern="^\\+1(\\d{10})$", trunks=["sbc.us.contoso.com"])
def_route = SipTrunkRoute(name="DefaultRoute", description="Handle all numbers", number_pattern="^\\+\\d+$", trunks=["sbc.us.contoso.com","sbc.eu.contoso.com"])
new_routes = [us_route, def_route]
sip_routing_client.set_routes(new_routes)
Aktualizace konfigurace přímého směrování
Vlastnosti konkrétního kmene můžete aktualizovat přepsáním záznamu pomocí stejného plně kvalifikovaného názvu domény. Můžete například nastavit novou hodnotu portu SBC:
new_trunk = SipTrunk(fqdn="sbc.us.contoso.com", sip_signaling_port=5063)
sip_routing_client.set_trunk(new_trunk)
Stejnou metodu použijete k vytvoření a aktualizaci pravidel směrování. Při aktualizaci tras odešlete všechny v jedné aktualizaci. Nová konfigurace směrování plně přepíše předchozí konfiguraci.
Odebrání konfigurace přímého směrování
Nemůžete upravit ani odebrat jednu hlasovou trasu. Měli byste přepsat celou konfiguraci směrování hlasu. Tady je příklad prázdného seznamu, který odebere všechny trasy a kmeny:
#delete all configured voice routes
print('Deleting all routes...')
sip_routing_client.set_routes([])
#delete all trunks
print('Deleting all trunks...')
sip_routing_client.set_trunks([])
Následující příklad můžete použít k odstranění jednoho kmene (SBC), pokud ho nepoužívají žádné hlasové trasy. Pokud je SBC uvedený v libovolné hlasové trase, nejprve tuto trasu odstraňte.
sip_routing_client.delete_trunk("sbc.us.contoso.com")
Spuštění kódu
Z příkazového řádku konzoly přejděte do adresáře, který obsahuje soubor direct_routing_sample.py . Pak spusťte aplikaci spuštěním následujícího příkazu Pythonu:
python direct_routing_sample.py
Vyčištění prostředků
Pokud chcete vyčistit a odebrat předplatné služby Communication Services, můžete odstranit prostředek nebo skupinu prostředků. Odstraněním skupiny prostředků se odstraní také všechny ostatní prostředky, které jsou k ní přidružené. Přečtěte si další informace o čištění prostředků.
Další kroky
Další informace najdete v následujících článcích:
- Přečtěte si o automatizaci volání pro vytváření pracovních postupů, které směrují a spravují volání do komunikačních služeb.
- Přečtěte si o možnostech volání sady SDK.
- Přečtěte si další informace o tom, jak volání funguje.
- Zavolejte na telefonní číslo pomocí rychlého startu.