Problemen met Azure Communication Services oplossen

Artikel
11/20/2024

Dit artikel helpt u bij het oplossen van problemen die u mogelijk ondervindt in uw Azure Communication Services-oplossing. Als u problemen met SMS wilt oplossen, kunt u leveringsrapportage met Azure Event Grid inschakelen om details van sms-bezorging vast te leggen.

Hulp vragen

We raden ontwikkelaars aan vragen in te dienen, functies voor te stellen en problemen als problemen te melden. Zie de pagina met speciale ondersteunings- en Help-opties voor meer informatie.

Voor het oplossen van bepaalde problemen hebt u mogelijk een of meer van de volgende informatie nodig:

MS-CV-id: Problemen met oproepen en berichten oplossen.
Oproep-id: Identificeer Azure Communication Services-aanroepen.
Sms-bericht-id: sms-berichten identificeren.
Korte code programma korte id: identificeer een korte code programma korte toepassing.
Korte id van gratis verificatiecampagne: identificeer een gratis verificatiecampagne korte toepassing.
E-mailbericht-id: E-mailaanvragen verzenden identificeren.
Correlatie-id: Aanvragen identificeren die zijn gedaan met behulp van Gespreksautomatisering.
Oproeplogboeken: gebruik de gedetailleerde informatie om problemen met gesprekken en netwerken op te lossen.

Zie Servicelimieten voor meer informatie over beperking en beperkingen.

De MS-CV-id ophalen

U kunt toegang krijgen tot de MS-CV-id door diagnostische gegevens in het clientOptions objectexemplaren te configureren wanneer u uw SDK's initialiseert. U kunt diagnostische gegevens configureren voor elke Azure SDK, waaronder Chat, Identiteit en VoIP-aanroepen.

Voorbeeld van clientopties

In de volgende codefragmenten wordt de configuratie van diagnostische gegevens gedemonstreerd. Wanneer u diagnostische gegevens voor SDK's inschakelt, worden diagnostische gegevens verzonden naar de geconfigureerde gebeurtenislistener.

C#
Python

// 1. Import Azure.Core.Diagnostics
using Azure.Core.Diagnostics;

// 2. Initialize an event source listener instance
using var listener = AzureEventSourceListener.CreateConsoleLogger();
Uri endpoint = new Uri("https://<RESOURCE-NAME>.communication.azure.net");
var (token, communicationUser) = await GetCommunicationUserAndToken();
CommunicationUserCredential communicationUserCredential = new CommunicationUserCredential(token);

// 3. Setup diagnostic settings
var clientOptions = new ChatClientOptions()
{
    Diagnostics =
    {
        LoggedHeaderNames = { "*" },
        LoggedQueryParameters = { "*" },
        IsLoggingContentEnabled = true,
    }
};

// 4. Initialize the ChatClient instance with the clientOptions
ChatClient chatClient = new ChatClient(endpoint, communicationUserCredential, clientOptions);
ChatThreadClient chatThreadClient = await chatClient.CreateChatThreadAsync("Thread Topic", new[] { new ChatThreadMember(communicationUser) });

from azure.communication.chat import ChatClient, CommunicationUserCredential
endpoint = "https://communication-services-sdk-live-tests-for-python.communication.azure.com"
chat_client = ChatClient(
    endpoint,
    CommunicationUserCredential(token),
    http_logging_policy=your_logging_policy)

Toegangs-id's gebruiken voor gespreksautomatisering

Wanneer u problemen met de Call Automation SDK oplost, zoals oproepbeheer of opnameproblemen, moet u de id's verzamelen die helpen bij het identificeren van de mislukte oproep of bewerking. U kunt een van de volgende twee id's opgeven:

Vanuit de header van het API-antwoord. Zoek het veld X-Ms-Skype-Chain-Id.
Vanuit de callback-gebeurtenissen die uw toepassing ontvangt na het uitvoeren van een actie. U kunt bijvoorbeeld de correlatie-id gebruiken CallConnected of PlayFailed zoeken.

.

Naast een van deze id's moet u details opgeven over de foutieve use case en het tijdstempel waarop de fout is opgetreden.

Toegang tot uw clientoproep-id

