Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Warning
Azure Communication Services wprowadza nowatorskie zmiany, a niektóre usługi są wycofywane. Dowiedz się więcej w przewodniku po zmianach emerytalnych i przełamowych.
W tym artykule opisano rozwiązywanie problemów związanych z kodami odpowiedzi dotyczącymi zakończenia połączenia dla Calling SDK, Call Automation i połączeń 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 Gridzdarzenia: upewnij się, że punkt końcowy aplikacji jest weryfikowany za pomocą usługi Event Grid podczas tworzenia subskrypcji zdarzeń. Stan aprowizacji subskrypcji zdarzeń ma wartość „Zakończono pomyślnie”, jeśli walidacja zakończy 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
PlayAudionie 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 na punktach końcowych sieci PSTN nie działają: w przypadku operacji
CreateCall,Transfer,AddParticipantiRedirectna numerach telefonów należy ustawić elementSourceCallerIdw żądaniu akcji. Jeśli nie używasz routingu bezpośredniego, źródłowy identyfikator dzwoniącego musi być numerem telefonu należącym do Twojego zasobu Communication Services, aby akcja zakończyła się powodzeniem.
Aby uzyskać więcej informacji na temat problemów śledzonych przez zespół produktu, zobacz Znane problemy.
Note
Kategorie komunikatów i wyników wymienione w poniższych tabelach są dostępne w publicznej wersji zapoznawczej. Aby uzyskać więcej informacji, zobacz Dodatkowe warunki użytkowania dla wersji zapoznawczych platformy Microsoft Azure.
Zrozumienie błędów kodów połączeń 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ą udostępniane za pośrednictwem właściwości call.callEndReason po zakończeniu połączenia.
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ć wartość Success, ExpectedError, UnexpectedClientError lub UnexpectedServerError.
Kody błędów i podkody klienta zestawu SDK połączeń usługi Azure Communication Services
W przypadku błędów po stronie klienta, jeśli właściwość resultCategories ma wartość ExpectedError, błąd jest oczekiwany z punktu widzenia pakietu 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.
| Subcode | Code | Message | Kategoria wyników | Advice |
|---|---|---|---|---|
| 40101 | 408 | Nie udało się utworzyć 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. |
UnexpectedClientError | |
| 40104 | 408 | Nie można utworzyć obiektu 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. |
UnexpectedClientError | |
| 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. |
UnexpectedClientError | Aby uzyskać więcej informacji, zobacz wymagania dotyczące sieci. |
| 40115 | 412 | Nie można utworzyć obiektu CallAgent, ponieważ nie można zainicjować połączenia z infrastrukturą 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. |
UnexpectedClientError | Aby uzyskać więcej informacji, zobacz wymagania dotyczące sieci. |
| 40216 | 500 | Nie można utworzyć 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. | UnexpectedClientError | |
| 40228 | 409 | Nie można utworzyć obiektu CallAgent, wystąpienie obiektu CallAgent skojarzone z tą tożsamością już istnieje. Usunąć istniejący obiekt CallAgent lub utworzyć nowy z inną tożsamością. | ExpectedError | |
| 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. | ExpectedError | |
| 40606 | 405 | Nie udało się wykryć głośników; wykrywanie ani wybieranie głośników nie jest obsługiwane w Chrome na Androidzie, Safari na iOS ani Safari na macOS. | ExpectedError | 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 udało się uzyskać zgody na korzystanie z mikrofonu i/lub kamery — odmówiono jej lub wystąpił błąd. Upewnij się, że zezwalaj na uprawnienia w ustawieniach przeglądarki i w ustawieniach systemu operacyjnego. | ExpectedError | 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. | UnexpectedClientError | Dowiedz się więcej o tym, jak najlepiej obsługiwać uprawnienia urządzenia. |
| 41006 | 400 | Nie można odebrać połączenia przychodzącego, ponieważ nie jest ono w stanie „Dzwoni”. Subskrybuj zdarzenie incomingCall obiektu CallAgent, aby zaakceptować połączenie przychodzące. |
ExpectedError | Zapoznaj się z następującymi artykułami, aby zidentyfikować główną przyczynę problemu - Odbieranie połączenia przychodzącego - Subskrybuj zdarzenia zestawu SDK |
| 41007 | 400 | Nie można odrzucić połączenia przychodzącego, ponieważ nie jest ono w stanie „Dzwoni”. Zasubskrybuj zdarzenie CallAgent, incomingCall aby odrzucić połączenie przychodzące. |
ExpectedError | Zapoznaj się z następującymi artykułami, aby zidentyfikować główną przyczynę problemu - Odbieranie połączenia przychodzącego - Subskrybuj zdarzenia 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. | UnexpectedClientError | |
| 41016 | 400 | Nie udało się wyłączyć wyciszenia 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. | UnexpectedClientError | |
| 41025 | 400 | Nie można uruchomić pliku wideo, wystąpienie LocalVideoStream jest nieprawidłowe lub puste. Przekaż wystąpienie LocalVideoStream. | ExpectedError | Upewnij się, że obiekt przekazany do funkcji uruchamiania wideo jest instancją klasy LocalVideoStream. Utworzyć obiekt LocalVideoStream przy użyciu obiektu VideoDeviceInfo lub MediaStream. 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. | ExpectedError | 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. | ExpectedError | 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 źródło wejściowe nie jest obecnie wysyłany. | ExpectedError | 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. | UnexpectedClientError | |
| 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. | UnexpectedClientError | |
| 41035 | 400 | Nie można rozpocząć udostępniania ekranu, udostępnianie ekranu zostało już rozpoczęte. | ExpectedError | Dowiedz się więcej na temat uruchamiania i zatrzymywania udostępniania ekranu podczas rozmowy |
| 41041 | 400 | Nie można zatrzymać udostępniania ekranu, udostępnianie ekranu zostało już zatrzymane. | ExpectedError | Dowiedz się więcej na temat uruchamiania i zatrzymywania udostępniania ekranu podczas rozmowy |
| 41048 | 410 | Nie udało się uruchomić obrazu wideo podczas nawiązywania 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. | UnexpectedClientError | - Urządzenie aparatu może być wyłączone w systemie. - Kamera jest używana przez inny proces. |
| 41056 | 412 | Nie można rozpocząć połączenia ani dołączyć do rozmowy, ponieważ zasady połączeń głosowych Teams Enterprise nie są włączone dla tego zasobu usługi Azure Communication Services. Postępuj zgodnie z samouczkiem online, aby go włączyć. | ExpectedError | Zobacz , jak umożliwić użytkownikom korzystanie z usługi Enterprise Voice online i poczty głosowej systemu telefonicznego, aby włączyć politykę głosową Teams Enterprise. |
| 41071 | 412 | Nie można rozpocząć udostępniania ekranu, połączenie nie jest w stanie „Połączono”. Subskrybuj zdarzenie obiektu Call stateChanged, aby wiedzieć, kiedy połączenie zostanie nawiązane. |
ExpectedError | Przydatne linki: - Sprawdzanie właściwości wywołania - Subskrybuj zdarzenia zestawu SDK |
| 41073 | 412 | Nie można pobrać ani ustawić niestandardowego strumienia MediaStream. Ta funkcja jest obecnie wyłączona w usłudze Azure Communication Services. | ExpectedError | |
| 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. | ExpectedError | 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. | ExpectedError | 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. | UnexpectedClientError | |
| 43004 | 400 | Nie można przełączyć urządzenia wideo, nieprawidłowe dane wejściowe. Dane wejściowe muszą być typu VideoDeviceInfo. | ExpectedError | 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. | ExpectedError | |
| 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. | ExpectedError | 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. | UnexpectedClientError | |
| 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. | ExpectedError | 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. | ExpectedError | — 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, strumień nie jest obsługiwany. Spróbuj ponownie, jeśli problem będzie się powtarzać, skontaktuj się z pomocą techniczną usług Azure Communication Services. | UnexpectedClientError | |
| 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. | UnexpectedClientError | 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. | UnexpectedClientError | 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. Subskrybuj właściwość isAvailable strumienia, aby otrzymywać powiadomienia, gdy zdalny uczestnik ma włączone wideo, a strumień jest dostępny do renderowania. | ExpectedError | Przydatne linki: - Wyświetlanie strumieni wideo lub udostępniania ekranu przez zdalnych uczestników - Dodawanie wywołania wideo 1:1 do aplikacji - Subskrybuj zdarzenia zestawu SDK |
| 43202 | 404 | Nie można renderować strumienia wideo. Ten strumień nie jest już dostępny. Zdalny uczestnik wyłączył wideo. | ExpectedError | 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. | UnexpectedClientError | |
| 43204 | 500 | Nie można wyrenderować strumienia wideo, nie można zasubskrybować strumienia wideo w infrastrukturze Azure Communication Services. Spróbuj ponownie, jeśli problem będzie się powtarzać, skontaktuj się z pomocą techniczną usług Azure Communication Services. | UnexpectedClientError | |
| 43209 | 405 | Nie można renderować strumienia wideo, usługa VideoStreamRenderer została usunięta podczas procesu inicjowania. | ExpectedError | |
| 43210 | 400 | Nie można usunąć elementu VideoStreamRenderer, ponieważ jest on już usunięty. | ExpectedError | |
| 43220 | 400 | Nie można utworzyć widoku, osiągnięto już maksymalną liczbę aktywnych RemoteVideoStream widoków. Możesz usunąć poprzedni, aby utworzyć nowy. |
ExpectedError | Dowiedz się więcej o tym, jak prawidłowo obsługiwać najlepszą liczbę przychodzących strumieni wideo |
| 71005 | 401 | Połączenie zawiodło z powodu błędu weryfikacji w Azure Communication Services. Spróbuj ponownie, jeśli problem będzie się powtarzać, skontaktuj się z pomocą techniczną usług Azure Communication Services. | UnexpectedClientError | |
| 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 | Połączenie zostało globalnie odrzucone przez zdalnego uczestnika usługi Communication Services. | 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. |
Zrozumienie błędów kodów połączeń 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ą udostępniane za pośrednictwem właściwości call.callEndReason po zakończeniu połączenia.
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ć wartość Success, 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ć.
| Subcode | Code | Message | Kategorie wyników | Advice |
|---|---|---|---|---|
| 0 | 0 | Połączenie zostało pomyślnie zakończone przez lokalnego uczestnika. | Success | |
| 0 | 487 | Połączenie zakończyło się pomyślnie, ponieważ obiekt wywołujący anulował połączenie. | Success | |
| 0 | 603 | Połączenie zakończyło się pomyślnie, ponieważ zostało odrzucone przez odbiorcę. | Success | 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 | ExpectedError | Przeglądarka jest w trybie offline lub ma problemy z siecią. Sprawdź połączenie sieciowe przeglądarki i spróbuj ponownie. |
| 3100 | 410 | Nawiązywanie połączenia nie powiodło się z powodu nieoczekiwanego problemu z siecią po stronie klienta. Sprawdź połączenie sieciowe klienta i spróbuj ponownie. | 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 | Konfigurowanie połączenia nie powiodło się — nie można przetworzyć oferty medió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 | Nawiązywanie połączenia nie powiodło się z powodu problemu z konfiguracją sieci po stronie klienta. Sprawdź konfigurację sieci po stronie klienta i spróbuj ponownie. | ExpectedError | Dowiedz się więcej o wywołaniu kończącym się podkodem 3112 tutaj. |
| 4097 | 0 | Połączenie zostało zakończone dla wszystkich użytkowników przez organizatora spotkania. | Success | |
| 4502 | 490 | Połączenie nie powiodło się z powodu problemów z łącznością sieciową; przeglądarka nie zdołała ukończyć żądania HTTP. | UnexpectedClientError | 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 osoba, do której dzwonisz, odebrała i zaakceptowała połączenie. | UnexpectedClientError | 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 | Połączenie zostało zakończone, ponieważ aplikacja nie zapewniła prawidłowego tokenu usługi Azure Communication Services. | UnexpectedClientError | Upewnij się, że aplikacja prawidłowo implementuje mechanizm odświeżania tokenów. |
| 4521 | 0 | Połączenie zostało zakończone, ponieważ użytkownik nagle rozłączył rozmowę. Może to być spowodowane zamknięciem przez użytkownika aplikacji, która obsługiwała połączenie, na przykład gdy użytkownik zamknął aplikację przez zamknięcie karty przeglądarki bez prawidłowego zakończenia połączenia. | ExpectedError | |
| 5000 | 0 | Połączenie zakończyło się dla tego uczestnika. Uczestnik został usunięty z konwersacji przez innego uczestnika. | Success | |
| 5003 | 0 | Połączenie zostało zakończone przez usługę Azure Communication Service, gdyż rozmowa dobiegła końca. | Success | |
| 5300 | 0 | Połączenie zakończyło się dla tego uczestnika, ponieważ zostało usunięte z konwersacji przez innego uczestnika. | Success | Połączenie zostało zakończone dla tego uczestnika, ponieważ inny uczestnik usunął tego uczestnika; mógł to być inny klient, interfejs API Call Automation lub interfejs API Graph. |
| 5317 | 0 | Uczestnik docelowy został usunięty z powodu aktualizacji roli uczestnika. | ExpectedError | |
| 5828 | 403 | Dołączenie do spotkania Rooms nie jest autoryzowane, ponieważ użytkownik nie znajduje się na liście zaproszonych. | UnexpectedClientError | |
| 5829 | 403 | Nie można dołączyć do spotkania Rooms po czasie zakończenia spotkania ani przed jego rozpoczęciem. | UnexpectedClientError | |
| 5830 | 403 | Tylko użytkownik usługi Communication Services może dołączyć do spotkania Rooms. | ExpectedError | |
| 7000 | 0 | Połączenie zostało zakończone przez interfejs API automatyzacji połączeń usługi Azure Communication Service lub bota serwerowego. | Success | Połączenie zostało zakończone przez interfejs API usługi ACS Call Automation lub bota Graph. |
| 10003 | 487 | Połączenie zostało anulowane dla tego punktu końcowego użytkownika, ponieważ zostało odebrane przez inny punkt końcowy. | Success | Zainicjowano połączenie do użytkownika docelowego (rozpoczęcie połączenia, dodanie uczestnika, przekazanie połączenia), użytkownik docelowy miał jednocześnie wiele aktywnych punktów końcowych, a na jednym z nich zaakceptował połączenie. To normalne zachowanie. Tylko jeden punkt końcowy może przyjąć połączenie i połączyć się z nim. 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 z powodu przekroczenia limitu czasu, ponieważ odbiorca nie zaakceptował ani nie odrzucił połączenia na czas. Upewnij się, że użytkownik zobaczył powiadomienie i/lub aplikacja może obsłużyć to automatycznie, a następnie spróbuj ponownie zainicjować to wywołanie. | ExpectedError | Połączenie zostało anulowane po upływie z góry określonego czasu (zwykle 2 minut), ponieważ użytkownik, do którego kierowano połączenie, nie odebrał go ani nie odrzucił. |
| 10009 | 401 | Nieuwierzytelniona tożsamość. Upewnij się, że token usług Azure Communication Services jest prawidłowy i nie wygasł. | UnexpectedClientError | |
| 71005 | 401 | Połączenie zawiodło z powodu błędu weryfikacji w Azure Communication Services. Spróbuj ponownie, jeśli problem będzie się powtarzać, skontaktuj się z pomocą techniczną usług Azure Communication Services. | UnexpectedClientError | |
| 10024 | 487 | Połączenie zakończyło się pomyślnie. Połączenie odrzucone przez wszystkie punkty końcowe odbiorcy. | Success | Spróbuj ponownie nawiązać 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. | ExpectedError | Jeśli docelowy użytkownik korzysta z zestawu SDK wywołań 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 Graph user ma właściwość department ustawioną na Microsoft Communication Application Instance, należy określić MicrosoftTeamsBotIdentifier. |
| 10057 | 408 | Połączenie nie powiodło się; odbiorca nie zdołał dokończyć zestawiania połączenia, najprawdopodobniej dlatego, że utracił połączenie z siecią lub gwałtownie zamknął aplikację. Upewnij się, że klienci są połączeni i są dostępni. | ExpectedError | |
| 10076 | 480 | Docelowy użytkownik był zarejestrowany, ale w chwili połączenia nie był online. Upewnij się, że docelowy użytkownik ma co najmniej jeden aktywny punkt końcowy i jest w trybie online. | ExpectedError | 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 był zarejestrowany w usłudze ACS i/lub do otrzymywania powiadomień push, ale w momencie połączenia nie był online. Upewnij się, że docelowy użytkownik ma co najmniej jeden aktywny punkt końcowy i jest w trybie online. | ExpectedError | 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. | ExpectedError | — 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 połączenia przez infrastrukturę Azure Communication Services z powodu braku możliwości ustanowienia łączności multimedialnej z infrastrukturą Azure Communication Services podczas ustanawiania połączenia. Sprawdź konfigurację sieci użytkownika, w tym sieć lokalną, zapory, konfigurację sieci VPN i spróbuj ponownie. | UnexpectedClientError | 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 połączenia przez infrastrukturę Azure Communication Services z powodu utraty łączności mediów z tą 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. | UnexpectedClientError | Upewnij się, że używasz najnowszego zestawu SDK w obsługiwanym środowisku. |
| 540000 | 0 | Połączenie zostało pomyślnie zakończone przez lokalnego abonenta PSTN. | Success | |
| 510403 | 403 | Połączenie zablokowane: - Nie znaleziono pasującej trasy głosowej dla numeru wybranego. - Nie podano alternatywnego identyfikatora dla wywołania. - Numer telefonu niedozwolony przez kontroler graniczny sesji (SBC) użytkownika. — Wcześniej oznaczony jako spam, a teraz zablokowano. |
ExpectedError | Aby uzyskać więcej informacji na temat alternatywnego identyfikatora, zobacz Zarządzanie wywołaniami. — Upewnij się, że masz prawidłową trasę głosową dla numeru wybranego. — 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 połączeń routingu bezpośredniego sprawdź, dlaczego kontroler graniczny sesji nie zezwolił na połączenie. — Upewnij się, że token usług komunikacyjnych jest prawidłowy i nie wygasł. |
| 540487 | 487 | Połączenie zakończyło się pomyślnie, ponieważ obiekt wywołujący anulował połączenie. | Success | |
| 560000 | 0 | Połączenie zostało pomyślnie zakończone przez zdalnego uczestnika PSTN. | Success | Możliwe przyczyny: — Użytkownik zakończył połączenie. - Połączenie zakończone przez agenta medialnego. |
| 560486 | 486 | Połączenie zostało zakończone, ponieważ zdalny uczestnik PSTN był zajęty. Wybrany numer był już zajęty lub wystąpiły problemy techniczne. | Success | - W przypadku połączeń Direct Routing sprawdź dzienniki i ustawienia kontrolera granicy sesji (SBC) oraz konfigurację limitów czasu. Możliwe przyczyny: wybrany numer był już zajęty lub występowały problemy techniczne. |
| 404 | Nie można odnaleźć połączenia. | Upewnij się, że numer, na który dzwonisz (lub połączenie, do którego dołączasz), 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 lokalnego stosu mediów lub infrastruktury multimedialnej. | 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 udało się obsłużyć połączenia 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. |
Zrozumienie kodów wybierania i podkodów
Kiedy są odbierane kody błędów?
Kody błędów w usłudze Call Automation mogą być zwracane jako synchroniczne odpowiedzi na wywołania interfejsu API lub jako 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 wywołanie interfejsu API zostanie wykonane i zaakceptowane, ale mimo to coś pójdzie nie tak, otrzymywane są zarówno zdarzenie callback, jak i kod błędu. Przykładem typowego zdarzenia zwrotnego związanego z niepowodzeniem połączenia jest zdarzenie callDisconnected, które jest zgłaszane za każdym razem, gdy połączenie zostaje rozłączone. Po odebraniu zdarzenia callDisconnected nie będzie już żadnych dalszych zdarzeń zwrotnych dla tego połączenia. Listę zdarzeń wywołania zwrotnego sygnalizacji połączeń znajdziesz na stronie (tę stronę), a listę zdarzeń wywołania zwrotnego dla akcji multimedialnych — na stronie (tę stronę).
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.
Kody błędów automatyzacji połączeń
| Zdarzenie wywołania zwrotnego | Code | Subcode | Description | Mitigation |
|---|---|---|---|---|
| UtworzeniePołączeniaNiepowiodłoSię / OdpowiedźNiepowiodłaSię | 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. |
| UtworzeniePołączeniaNiepowiodłoSię / OdpowiedźNiepowiodłaSię | 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. |
| Odpowiedź nie powiodła się | 400 | 8501 | Akcja nie jest obsługiwana. Połączenie nie zostało nawiązane. | Akcja powiązana z komunikatem o błędzie została aktywowana, gdy połączenie nie było aktywne. Upewnij się, że po rozłączeniu połączenia nie są rozpoczynane żadne nowe działania związane z połączeniem. Ten błąd może również wynikać z działań wykonanych podczas aktywnego połączenia, jeśli nastąpiły one w czasie zbliżonym do momentu rozłączenia połączenia. |
| Odpowiedź nie powiodła się | 400 | 8500 | Nieprawidłowy tryb multimediów | Sprawdź stan operacji na multimediach, aby zobaczyć, czy którakolwiek z nich jest już aktywna lub czy docelowy uczestnik jest już objęty operacją na multimediach. Jeśli jest aktywna operacja multimediów, poczekaj na zakończenie operacji, a następnie ponów próbę. |
| Połączenie rozłączone | 400 | 8559 | Ta akcja nie jest obsługiwana. Dozwolona jest tylko jedna aplikacja do wykonywania połączeń. | 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. |
| Nie udało się udzielić odpowiedzi | 400 | 8528 | Akcja nie jest obsługiwana; połączenie zostało zakończone | Akcja powiązana z komunikatem o błędzie została aktywowana, gdy połączenie zostało zakończone. Upewnij się, że po zakończeniu połączenia nie są rozpoczynane nowe działania związane z połączeniem. Ten błąd może również wynikać z działań wykonywanych podczas aktywnego połączenia, jeśli następują one blisko momentu zakończenia połączenia. |
| NieudanaPróbaUtworzeniaPołączenia / NieudanePołączenie | 409 | 8519 | Conflict | 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. |
| CreateCallFailed | 403 | 7507 | Nieprawidłowy identyfikator ź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 parametrów połączenia z zasobu ACS, w którym skonfigurowano webhook dla połączeń przychodzących (numer telefonu musi należeć do tego samego zasobu ACS, który odbiera połączenie). |
| Nie udało się utworzyć połączenia | 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ń. |
| Odpowiedź nie powiodła się | 400 | 8585 | Akcja jest nieprawidłowa w bieżącym stanie wywołania | Połączenie nie zostało nawiązane lub zostało przerwane: poczekaj na nawiązanie połączenia przed ponowieniem operacji multimedialnej. |
| Nie udało się utworzyć połączenia | 405 | 8520 | Funkcjonalność nie jest obecnie obsługiwana | Oczekiwany błąd: Przepływ pracy nie jest obecnie obsługiwany. Sprawdź nasz blog o wydaniu, aby zobaczyć, czy jest dostępna zaktualizowana wersja SDK, która obsługuje te funkcje. Aby uzyskać listę nieobsługiwanych przepływów pracy, zobacz stronę Znane ograniczenia usługi Call Automation. |
| Nie udało się utworzyć połączenia | 412 | 8583 | Warunek wstępny nie został spełniony | Zapoznaj się z tą stroną zawierającą listę niezgodnych operacji na multimediach, aby upewnić się, że nie uruchamiasz ani nie dodajesz do kolejki niezgodnych operacji. |
| Nie można utworzyć połączenia | 400 | 8567 | Jednostka usługi zasobu ACS nie jest włączona | 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. |
| Nie udało się utworzyć połączenia | 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. |
| Połączenie rozłączone | 200 | 0 | Połączenie zostało pomyślnie zakończone przez uczestnika lokalnego. | Nie jest wymagana żadna akcja; połączenie zakończyło się zgodnie z oczekiwaniami. |
| Połączenie rozłączone | 200 | 4521 | Uczestnik został nagle rozłączony (np. zamknął aplikację, kartę lub przeglądarkę bez zakończenia połączenia). | Zaleca się wdrożenie mechanizmu łagodnego rozłączania po stronie klienta. Użyj dzienników klienta, aby sprawdzić, czy wymuszono zamknięcie aplikacji. |
| Połączenie rozłączone | 200 | 5000 | Uczestnik usunięty przez innego uczestnika. | Sprawdź logikę sterowania wywołaniami, aby uzyskać informacje o operacjach usuwania. Upewnij się, że usunięcie było zamierzone. |
| Połączenie rozłączone | 200 | 5010 | Połączenie zakończyło się, ponieważ pozostał tylko jeden uczestnik. | Jest to oczekiwane zachowanie. Dołącz ponownie do wielu uczestników, jeśli połączenie miało być kontynuowane. |
| Połączenie rozłączone | 200 | 5013 | Połączenie zostało zakończone, ponieważ nikt inny nie dołączył do połączenia grupowego. | Sprawdź czas dołączenia uczestnika. |
| Połączenie rozłączone | 200 | 7000 | Połączenie zakończone przez usługę Azure Communication Services Call Automation lub bota po stronie serwera. | Sprawdź, czy logika bota spowodowała zakończenie połączenia. Przejrzyj implementację bota i przepływ wywołań. |
| Połączenie rozłączone | 200 | 7015 | Połączenie zakończone przez usługę po pomyślnym przeniesieniu. | Nie jest wymagane żadne działanie; połączenie zostało zakończone zgodnie z oczekiwanym działaniem przekierowania. |
| Połączenie rozłączone | 487 | 0 | Połączenie zakończyło się pomyślnie, ponieważ obiekt wywołujący anulował połączenie. | Nie jest wymagana żadna akcja. Upewnij się, że anulowanie jest zamierzone. |
| Połączenie rozłączone | 487 | 10003 | Połączenie zostało zaakceptowane przez inny punkt końcowy (np. inny bot odebrał połączenie). Upewnij się, że boty odbierają tylko połączenia kierowane do nich. | Logika aplikacji powinna sprawdzać priorytet punktu końcowego lub logikę ponownej trasy. |
| Połączenie rozłączone | 487 | 10024 | Połączenie zostało odrzucone przez wszystkie punkty końcowe odbiorcy. | Nie jest wymagana żadna akcja. |
| Połączenie rozłączone | 500 | 10045 | Błąd infrastruktury usług Azure Communication Services. | Zbierz dzienniki i skontaktuj się z pomocą techniczną, jeśli problem będzie się powtarzał. |
| Połączenie rozłączone | 503 | 560503 | Nieoczekiwany błąd serwera. | Wewnętrzny błąd serwera, zbierz logi i otwórz zgłoszenie do działu wsparcia |
| CreateCallFailed | 401 | 10009 | Nieuwierzytelniona tożsamość. | Upewnij się, że token usług Azure Communication Services jest prawidłowy, o określonym zakresie i nie wygasł. |
| CreateCallFailed | 403 | 510403 | Połączenie oznaczone jako spam i zablokowane. | Przejrzyj wzorzec wywołań wychodzących. Upewnij się, że jest ona zgodna z zasadami ochrony przed spamem. |
| CreateCallFailed | 403 | 560403 | Połączenie zostało zabronione, anulowane lub odrzucone. | Zweryfikuj uprawnienia i stan użytkownika docelowego. |
| CreateCallFailed | 404 | 4500 | Identyfikator połączenia nie istnieje lub połączenie zostało już zakończone. | Sprawdź ponownie identyfikator połączenia i cykl życia połączenia. Upewnij się, że nie odnosisz się do wywołania, które wygasło. |
| CreateCallFailed | 480 | 10078 | Uczestnik zdalny nie jest zarejestrowany lub osiągalny. | Upewnij się, że aplikacja kliencka wywoływanego jest uruchomiona i zarejestrowana. Spróbuj ponownie później, jeśli to konieczne. |
| CreateCallFailed | 480 | 560480 | Brak odpowiedzi od osoby wywoływanej. | Potwierdź dostępność użytkownika. |
| CreateCallFailed | 487 | 540487 | Połączenie anulowane przez inicjatora. | Nie jest wymagana żadna akcja. Sprawdź, czy aplikacja źródłowa anulowała wywołanie zgodnie z oczekiwaniami. |
| Połączenie nie powiodło się | 408 | 10057 | Przekroczenie limitu czasu podczas dołączania do spotkania lub akceptowania połączeń. | Zweryfikuj obecność uczestnika i gotowość klienta. |
| Połączenie nie powiodło się | 429 | 10110 | Przekroczono maksymalny czas trwania wywołania. | Przejrzyj zasady czasu trwania połączeń. W razie potrzeby rozważ zaplanowanie ponownego połączenia. |
| Połączenie nie powiodło się | 480 | 10076 | Docelowy użytkownik zarejestrowany, ale w trybie offline. | Element docelowy musi być w trybie online. Potwierdź stan aplikacji lub powrót do poczty głosowej lub wiadomości asynchronicznych. |
| Połączenie nie powiodło się | 484 | 560484 | Nieprawidłowy lub niekompletny adres odbiorcy. | Zweryfikuj identyfikator odbiorcy połączenia (np. numer telefonu, identyfikator ACS). Popraw i ponów próbę. |
| Odpowiedź nie powiodła się | 401 | 71005 | Błąd weryfikacji tokenu podczas odpowiadania na połączenie. | Upewnij się, że żądanie AnswerCall ma prawidłowy, nie wygasły token. |
| Odpowiedź nie powiodła się | 404 | 404 | Nie można odpowiedzieć. | Zbierz logi i otwórz zgłoszenie do pomocy technicznej |
| Odpowiedź nie powiodła się | 408 | 4506 | Przekroczono limit czasu — wywoływana strona nie odpowiedziała na czas. | Sprawdź dostępność aplikacji i powiadomienia push. |
| Odpowiedź nie powiodła się | 495 | 4507 | Nieprawidłowy token usług Azure Communication Services. | Sprawdź generowanie i zakres tokenu. W razie potrzeby ponownie wygeneruj token. |
| Odpowiedź nie powiodła się | 430 | 10315 | Nie można dostarczyć komunikatu sygnałowego do klienta. | Upewnij się, że aplikacja kliencka jest osiągalna i może odbierać komunikaty sygnalizacyjne. |
| Odpowiedź nie powiodła się | 430 | 10317 | Klient nie potwierdził żądania sygnalizowania. | Sprawdź czas odpowiedzi aplikacji klienckiej. W razie potrzeby uruchom ponownie aplikację lub urządzenie. |
| Odpowiedź nie powiodła się | 480 | 10077 | Urządzenie docelowe było zarejestrowane, ale nie było online w chwili połączenia. | Upewnij się, że wywoływana strona ma aktywną sesję i nie działa w tle ani w stanie uśpienia. |
| Odpowiedź nie powiodła się | 487 | 10004 | Limit czasu — użytkownik nie zaakceptował ani nie odrzucił w czasie. | Rozważ dodanie ścieżki rezerwowej lub rozszerzonego czasu trwania dzwonienia. |
| Odpowiedź nie powiodła się | 487 | 4501 | Odrzucona oferta multimedialna lub nie udało się jej wygenerować (np. niezgodność punktów końcowych). | Zweryfikuj możliwości multimediów i zapewnij zgodność między uczestnikami. |
| Odpowiedź nie powiodła się | 490 | 4502 | Problem z siecią — nie można ukończyć żądania w przeglądarce. | Zweryfikuj łączność klienta i dodaj domeny ACS do listy dozwolonych w ustawieniach sieciowych. |
| Odpowiedź nie powiodła się | 496 | 7 | Utracono połączenie sieciowe; ponowne próby nie powiodły się. | Rejestrowanie i monitorowanie rozłączeń cyklicznych w celu dalszej analizy. |
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 | Description |
|---|---|
| 400 | Nieprawidłowe żądanie |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Nie znaleziono |
| 405 | Niedozwolona metoda |
| 406 | Nie do przyjęcia |
| 408 | Przekroczono limit czasu |
| 409 | Conflict |
| 412 | Warunek wstępny nie został spełniony |
| 413 | Zbyt duża jednostka żądania |
| 426 | Wymagane uaktualnienie |
| 429 | Zbyt wiele żądań |
| 481 | Transakcja nie istnieje |
| 487 | Canceled |
kody 5xx
Kod 5xx reprezentuje błąd serwera.
| Kod stanu | Description |
|---|---|
| 500 | Wewnętrzny błąd serwera. |
| 501 | Nie zaimplementowano |
| 502 | Zła brama |
| 503 | Usługa niedostępna |
| 504 | Przekroczono limit czasu bramy |
Kody 6xx
Kod 6xx reprezentuje błąd globalny.
| Kod stanu | Description |
|---|---|
| 603 | Declined |
Ogólne podkody
| Subcode | Description |
|---|---|
| 0 | Success |
| 7000 | Graceful |
| 7500 | Nieobsługiwana tożsamość AAD |
| 7501 | Nieprawidłowy token |
| 7502 | Nie włączono dostępu |
| 7504 | Niewystarczające uprawnienia aplikacji |
| 7505 | Niezgodność firmowego dzierżawcy |
| 7506 | Niezaufany certyfikat |
| 7507 | Nieprawidłowy identyfikator źródła wywołania |
| 7508 | Nieobsługiwana tożsamość 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ść obiektu docelowego ACS |
| 7603 | Nieprawidłowa tożsamość ACS |
| 7604 | Nieautoryzowany scenariusz współpracy z aplikacją Teams |
| 7605 | Scenariusz interoperacyjności nieautoryzowanego nagrywania w Microsoft Teams |
| 7606 | Nieautoryzowany zasób ACS dla akcji poznawczych |
| 8500 | Nieprawidłowy tryb multimediów |
| 8501 | Połączenie nie zostało nawiązane |
| 8502 | Mój identyfikator uczestnika jest niedostępny |
| 8503 | Dźwięk połączeń i multimediów — stan: nieaktywny |
| 8504 | Strumienie multimedialne są niedostępne |
| 8505 | Wielu uczestników z zastąpieniem |
| 8506 | Nagranie rozmowy o niezgodności |
| 8508 | Operacja anulowana |
| 8509 | Osiągnięto maksymalny limit czasu ciszy |
| 8510 | Upłynął limit czasu ciszy początkowej |
| 8511 | Monit odtwarzania nie powiódł się |
| 8512 | Nie udało się odtworzyć sygnału dźwiękowego |
| 8513 | Limit czasu odbierania multimediów |
| 8514 | Wykryto zatrzymanie tonu |
| 8515 | Osiągnięto maksymalny czas trwania nagrania |
| 8516 | Ograniczanie wywołań |
| 8517 | Niezgodność identyfikatora dzierżawcy |
| 8518 | Wyjątek podczas wywołania |
| 8519 | Conflict |
| 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 | Niezarejestrowany uczestnik |
| 8526 | Nieprawidłowy token dołączania |
| 8527 | Nieprawidłowy adres URL do dołączenia |
| 8528 | Połączenie zostało zakończone |
| 8529 | Osiągnięto miesięczny limit wywołań objętych ograniczeniem szybkości |
| 8530 | Osiągnięto limit aktywnych połączeń objętych ograniczaniem |
| 8531 | Maksymalna liczba odebranych cyfr |
| 8532 | Upłynął 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 | Odbiorca odrzucił połączenie |
| 8539 | Abonent jest zajęty |
| 8540 | Abonent jest zajęty we wszystkich lokalizacjach |
| 8541 | Wywoływanie niedostępne |
| 8542 | Anulowano połączenie |
| 8543 | Połączenie nie istnieje |
| 8544 | Abonent jest nieosiągalny |
| 8545 | Dopasowana opcja mowy |
| 8546 | Wywoływany element wysłał nieprawidłowe żądanie |
| 8547 | Opcja mówienia nie pasuje |
| 8548 | Połączenie nie jest połączeniem grupowym |
| 8549 | Nie udało się utworzyć konwersacji retargetingowej |
| 8550 | Negocjacja mediów dla ponownego kierowania nie powiodła się |
| 8551 | Retargetowanie nie jest obsługiwane |
| 8552 | Nie można usunąć organizatora |
| 8553 | Zduplikowane nagranie |
| 8554 | Miks audio uczestnika spoza spotkania |
| 8555 | Retarget już w toku |
| 8556 | Akcja nie jest obsługiwana dla wywołania CR |
| 8557 | Nieprawidłowy typ formatu |
| 8558 | Uczestnik nie jest obecny |
| 8559 | Duplikuj pojedyncze połączenie wychodzące |
| 8560 | Dołącz do konwersacji zablokowanej z powodu zablokowanego spotkania |
| 8561 | Nieprawidłowy identyfikator dołączania do spotkania |
| 8562 | Tryb nagrywania nie jest obsługiwany |
| 8563 | Mowa nie została rozpoznana |
| 8564 | Błąd połączenia z usługą rozpoznawania mowy |
| 8565 | Błąd usługi Cognitive Services |
| 8566 | Operacja włączenia dźwięku jest niedozwolona |
| 8567 | Jednostka usługi zasobu ACS nie jest włączona |
| 8568 | Żądanie usługi Cognitive Services z użyciem tożsamości zarządzanej zakończyło się niepowodzeniem |
| 8571 | Konflikt podczas nagrywania |
| 8569 | Rozpoznawanie mowy |
| 8570 | Błąd rozpoznawania mowy w usługach Cognitive Services |
| 8572 | Zamykanie usługi odtwarzania |
| 8573 | Metoda wstrzymania/wznawiania jest 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 kod SSML |
| 8583 | Warunek wstępny nie został spełniony |
| 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 wyznaczonym czasie |
| 8588 | Zakończono nagrywanie i przekroczono limit czasu odbioru mediów |
| 8589 | Rekord ograniczony |
| 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 do transkrypcji nie jest obsługiwany |
| 8606 | Tworzenie identyfikatora komunikacji nie powiodło się |
| 8607 | Konflikt operacji transferu |
| 8608 | Błąd klienta uczestnika nagrywania |
| 8609 | Nieprawidłowa odpowiedź dołączenia od bota |
| 8610 | Brak odpowiedzi bota na powiadomienie |
| 8613 | Osiągnięto limit napisów na żywo z powodu ograniczenia liczby wywołań |
| 9001 | Nieznany błąd z usługi bazowej |
| 9002 | Błąd limitu czasu usługi bazowej |
| 9003 | Błąd anulowania operacji |
| 9998 | Błąd krytyczny |
| 9999 | Unknown |
Kody diagnostyczne SIP i Q.850 w zdarzeniach wywołania zwrotnego
Zdarzenia wywołania zwrotnego usługi Call Automation obsługują teraz dane diagnostyczne niskiego poziomu za pośrednictwem pól SipDetails i Q850Details, dodanych do istniejącego obiektu ResultInformation.
Te dane diagnostyczne obejmują szczegółowe informacje na poziomie protokołu z warstwy sygnalizowania telekomunikacyjnego, pomagając rozwiązywać problemy, takie jak przerywanie połączeń, nieochwytne miejsca docelowe lub nieoczekiwane odrzucenia w scenariuszach PSTN i SIP/VoIP.
Availability
Note
Obecność SipDetails i Q850Details jest całkowicie zależna od tego, czy zaangażowany przewoźnik SBC czy telekomunikacyjny dostarcza te informacje.
Jeśli sterownik graniczny sesji (SBC)/operator zwróci odpowiednie informacje diagnostyczne po odpowiednim żądaniu sygnalizacyjnym automatyzacji połączeń, wynikowe zdarzenie będzie zawierać SipDiagnosticInfo w obrębie ResultInformation.
Zdarzenia, których dotyczy problem
Następujące zdarzenia mogą zawierać SipDiagnosticInfo w swoich ResultInformation:
RemoveParticipantsFailedAddParticipantsFailedCreateCallFailedAnswerFailedCallDisconnectedTransferFailedCanAddParticipantFailed
W praktyce każde zdarzenie callback zawierające ResultInformation może zawierać te dane diagnostyczne, jeśli zostały one dostarczone przez SBC/operatora.
Struktura
Każda diagnostyka jest reprezentowana jako obiekt:
| Majątek | Typ | Description |
|---|---|---|
Code |
Integer | KOD SIP lub Q.850 (np. 486, 16) |
Message |
Sznurek | Powód czytelny dla człowieka (np. „Linia zajęta”) |
Pola te są opcjonalne i pojawiają się tylko wtedy, gdy zostały dostarczone przez SBC/przewoźnika.
Example
{
"ResultInformation": {
"Code": 500,
"SubCode": 560503,
"Message": "Unexpected server error",
"SipDetails": {
"Code": 486,
"Message": "Busy Here"
},
"Q850Details": {
"Code": 17,
"Message": "User busy"
}
}
}
Kody odpowiedzi połączeń PSTN z parametrem ParticipantEndReason
Ta sekcja zawiera informacje dotyczące rozwiązywania problemów dla różnych kombinacji ParticipantEndReason kodów odpowiedzi i ParticipantEndSubCode . W tabelach w tej sekcji, ParticipantEndReason = Code i ParticipantEndSubCode = SubCode.
Ogólnie rzecz biorąc, jeśli wartość ParticipantEndSubCode zaczyna się od 560 lub 540, oznacza to, że SBC użytkownika lub operatora wygenerował kod odpowiedzi. Jest to przydatne w przypadku rozwiązywania problemów z wywołaniami routingu bezpośredniego, ponieważ podkodowanie może pomóc określić, czy błąd pochodzi z SBC, czy z usługi firmy Microsoft. Kod podrzędny rozpoczynający się od 560 reprezentuje połączenie wychodzące, a podkod rozpoczynający się od 540 reprezentuje połączenie przychodzące. W obu przypadkach sprawdź dzienniki SBC.
Jeśli na przykład wartość ParticipantEndSubCode wynosi 560403, oznacza to, że było to połączenie wychodzące, SBC wygenerował końcowy kod odpowiedzi, a kod odpowiedzi SIP z SBC wynosił 403. Rozpocznij rozwiązywanie problemów z połączeń, sprawdzając dzienniki SBC.
W przypadku ParticipantEndSubCode odpowiedzi, które nie zaczynają się od 560 lub 540, usługa firmy Microsoft wygenerowała końcowy kod odpowiedzi.
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 | Code | Message | Kategorie wyników | Advice |
|---|---|---|---|---|
| 0 | 0 | Połączenie zostało pomyślnie zakończone przez lokalnego uczestnika. | Success | |
| 560000 | 0 | Normalne zakończenie połączenia PSTN: — Użytkownik zakończył połączenie. - Połączenie zakończone przez agenta medialnego. |
Success | |
| 540000 | 0 | Normalne zakończenie połączenia PSTN: — Użytkownik zakończył połączenie. - Połączenie zakończone przez agenta medialnego. |
Success |
UczestnikEndReason 4xx
Odpowiedź ParticipantEndReason z wartością 4xx oznacza, że wywołanie nie nawiązało połączenia.
| SubCode | Code | Message | Kategorie wyników | Advice |
|---|---|---|---|---|
| 510403 | 403 | Połączenie zablokowane: - Nie znaleziono pasującej trasy głosowej dla numeru wybranego. - Nie podano alternatywnego identyfikatora dla wywołania. - Numer telefonu nie jest dozwolony przez kontroler granic sesji użytkownika (SBC). — Wcześniej oznaczone jako spam i teraz zablokowane. |
Aby uzyskać więcej informacji na temat alternatywnego identyfikatora, zobacz Zarządzanie wywołaniami. — Upewnij się, że masz prawidłową trasę głosową dla numeru wybranego. — 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 połączeń routingu bezpośredniego sprawdź, dlaczego kontroler graniczny sesji nie zezwolił na połączenie. — Upewnij się, że token usług komunikacyjnych jest prawidłowy i nie wygasł. |
|
| 560403 | 403 | - Wywołanie zabronione. - Połączenie zostało anulowane. - Połączenie odrzucone. |
Upewnij się, że dzwonisz pod prawidłowy numer telefonu we właściwym formacie. Aby uzyskać więcej informacji na temat obsługiwanych formatów liczb, zobacz https://en.wikipedia.org/wiki/E.164. | |
| 511532 | 403 | Nie znaleziono konfiguracji magistrali SIP dla zasobu. | Sprawdź konfigurację routingu bezpośredniego w witrynie Azure Portal. Aby uzyskać więcej informacji, zobacz Direct routing provisioning. | |
| 560404 | 404 | - Nie można odnaleźć numeru telefonu. - Numer telefonu nie został przypisany do żadnego miejsca docelowego. - Numer telefonu jest niedozwolony przez kontroler graniczny 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 do tego 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 połączeń z routingiem bezpośrednim sprawdź dzienniki sterownika granicy sesji (SBC), jego ustawienia oraz konfigurację limitów czasu. |
|
| 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 połączeń z routingiem bezpośrednim sprawdź dzienniki SBC, jego ustawienia oraz konfigurację limitów czasu. |
|
| 531004 | 410 | Sprawdzanie interaktywnego ustanowienia łączności (ICE) nie powiodło się. | - Nie można utworzyć ś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 dokumencie 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. - Wywoływany użytkownik jest tymczasowo niedostępny. |
- Dokładnie sprawdź, dlaczego nazwana partia nie odpowiedziała. - Spróbuj połączyć się ponownie później, jeśli abonent wywoływany był tymczasowo niedostępny. - W przypadku połączeń z routingiem bezpośrednim sprawdź dzienniki SBC oraz ustawienia i konfigurację limitów czasu. |
|
| 560484 | 484 | - Niekompletny lub nieprawidłowy adres abonenta wywoływanego. - 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ń. |
|
| 540486 | 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 połączeń z routingiem bezpośrednim sprawdź dzienniki SBC, ustawienia oraz konfigurację limitów czasu. |
|
| 560486 | 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 połączeń w ramach routingu bezpośredniego sprawdź dzienniki, ustawienia i konfigurację limitów czasu SBC. |
|
| 540487 | 487 | Osoba dzwoniąca anulowała żądanie połączenia. | Ponów próbę połączenia. | |
| 560487 | 497 | - Osoba dzwoniąca anulowała żądanie połączenia. - Żądanie zostało zakończone z powodu normalnego zakończenia połączenia. |
Ponów połączenie. |
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 | Code | Message | Kategorie wyników | Advice |
|---|---|---|---|---|
| 560500 | 500 | Wystąpił wewnętrzny błąd serwera w jednej z usług uczestniczących w tym wywołaniu. | - Ponów połączenie. Jeśli problem będzie się powtarzać, skontaktuj się z dostawcą telco lub pomocą techniczną firmy Microsoft. — W przypadku połączeń z routingiem bezpośrednim sprawdź dzienniki SBC oraz jego ustawienia i konfigurację limitów czasu, aby ustalić, czy to SBC spowodował niepowodzenie. |
|
| 560503 | 503 | - Wywołanie nie powiodło się z powodu wewnętrznego błędu serwera w jednej z usług uczestniczących w wywołaniu. - Sieć używana do zestawienia połączenia nie działa. - Tymczasowe niepowodzenie jednej z usług uczestniczących w wywołaniu. |
— Sprawdź konfigurację sieci i routingu pod kątem możliwych problemów. Sprawdź, czy reguły zapory sieciowej są poprawne. - Ponów połączenie. 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 | Code | Message | Kategorie wyników | Advice |
|---|---|---|---|---|
| 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.
| Code | Message | Advice |
|---|---|---|
| 401 | Unauthorized | Upewnij się, że token usług komunikacyjnych jest prawidłowy i nie wygasł. |
| 403 | Forbidden | 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.
| Code | Message | Advice |
|---|---|---|
| 2000 | Komunikat został dostarczony pomyślnie. | |
| 4000 | Komunikat jest odrzucany z powodu wykrywania oszustw. | Upewnij się, że nie przekraczasz maksymalnej liczby wiadomości dozwolonej dla Twojego numeru. |
| 4001 | Komunikat jest odrzucany z powodu nieprawidłowego formatu źródła/od numeru | Upewnij się, że numer w polu „Do” ma format E.164, a numer w polu „Od” ma format E.164 lub format krótkiego kodu. |
| 4002 | Wiadomość została odrzucona z powodu nieprawidłowego formatu numeru odbiorcy. | 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 | Wiadomość nie została dostarczona, ponieważ numer docelowy 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 jest nieosiągalny. | Spróbuj ponownie wysłać wiadomość później. |
| 4007 | Numer Destination/To zrezygnował z odbierania komunikatów od Użytkownika. | Oznacz numer w polu „Miejsce docelowe/Do” jako wypisany, aby nie były już podejmowane dalsze próby wysyłania wiadomości na ten numer. |
| 4008 | Przekroczono maksymalną liczbę komunikatów dozwolonych dla profilu. | Upewnij się, że nie przekraczasz maksymalnej liczby wiadomości dozwolonej dla Twojego numeru, albo użyj kolejek do grupowania wiadomości w 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ą. |
| 4020 | Komunikat odrzucony przez przewoźnika z powodu naruszenia woluminu. | Upewnij się, że nie przekraczasz maksymalnej liczby wiadomości dozwolonej dla Twojego numeru, albo użyj kolejek do grupowania wiadomości w partie. |
| 5000 | Nie udało się dostarczyć wiadomości. 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 | Wiadomość nie została dostarczona z powodu nieznanego błędu. | Spróbuj ponownie wysłać wiadomość. |