Rozwiązywanie problemów z kodami odpowiedzi zakończenia wywołań dla zestawu SDK wywoływania, zestawu SDK usługi Call Automation, PSTN, zestawu SDK czatu i zestawu SMS SDK
W tym artykule opisano rozwiązywanie problemów z kodami odpowiedzi zakończenia wywołań dla wywoływania zestawu SDK, automatyzacji wywołań i wywołań PSTN.
Wskazówki dotyczące rozwiązywania problemów
Podczas rozwiązywania problemów należy wziąć pod uwagę następujące porady:
- Aplikacja nie odbiera
IncomingCall Event Grid
zdarzenia: upewnij się, że punkt końcowy aplikacji jest weryfikowany za pomocą usługi Event Grid podczas tworzenia subskrypcji zdarzeń. Stan aprowizacji subskrypcji zdarzeń jest oznaczony jako powodzenie, jeśli walidacja zakończyła się pomyślnie. - W przypadku błędu
The field CallbackUri is invalid
: Usługa Call Automation nie obsługuje punktów końcowych HTTP. Upewnij się, że adres URL wywołania zwrotnego, który podajesz, obsługuje protokół HTTPS. - Akcja
PlayAudio
nie odtwarza niczego: obecnie tylko format pliku Wave (.wav) jest obsługiwany w przypadku plików audio. Zawartość audio w pliku falowym musi być mono (jednokanałowa), próbki 16-bitowe z częstotliwością próbkowania 16 000 (16 KHz). - Akcje w punktach końcowych PSTN nie działają: w przypadku
CreateCall
numerów telefonów ,Transfer
,AddParticipant
iRedirect
należy ustawićSourceCallerId
element w żądaniu akcji. Jeśli nie używasz routingu bezpośredniego, identyfikator obiektu wywołującego źródło musi być numerem telefonu należącym do zasobu usług komunikacyjnych, aby akcja powiodła się.
Aby uzyskać więcej informacji na temat problemów śledzonych przez zespół produktu, zobacz Znane problemy.
Uwaga
Kategorie komunikatów i wyników wymienione w poniższych tabelach są dostępne w publicznej wersji zapoznawczej. Aby uzyskać więcej informacji, zobacz Uzupełniające warunki korzystania z wersji zapoznawczych platformy Microsoft Azure.
Opis błędów kodów wywołujących i podkodów
Kody błędów, podkody i odpowiadające im kategorie wyników ułatwiają deweloperom identyfikowanie i diagnozowanie błędów. Te kody błędów są widoczne za pośrednictwem właściwości po zakończeniu call.callEndReason
wywołania.
Szczegóły kodu błędu obejmują:
Kod — to 3-cyfrowe liczby całkowite reprezentujące stan odpowiedzi klienta lub serwera. Kategorie kodu:
- Pomyślne odpowiedzi (200-299)
- Błąd klienta (400-499)
- Błąd serwera (500-599)
- Błąd globalny (600–699)
Podkodowanie — są definiowane jako liczba całkowita, gdzie każda liczba wskazuje unikatową przyczynę, specyficzną dla grupy scenariuszy lub konkretnego wyniku scenariusza.
Komunikat — opisuje wynik i zawiera wskazówki, jak rozwiązać problem, jeśli wynik jest niepowodzeniem.
ResultCategory — wskazuje typ błędu. W zależności od kontekstu wartość może mieć Success
wartość , ExpectedError
, UnexpectedClientError
lub UnexpectedServerError
.
Kody błędów i podkody klienta zestawu SDK wywołujące usługi Azure Communication Services
W przypadku błędów klienta, jeśli właściwość resultCategories to ExpectedError
, błąd jest oczekiwany z perspektywy zestawu SDK. Takie błędy są często spotykane w niepowodzeniach warunków wstępnych, takich jak nieprawidłowe argumenty przekazywane przez aplikację lub gdy bieżący stan systemu nie zezwala na wywołanie interfejsu API. Aplikacja powinna sprawdzić przyczynę błędu i logikę wywoływania interfejsu API.
Podkod | Kod | Komunikat | Kategoria wyników | Rada |
---|---|---|---|---|
40101 | 408 | Nie można utworzyć elementu CallAgent. Spróbuj ponownie, jeśli problem będzie się powtarzać, zbierz dzienniki konsoli przeglądarki, .HAR plik i skontaktuj się z pomocą techniczną usług Azure Communication Services. |
Nieoczekiwany błądClient | |
40104 | 408 | Nie można utworzyć elementu CallAgent. Spróbuj ponownie, jeśli problem będzie się powtarzać, zbierz dzienniki konsoli przeglądarki, .HAR plik i skontaktuj się z pomocą techniczną usług Azure Communication Services. |
Nieoczekiwany błądClient | |
40114 | 408 | Nie można nawiązać połączenia z infrastrukturą usług Azure Communication Services. Spróbuj ponownie i sprawdź żądania sieciowe przeglądarki. Jeśli żądania kończą się niepowodzeniem, zbierz dzienniki konsoli przeglądarki, .HAR plik i skontaktuj się z pomocą techniczną usług Azure Communication Services. |
Nieoczekiwany błądClient | Aby uzyskać więcej informacji, zobacz wymagania dotyczące sieci. |
40115 | 412 | Nie można utworzyć klasy CallAgent, nie można zainicjować połączenia z infrastrukturą usług Azure Communication Services. Spróbuj ponownie i sprawdź żądania sieciowe przeglądarki. Jeśli żądania kończą się niepowodzeniem, zbierz dzienniki konsoli przeglądarki, .HAR plik i skontaktuj się z pomocą techniczną usług Azure Communication Services. |
Nieoczekiwany błądClient | Aby uzyskać więcej informacji, zobacz wymagania dotyczące sieci. |
40216 | 500 | Nie można utworzyć elementu CallAgent. Spróbuj ponownie, jeśli problem będzie się powtarzać, zbierz dzienniki konsoli przeglądarki i skontaktuj się z pomocą techniczną usług Azure Communication Services. | Nieoczekiwany błądClient | |
40228 | 409 | Nie można utworzyć klasy CallAgent, wystąpienie klasy CallAgent skojarzone z tą tożsamością już istnieje. Usunąć istniejący obiekt CallAgent lub utworzyć nowy z inną tożsamością. | Oczekiwany błąd | |
40230 | 409 | Nie można utworzyć aplikacji TeamsCallAgent, istnieje już wystąpienie klasy TeamsCallAgent skojarzone z tą tożsamością. Przed utworzeniem nowego należy usunąć istniejącą aplikację TeamsCallAgent. | Oczekiwany błąd | |
40606 | 405 | Nie można wyliczyć prelegentów. Nie można wyliczyć/wybrać głośników w przeglądarce Android Chrome, iOS Safari ani macOS Safari. | Oczekiwany błąd | Wyliczenie/wybór osoby mówiącej nie jest obsługiwane w przeglądarce Android Chrome, iOS Safari ani macOS Safari. System operacyjny automatycznie wybiera głośnik (urządzenie wyjściowe). Dowiedz się więcej o zarządzaniu urządzeniami i sposobach najlepszego rozwiązywania tych problemów. |
40613 | 400 | Nie można uzyskać uprawnień do użycia mikrofonu i/lub kamery, zostało ono odrzucone lub nie powiodło się. Upewnij się, że zezwalaj na uprawnienia w ustawieniach przeglądarki i w ustawieniach systemu operacyjnego. | Oczekiwany błąd | Dowiedz się więcej o tym, jak najlepiej obsługiwać uprawnienia urządzenia. |
40614 | 500 | Nie można poprosić o uprawnienia urządzenia Upewnij się, że zezwalaj na uprawnienia w ustawieniach przeglądarki i w ustawieniach systemu operacyjnego i spróbuj ponownie. Jeśli problem będzie się powtarzać, zbierz dzienniki konsoli przeglądarki i skontaktuj się z pomocą techniczną usług Azure Communication Services. | Nieoczekiwany błądClient | Dowiedz się więcej o tym, jak najlepiej obsługiwać uprawnienia urządzenia. |
41006 | 400 | Nie można zaakceptować połączenia przychodzącego, ale nie jest w stanie Dzwonienie. Zasubskrybuj zdarzenie CallAgent, incomingCall aby zaakceptować połączenie przychodzące. |
Oczekiwany błąd | Zapoznaj się z następującymi artykułami, aby zidentyfikować główną przyczynę problemu - Odbieranie połączenia przychodzącego - Subskrybowanie zdarzeń zestawu SDK |
41007 | 400 | Nie można odrzucić wywołania przychodzącego, ale nie jest w stanie Dzwonienie. Zasubskrybuj zdarzenie CallAgent, incomingCall aby odrzucić połączenie przychodzące. |
Oczekiwany błąd | Zapoznaj się z następującymi artykułami, aby zidentyfikować główną przyczynę problemu - Odbieranie połączenia przychodzącego - Subskrybowanie zdarzeń zestawu SDK |
41015 | 500 | Nie można wyciszyć mikrofonu. Spróbuj ponownie, jeśli problem będzie się powtarzać, zbierz dzienniki konsoli przeglądarki i skontaktuj się z pomocą techniczną usług Azure Communication Services. | Nieoczekiwany błądClient | |
41016 | 400 | Nie można wyciszyć mikrofonu. Spróbuj ponownie, jeśli problem będzie się powtarzać, zbierz dzienniki konsoli przeglądarki i skontaktuj się z pomocą techniczną usług Azure Communication Services. | Nieoczekiwany błądClient | |
41025 | 400 | Nie można uruchomić pliku wideo, wystąpienie LocalVideoStream jest nieprawidłowe lub puste. Przekaż wystąpienie LocalVideoStream. | Oczekiwany błąd | Upewnij się, że obiekt przekazany do uruchomienia wideo jest wystąpieniem LocalVideoStream. Konstruowanie LocalVideoStream obiektu przy użyciu VideoDeviceInfo obiektu lub MediaStream obiektu. Zapoznaj się z następującymi artykułami, aby zidentyfikować główną przyczynę problemu: - Umieszczanie połączenia za pomocą kamery wideo - Uruchamianie i zatrzymywanie wysyłania lokalnego wideo podczas rozmowy - Uzyskiwanie dostępu do nieprzetworzonego wideo |
41027 | 400 | Nie można uruchomić wideo. Wideo zostało już uruchomione. | Oczekiwany błąd | Przydatne linki: - Umieszczanie połączenia za pomocą kamery wideo - Uruchamianie i zatrzymywanie wysyłania lokalnego wideo podczas rozmowy |
41030 | 400 | Nie można zatrzymać wideo. Wideo zostało już zatrzymane. | Oczekiwany błąd | Przydatne linki: - Umieszczanie połączenia za pomocą kamery wideo - Uruchamianie i zatrzymywanie wysyłania lokalnego wideo podczas rozmowy |
41032 | 400 | Nie można zatrzymać wideo, nieprawidłowy argument. LocalVideoStream używany jako dane wejściowe nie jest obecnie wysyłane. | Oczekiwany błąd | LocalVideoStream, który jest wysyłany w wywołaniu, jest przechowywany w tablicy Call.localVideoStreams[] i jest typu Video lub RawMedia . Zapoznaj się z następującymi artykułami, aby zidentyfikować główną przyczynę problemu: - Umieszczanie połączenia za pomocą kamery wideo - Uruchamianie i zatrzymywanie wysyłania lokalnego wideo podczas rozmowy - Uzyskiwanie dostępu do nieprzetworzonego wideo |
41033 | 500 | Nie można wstrzymać połączenia. Spróbuj ponownie, jeśli problem będzie się powtarzać, zbierz dzienniki konsoli przeglądarki i skontaktuj się z pomocą techniczną usług Azure Communication Services. | Nieoczekiwany błądClient | |
41034 | 500 | Nie można wznowić połączenia. Spróbuj ponownie, jeśli problem będzie się powtarzać, zbierz dzienniki konsoli przeglądarki i skontaktuj się z pomocą techniczną usług Azure Communication Services. | Nieoczekiwany błądClient | |
41035 | 400 | Nie można uruchomić udziału ekranu, udział ekranu został już uruchomiony. | Oczekiwany błąd | Dowiedz się więcej na temat uruchamiania i zatrzymywania udostępniania ekranu podczas rozmowy |
41041 | 400 | Nie można zatrzymać udziału ekranu, udział ekranu został już zatrzymany. | Oczekiwany błąd | Dowiedz się więcej na temat uruchamiania i zatrzymywania udostępniania ekranu podczas rozmowy |
41048 | 410 | Nie można uruchomić wideo podczas procesu instalacji połączenia. Upewnij się, że zezwalaj na uprawnienia wideo w ustawieniach przeglądarki i ustawieniach systemu operacyjnego oraz upewnij się, że urządzenie aparatu nie jest używane przez inny proces. | Nieoczekiwany błądClient | - Urządzenie aparatu może być wyłączone w systemie. - Aparat jest używany przez inny proces. |
41056 | 412 | Nie można uruchomić połączenia lub dołączyć do połączenia, zasady głosowe usługi Teams Enterprise nie są włączone dla tego zasobu usług Azure Communication Services. Postępuj zgodnie z samouczkiem online, aby go włączyć. | Oczekiwany błąd | Zobacz, jak umożliwić użytkownikom korzystanie z usługi Enterprise Voice online i system telefoniczny Poczty głosowej w celu włączenia zasad głosowych usługi Teams Enterprise |
41071 | 412 | Nie można uruchomić udziału ekranu, wywołanie nie jest w stanie Połączono. Zasubskrybuj zdarzenie połączenia stateChanged , aby wiedzieć, kiedy połączenie jest połączone. |
Oczekiwany błąd | Przydatne linki: - Sprawdzanie właściwości wywołania - Subskrybowanie zdarzeń zestawu SDK |
41073 | 412 | Nie można pobrać lub ustawić niestandardowego elementu MediaStream. Ta funkcja jest obecnie wyłączona przez usługi Azure Communication Services. | Oczekiwany błąd | |
43000 | 412 | Nie można uruchomić wideo, urządzenie wideo jest używane przez inny proces/aplikację. Zatrzymaj użycie aparatu w innym procesie/aplikacji i spróbuj ponownie. | Oczekiwany błąd | Dowiedz się więcej o tym, jak najlepiej poradzić sobie z aparatem używanym przez inny proces |
43001 | 403 | Nie można uruchomić wideo. Nie udzielono uprawnień do korzystania z wybranego urządzenia wideo. Upewnij się, że uprawnienia urządzenia wideo są dozwolone w ustawieniach przeglądarki i w ustawieniach systemu. | Oczekiwany błąd | Upewnij się, że uprawnienia aparatu są dozwolone w ustawieniach przeglądarki i ustawieniach systemu urządzenia. Upewnij się, że aparaty fotograficzne nie są wyłączone w ustawieniach systemu urządzenia. W systemie macOS upewnij się, że nagrywanie ekranu jest dozwolone z poziomu ustawień systemowych. Przydatne linki: - Żądanie uprawnień urządzenia- Uprawnienia do udostępniania ekranu w systemie macOS - Wyliczanie lub uzyskiwanie dostępu do urządzeń w przeglądarce Safari w systemach macOS i iOS |
43002 | 500 | Nie można uruchomić wideo, nieznany błąd. Spróbuj ponownie. Jeśli problem będzie się powtarzać, skontaktuj się z pomocą techniczną usług Azure Communication Services. | Nieoczekiwany błądClient | |
43004 | 400 | Nie można przełączyć urządzenia wideo, nieprawidłowe dane wejściowe. Dane wejściowe muszą być typu VideoDeviceInfo. | Oczekiwany błąd | Użyj menedżera urządzeń, aby uzyskać listę obiektów VideoDeviceInfo, a następnie użyj obiektu VideoDeviceInfo, aby przełączyć źródło. Dowiedz się więcej na temat uruchamiania i zatrzymywania wysyłania lokalnego wideo podczas rozmowy |
43005 | 400 | Nie można przełączyć urządzenia wideo, nie można przełączyć się na to samo urządzenie wideo, jest już wybrane. | Oczekiwany błąd | |
43013 | 412 | Nie można uruchomić wideo, nie znaleziono żadnych urządzeń wideo. Upewnij się, że urządzenia wideo są podłączone i włączone w ustawieniach systemowych. | Oczekiwany błąd | Upewnij się, że masz podłączoną kamerę i zainstalowaną na urządzeniu. |
43014 | 412 | Nie można uruchomić wideo, błąd podczas żądania strumienia multimediów. Spróbuj ponownie, jeśli problem będzie się powtarzać, skontaktuj się z pomocą techniczną usług Azure Communication Services. | Nieoczekiwany błądClient | |
43015 | 412 | Nie można uruchomić wideo, upłynął limit czasu żądania strumienia multimediów. Zezwalaj na uprawnienia w monicie przeglądarki o dostęp do aparatu i spróbuj ponownie. | Oczekiwany błąd | Ten błąd może wystąpić, jeśli użytkownik nie podejmuje akcji w monicie o uprawnienia przeglądarki, aby zezwolić na dostęp do aparatu. |
43016 | 412 | Nie można uruchomić wideo, uprawnienia odrzucone przez system. Upewnij się, że uprawnienia urządzenia wideo są dozwolone w ustawieniach przeglądarki i w ustawieniach systemu. | Oczekiwany błąd | — Upewnij się, że uprawnienia aparatu są dozwolone w ustawieniach przeglądarki i ustawieniach systemu urządzenia. — Upewnij się, że kamery nie są wyłączone w ustawieniach systemu urządzenia. — W systemie macOS upewnij się, że nagrywanie ekranu jest dozwolone z ustawień systemowych. Przydatne linki: - Żądanie uprawnień urządzenia -Uprawnienia do udostępniania ekranu w systemie macOS - Wyliczanie lub uzyskiwanie dostępu do urządzeń w przeglądarce Safari w systemach macOS i iOS |
43017 | 412 | Nie można uruchomić wideo, nieobsługiwanego strumienia. Spróbuj ponownie, jeśli problem będzie się powtarzać, skontaktuj się z pomocą techniczną usług Azure Communication Services. | Nieoczekiwany błądClient | |
43018 | 412 | Nie można uruchomić wideo, nie można ustawić ograniczeń. Spróbuj ponownie, jeśli problem będzie się powtarzać, skontaktuj się z pomocą techniczną usług Azure Communication Services. | Nieoczekiwany błądClient | Dowiedz się więcej na temat ustawiania ograniczeń wideo |
43019 | 412 | Nie można uruchomić wideo, nie wybrano urządzenia. Upewnij się, że należy przekazać element LocalVideoStream skonstruowany za pomocą elementu VideoDeviceInfo i spróbować ponownie. Jeśli problem będzie się powtarzać, skontaktuj się z pomocą techniczną usług Azure Communication Services. | Nieoczekiwany błądClient | Przydatne linki: - Umieszczanie połączenia za pomocą kamery wideo - Uruchamianie i zatrzymywanie wysyłania lokalnego wideo podczas rozmowy |
43200 | 412 | Nie można renderować strumienia wideo. Ten strumień nie jest dostępny. Zasubskrybuj właściwość isAvailable strumienia, aby otrzymywać powiadomienia, gdy uczestnik zdalny ma swój film wideo, a strumień jest dostępny do renderowania. | Oczekiwany błąd | Przydatne linki: - Renderowanie strumieni wideo/udostępniania ekranu uczestnika zdalnego - Dodawanie wywołania wideo 1:1 do aplikacji - Subskrybowanie zdarzeń zestawu SDK |
43202 | 404 | Nie można renderować strumienia wideo. Ten strumień nie jest już dostępny. Zdalny uczestnik wyłączył swoje wideo. | Oczekiwany błąd | Uczestnik zdalny wyłączył swoje wideo podczas próby utworzenia widoku dla niego. |
43203 | 408 | Nie można renderować strumienia wideo, upłynął limit czasu renderowania podczas oczekiwania na klatki wideo. Spróbuj ponownie, jeśli problem będzie się powtarzać, skontaktuj się z pomocą techniczną usług Azure Communication Services. | Nieoczekiwany błądClient | |
43204 | 500 | Nie można renderować strumienia wideo, nie można subskrybować wideo w infrastrukturze usług Azure Communication Services. Spróbuj ponownie, jeśli problem będzie się powtarzać, skontaktuj się z pomocą techniczną usług Azure Communication Services. | Nieoczekiwany błądClient | |
43209 | 405 | Nie można renderować strumienia wideo, usługa VideoStreamRenderer została usunięta podczas procesu inicjowania. | Oczekiwany błąd | |
43210 | 400 | Nie można usunąć elementu VideoStreamRenderer, ponieważ jest on już usunięty. | Oczekiwany błąd | |
43220 | 400 | Nie można utworzyć widoku, osiągnięto już maksymalną liczbę aktywnych RemoteVideoStream widoków. Możesz usunąć poprzedni, aby utworzyć nowy. |
Oczekiwany błąd | Dowiedz się więcej o tym, jak prawidłowo obsługiwać najlepszą liczbę przychodzących strumieni wideo |
480 | Nie zarejestrowano zdalnego punktu końcowego klienta. | Upewnij się, że zdalny punkt końcowy jest dostępny. | ||
481 | Nie można obsłużyć wywołania przychodzącego. | Prześlij wniosek o pomoc techniczną za pośrednictwem witryny Azure Portal. | ||
487 | Połączenie anulowane, lokalnie odrzucone, zakończone z powodu problemu z niezgodnością punktu końcowego lub nie udało się wygenerować oferty multimediów. | Oczekiwane zachowanie. | ||
490, 491, 496, 497, 498 | Problemy z siecią punktów końcowych lokalnych. | Sprawdź sieć. | ||
503, 504 | Błąd infrastruktury usług komunikacyjnych. | Prześlij wniosek o pomoc techniczną za pośrednictwem witryny Azure Portal. | ||
600 | Zajęty wszędzie. Uczestnik skontaktował się pomyślnie, ale zwrócił sygnał zajęty. | Oczekiwane zachowanie. | ||
603 | Wywołanie globalnie odrzucone przez uczestnika zdalnych usług komunikacyjnych. | Oczekiwane zachowanie. | ||
604 | Nie istnieje nigdzie. Żądany identyfikator URI nie istnieje. | Oczekiwane zachowanie. | ||
606 | Nie do przyjęcia. Uczestnik pomyślnie skontaktował się, ale nie może obsługiwać opisanej sesji. | Oczekiwane zachowanie. |
Opis błędów kodów wywołujących i podkodów
Kody błędów, podkody i odpowiadające im kategorie wyników ułatwiają deweloperom identyfikowanie i diagnozowanie błędów. Te kody błędów są widoczne za pośrednictwem właściwości po zakończeniu call.callEndReason
wywołania.
Szczegóły kodu błędu obejmują:
Kod — to 3-cyfrowe liczby całkowite reprezentujące stan odpowiedzi klienta lub serwera. Kategorie kodu:
- Pomyślne odpowiedzi (200-299)
- Błąd klienta (400-499)
- Błąd serwera (500-599)
- Błąd globalny (600–699)
Podkodowanie — są definiowane jako liczba całkowita, gdzie każda liczba wskazuje unikatową przyczynę, specyficzną dla grupy scenariuszy lub konkretnego wyniku scenariusza.
Komunikat — opisuje wynik i zawiera wskazówki, jak rozwiązać problem, jeśli wynik jest niepowodzeniem.
ResultCategory — wskazuje typ błędu. W zależności od kontekstu wartość może mieć Success
wartość , ExpectedError
, UnexpectedClientError
lub UnexpectedServerError
.
Wywoływanie kodów wywołań końcowych i podkodów
Istnieją różne wyjaśnienia, dlaczego połączenie zakończyło się. Poniżej przedstawiono znaczenie kodów zakończenia wywołań i podkodów, które pokazują, jak wywołanie może się zakończyć.
Podkod | Kod | Komunikat | Kategorie wyników | Rada |
---|---|---|---|---|
0 | 0 | Połączenie zakończyło się pomyślnie przez uczestnika lokalnego. | Powodzenie | |
0 | 487 | Połączenie zakończyło się pomyślnie, ponieważ obiekt wywołujący anulował połączenie. | Powodzenie | |
0 | 603 | Wywołanie zakończyło się pomyślnie, ponieważ zostało odrzucone z wywołania. | Powodzenie | Połączenie zostało zakończone, ponieważ zostało odrzucone przez użytkownika docelowego za pośrednictwem zestawu SDK klienta, funkcji Call Automation, Graph, PSTN lub Teams. |
7 | 496 | Wywołanie zostało zakończone, ponieważ klient nagle stracił połączenie sieciowe i pomimo wielokrotnego ponawiania próby połączenia nie był w stanie nawiązać połączenia | Oczekiwany błąd | Przeglądarka jest w trybie offline lub ma problemy z siecią. Sprawdź połączenie sieciowe przeglądarki i spróbuj ponownie. |
3100 | 410 | Instalacja wywołania nie powiodła się z powodu nieoczekiwanego problemu z siecią na kliencie, sprawdź sieć klienta i ponów próbę. | UnxpectedClientError | Sprawdź konfigurację sieci, upewnij się, że jest ona zgodna z wymaganiami sieci wywołania usługi Azure Communication. |
3101 | 410 | Wywołanie przerwane z powodu nieoczekiwanego problemu z siecią na kliencie, sprawdź sieć klienta i ponów próbę. | UnxpectedClientError | Sprawdź konfigurację sieci, upewnij się, że jest ona zgodna z wymaganiami sieci wywołania usługi Azure Communication. |
3111 | 410 | Instalacja wywołania nie powiodła się, nie można przetworzyć oferty multimediów podczas nawiązywania połączenia. | UnxpectedClientError | Spróbuj ponownie. Jeśli problem będzie się powtarzać, zbierz informacje o wywołaniu, dzienniki klienta, dzienniki konsoli przeglądarki i skontaktuj się z pomocą techniczną usług Azure Communication Services. |
3112 | 410 | Instalacja wywołania nie powiodła się z powodu problemu z konfiguracją sieci po stronie klienta, sprawdź konfigurację sieci klienta i ponów próbę. | Oczekiwany błąd | Dowiedz się więcej o wywołaniu kończącym się podkodem 3112 tutaj. |
4097 | 0 | Połączenie zakończyło się dla wszystkich użytkowników przez organizatora spotkania. | Powodzenie | |
4502 | 490 | Wywołanie nie powiodło się z powodu problemów z łącznością sieciową, przeglądarka nie mogła ukończyć sieciowego żądania HTTP. | Nieoczekiwany błądClient | Klient nie może ukończyć żądania HTTP i odpowiedzi. Spróbuj ponownie. Jeśli problem będzie się powtarzać, zbierz informacje o wywołaniu, dzienniki klienta, dzienniki konsoli przeglądarki i skontaktuj się z pomocą techniczną usług Azure Communication Services. |
4506 | 408 | Upłynął limit czasu połączenia. Sprawdź, czy obiekt wywoływany odebrał i zaakceptował wywołanie. | Nieoczekiwany błądClient | Spróbuj ponownie. Jeśli problem będzie się powtarzać, zbierz informacje o wywołaniu, dzienniki klienta, dzienniki konsoli przeglądarki i skontaktuj się z pomocą techniczną usług Azure Communication Services. |
4507 | 495 | Wywołanie zostało zakończone, ponieważ aplikacja nie dostarczyła prawidłowego tokenu usług Azure Communication Services. | Nieoczekiwany błądClient | Upewnij się, że aplikacja prawidłowo implementuje mechanizm odświeżania tokenów. |
4521 | 0 | Połączenie zakończyło się, ponieważ użytkownik nagle rozłączył się z wywołaniem. Może to być spowodowane zamknięciem przez użytkownika aplikacji, która hostuje wywołanie, na przykład użytkownik przerwał aplikację, zamykając kartę przeglądarki bez odpowiedniego zawieszenia. | Oczekiwany błąd | |
5000 | 0 | Połączenie zakończyło się dla tego uczestnika. Uczestnik został usunięty z konwersacji przez innego uczestnika. | Powodzenie | |
5003 | 0 | Wywołanie zakończyło się pomyślnie, ponieważ wszystkie wywoływane punkty końcowe odrzuciły wywołanie. | Powodzenie | |
5300 | 0 | Połączenie zakończyło się dla tego uczestnika, ponieważ zostało usunięte z konwersacji przez innego uczestnika. | Powodzenie | Wywołanie zakończone dla tego uczestnika, ponieważ inny uczestnik go usunął, może to być inny klient, wywołanie interfejsu API automatyzacji, interfejs API programu Graph. |
5317 | 0 | Uczestnik docelowy został usunięty z powodu aktualizacji roli uczestnika. | Oczekiwany błąd | |
5828 | 403 | Dołączanie nie jest autoryzowane dla spotkania Pokoje, ponieważ użytkownik nie jest częścią listy zapraszanych. | Nieoczekiwany błądClient | |
5829 | 403 | Dołączenie nie jest dozwolone dla spotkania Pokoje poza godziną zakończenia lub przed rozpoczęciem spotkania. | Nieoczekiwany błądClient | |
5830 | 403 | Tylko użytkownik usług komunikacyjnych może dołączyć do spotkania Pokoje. | Oczekiwany błąd | |
7000 | 0 | Wywołanie zostało zakończone przez interfejs API automatyzacji wywołań usługi Azure Communication Service lub bota serwera. | Powodzenie | Połączenie zostało zakończone przez interfejs API automatyzacji wywołań ACS lub bota programu Graph. |
10003 | 487 | Wywołanie zostało anulowane dla tego punktu końcowego użytkownika, ponieważ zostało zaakceptowane w innym miejscu przez inny punkt końcowy. | Powodzenie | Wywołanie zostało zainicjowane dla użytkownika docelowego (wywołanie początkowe, dodawanie uczestnika, przenoszenie), użytkownik docelowy miał wiele aktywnych punktów końcowych w tym samym czasie, przy jednym z użytkowników punktów końcowych zaakceptował wywołanie. Jest to normalne zachowanie. Tylko jeden punkt końcowy może akceptować i łączyć się z wywołaniem. Wszystkie inne punkty końcowe otrzymują kod podrzędny 10003, aby wskazać, że wywołanie zostało już zaakceptowane. |
10004 | 487 | Połączenie zostało anulowane przy przekroczeniu limitu czasu, ponieważ użytkownik docelowy nie zaakceptował ani nie odrzucił go na czas. Upewnij się, że użytkownik zobaczył powiadomienie i/lub aplikację może obsłużyć je automatycznie i spróbować zainicjować to wywołanie ponownie. | Oczekiwany błąd | Połączenie zostało anulowane po wstępnie zdefiniowanym czasie (zwykle 2 minuty), ponieważ użytkownik docelowy nie zaakceptował ani nie odrzucił. |
100000 | 401 | Tożsamość nieuwierzytelnione. Upewnij się, że token usług Azure Communication Services jest prawidłowy i nie wygasł. | Nieoczekiwany błądClient | |
10024 | 487 | Połączenie zakończyło się pomyślnie. Wywołanie odrzucone przez wszystkie wywoływane punkty końcowe. | Powodzenie | Spróbuj ponownie umieścić połączenie. |
10037 | 480 | Użytkownik docelowy nie miał żadnych punktów końcowych zarejestrowanych w usłudze ACS. Upewnij się, że docelowy użytkownik ma co najmniej jeden aktywny punkt końcowy i jest w trybie online. | Oczekiwany błąd | Jeśli użytkownik docelowy korzysta z zestawu SDK wywołującego usługi Azure Communication Services, upewnij się, że zestaw SDK został pomyślnie zainicjowany w aplikacji klienckiej. Jeśli użytkownik docelowy jest użytkownikiem usługi Teams, upewnij się, że jego klient jest w trybie online. Upewnij się, że identyfikator użytkownika docelowego (CommunicationUserIdentifier, MicrosoftTeamsUserIdentifier lub MicrosoftTeamsBotIdentifier) jest poprawny. Jeśli interfejs API user programu Graph ma właściwość department ustawioną MicrosoftTeamsBotIdentifier na Microsoft Communication Application Instance wartość , należy określić. |
10057 | 408 | Wywołanie nie powiodło się. Wywołanie wywoływane nie powiodło się, nie można sfinalizować konfiguracji wywołania, najprawdopodobniej wywołanie wywoływane straciło sieć lub nagle przerwało aplikację. Upewnij się, że klienci są połączeni i są dostępni. | Oczekiwany błąd | |
10076 | 480 | Użytkownik docelowy został zarejestrowany, ale nie był w trybie online w momencie wywołania. Upewnij się, że docelowy użytkownik ma co najmniej jeden aktywny punkt końcowy i jest w trybie online. | Oczekiwany błąd | Jeśli użytkownik docelowy korzysta z zestawu SDK wywołującego usługi Azure Communication Services, upewnij się, że zestaw SDK został pomyślnie zainicjowany w aplikacji klienckiej, a ich punkt końcowy jest w trybie online. Jeśli użytkownik docelowy jest użytkownikiem usługi Teams, upewnij się, że jego klient jest w trybie online. |
10077 | 480 | Użytkownik docelowy został zarejestrowany w usłudze ACS i/lub w przypadku powiadomień wypychanych, ale nie był w trybie online w momencie wywołania. Upewnij się, że docelowy użytkownik ma co najmniej jeden aktywny punkt końcowy i jest w trybie online. | Oczekiwany błąd | Jeśli użytkownik docelowy korzysta z zestawu SDK wywołującego usługi Azure Communication Services, upewnij się, że zestaw SDK został pomyślnie zainicjowany w aplikacji klienckiej, a ich punkt końcowy jest w trybie online. Jeśli aplikacja korzysta z powiadomień wypychanych, upewnij się, że są one poprawnie skonfigurowane. Jeśli użytkownik docelowy jest użytkownikiem usługi Teams, upewnij się, że jego klient jest w trybie online. |
10078 | 480 | Zdalny punkt końcowy klienta nie jest zarejestrowany lub nieosiągalny. Upewnij się, że zdalny punkt końcowy klienta pomyślnie wysyła żądania sieciowe do usług Azure Communication Services. | Oczekiwany błąd | — Jeśli użytkownik docelowy korzysta z zestawu SDK wywołującego usługi Azure Communication Services, upewnij się, że zestaw SDK został pomyślnie zainicjowany w aplikacji klienckiej, a ich punkt końcowy jest w trybie online. Jeśli aplikacja korzysta z powiadomień wypychanych, upewnij się, że są one poprawnie skonfigurowane. — Jeśli użytkownik docelowy jest użytkownikiem usługi Teams, upewnij się, że jego klient jest w trybie online. |
301004 | 410 | Uczestnik został usunięty z wywołania przez infrastrukturę usług Azure Communication Services ze względu na niezdolność do nawiązywania łączności multimediów z infrastrukturą usług Azure Communication Services podczas konfigurowania połączeń. Sprawdź konfigurację sieci użytkownika, w tym sieć lokalną, zapory, konfigurację sieci VPN i spróbuj ponownie. | Nieoczekiwany błądClient | Upewnij się, że sieć użytkownika jest poprawnie skonfigurowana, postępuj zgodnie z publiczną dokumentacją "Zalecenia dotyczące sieci". |
301005 | 410 | Uczestnik został usunięty z wywołania przez infrastrukturę usług Azure Communication Services z powodu utraty łączności multimediów z tą samą infrastrukturą. Dzieje się tak zwykle, jeśli uczestnik nagle opuszcza połączenie lub traci łączność sieciową. Jeśli uczestnik chce kontynuować połączenie, może ponownie nawiązać połączenie. | Nieoczekiwany błądClient | Upewnij się, że używasz najnowszego zestawu SDK w obsługiwanym środowisku. |
540000 | 0 | Połączenie zakończyło się pomyślnie przez lokalnego wywołującego PSTN. | Powodzenie | |
510403 | 403 | Połączenie zostało zakończone, wcześniej oznaczone jako spam i teraz zablokowane. | Oczekiwany błąd | — Upewnij się, że token usług komunikacyjnych jest prawidłowy i nie wygasł. - Upewnij się, że należy przekazać opcje AlternateId wywołania. |
540487 | 487 | Połączenie zakończyło się pomyślnie, ponieważ obiekt wywołujący anulował połączenie. | Powodzenie | |
560000 | 0 | Połączenie zakończyło się pomyślnie przez zdalnego uczestnika PSTN. | Powodzenie | Możliwe przyczyny: — Użytkownik zakończył połączenie. - Wywołanie zakończone przez agenta multimediów. |
560486 | 486 | Połączenie zostało zakończone, ponieważ zdalny uczestnik PSTN był zajęty. Wywołano już numer lub wystąpiły problemy techniczne. | Powodzenie | — W przypadku wywołań routingu bezpośredniego sprawdź konfigurację ustawień i ustawień i limitów czasu kontroli granic sesji. Możliwe przyczyny: numer o nazwie był już w wywołaniu lub wystąpiły problemy techniczne. |
404 | Nie można odnaleźć połączenia. | Upewnij się, że numer, który wywołujesz (lub połączenie), istnieje. | ||
408 | Upłynął limit czasu kontrolera połączeń. | Upłynął limit czasu oczekiwania kontrolera wywołań na komunikaty protokołu z punktów końcowych użytkownika. Upewnij się, że klienci są połączeni i są dostępni. | ||
410 | Błąd stosu multimediów lokalnych lub infrastruktury multimediów. | Upewnij się, że używasz najnowszego zestawu SDK w obsługiwanym środowisku. | ||
430 | Nie można dostarczyć komunikatu do aplikacji klienckiej. | Upewnij się, że aplikacja kliencka jest uruchomiona i dostępna. | ||
480 | Nie zarejestrowano zdalnego punktu końcowego klienta. | Upewnij się, że zdalny punkt końcowy jest dostępny. | ||
481 | Nie można obsłużyć wywołania przychodzącego. | Prześlij wniosek o pomoc techniczną za pośrednictwem witryny Azure Portal. | ||
490, 491, 496, 497, 498 | Problemy z siecią punktów końcowych lokalnych. | Sprawdź konfigurację sieci, upewnij się, że jest ona zgodna z wymaganiami sieci wywołania usługi Azure Communication. | ||
500, 503, 504 | Błąd infrastruktury usług komunikacyjnych. | Prześlij wniosek o pomoc techniczną za pośrednictwem witryny Azure Portal. |
Opis kodów wywołujących i podkodów
Kiedy są odbierane kody błędów?
Kody błędów dla usługi Call Automation mogą pochodzić jako synchroniczne odpowiedzi na wywołania interfejsu API lub odpowiedzi asynchroniczne za pośrednictwem podanego identyfikatora URI wywołania zwrotnego. W sytuacji synchronicznej, jeśli wywołanie interfejsu API zostanie wykonane i nie zostanie zaakceptowane, usługa ACS udostępni kod błędu opisujący, dlaczego wywołanie interfejsu API zostało odrzucone. W scenariuszach asynchronicznych, jeśli zostało wykonane wywołanie interfejsu API i jest akceptowane, ale coś nadal pójdzie nie tak, zarówno zdarzenie wywołania zwrotnego, jak i kod błędu są odbierane. Przykładem typowego zdarzenia wywołania zwrotnego dla niepowodzeń wywołań jest callDisconnected
zdarzenie, które jest wyświetlane za każdym razem, gdy wywołanie zostanie rozłączone. Po odebraniu callDisconnected
zdarzenia nie będzie więcej zdarzeń wywołania zwrotnego dla danego wywołania. Aby uzyskać listę zdarzeń wywołania zwrotnego sygnalizujących wywołanie zwrotne, zobacz (ta strona) i lista zdarzeń wywołania zwrotnego dla akcji multimedialnych zobacz (ta strona).
Składnia kodu błędu
Kody błędów, podkody i odpowiadające im kategorie wyników ułatwiają deweloperom identyfikowanie i diagnozowanie błędów. Szczegóły kodu błędu obejmują:
Kod — to 3-cyfrowe liczby całkowite reprezentujące stan odpowiedzi klienta lub serwera. Kategorie kodu:
- Pomyślne odpowiedzi (200-299)
- Błąd klienta (400-499)
- Błąd serwera (500-599)
- Błąd globalny (600–699)
Podkodowanie — są definiowane jako liczba całkowita, gdzie każda liczba wskazuje unikatową przyczynę, specyficzną dla grupy scenariuszy lub konkretnego wyniku scenariusza.
Komunikat — opisuje wynik i zawiera wskazówki, jak rozwiązać problem, jeśli wynik jest błędem.
Oprócz kodu i podkodu można znaleźć bardziej szczegółowe informacje dotyczące rozwiązywania problemów w dziennikach wywołań. Aby dowiedzieć się więcej na temat włączania i uzyskiwania dostępu do dzienników połączeń telefonicznych, zobacz tę stronę , aby uzyskać szczegółowe wskazówki.
Kody błędów zestawu SDK usługi Call Automation
Poniższa tabela zawiera najbardziej typowe kody i podkody. Jeśli błąd nie znajduje się w tej tabeli, zapoznaj się z kodami ogólnymi i kodami podrzędnymi, aby uzyskać więcej informacji na temat konkretnego scenariusza.
Najczęstsze kody błędów automatyzacji wywołań
Kod | Podkod | opis | Ograniczanie ryzyka |
---|---|---|---|
404 | 8522 | Ogólny kod błędu wskazujący, że zasób nie został znaleziony. Zasoby mogą obejmować połączenia i uczestników. | Sprawdź stan połączenia: połączenie mogło już zostać zakończone lub uczestnik opuścił połączenie. |
400 | 8523 | Ogólny kod błędu wskazujący, że coś w treści żądania jest nieprawidłowe. | Upewnij się, że wszystkie parametry są prawidłowe. Zapoznaj się z komunikatem o błędzie, aby określić, który parametr zgłasza błąd. |
400 | 8501 | Nie nawiązane wywołanie nieobsługiwane akcji | Akcja skojarzona z komunikatem o błędzie została aktywowana, gdy wywołanie nie było aktywne. Upewnij się, że nowe akcje wywołania nie są inicjowane po rozłączeniu wywołania. Ten błąd może również wynikać z akcji wywoływanych, gdy wywołanie jest aktywne, jeśli zbliża się do czasu rozłączenia wywołania. |
400 | 8500 | Nieprawidłowy tryb multimediów | Sprawdź stan operacji multimedialnych, aby sprawdzić, czy którykolwiek z nich jest już aktywny lub czy uczestnik docelowy jest już w operacji nośnika. Jeśli jest aktywna operacja multimediów, poczekaj na zakończenie operacji, a następnie ponów próbę. |
400 | 8559 | Akcja nieobsługiwana tylko jedna aplikacja wybierania numerów jest dozwolona | Zduplikowane żądanie rozpoczęcia nagrywania, nagranie zostało już zainicjowane lub w toku. Dokładnie sprawdź stan rejestrowania, aby upewnić się, że jest on nieaktywny przed przesłaniem nowego wywołania rozpoczęcia nagrywania. |
400 | 8528 | Akcja nieobsługiwana wywołanie zostało zakończone | Akcja skojarzona z komunikatem o błędzie została aktywowana, gdy wywołanie zostało zakończone. Upewnij się, że nowe akcje wywołania nie są inicjowane po zakończeniu wywołania. Ten błąd może również wynikać z akcji wywoływanych, gdy wywołanie jest aktywne, jeśli zbliża się do czasu zakończenia wywołania. |
409 | 8519 | Konflikt | Upewnij się, że wiele akcji nie jest wykonywanych równolegle na tym samym zasobie. Zapoznaj się z komunikatem o błędzie, aby określić, które dwie akcje są w konflikcie. |
403 | 7507 | Nieprawidłowa tożsamość źródła wywołania | Tożsamość aplikacji z tokenu autoryzacji nie jest zgodna z tożsamością aplikacji w źródle wywołań. Upewnij się, że używasz parametry połączenia z zasobu ACS, w którym skonfigurowano element webhook połączenia przychodzącego (numer telefonu musi być własnością tego samego zasobu usługi ACS odbierającego połączenie). |
403 | 7504 | Niewystarczające uprawnienia aplikacji | Kod ogólny dotyczący niewystarczających uprawnień, sprawdź komunikat o błędzie w kontekście tego, jakiego zasobu brakuje uprawnień. |
400 | 8585 | Akcja jest nieprawidłowa w bieżącym stanie wywołania | Połączenie nie zostało nawiązane lub zostało rozłączone: poczekaj na nawiązanie połączenia przed ponowieniem próby wykonania akcji nośnika. |
405 | 8520 | Obecnie nieobsługiwane funkcje | Oczekiwany błąd: Przepływ pracy nie jest obecnie obsługiwany. Sprawdź nasz blog o wersji, aby sprawdzić, czy istnieje zaktualizowany zestaw SDK, który włączył te funkcje. Aby uzyskać listę nieobsługiwanych przepływów pracy, zobacz stronę Znane ograniczenia usługi Call Automation. |
412 | 8583 | Warunek wstępny nie powiódł się | Odwołaj się do tej strony z listą niezgodnych akcji multimedialnych, aby upewnić się, że nie uruchamiasz ani nie kolejkujesz niezgodnych akcji. |
400 | 8567 | Nie włączono jednostki usługi zasobów ACS | Zasób usługi Azure Cognitive Service nie jest poprawnie skonfigurowany. Zobacz tę stronę , aby zapoznać się z przewodnikiem dotyczącym konfigurowania zasobu usługi Azure Cognitive Service. |
405 | 8522 | Brak konfiguracji | Sprawdź komunikat o błędzie, aby uzyskać więcej kontekstu, w którym należy ustanowić konfigurację. Ta konfiguracja musi wystąpić podczas wywoływania interfejsu API AnswerCall. |
Kody błędów ogólnych
Kody 2xx
Kod 2xx reprezentuje pomyślną odpowiedź. Kod podrzędny pomyślnej odpowiedzi będzie wynosić 0.
Kody 4xx
Kod 4xx reprezentuje błąd klienta.
Kod stanu | opis |
---|---|
400 | Nieprawidłowe żądanie |
401 | Brak autoryzacji |
403 | Dostęp zabroniony |
404 | Nie znaleziono |
405 | Niedozwolona metoda |
406 | Nie do przyjęcia |
408 | Przekroczono limit czasu |
409 | Konflikt |
412 | Warunek wstępny nie powiódł się |
413 | Zbyt duża jednostka żądania |
426 | Wymagane uaktualnienie |
429 | Zbyt wiele żądań |
481 | Transakcja nie istnieje |
487 | Anulowany |
Kody 5xx
Kod 5xx reprezentuje błąd serwera.
Kod stanu | opis |
---|---|
500 | Wewnętrzny błąd serwera. |
501 | Nie zaimplementowano |
502 | Zła brama |
503 | Usługa niedostępna |
504 | Limit czasu bramy |
Kody 6xx
Kod 6xx reprezentuje błąd globalny.
Kod stanu | opis |
---|---|
603 | Odrzucone |
Ogólne podkody
Podkod | opis |
---|---|
0 | Powodzenie |
7000 | Pełen wdzięku |
7500 | Nieobsługiwana tożsamość usługi AAD |
7501 | Nieprawidłowy token |
7502 | Nie włączono dostępu |
7504 | Niewystarczające uprawnienia aplikacji |
7505 | Niezgodność dzierżawy przedsiębiorstwa |
7506 | Niezaufany certyfikat |
7507 | Nieprawidłowa tożsamość źródła wywołania |
7508 | Nieobsługiwana tożsamość usługi ACS |
7509 | Błąd walidacji Hmac |
7510 | Błąd weryfikacji tożsamości zarządzanej |
7600 | Nie włączono dostępu do zasobów |
7601 | Nieprawidłowa tożsamość źródłowa usługi ACS |
7602 | Nieprawidłowa tożsamość docelowa usługi ACS |
7603 | Nieprawidłowa tożsamość usługi ACS |
7604 | Scenariusz międzyoperatoryzowany dla zespołów nieautoryzowanych |
7605 | Scenariusz międzyoperacyjnej rejestracji nieautoryzowanych zespołów |
7606 | Nieautoryzowany zasób ACS dla akcji poznawczych |
8500 | Nieprawidłowy tryb multimediów |
8501 | Nie nawiązaliśmy połączenia |
8502 | Mój identyfikator uczestnika jest niedostępny |
8503 | Nieaktywne wywoływanie dźwięku stanu multimediów |
8504 | Strumienie multimediów są niedostępne |
8505 | Wielu uczestników z zastąpieniem |
8506 | Połączenie rejestrowania niezgodności |
8508 | Operacja anulowana |
8509 | Osiągnięto maksymalny limit czasu ciszy |
8510 | Osiągnięto limit czasu początkowej ciszy |
8511 | Monit odtwarzania nie powiódł się |
8512 | Odtwórz sygnał dźwiękowy nie powiódł się |
8513 | Limit czasu odbierania multimediów |
8514 | Wykryto zatrzymanie tonu |
8515 | Osiągnięto maksymalny czas trwania rekordu |
8516 | Ograniczanie wywołań |
8517 | Niezgodność identyfikatora dzierżawy |
8518 | Wyjątek wywołania |
8519 | Konflikt |
8520 | Nie zaimplementowano |
8521 | Zbyt wiele przeskoków |
8522 | Nie znaleziono |
8523 | Nieprawidłowy argument |
8524 | Nieprawidłowa liczba uczestników na potrzeby rejestrowania zgodności |
8525 | Nie zarejestrowana strona |
8526 | Nieprawidłowy token sprzężenia |
8527 | Nieprawidłowy adres URL sprzężenia |
8528 | Połączenie zostało zakończone |
8529 | Osiągnięto limit miesięczny z ograniczaniem wywołań |
8530 | Osiągnięto limit wywołań z ograniczeniami wywołań aktywnych |
8531 | Maksymalna liczba odebranych cyfr |
8532 | Osiągnięto limit czasu między cyframi |
8533 | Dopasowana opcja Dtmf |
8534 | Wprowadzony nieprawidłowy ton |
8535 | Nieprawidłowy format pliku |
8536 | Pobieranie pliku nie powiodło się |
8537 | Osiągnięto limit czasu utrzymania aktywności |
8538 | Odrzucono obiekt wywoływany |
8539 | Wywoływanie zajęte |
8540 | Wywoływanie zajęte wszędzie |
8541 | Wywoływanie niedostępne |
8542 | Anulowano połączenie |
8543 | Wywołanie nie istnieje |
8544 | Wywoływanie niemożliwym do osiągnięcia |
8545 | Dopasowana opcja mowy |
8546 | Wywoływane wysłane nieprawidłowe żądanie |
8547 | Opcja mowy nie jest dopasowana |
8548 | Połączenie nie jest wywołaniem grupy |
8549 | Nie można utworzyć konwersacji retarget |
8550 | Nie można wynegocjować nośnika retarget |
8551 | Nieobsługiwane retarget |
8552 | Nie można usunąć organizatora |
8553 | Zduplikowane nagranie |
8554 | Uczestnik z konferencji Audio Mix |
8555 | Retarget już w toku |
8556 | Akcja nieobsługiwana w przypadku wywołania CR |
8557 | Nieprawidłowy typ formatu |
8558 | Uczestnik nie jest obecny |
8559 | Duplikowanie pojedynczego wybierania numerów |
8560 | Dołącz do konwersacji zablokowanej z powodu zablokowanego spotkania |
8561 | Nieprawidłowy identyfikator spotkania dołączenia |
8562 | Tryb nagrywania nie jest obsługiwany |
8563 | Rozpoznawanie mowy nie jest rozpoznawane |
8564 | Błąd połączenia z usługą rozpoznawania mowy |
8565 | Błąd usług Cognitive Services |
8566 | Nie można cofnąć operacji wyciszenie |
8567 | Nie włączono jednostki usługi zasobów ACS |
8568 | Tożsamość zarządzana dla żądania usługi Cognitive Service nie powiodła się |
8571 | Konflikt operacji nagrywania |
8569 | Rozpoznawanie mowy |
8570 | Błąd rozpoznawania mowy w usługach Cognitive Services |
8572 | Zamykanie usługi odtwarzania |
8573 | Wstrzymaj wznawianie, metoda niedozwolona |
8578 | Transkrypcja nie powiodła się |
8579 | Anulowano transkrypcję |
8580 | Zamykanie usługi transkrypcji |
8581 | Nieprawidłowy adres URL strumienia |
8582 | Odtwórz tekst źródłowy lub pusty Ssml |
8583 | Warunek wstępny nie powiódł się |
8585 | Akcja jest nieprawidłowa w bieżącym stanie wywołania |
8586 | Połączenie przychodzące nie jest potwierdzane przez bota |
8587 | Nie odebrano połączenia przychodzącego w czasie |
8588 | Ukończono rekord i przekroczenie limitu czasu odbierania multimediów |
8589 | Ograniczanie rekordu |
8594 | Aktualizowanie stanu spotkania nie powiodło się |
8603 | Przesyłanie strumieniowe multimediów nie powiodło się |
8604 | Anulowano przesyłanie strumieniowe multimediów |
8605 | Niestandardowy model mowy transkrypcji nie jest obsługiwany |
8606 | Tworzenie identyfikatora komunikacji nie powiodło się |
8607 | Konflikt operacji transferu |
8608 | Błąd klienta uczestnika rejestrowania |
8609 | Nieprawidłowa odpowiedź sprzężenia z bota |
8610 | Brak odpowiedzi bota na powiadomienie |
8613 | Osiągnięto limit podpisów na żywo z ograniczeniami wywołań |
9001 | Nieznany błąd z usługi bazowej |
9002 | Błąd przekroczenia limitu czasu z usługi bazowej |
9003 | Błąd anulowanej operacji |
9998 | Błąd krytyczny |
9999 | Nieznane |
Kody odpowiedzi wywołań PSTN za pomocą elementu ParticipantEndReason
Ta sekcja zawiera informacje dotyczące rozwiązywania problemów dla różnych kombinacji ParticipantEndReason
kodów odpowiedzi i ParticipantEndSubCode
. W przypadku tabel w tej sekcji kod ParticipantEndReason
= i = ParticipantEndSubCode
podkodowanie.
UczestnikEndReason 0
Odpowiedź ParticipantEndReason
z wartością 0 zwykle oznacza zwykłe czyszczenie wywołań i oznacza wywołania zakończone bez błędów.
SubCode | Kod | Komunikat | Kategorie wyników | Rada |
---|---|---|---|---|
0 | 0 | Połączenie zakończyło się pomyślnie przez uczestnika lokalnego. | Powodzenie | |
560000 | 0 | Normalne zakończenie wywołania PSTN: — Użytkownik zakończył połączenie. - Wywołanie zakończone przez agenta multimediów. |
Powodzenie | |
540000 | 0 | Normalne zakończenie wywołania PSTN: — Użytkownik zakończył połączenie. - Wywołanie zakończone przez agenta multimediów. |
Powodzenie |
UczestnikEndReason 4xx
Odpowiedź ParticipantEndReason
z wartością 4xx oznacza, że wywołanie nie nawiązało połączenia.
SubCode | Kod | Komunikat | Kategorie wyników | Rada |
---|---|---|---|---|
510403 | 403 | Połączenie zablokowane: - Alternatywny identyfikator nie podano dla wywołania. - Numer telefonu niedozwolony przez użytkowników Kontroler granic sesji (SBC). |
— Aby uzyskać więcej informacji na temat alternatywnego identyfikatora, zobacz Zarządzanie wywołaniami. — Upewnij się, że określono prawidłowy identyfikator alternatywny. Musi to być numer telefonu należący do używanego zasobu. — Sprawdź, czy jesteś właścicielem zasobu, którego używasz do wywołania. - W przypadku wywołań routingu bezpośredniego sprawdź, dlaczego kontroler graniczny sesji niedozwolony wywołania. |
|
560403 | 403 | - Wywołaj zabronione. - Połączenie zostało anulowane. - Połączenie odrzucone. |
Upewnij się, że nazwano prawidłowy numer telefonu w poprawnym formacie. Aby uzyskać więcej informacji na temat obsługiwanych formatów liczb, zobacz https://en.wikipedia.org/wiki/E.164. | |
511532 | 403 | Nie można odnaleźć konfiguracji magistrali SIP zasobu. | Sprawdź konfigurację routingu bezpośredniego w witrynie Azure Portal. Aby uzyskać więcej informacji, zobacz Direct routing provisioning (Aprowizowanie routingu bezpośredniego). | |
560404 | 404 | - Nie można odnaleźć numeru telefonu. - Numer telefonu nie został przypisany do żadnego miejsca docelowego. - Numer telefonu niedozwolony przez kontroler obramowania sesji. |
— Upewnij się, że numer telefonu należy do zasobu, którego używasz, i że jesteś właścicielem zasobu. — Sprawdź, czy numer, który wywołujesz, istnieje i jest przypisany do prawidłowego obiektu docelowego. |
|
511404 | 404 | - Nie można odnaleźć numeru telefonu. — Nie znaleziono zasobu użytego w wywołaniu. |
— Upewnij się, że użyto numeru telefonu należącego do używanego zasobu i że jesteś właścicielem zasobu. — Sprawdź, czy numer, który wywołujesz, istnieje i jest przypisany do prawidłowego obiektu docelowego. — Upewnij się, że zasób używany dla wywołania nie został usunięty ani wyłączony. — Upewnij się, że subskrypcje platformy Azure nie zostały usunięte ani wyłączone. |
|
560408 | 408 | Nazwana strona nie odpowiedziała na wiadomość o utworzeniu połączenia w określonym przedziale czasu. | - Dokładnie sprawdź, dlaczego nazwana partia nie odpowiedziała. — W przypadku wywołań routingu bezpośredniego sprawdź konfigurację dzienników i ustawień i limitów czasu kontroli granic sesji (SBC). |
|
500001 | 408 | Limit czasu bramy użytkownika Usługi Azure Communication Services nie otrzymały odpowiedzi od klienta w określonym przedziale czasu i zakończyły żądanie. |
- Dokładnie sprawdź, dlaczego nazwana partia nie odpowiedziała. — W przypadku wywołań routingu bezpośredniego sprawdź konfigurację dzienników I ustawień i limitów czasu SBC. |
|
531004 | 410 | Sprawdzanie interaktywnego ustanowienia łączności (ICE) nie powiodło się. | - Nie można ustanowić ścieżki multimedialnej. Może to być spowodowane nieprawidłową konfiguracją sieci. Sprawdź konfigurację sieci, aby upewnić się, że wymagane adresy IP i porty nie są blokowane. Zapoznaj się z wytycznymi w temacie https://www.rfc-editor.org/rfc/rfc5245#section-7. — W przypadku wywołań routingu bezpośredniego sprawdź dzienniki I ustawienia protokołu SBC pod kątem konfiguracji i profilu ICE. Skontaktuj się z dostawcą SBC, aby uzyskać pomoc dotyczącą konfiguracji. Aby uzyskać więcej informacji, zobacz List of Session Border Controllers certified for Azure Communication Services direct routing (Lista kontrolerów granic sesji certyfikowanych na potrzeby routingu bezpośredniego usług Azure Communication Services). |
|
560480 | 480 | - Brak odpowiedzi od nazwanego użytkownika. - Nazwany użytkownik tymczasowy niedostępny. |
- Dokładnie sprawdź, dlaczego nazwana partia nie odpowiedziała. - Ponów próbę połączenia później w przypadku, gdy wywołana strona była tymczasowa niedostępna. — W przypadku wywołań routingu bezpośredniego sprawdź konfigurację dzienników I ustawień i limitów czasu SBC. |
|
560484 | 484 | - Niekompletny lub nieprawidłowy adres wywoływany. - Niekompletny lub nieprawidłowy format numeru wywoływanego. |
— W niektórych przypadkach można zignorować te błędy, ponieważ użytkownik wybiera nieprawidłowy numer. - Upewnij się, że numery telefonów są poprawnie sformatowane. Aby uzyskać więcej informacji, zobacz https://en.wikipedia.org/wiki/E.164. — W przypadku routingu bezpośredniego połączenie SBC może spowodować te błędy z powodu braku konfiguracji w scenariuszu transferu wywołań. |
|
60486 | 486 | Wywołana liczba była zajęta | - Wywołany numer może być połączony z istniejącym połączeniem lub mieć problem techniczny. — W przypadku wywołań routingu bezpośredniego sprawdź konfigurację dzienników I ustawień i limitów czasu SBC. |
|
540487 | 487 | Obiekt wywołujący zakończył żądanie połączenia. | Ponów próbę wywołania. | |
560487 | 497 | - Obiekt wywołujący zakończył żądanie połączenia. — Żądanie zostało zakończone z normalnym czyszczeniem połączeń. |
Ponów próbę wywołania. |
UczestnikEndReason 5xx
Odpowiedź ParticipantEndReason
o wartości 5xx oznacza, że wywołanie nie powiodło się z powodu problemu z oprogramowaniem lub składnikiem sprzętowym wymaganym do ukończenia połączenia.
SubCode | Kod | Komunikat | Kategorie wyników | Rada |
---|---|---|---|---|
560500 | 500 | Wystąpił wewnętrzny błąd serwera w jednej z usług zaangażowanych w wywołanie. | - Ponów próbę wywołania. Jeśli problem będzie się powtarzać, skontaktuj się z dostawcą telco lub pomocą techniczną firmy Microsoft. — W przypadku wywołań routingu bezpośredniego sprawdź konfigurację dzienników I ustawień i limitów czasu SBC, aby sprawdzić, czy połączenie SBC spowodowało awarię. |
|
560503 | 503 | - Wywołanie nie powiodło się z powodu wewnętrznego błędu serwera w jednej z usług zaangażowanych w wywołanie. - Sieć używana do ustanowienia wywołania jest poza kolejnością. - Tymczasowa awaria w jednej z usług zaangażowanych w wywołanie. |
— Sprawdź konfigurację sieci i routingu pod kątem możliwych problemów. Sprawdź, czy reguły zapory sieciowej są poprawne. - Ponów próbę wywołania. Jeśli problem będzie się powtarzać, skontaktuj się z dostawcą telco lub pomocą techniczną firmy Microsoft. — W przypadku wywołań routingu bezpośredniego sprawdź konfigurację dzienników I ustawień i limitów czasu SBC, aby sprawdzić, czy połączenie SBC spowodowało awarię. |
UczestnikEndReason 603
Odpowiedź ParticipantEndReason
o wartości 603 oznacza, że wywołanie zostało odrzucone bez nawiązywania połączenia.
SubCode | Kod | Komunikat | Kategorie wyników | Rada |
---|---|---|---|---|
560603 | 603 | - Połączenie odrzucone przez odbiorcę. - Połączenie odrzucone z powodu wykrycia oszustw. |
— Jeśli odbiorca odrzucił go, ponów próbę wywołania. — Upewnij się, że nie przekraczasz maksymalnej liczby współbieżnych połączeń dozwolonych dla numeru telefonu usług Azure Communication Services. Aby uzyskać więcej informacji, zobacz Ograniczenia połączeń PSTN. |
Kody błędów zestawu SDK czatu
Zestaw SDK czatu używa następujących kodów błędów, aby ułatwić rozwiązywanie problemów z czatem. Kody błędów są widoczne za pośrednictwem error.code
właściwości w odpowiedzi na błąd.
Kod | Komunikat | Rada |
---|---|---|
401 | Brak autoryzacji | Upewnij się, że token usług komunikacyjnych jest prawidłowy i nie wygasł. |
403 | Dostęp zabroniony | Upewnij się, że inicjator żądania ma dostęp do zasobu. |
429 | Zbyt wiele żądań | Upewnij się, że aplikacja po stronie klienta obsługuje ten scenariusz w przyjazny dla użytkownika sposób. Jeśli błąd będzie się powtarzać, prześlij wniosek o pomoc techniczną. |
503 | Usługa niedostępna | Prześlij wniosek o pomoc techniczną za pośrednictwem witryny Azure Portal. |
Kody błędów wiadomości SMS
Zestaw SMS SDK używa następujących kodów błędów, aby ułatwić rozwiązywanie problemów z wiadomościami SMS. Kody błędów są widoczne za pośrednictwem DeliveryStatusDetails
pola w raporcie dostarczania wiadomości SMS.
Kod | Komunikat | Rada |
---|---|---|
2000 | Komunikat został dostarczony pomyślnie. | |
4000 | Komunikat jest odrzucany z powodu wykrywania oszustw. | Upewnij się, że nie przekraczasz maksymalnej liczby komunikatów dozwolonych dla twojej liczby. |
4001 | Komunikat jest odrzucany z powodu nieprawidłowego formatu źródła/od numeru | Upewnij się, że wartość Liczba do ma format E.164, a format od numeru jest w formacie E.164 lub Krótki kod. |
4002 | Komunikat jest odrzucany z powodu nieprawidłowego formatu miejsca docelowego/do numeru. | Upewnij się, że numer Do jest w formacie E.164 |
4003 | Komunikat nie może zostać dostarczony z powodu nieobsługiwanego miejsca docelowego. | Sprawdź, czy miejsce docelowe, do którego próbujesz wysłać, jest obsługiwane. |
4004 | Komunikat nie może być dostarczany, ponieważ liczba docelowa/do nie istnieje. | Upewnij się, że numer Do, do którego wysyłasz, jest prawidłowy. |
4005 | Komunikat zablokowany przez operatora docelowego. | |
4006 | Numer Docelowy/Do nie jest osiągalny. | Spróbuj ponownie wysłać wiadomość później. |
4007 | Numer Destination/To zrezygnował z odbierania komunikatów od Użytkownika. | Oznacz numer Docelowy/Do jako zrezygnowany, aby nie podjęto dalszych prób wiadomości w numerze. |
4008 | Przekroczono maksymalną liczbę komunikatów dozwolonych dla profilu. | Upewnij się, że nie przekraczasz maksymalnej liczby komunikatów dozwolonych dla liczby lub użyjesz kolejek do dzielenia komunikatów na partie. |
4009 | Komunikat odrzucony przez system upoważnienia firmy Microsoft. | Najczęściej dzieje się tak w przypadku wykrycia fałszywych działań. Aby uzyskać więcej informacji, skontaktuj się z pomocą techniczną. |
4010 | Wiadomość została zablokowana z powodu braku weryfikacji numeru bezpłatnego. | Przejrzyj niezweryfikowane limity wysyłania i jak najszybciej prześlij weryfikację bezpłatną. |
5000 | Komunikat nie może dostarczyć. Skontaktuj się z zespołem pomocy technicznej firmy Microsoft, aby uzyskać więcej informacji. | Prześlij wniosek o pomoc techniczną za pośrednictwem witryny Azure Portal. |
5001 | Komunikat nie może zostać dostarczony z powodu tymczasowej niedostępności aplikacji/systemu. | |
5002 | Przewoźnik nie obsługuje raportu dostawy | Najczęściej dzieje się tak, jeśli przewoźnik nie obsługuje raportów dostawy. Nie jest wymagana żadna akcja, ponieważ komunikat mógł zostać już dostarczony. |
9999 | Komunikat nie może zostać dostarczony z powodu nieznanego błędu/błędu. | Spróbuj ponownie wysłać wiadomość. |