Wanneer u problemen met spraak- of videogesprekken oplost, moet u mogelijk een call ID. Open deze waarde via de id eigenschap van het call object.

// `call` is an instance of a call created by `callAgent.startCall` or `callAgent.join` methods
console.log(call.id)

// The `call id` property can be retrieved by calling the `call.getCallId()` method on a call object after a call ends
// todo: the code snippet suggests it's a property while the comment suggests it's a method call
print(call.callId)

// The `call id` property can be retrieved by calling the `call.getCallId()` method on a call object after a call ends
// `call` is an instance of a call created by `callAgent.startCall(…)` or `callAgent.join(…)` methods
Log.d(call.getCallId())

De sms-bericht-id ophalen

Voor problemen met sms kunt u de bericht-id van het antwoordobject ophalen.

.NET

// Instantiate the SMS client
const smsClient = new SmsClient(connectionString);
async function main() {
  const result = await smsClient.send({
    from: "+18445792722",
    to: ["+1972xxxxxxx"],
    message: "Hello World 👋🏻 via Sms"
  }, {
    enableDeliveryReport: true // Optional parameter
  });
console.log(result); // your message ID is in the result
}

Toegang tot uw korte code programma korte id

Zoek de korte programma-id in Azure Portal in de sectie Korte codes .

Schermopname van een korte code programma korte id.

Toegang tot uw gratis verificatiecampagne korte id

Zoek de korte programma-id in Azure Portal in de sectie Regelgevingsdocumenten .

Schermopname van een korte id van een gratis verificatiecampagne.

Toegang tot uw e-mailbewerkings-id

Wanneer u problemen met het verzenden van e-mail of statusaanvragen voor e-mailberichten oplost, moet u mogelijk een bewerkings-id opgeven. U hebt toegang tot deze waarde in het antwoord.

.NET

var emailSendOperation = await emailClient.SendAsync(
    wait: WaitUntil.Completed,
    senderAddress: sender,
    recipientAddress: recipient,
    subject: subject,
    htmlContent: htmlContent);

/// Get the OperationId so that it can be used for tracking the message for troubleshooting
Console.WriteLine($"Email operation id = {emailSendOperation.Id}");

Toegang tot ondersteuningsbestanden in de Calling SDK

De Calling SDK biedt handige methoden voor toegang tot de logboekbestanden. Deze bestanden kunnen microsoft-ondersteuningsspecialisten en -technici helpen. U wordt aangeraden deze logboeken te verzamelen wanneer u een probleem detecteert.

Oproeplogboeken inschakelen en openen

Meer informatie over het inschakelen en openen van oproeplogboeken.

JavaScript

De Azure Communication Services Calling SDK is intern afhankelijk van de @azure/loggerbibliotheek om logboekregistratie te beheren.

Gebruik de setLogLevel methode van het pakket om het uitvoerniveau van het @azure/logger logboek te configureren. Maak een logger en geef deze door aan de CallClient constructor.

import { setLogLevel, createClientLogger, AzureLogger } from '@azure/logger';
setLogLevel('verbose');
let logger = createClientLogger('ACS');
const callClient = new CallClient({ logger });

U kunt AzureLogger de logboekuitvoer van Azure SDK's omleiden door de AzureLogger.log methode te overschrijven.

U kunt zich aanmelden bij de browserconsole, een bestand of een buffer. U kunt ook verzenden naar uw eigen service. Als u logboeken via het netwerk naar uw eigen service wilt verzenden, verzendt u geen aanvraag per logboekregel omdat deze methode de browserprestaties nadelig beïnvloedt. Verzamel in plaats daarvan logboeklijnen en verzend ze in batches.

// Redirect log output
AzureLogger.log = (...args) => {
    // To console, file, buffer, REST API, etc...
    console.log(...args); 
};

Systeemeigen SDK (Android/iOS)

Voor Android, iOS en Windows biedt de Azure Communication Services Calling SDK toegang tot logboekbestanden.

Zie de zelfstudie voor toegang tot logboekbestanden voor het aanroepen van systeemeigen SDK's.

UI-bibliotheken (Android, iOS)

