Delen via

Problemen met Azure Communication Services oplossen

  • Artikel

Dit document helpt u bij het oplossen van problemen die u mogelijk ondervindt in uw Communication Services-oplossing. Als u sms-problemen wilt oplossen, kunt u bezorgingsrapportage met Event Grid inschakelen om bezorgingsgegevens van sms-berichten vast te leggen.

Hulp krijgen

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: Communication Services-aanroepen identificeren.
  • 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: Bevatten gedetailleerde informatie kan worden gebruikt om problemen met gesprekken en netwerken op te lossen.

Zie Servicelimieten voor meer informatie over beperking en beperkingen.

De MS-CV-id ophalen

U hebt toegang tot de MS-CV-id door diagnostische gegevens in het objectexemplaren te configureren bij het clientOptions initialiseren van uw SDK's. U kunt diagnostische gegevens configureren voor elke Azure-SDK, inclusief 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, kunnen diagnostische gegevens worden verzonden naar de geconfigureerde gebeurtenislistener:

// 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) });

Toegangs-id's vereist voor gespreksautomatisering

Bij het oplossen van problemen met de Call Automation SDK, 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.

  • Zoek het veld X-Ms-Skype-Chain-Idin de header van het API-antwoord.

    Schermopname van antwoordheader met X-Ms-Skype-Chain-Id.

  • Vanaf de callback-gebeurtenissen ontvangt uw toepassing na het uitvoeren van een actie. Zoek bijvoorbeeld CallConnected PlayFailedde correlationID.

    Schermopname van de niet-verbonden oproepgebeurtenis met correlatie-id.

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

Toegang tot uw clientoproep-id

Bij het oplossen van problemen met spraak- of videogesprekken 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)

De sms-bericht-id ophalen

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

// 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 e-mailberichtstatusaanvragen wilt oplossen, moet u mogelijk een operation ID. U hebt toegang tot deze waarde in het antwoord:

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}");

Ondersteuningsbestanden openen in de Aanroepende SDK

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

Oproeplogboeken inschakelen en openen

[JavaScript]

De Azure Communication Services Calling SDK is intern afhankelijk van @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 als volgt 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 gebruiken om de logboekuitvoer van Azure SDK's om te leiden door de AzureLogger.log methode te overschrijven:

U kunt zich aanmelden bij de browserconsole, een bestand, buffer, verzenden naar onze eigen service, enzovoort. Als u logboeken via het netwerk naar uw eigen service wilt verzenden, verzendt u geen aanvraag per logboekregel omdat dit de prestaties van de browser 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 zelfstudies voor toegang tot logboekbestanden voor het aanroepen van systeemeigen SDK's

UI-bibliotheken (Android, iOS)

Als u de uibibliotheken van Azure Communication Services voor Android of iOS gebruikt, kunt u gebruikersfeedback aanvragen via het ingebouwde ondersteuningsformulier.

Voor meer informatie over de ondersteuningsfuncties van het ondersteuningsformulier voor bellende gebruikersinterface raadpleegt u de zelfstudie over de integratie van ondersteuningsformulieren. In dit document wordt u begeleid bij het toevoegen van de benodigde gebeurtenis-handler en het maken van een eenvoudige client-/server-implementatie voor gecentraliseerde opslag van ondersteuningsgegevens. In deze handleiding wordt het pad beschreven voor integratie met de ondersteuningsservices die door uw organisatie worden gebruikt.

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

Of u nu de Calling SDK of calling UI SDK gebruikt, en biedt ondersteuning aan uw klanten is een belangrijk onderdeel van elke robuuste integratie. In het volgende document worden de belangrijkste overwegingen op elk punt van de feedbacklus voor ondersteuning gemarkeerd en vindt u punten om meer te weten te komen.

Gebruikersondersteuning bieden

Microsoft Entra-gegevens zoeken

  • Map-id ophalen
  • Toepassings-id ophalen
  • Gebruikers-id ophalen

Map-id ophalen

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

  1. Navigeer naar Azure Portal en meld u aan bij Azure Portal met behulp van de referenties.

  2. Selecteer in het linkerdeelvenster Microsoft Entra-id.

  3. Kopieer op de overzichtspagina in Microsoft Entra-id de map-id (tenant) en sla deze op in uw toepassingscode.

    Schermopname van het kopiëren van de Microsoft Entra-tenant-id en het opslaan ervan.

Toepassings-id ophalen

Volg deze stappen om uw toepassings-id te vinden:

  1. Navigeer naar Azure Portal en meld u aan bij Azure Portal met behulp van de referenties.

  2. Selecteer in het linkerdeelvenster Microsoft Entra-id.

  3. Selecteer uw toepassing in App-registraties in Microsoft Entra-id.

  4. Kopieer de Toepassings-id en sla deze op in uw toepassingscode.

    Schermopname van het kopiëren van de Microsoft Entra-toepassings-id en het opslaan ervan.

    De map-id (tenant) vindt u ook op de overzichtspagina van de toepassing.

Gebruikers-id ophalen

Volg deze stappen om uw gebruikers-id te vinden:

  1. Navigeer naar Azure Portal en meld u aan bij Azure Portal met behulp van de referenties.

  2. Selecteer in het linkerdeelvenster Microsoft Entra-id.

  3. Selecteer uw gebruiker in Gebruikers in Microsoft Entra-id.

  4. Kopieer vanaf de profielpagina in Microsoft Entra-gebruikers de object-id en sla deze op in uw toepassingscode.

    Schermopname van het kopiëren van microsoft Entra-gebruikers-id en het opslaan ervan.

Onveranderbare resource-id ophalen

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

  1. Navigeer naar Azure Portal en meld u aan bij Azure Portal met behulp van de referenties.
  2. Open uw Communication Service-resource.
  3. Selecteer In het linkerdeelvenster Overzicht en schakel over naar een JSON-weergaveSchermopname van het overschakelen van communicatieresourceoverzicht naar een JSON-weergave.
  4. Kopieer de waarde op de immutableResourceId pagina Resource JSON en geef deze op aan uw ondersteuningsteam. Schermopname van Resource JSON.

Verificatie van de geschiktheid van Teams-licenties voor het gebruik van Azure Communication Services-ondersteuning 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:

  • Verificatie via teams-webclient
  • Uw huidige Teams-licentie controleren via Microsoft Graph API

Verificatie via teams-webclient

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

  1. Open uw browser en navigeer naar de Teams-webclient.
  2. Meld u aan met referenties met een geldige Teams-licentie.
  3. 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.

Uw huidige Teams-licentie controleren via Microsoft Graph API

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

  1. Open uw browser en navigeer naar Graph Explorer

  2. Meld u aan bij Graph Explorer met behulp van de referenties. Schermopname van het aanmelden bij Graph Explorer.

  3. Voer in het queryvak de volgende API in en klik op Query uitvoeren :

    https://graph.microsoft.com/v1.0/me/licenseDetails

    Schermopname van het invoeren van API in Graph Explorer.

    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

  4. In het voorbeeldvenster Antwoord wordt de uitvoer als volgt weergegeven:

    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"
                }
            ]
        }
    ]
}

  5. Licentiedetails zoeken waar de eigenschap servicePlanName een van de waarden in de tabel In aanmerking komende Teams-licenties heeft