Als u de UI-bibliotheken van Azure Communication Services voor Android of iOS gebruikt, kunt u feedback van gebruikers vragen via het ingebouwde ondersteuningsformulier.

Zie de zelfstudie over de integratie van ondersteuningsformulier voor ondersteuningsformulieren voor ondersteuning voor ondersteuningsformulieren voor meer informatie over de ondersteuningsfuncties van het ondersteuningsformulier voor bellen. In dit artikel leest u hoe u de benodigde gebeurtenis-handler toevoegt en een eenvoudige client-/server-implementatie maakt voor gecentraliseerde opslag van ondersteuningsinformatie. In dit artikel wordt het pad beschreven voor integratie met de ondersteuningsservices die uw organisatie gebruikt.

End-to-end-ondersteuningsstromen bouwen in uw ACS-integraties

Of u nu de Calling SDK of de Calling UI SDK gebruikt, en ondersteuning biedt aan uw klanten is een belangrijk onderdeel van elke robuuste integratie.

In het artikel Over gebruikersondersteuning worden de belangrijkste overwegingen op elk punt van de feedbacklus voor ondersteuning gemarkeerd en vindt u springpunten voor meer informatie.

Informatie over Microsoft Entra zoeken

Gebruik de volgende procedures om Microsoft Entra-informatie te vinden.

Een map-id ophalen

Voer de volgende stappen uit om uw map-id (tenant) te vinden:

Meld u aan bij het Azure-portaal.
Selecteer Microsoft Entra ID in het servicemenu.
Kopieer op de pagina Overzicht in Microsoft Entra ID de map-id (tenant-id) en sla deze op in uw toepassingscode.

Een toepassings-id ophalen

Voer de volgende stappen uit om uw toepassings-id te vinden:

Meld u aan bij het Azure-portaal.
Selecteer Microsoft Entra ID in het servicemenu.
Selecteer uw toepassing in App-registraties in Microsoft Entra-id.
Kopieer de toepassings-id (client) en sla deze op in uw toepassingscode.

U kunt ook de map-id (tenant) vinden op de pagina Overzicht van de toepassing.

Een gebruikers-id ophalen

Voer de volgende stappen uit om uw gebruikers-id te vinden:

Meld u aan bij het Azure-portaal.
Selecteer Microsoft Entra ID in het servicemenu.
Selecteer uw gebruiker in Gebruikers in Microsoft Entra-id.
Kopieer op de profielpagina voor Microsoft Entra-gebruikers de object-id en sla deze op in uw toepassingscode.

Een onveranderbare resource-id ophalen

Soms moet u ook de onveranderbare resource-id van uw Azure Communication Services-resource opgeven. Voer de volgende stappen uit om deze te vinden:

Meld u aan bij het Azure-portaal.
Open uw Azure Communication Services-resource.
Selecteer Overzicht in het servicemenu en schakel over naar een JSON-weergave.
Kopieer de immutableResourceId waarde op de pagina Resource JSON en geef deze op aan uw ondersteuningsteam.

Controleren of teams-licentie in aanmerking komt voor het gebruik van Ondersteuning voor Azure Communication Services voor Teams-gebruikers

Er zijn twee manieren om te controleren of uw Teams-licentie in aanmerking komt voor het gebruik van Azure Communication Services-ondersteuning voor Teams-gebruikers.

Verifiëren via teams-webclient

Volg deze stappen om te controleren of uw Teams-licentie in aanmerking komt via de Teams-webclient:

Open uw browser en ga naar de Teams-webclient.
Meld u aan met referenties met een geldige Teams-licentie.
Als de verificatie is geslaagd en u in het https://teams.microsoft.com/ domein blijft, komt uw Teams-licentie in aanmerking. Als de verificatie mislukt of u wordt omgeleid naar het https://teams.live.com/v2/ domein, komt uw Teams-licentie niet in aanmerking voor het gebruik van Azure Communication Services-ondersteuning voor Teams-gebruikers.

Controleer uw huidige Teams-licentie via de Microsoft Graph API

U vindt uw huidige Teams-licentie met behulp van licenseDetails. De Microsoft Graph API retourneert de licenties die aan een gebruiker zijn toegewezen. Volg deze stappen om het hulpprogramma Graph Explorer te gebruiken om licenties weer te geven die aan een gebruiker zijn toegewezen.

Open uw browser en ga naar Graph Explorer.
Meld u aan bij Graph Explorer met behulp van referenties.
Voer in het queryvak de volgende API in en selecteer Query uitvoeren.
```
https://graph.microsoft.com/v1.0/me/licenseDetails
```
U kunt ook een query uitvoeren op een bepaalde gebruiker door de gebruikers-id op te geven met behulp van de volgende API:
```
https://graph.microsoft.com/v1.0/users/{id}/licenseDetails
```

In het voorbeeldvenster Antwoord ziet u uitvoer.

Het antwoordobject dat hier wordt weergegeven, kan worden ingekort voor leesbaarheid.

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('071cc716-8147-4397-a5ba-b2105951cc0b')/assignedLicenses",
    "value": [
        {
            "skuId": "b05e124f-c7cc-45a0-a6aa-8cf78c946968",
            "servicePlans":[
                {
                    "servicePlanId":"57ff2da0-773e-42df-b2af-ffb7a2317929",
                    "servicePlanName":"TEAMS1",
                    "provisioningStatus":"Success",
                    "appliesTo":"User"
                }
            ]
        }
    ]
}

Zoek licentiegegevens waar de servicePlanName eigenschap een van de waarden in de tabel In aanmerking komende Teams-licenties heeft.

Problemen met PSTN-aanroepen van Azure Communication Services oplossen.
Problemen met antwoordcodes voor oproepeinden oplossen voor de Calling SDK, Call Automation SDK, PSTN, Chat SDK en SMS SDK.
Toegang tot logboeken voor spraak en video, chat, e-mail, netwerkkruising, opname, sms en gespreksautomatisering.
Metrische gegevens.
Servicelimieten.

Delen via

Problemen met Azure Communication Services oplossen

Hulp vragen

De MS-CV-id ophalen

Voorbeeld van clientopties

Toegangs-id's gebruiken voor gespreksautomatisering

Toegang tot uw clientoproep-id

De sms-bericht-id ophalen

Toegang tot uw korte code programma korte id

Toegang tot uw gratis verificatiecampagne korte id

Toegang tot uw e-mailbewerkings-id

Toegang tot ondersteuningsbestanden in de Calling SDK

Oproeplogboeken inschakelen en openen

JavaScript

Systeemeigen SDK (Android/iOS)

UI-bibliotheken (Android, iOS)

End-to-end-ondersteuningsstromen bouwen in uw ACS-integraties

Informatie over Microsoft Entra zoeken

Een map-id ophalen

Een toepassings-id ophalen

Een gebruikers-id ophalen

Een onveranderbare resource-id ophalen

Controleren of teams-licentie in aanmerking komt voor het gebruik van Ondersteuning voor Azure Communication Services voor Teams-gebruikers

Verifiëren via teams-webclient

Controleer uw huidige Teams-licentie via de Microsoft Graph API

Feedback

Aanvullende resources

Delen via

Problemen met Azure Communication Services oplossen

Hulp vragen

De MS-CV-id ophalen

Voorbeeld van clientopties

Toegangs-id's gebruiken voor gespreksautomatisering

Toegang tot uw clientoproep-id

De sms-bericht-id ophalen

Toegang tot uw korte code programma korte id

Toegang tot uw gratis verificatiecampagne korte id

Toegang tot uw e-mailbewerkings-id

Toegang tot ondersteuningsbestanden in de Calling SDK

Oproeplogboeken inschakelen en openen

JavaScript

Systeemeigen SDK (Android/iOS)

UI-bibliotheken (Android, iOS)

End-to-end-ondersteuningsstromen bouwen in uw ACS-integraties

Informatie over Microsoft Entra zoeken

Een map-id ophalen

Een toepassings-id ophalen

Een gebruikers-id ophalen

Een onveranderbare resource-id ophalen

Controleren of teams-licentie in aanmerking komt voor het gebruik van Ondersteuning voor Azure Communication Services voor Teams-gebruikers

Verifiëren via teams-webclient

Controleer uw huidige Teams-licentie via de Microsoft Graph API

Gerelateerde inhoud

Feedback

Aanvullende resources