Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Tento článek popisuje řešení potíží s kódy koncových odpovědí volání pro volání sady SDK, automatizace volání a volání do veřejné telefonní sítě.
Tipy pro řešení potíží
Při řešení potíží zvažte následující tipy:
- Vaše aplikace nepřijímá
IncomingCall Event Gridudálost: Při vytváření odběru událostí se ujistěte, že je koncový bod aplikace ověřen pomocí Event Gridu . Stav zřizování odběru událostí se označí jako úspěšný, pokud bylo ověření úspěšné. -
The field CallbackUri is invalidChyba: Automatizace volání nepodporuje koncové body HTTP. Ujistěte se, že adresa URL zpětného volání, kterou zadáte, podporuje HTTPS. - Akce
PlayAudionic nehraje: U zvukových souborů se v současné době podporuje jenom formát Wave (.wav). Zvukový obsah v souboru wave musí být mono (jednokanálové), 16bitové vzorky s vzorkovací frekvencí 16 000 (16 KHz). - Akce u koncových bodů veřejné telefonní sítě nefungují: Pro
CreateCall,TransferAddParticipant, aRedirectna telefonní čísla je potřeba nastavitSourceCallerIdv žádosti o akci. Pokud nepoužíváte přímé směrování, musí být ID zdrojového volajícího telefonním číslem vlastněným prostředkem komunikační služby, aby akce byla úspěšná.
Další informace o problémech sledovaných produktovými týmy najdete v tématu Známé problémy.
Note
Kategorie zpráv a výsledků uvedené v následujících tabulkách jsou ve verzi Public Preview. Další informace najdete v dodatečných podmínkách použití pro verze Preview v Microsoft Azure.
Principy chyb volání a podkódů
Kódy chyb, podkódy a odpovídající kategorie výsledků pomáhají vývojářům identifikovat a diagnostikovat chyby. Tyto kódy chyb jsou zpřístupněny prostřednictvím call.callEndReason vlastnosti po ukončení volání.
Podrobnosti o kódu chyby zahrnují:
Kód – jedná se o 3místná celá čísla představující stav odpovědi klienta nebo serveru. Kategorie kódu:
- Úspěšné odpovědi (200–299)
- Chyba klienta (400–499)
- Chyba serveru (500–599)
- Globální chyba (600–699)
Podkód – definuje se jako celé číslo, kde každé číslo označuje jedinečný důvod specifický pro skupinu scénářů nebo konkrétní výsledek scénáře.
Zpráva – popisuje výsledek a poskytuje rady, jak zmírnit problém, pokud je výsledkem selhání.
ResultCategory – označuje typ chyby. V závislosti na kontextu může být Successhodnota , ExpectedError, UnexpectedClientError, nebo UnexpectedServerError.
Kódy chyb a podkódy klienta služby Azure Communication Services volající sdk
U chyb klienta, pokud je ExpectedErrorvlastnost resultCategories , chyba se očekává z pohledu sady SDK. K těmto chybám běžně dochází v selháních předpokladů, jako jsou nesprávné argumenty předané aplikací nebo když aktuální stav systému nepovoluje volání rozhraní API. Aplikace by měla zkontrolovat důvod chyby a logiku pro vyvolání rozhraní API.
| Subcode | Code | Message | Kategorie výsledků | Advice |
|---|---|---|---|---|
| 40101 | 408 | Vytvoření callagentu se nezdařilo. Zkuste to znovu, pokud problém přetrvává, shromážděte protokoly konzoly prohlížeče, .HAR soubor a obraťte se na podporu služby Azure Communication Services. |
UnexpectedClientError | |
| 40104 | 408 | Vytvoření callagentu se nezdařilo. Zkuste to znovu, pokud problém přetrvává, shromážděte protokoly konzoly prohlížeče, .HAR soubor a obraťte se na podporu služby Azure Communication Services. |
UnexpectedClientError | |
| 40114 | 408 | Připojení k infrastruktuře služby Azure Communication Services se nezdařilo. Zkuste to znovu a zkontrolujte síťové požadavky prohlížeče. Pokud požadavky stále selhávají, shromážděte protokoly konzoly prohlížeče, .HAR soubor a obraťte se na podporu služby Azure Communication Services. |
UnexpectedClientError | Další informace najdete v požadavcích na síť. |
| 40115 | 412 | Nepodařilo se vytvořit CallAgent, nepodařilo se inicializovat připojení k infrastruktuře služby Azure Communication Services. Zkuste to znovu a zkontrolujte síťové požadavky prohlížeče. Pokud požadavky stále selhávají, shromážděte protokoly konzoly prohlížeče, .HAR soubor a obraťte se na podporu služby Azure Communication Services. |
UnexpectedClientError | Další informace najdete v požadavcích na síť. |
| 40216 | 500 | Vytvoření callagentu se nezdařilo. Zkuste to znovu, pokud problém přetrvává, shromážděte protokoly konzoly prohlížeče a obraťte se na podporu služby Azure Communication Services. | UnexpectedClientError | |
| 40228 | 409 | Vytvoření CallAgent se nezdařilo, instance CallAgent přidružené k této identitě již existuje. Odstraňte existující callagent nebo vytvořte nový s jinou identitou. | ExpectedError | |
| 40230 | 409 | Nelze vytvořit TeamsCallAgent, instanci TeamsCallAgent přidruženou k této identitě již existuje. Před vytvořením nového objektu odstraňte existujícího agenta TeamsCallAgent. | ExpectedError | |
| 40606 | 405 | Zobrazení výčtu reproduktorů se nezdařilo. Není podporováno zobrazení výčtu nebo výběru reproduktorů v androidu Chrome, iOS Safari ani macOS Safari. | ExpectedError | Výčet a výběr mluvčího se nepodporuje v Android Chrome, iOS Safari ani macOS Safari. Operační systém automaticky vybere reproduktor (výstupní zařízení). Přečtěte si další informace o správě zařízení a o tom, jak tyto problémy co nejlépe zmírnit. |
| 40613 | 400 | Nepodařilo se získat oprávnění k použití mikrofonu nebo kamery, bylo zamítnuto nebo selhalo. Ujistěte se, že chcete povolit oprávnění v prohlížeči a v nastavení operačního systému. | ExpectedError | Přečtěte si další informace o tom, jak nejlépe zpracovat oprávnění zařízení. |
| 40614 | 500 | Nepovedlo se požádat o oprávnění zařízení, ujistěte se, že se oprávnění povolí v nastavení prohlížeče a v nastavení operačního systému a zkuste to znovu. Pokud problém přetrvává, shromážděte protokoly konzoly prohlížeče a obraťte se na podporu služby Azure Communication Services. | UnexpectedClientError | Přečtěte si další informace o tom, jak nejlépe zpracovat oprávnění zařízení. |
| 41006 | 400 | Příchozí hovor se nepovedlo přijmout, není ve stavu vyzvánění. Přihlaste se k odběru incomingCall události CallAgent a přijměte příchozí hovor. |
ExpectedError | Informace o původní příčině problému najdete v následujících článcích. - Přijetí příchozího hovoru - Přihlášení k odběru událostí sady SDK |
| 41007 | 400 | Příchozí hovor se nepodařilo odmítnout, není ve stavu vyzvánění. Přihlaste se k odběru incomingCall události CallAgent a zamítněte příchozí hovor. |
ExpectedError | Informace o původní příčině problému najdete v následujících článcích. - Přijetí příchozího hovoru - Přihlášení k odběru událostí sady SDK |
| 41015 | 500 | Ztlumení mikrofonu se nezdařilo. Zkuste to znovu, pokud problém přetrvává, shromážděte protokoly konzoly prohlížeče a obraťte se na podporu služby Azure Communication Services. | UnexpectedClientError | |
| 41016 | 400 | Ztlumení mikrofonu se nezdařilo. Zkuste to znovu, pokud problém přetrvává, shromážděte protokoly konzoly prohlížeče a obraťte se na podporu služby Azure Communication Services. | UnexpectedClientError | |
| 41025 | 400 | Spuštění videa se nezdařilo, instance LocalVideoStream je neplatná nebo prázdná. Předejte instanci LocalVideoStream. | ExpectedError | Ujistěte se, že objekt předaný ke spuštění videa je instance LocalVideoStream. LocalVideoStream Vytvoření objektu VideoDeviceInfo nebo objektu MediaStream pomocí Pokud chcete zjistit původní příčinu problému, projděte si následující články: - Volání pomocí videokamery - Spuštění a zastavení odesílání místního videa během hovoru - Nezpracované video v Accessu |
| 41027 | 400 | Nepovedlo se spustit video, video už je spuštěné. | ExpectedError | Užitečné odkazy: - Volání pomocí videokamery - Spuštění a zastavení odesílání místního videa během hovoru |
| 41030 | 400 | Video se nepovedlo zastavit, video je už zastavené. | ExpectedError | Užitečné odkazy: - Volání pomocí videokamery - Spuštění a zastavení odesílání místního videa během hovoru |
| 41032 | 400 | Nepodařilo se zastavit video, neplatný argument. LocalVideoStream použitý jako vstup se aktuálně neodesílají. | ExpectedError | LocalVideoStream, který se odesílá ve volání, je uložen v poli Call.localVideoStreams[] a je typu Video nebo RawMedia. Pokud chcete zjistit původní příčinu problému, projděte si následující články: - Volání pomocí videokamery - Spuštění a zastavení odesílání místního videa během hovoru - Nezpracované video v Accessu |
| 41033 | 500 | Volání se nezdařilo. Zkuste to znovu, pokud problém přetrvává, shromážděte protokoly konzoly prohlížeče a obraťte se na podporu služby Azure Communication Services. | UnexpectedClientError | |
| 41034 | 500 | Volání se nepovedlo obnovit. Zkuste to znovu, pokud problém přetrvává, shromážděte protokoly konzoly prohlížeče a obraťte se na podporu služby Azure Communication Services. | UnexpectedClientError | |
| 41035 | 400 | Sdílení obrazovky se nepovedlo spustit, sdílení obrazovky je už spuštěné. | ExpectedError | Další informace o tom, jak spustit a zastavit sdílení obrazovky během hovoru |
| 41041 | 400 | Sdílení obrazovky se nepovedlo zastavit, sdílení obrazovky je už zastavené. | ExpectedError | Další informace o tom, jak spustit a zastavit sdílení obrazovky během hovoru |
| 41048 | 410 | Během procesu nastavení hovoru se nepovedlo spustit video. Ujistěte se, že chcete povolit oprávnění k videu v nastavení prohlížeče a v nastavení operačního systému a ujistěte se, že zařízení fotoaparátu nepoužívá jiný proces. | UnexpectedClientError | - Zařízení fotoaparátu může být v systému zakázané. - Kameru používá jiný proces. |
| 41056 | 412 | Nepodařilo se zahájit hovor nebo se připojit k hovoru, pro tento prostředek služby Azure Communication Services není povolená zásada hlasu Teams Enterprise. Postupujte podle kurzu online a povolte ho. | ExpectedError | Přečtěte si, jak uživatelům povolit online a Telefonní systém Hlasovou schránku pro Teams Enterprise |
| 41071 | 412 | Nepovedlo se spustit sdílení obrazovky, hovor není ve stavu Připojeno. Přihlaste se k odběru události volání stateChanged , abyste věděli, kdy je hovor připojený. |
ExpectedError | Užitečné odkazy: - Kontrola vlastností volání - Přihlášení k odběru událostí sady SDK |
| 41073 | 412 | Nepovedlo se získat nebo nastavit vlastní MediaStream. Tato funkce je aktuálně zakázaná službou Azure Communication Services. | ExpectedError | |
| 43000 | 412 | Nepovedlo se spustit video, videoza zařízení používá jiný proces nebo aplikace. Zastavte, aby se vaše kamera používala v jiném procesu nebo aplikaci, a zkuste to znovu. | ExpectedError | Přečtěte si další informace o tom, jak nejlépe řešit kameru používanou jiným procesem. |
| 43001 | 403 | Nepovedlo se spustit video, oprávnění nebyla udělena k používání vybraného videoza zařízení. Ujistěte se, že jsou v nastavení prohlížeče a v nastavení systému povolená oprávnění videoza zařízení. | ExpectedError | Ujistěte se, že oprávnění fotoaparátu jsou povolená v nastavení prohlížeče a v nastavení systému zařízení. Ujistěte se, že kamery nejsou v nastavení systému zařízení zakázané. V systému macOS se ujistěte, že je záznam obrazovky povolený z nastavení systému. Užitečné odkazy: - Vyžádání oprávnění zařízení- Oprávnění ke sdílení obrazovky v systému macOS - Vytvoření výčtu nebo přístupu k zařízením pro Safari v macOS a iOS |
| 43002 | 500 | Nepovedlo se spustit video, neznámou chybu. Zkuste to ještě jednou. Pokud problém přetrvává, obraťte se na podporu služeb Azure Communication Services. | UnexpectedClientError | |
| 43004 | 400 | Nepodařilo se přepnout videozaloha, neplatný vstup. Vstup musí být typu VideoDeviceInfo. | ExpectedError | Pomocí správce zařízení získejte seznam objektů VideoDeviceInfo a pak pomocí objektu VideoDeviceInfo přepněte zdroj. Další informace o tom, jak spustit a zastavit odesílání místního videa během hovoru |
| 43005 | 400 | Nepodařilo se přepnout videoza zařízení, nejde přepnout na stejné videoza zařízení, které je už vybrané. | ExpectedError | |
| 43013 | 412 | Nepovedlo se spustit video, nenašla se žádná videoza zařízení. Ujistěte se, že jsou videoza zařízení připojená a povolená v nastavení systému. | ExpectedError | Ujistěte se, že máte na zařízení připojenou a nainstalovanou kameru. |
| 43014 | 412 | Nepodařilo se spustit video, chyba s žádostí o datový proud médií. Zkuste to znovu, pokud problém přetrvává, obraťte se na podporu služeb Azure Communication Services. | UnexpectedClientError | |
| 43015 | 412 | Spuštění videa se nezdařilo, vypršel časový limit požadavku na datový proud médií. Povolte oprávnění na příkazovém řádku prohlížeče pro přístup k fotoaparátu a zkuste to znovu. | ExpectedError | K této chybě může dojít v případě, že uživatel neprovádí akci na výzvě k povolení přístupu k fotoaparátu v prohlížeči. |
| 43016 | 412 | Spuštění videa, oprávnění odepřená systémem se nezdařila. Ujistěte se, že jsou v nastavení prohlížeče a v nastavení systému povolená oprávnění videoza zařízení. | ExpectedError | – Ujistěte se, že oprávnění fotoaparátu jsou povolená v nastavení prohlížeče a v nastavení systému zařízení. – Zajistěte, aby kamery nejsou v nastavení systému zařízení zakázané. – V systému macOS se ujistěte, že je záznam obrazovky povolený z nastavení systému. Užitečné odkazy: - Vyžádání oprávnění zařízení - Oprávnění ke sdílení obrazovky v systému macOS - Vytvoření výčtu nebo přístupu k zařízením pro Safari v macOS a iOS |
| 43017 | 412 | Spuštění videa, nepodporovaného streamu se nezdařilo. Zkuste to znovu, pokud problém přetrvává, obraťte se na podporu služeb Azure Communication Services. | UnexpectedClientError | |
| 43018 | 412 | Nepovedlo se spustit video, nepodařilo se nastavit omezení. Zkuste to znovu, pokud problém přetrvává, obraťte se na podporu služeb Azure Communication Services. | UnexpectedClientError | Další informace o nastavení omezení videa |
| 43019 | 412 | Nepovedlo se spustit video, žádné zařízení není vybrané. Ujistěte se, že chcete předat LocalVideoStream vytvořený pomocí VideoDeviceInfo a zkuste to znovu. Pokud problém přetrvává, obraťte se na podporu služeb Azure Communication Services. | UnexpectedClientError | Užitečné odkazy: - Volání pomocí videokamery - Spuštění a zastavení odesílání místního videa během hovoru |
| 43200 | 412 | Nepodařilo se vykreslit stream videa, tento stream není k dispozici. Přihlaste se k odběru vlastnosti isAvailable datového proudu, abyste dostávali oznámení, když má vzdálený účastník video zapnuté a stream je k dispozici pro vykreslování. | ExpectedError | Užitečné odkazy: - Vykreslení videa nebo sdílení obrazovek vzdáleného účastníka - Přidání videohovorů 1:1 do aplikace - Přihlášení k odběru událostí sady SDK |
| 43202 | 404 | Stream videa se nepovedlo vykreslit, tento stream už není dostupný. Vzdálený účastník vypnul své video. | ExpectedError | Vzdálený účastník vypnul své video při pokusu o vytvoření zobrazení. |
| 43203 | 408 | Při čekání na snímky videa se nepodařilo vykreslit datový proud videa, vypršel časový limit vykreslování. Zkuste to znovu, pokud problém přetrvává, obraťte se na podporu služeb Azure Communication Services. | UnexpectedClientError | |
| 43204 | 500 | Nepodařilo se vykreslit stream videa, nepodařilo se přihlásit k odběru videa v infrastruktuře služby Azure Communication Services. Zkuste to znovu, pokud problém přetrvává, obraťte se na podporu služeb Azure Communication Services. | UnexpectedClientError | |
| 43209 | 405 | Nepodařilo se vykreslit video stream, VideoStreamRenderer byl uvolněn během procesu inicializace. | ExpectedError | |
| 43210 | 400 | Nepovedlo se likvidovat VideoStreamRenderer, protože už je uvolněný. | ExpectedError | |
| 43220 | 400 | Vytvoření zobrazení se nezdařilo, maximální počet aktivních RemoteVideoStream zobrazení, která už byla dosažena. Pokud chcete vytvořit nový, můžete zlikvidovat předchozí. |
ExpectedError | Přečtěte si další informace o tom, jak správně podporovat nejlepší počet příchozích streamů videa. |
| 71005 | 401 | Volání selhalo kvůli chybě ověření ve službě Azure Communication Services. Zkuste to znovu, pokud problém přetrvává, obraťte se na podporu služeb Azure Communication Services. | UnexpectedClientError | |
| 480 | Koncový bod vzdáleného klienta není zaregistrovaný. | Ujistěte se, že je vzdálený koncový bod dostupný. | ||
| 481 | Zpracování příchozího hovoru se nezdařilo. | Vytvořte žádost o podporu prostřednictvím webu Azure Portal. | ||
| 487 | Volání se zrušilo, místně odmítlo, skončilo kvůli problému s neshodou koncových bodů nebo se nepodařilo vygenerovat nabídku médií. | Očekávané chování | ||
| 490, 491, 496, 497, 498 | Problémy se sítí místního koncového bodu | Zkontrolujte síť. | ||
| 503, 504 | Chyba infrastruktury komunikačních služeb | Vytvořte žádost o podporu prostřednictvím webu Azure Portal. | ||
| 600 | Zaneprázdněn všude. Účastník se úspěšně kontaktoval, ale vrátil zaneprázdněný signál. | Očekávané chování | ||
| 603 | Volání globálně odmítnuto účastníkem vzdálené komunikační služby. | Očekávané chování | ||
| 604 | Neexistuje nikde. Požadovaný identifikátor URI neexistuje. | Očekávané chování | ||
| 606 | Není přijatelné. Účastník se úspěšně kontaktoval, ale nemůže podporovat popsanou relaci. | Očekávané chování |
Principy chyb volání a podkódů
Kódy chyb, podkódy a odpovídající kategorie výsledků pomáhají vývojářům identifikovat a diagnostikovat chyby. Tyto kódy chyb jsou zpřístupněny prostřednictvím call.callEndReason vlastnosti po ukončení volání.
Podrobnosti o kódu chyby zahrnují:
Kód – jedná se o 3místná celá čísla představující stav odpovědi klienta nebo serveru. Kategorie kódu:
- Úspěšné odpovědi (200–299)
- Chyba klienta (400–499)
- Chyba serveru (500–599)
- Globální chyba (600–699)
Podkód – definuje se jako celé číslo, kde každé číslo označuje jedinečný důvod specifický pro skupinu scénářů nebo konkrétní výsledek scénáře.
Zpráva – popisuje výsledek a poskytuje rady, jak zmírnit problém, pokud je výsledkem selhání.
ResultCategory – označuje typ chyby. V závislosti na kontextu může být Successhodnota , ExpectedError, UnexpectedClientError, nebo UnexpectedServerError.
Volání kódů koncových volání a podkódů
Existují různá vysvětlení, proč hovor skončil. Tady jsou významy kódů volání a dílčích kódů, které ukazují, jak může volání končit.
| Subcode | Code | Message | Kategorie výsledků | Advice |
|---|---|---|---|---|
| 0 | 0 | Hovor byl úspěšně ukončen místním účastníkem. | Success | |
| 0 | 487 | Hovor byl úspěšně ukončen, protože volající hovor zrušil. | Success | |
| 0 | 603 | Hovor byl úspěšně ukončen, protože byl odmítnut z volaný. | Success | Hovor skončil, protože byl odmítnut od cílového uživatele prostřednictvím klientské sady SDK, automatizace volání, grafu, veřejné telefonní sítě nebo funkce zamítnutí Teams. |
| 7 | 496 | Volání skončilo, protože klient náhle ztratil síťové připojení a navzdory opakovanému opakování se nemohl připojit | ExpectedError | Prohlížeč je offline nebo má problémy se sítí. Zkontrolujte síťové připojení prohlížeče a zkuste to znovu. |
| 3100 | 410 | Instalace volání selhala kvůli neočekávanému problému se sítí v klientovi, zkontrolujte síť klienta a zkuste to znovu. | UnxpectedClientError | Zkontrolujte konfiguraci sítě a ujistěte se, že splňuje požadavky sítě azure Communication Call. |
| 3101 | 410 | Volání se přeruší kvůli neočekávanému problému se sítí v klientovi, zkontrolujte síť klienta a zkuste to znovu. | UnxpectedClientError | Zkontrolujte konfiguraci sítě a ujistěte se, že splňuje požadavky sítě azure Communication Call. |
| 3111 | 410 | Nastavení volání se nezdařilo, při připojování hovoru se nepodařilo zpracovat nabídku médií. | UnxpectedClientError | Zkuste to ještě jednou. Pokud problém přetrvává, shromážděte informace o volání, protokoly klienta, protokoly konzoly prohlížeče a obraťte se na podporu služby Azure Communication Services. |
| 3112 | 410 | Instalace volání selhala kvůli problému s konfigurací sítě na straně klienta, zkontrolujte konfiguraci sítě klienta a zkuste to znovu. | ExpectedError | Další podrobnosti o volání končícím podkódem 3112 najdete tady. |
| 4097 | 0 | Hovor skončil pro všechny uživatele organizátorem schůzky. | Success | |
| 4502 | 490 | Volání selhalo kvůli problémům s připojením k síti, prohlížeč nedokončí požadavek HTTP sítě. | UnexpectedClientError | Klientovi se nepodařilo dokončit požadavek a odpověď HTTP. Zkuste to ještě jednou. Pokud problém přetrvává, shromážděte informace o volání, protokoly klienta, protokoly konzoly prohlížeče a obraťte se na podporu služby Azure Communication Services. |
| 4506 | 408 | Vypršel časový limit hovoru. Zkontrolujte, jestli volal volaný a přijal hovor. | UnexpectedClientError | Zkuste to ještě jednou. Pokud problém přetrvává, shromážděte informace o volání, protokoly klienta, protokoly konzoly prohlížeče a obraťte se na podporu služby Azure Communication Services. |
| 4507 | 495 | Volání skončilo, protože aplikace neposkytla platný token služby Azure Communication Services. | UnexpectedClientError | Ujistěte se, že vaše aplikace implementuje mechanismus aktualizace tokenů správně. |
| 4521 | 0 | Hovor skončil, protože uživatel se náhle odpojil od hovoru. Příčinou může být to, že uživatel zavře aplikaci, která hostovala volání, například uživatel ukončil aplikaci zavřením karty prohlížeče bez správného zablokování. | ExpectedError | |
| 5000 | 0 | Hovor pro tohoto účastníka skončil. Účastník byl odebrán z konverzace jiným účastníkem. | Success | |
| 5003 | 0 | Volání ukončila služba Azure Communication Service, protože hovor skončil. | Success | |
| 5300 | 0 | Hovor pro tohoto účastníka skončil, protože byl odebrán z konverzace jiným účastníkem. | Success | Hovor pro tohoto účastníka skončil, protože ho odebral jiný účastník, může se jednat o jiného klienta, rozhraní API pro automatizaci volání nebo rozhraní Graph API. |
| 5317 | 0 | Cílový účastník se odebere kvůli aktualizaci role účastníka. | ExpectedError | |
| 5828 | 403 | Připojení není pro schůzku místností autorizované, protože uživatel není součástí seznamu pozvaných osob. | UnexpectedClientError | |
| 5829 | 403 | Připojení není povolené pro schůzku místnosti za koncovým časem nebo před začátkem schůzky. | UnexpectedClientError | |
| 5830 | 403 | Ke schůzce místností se může připojit jenom uživatel komunikačních služeb. | ExpectedError | |
| 7000 | 0 | Volání skončilo rozhraním API pro automatizaci volání služby Azure Communication Service nebo serverovým robotem. | Success | Volání skončilo rozhraním API služby ACS Pro automatizaci volání nebo robotem Graphu. |
| 10003 | 487 | Volání se pro tento koncový bod uživatele zrušilo, protože ho přijal jiný koncový bod jinde. | Success | Hovor byl zahájen pro cílového uživatele (zahájit hovor, přidat účastníka, přepojení), cílový uživatel měl současně více aktivních koncových bodů na jednom z koncových bodů, který hovor přijal. Toto je normální chování, pouze jeden koncový bod může přijmout a připojit se k volání. Všechny ostatní koncové body obdrží podkód 10003, aby bylo možné označit, že volání bylo již přijato. |
| 10004 | 487 | Při vypršení časového limitu se hovor zrušil, protože cílový uživatel ho včas nepřijal nebo odmítl. Ujistěte se, že uživatel viděl oznámení nebo aplikaci, aby ho mohl automaticky zpracovat, a zkuste ho znovu zahájit. | ExpectedError | Hovor byl zrušen po předdefinované době (obvykle 2 minuty), protože cílový uživatel nepřijal nebo odmítl. |
| 10009 | 401 | Neověřená identita Ujistěte se, že je token služby Azure Communication Services platný a nevypršela jeho platnost. | UnexpectedClientError | |
| 71005 | 401 | Volání selhalo kvůli chybě ověření ve službě Azure Communication Services. Zkuste to znovu, pokud problém přetrvává, obraťte se na podporu služeb Azure Communication Services. | UnexpectedClientError | |
| 10024 | 487 | Hovor byl úspěšně ukončen. Hovor odmítnutý všemi volanými koncovými body | Success | Zkuste hovor umístit znovu. |
| 10037 | 480 | Cílový uživatel neměl zaregistrované žádné koncové body ve službě ACS. Ujistěte se, že cílový uživatel má aspoň jeden aktivní koncový bod a je online. | ExpectedError | Pokud cílový uživatel používá sadu SDK pro volání služeb Azure Communication Services, ujistěte se, že se sada SDK úspěšně inicializuje ve své klientské aplikaci. Pokud je cílovým uživatelem uživatel Teams, ujistěte se, že je jeho klient online. Ujistěte se, že je správný identifikátor cílového uživatele (CommunicationUserIdentifier, MicrosoftTeamsUserIdentifier nebo MicrosoftTeamsBotIdentifier). Pokud má rozhraní Graph API user nastavenou vlastnostdepartment, Microsoft Communication Application InstanceMicrosoftTeamsBotIdentifier měla by být zadána. |
| 10057 | 408 | Volání selhalo, volané se nepodařilo dokončit nastavení volání, s největší pravděpodobností volanou ztracenou síť nebo aplikaci náhle ukončila. Ujistěte se, že jsou klienti připojení a jsou k dispozici. | ExpectedError | |
| 10076 | 480 | Cílový uživatel byl zaregistrován, ale nebyl online v době volání. Ujistěte se, že cílový uživatel má aspoň jeden aktivní koncový bod a je online. | ExpectedError | Pokud cílový uživatel používá sadu SDK pro volání služeb Azure Communication Services, ujistěte se, že se sada SDK úspěšně inicializuje ve své klientské aplikaci a že je jeho koncový bod online. Pokud je cílovým uživatelem uživatel Teams, ujistěte se, že je jeho klient online. |
| 10077 | 480 | Cílový uživatel byl zaregistrovaný ve službě ACS nebo pro nabízená oznámení, ale v době volání nebyl online. Ujistěte se, že cílový uživatel má aspoň jeden aktivní koncový bod a je online. | ExpectedError | Pokud cílový uživatel používá sadu SDK pro volání služeb Azure Communication Services, ujistěte se, že se sada SDK úspěšně inicializuje ve své klientské aplikaci a že je jeho koncový bod online. Pokud aplikace využívá nabízená oznámení, ujistěte se, že jsou správně nakonfigurovaná. Pokud je cílovým uživatelem uživatel Teams, ujistěte se, že je jeho klient online. |
| 10078 | 480 | Vzdálený koncový bod klienta není zaregistrovaný nebo není dostupný. Ujistěte se, že koncový bod vzdáleného klienta úspěšně odesílá síťové požadavky do služeb Azure Communication Services. | ExpectedError | – Pokud cílový uživatel používá sadu SDK pro volání služeb Azure Communication Services, ujistěte se, že se sada SDK úspěšně inicializuje ve své klientské aplikaci a že je koncový bod online. Pokud aplikace využívá nabízená oznámení, ujistěte se, že jsou správně nakonfigurovaná. – Pokud je cílový uživatel uživatelem Teams, ujistěte se, že je jeho klient online. |
| 301004 | 410 | Účastník byl z volání odebrán infrastrukturou služeb Azure Communication Services kvůli nemožnosti navázat připojení médií s infrastrukturou služby Azure Communication Services během nastavování volání. Zkontrolujte konfiguraci sítě uživatele, včetně místní sítě, bran firewall, konfigurace sítí VPN, a zkuste to znovu. | UnexpectedClientError | Ujistěte se, že je síť uživatele správně nakonfigurovaná, postupujte podle veřejné dokumentace Doporučení k síti. |
| 301005 | 410 | Účastník se odebral z hovoru infrastrukturou služby Azure Communication Services kvůli ztrátě připojení k médiím se stejnou infrastrukturou. K tomu obvykle dochází v případě, že účastník opustí hovor náhle nebo ztratí síťové připojení. Pokud chce účastník pokračovat v hovoru, může se znovu připojit. | UnexpectedClientError | Ujistěte se, že používáte nejnovější sadu SDK v podporovaném prostředí. |
| 540000 | 0 | Hovor byl úspěšně ukončen místním volajícím do veřejné telefonní sítě. | Success | |
| 510403 | 403 | Hovor je zablokovaný: - Pro vytočité číslo nebyla nalezena žádná odpovídající hlasová trasa. - Alternativní ID není zadáno pro volání. - Telefonní číslo nepovolené uživatelem Session Border Controller (SBC). - Dříve označí jako spam a teď je zablokovaný. |
ExpectedError | Další informace o alternativním ID najdete v tématu Správa volání. – Potvrďte, že máte platnou hlasovou trasu pro vytočení čísla. – Ujistěte se, že jste zadali platné alternativní ID. Musí to být telefonní číslo, které patří k prostředku, který používáte. – Ověřte, že vlastníte prostředek, který používáte k volání. – U přímých volání směrování ověřte, proč váš řadič ohraničení relace nepovolil volání. – Ujistěte se, že je token komunikační služby platný a nevypršela jeho platnost. |
| 540487 | 487 | Hovor byl úspěšně ukončen, protože volající hovor zrušil. | Success | |
| 560000 | 0 | Hovor byl úspěšně ukončen vzdáleným účastníkem veřejné telefonní sítě. | Success | Možné příčiny: - Uživatel hovor ukončil. - Hovor skončil mediálním agentem. |
| 560486 | 486 | Hovor skončil, protože vzdálený účastník veřejné telefonní sítě byl zaneprázdněn. Volaná čísla už byla v hovoru nebo má technické problémy. | Success | – V případě volání přímého směrování zkontrolujte konfiguraci protokolů a nastavení a časových limitů služby Session Border Control. Možné příčiny: Volaná čísla už byla v hovoru nebo má technické problémy. |
| 404 | Volání nebylo nalezeno. | Ujistěte se, že číslo, které voláte (nebo hovor, ke kterému se připojujete), existuje. | ||
| 408 | Vypršel časový limit ovladače hovoru. | Vypršel časový limit kontroleru volání čekající na zprávy protokolu z koncových bodů uživatele. Ujistěte se, že jsou klienti připojení a jsou k dispozici. | ||
| 410 | Chyba místní zásobníku médií nebo infrastruktury médií | Ujistěte se, že používáte nejnovější sadu SDK v podporovaném prostředí. | ||
| 430 | Zprávu nelze doručit klientské aplikaci. | Ujistěte se, že je klientská aplikace spuštěná a dostupná. | ||
| 480 | Koncový bod vzdáleného klienta není zaregistrovaný. | Ujistěte se, že je vzdálený koncový bod dostupný. | ||
| 481 | Zpracování příchozího hovoru se nezdařilo. | Vytvořte žádost o podporu prostřednictvím webu Azure Portal. | ||
| 490, 491, 496, 497, 498 | Problémy se sítí místního koncového bodu | Zkontrolujte konfiguraci sítě a ujistěte se, že splňuje požadavky sítě azure Communication Call. | ||
| 500, 503, 504 | Chyba infrastruktury komunikačních služeb | Vytvořte žádost o podporu prostřednictvím webu Azure Portal. |
Principy kódů volání a podkódů
Kdy se zobrazují kódy chyb?
Kódy chyb pro automatizaci volání můžou být buď synchronní odpovědi na volání rozhraní API, nebo asynchronní odpovědi prostřednictvím zadaného identifikátoru URI zpětného volání. V synchronní situaci, pokud se provede volání rozhraní API a není přijato, služba ACS poskytne kód chyby popisující, proč bylo volání rozhraní API odmítnuto. V asynchronních scénářích, pokud se provede volání rozhraní API a přijme se, ale něco se stále nepovede, obdrží se událost zpětného volání i kód chyby. Příkladem běžné události zpětného volání pro selhání volání by byla callDisconnected událost, která se zobrazí při každém odpojení volání.
callDisconnected Jakmile se událost přijme, už pro dané volání nebudou k dispozici žádné další události zpětného volání. Seznam událostí zpětného volání signalizačních volání najdete (na této stránce) a seznam událostí zpětného volání pro akce médií (tato stránka).
Syntaxe kódu chyby
Kódy chyb, podkódy a odpovídající kategorie výsledků pomáhají vývojářům identifikovat a diagnostikovat chyby. Podrobnosti o kódu chyby zahrnují:
Kód – jedná se o 3místná celá čísla představující stav odpovědi klienta nebo serveru. Kategorie kódu:
- Úspěšné odpovědi (200–299)
- Chyba klienta (400–499)
- Chyba serveru (500–599)
- Globální chyba (600–699)
Podkód – definuje se jako celé číslo, kde každé číslo označuje jedinečný důvod specifický pro skupinu scénářů nebo konkrétní výsledek scénáře.
Zpráva – popisuje výsledek a poskytuje rady, jak problém zmírnit, pokud je výsledkem selhání.
Kromě kódu a podkódu najdete podrobnější informace o řešení potíží v protokolech volání. Další informace o povolení a přístupu k protokolům volání najdete na této stránce s podrobnými pokyny.
Kódy chyb sady SDK pro automatizaci volání
Následující tabulka obsahuje nejběžnější kódy a podkódy. Pokud vaše chyba není v této tabulce, přečtěte si obecné kódy a podkódy a získejte další informace o vašem konkrétním scénáři.
Kódy chyb služby Automation volání
| Událost zpětného volání | Code | Subcode | Description | Mitigation |
|---|---|---|---|---|
| CreateCallFailed / AnswerFailed | 404 | 8522 | Obecný kód chyby, který označuje, že prostředek nebyl nalezen. Prostředky můžou zahrnovat hovory a účastníky. | Pečlivě zkontrolujte stav hovoru: Hovor už možná skončil nebo účastník hovor opustil. |
| Vytvoření hovoru selhalo / Odpověď selhala | 400 | 8523 | Obecný kód chyby, který označuje, že něco v textu požadavku je neplatné. | Zkontrolujte, jestli jsou všechny parametry platné. Informace o tom, který parametr vyvolá chybu, najdete v chybové zprávě. |
| Odpověď se nezdařila. | 400 | 8501 | Nepodporovaná volání se nesvážela | Akce přidružená k chybové zprávě byla aktivována, když volání nebylo aktivní. Ujistěte se, že se po odpojení volání nesicializovaly nové akce volání. Tato chyba může také vést k akcím vyvolaným během aktivního volání, pokud se blíží době odpojení volání. |
| Odpověď se nezdařila. | 400 | 8500 | Neplatný režim média | Zkontrolujte stav operací multimédií a zjistěte, jestli je některý z nich již aktivní, nebo jestli už je cílový účastník v operaci média. Pokud existuje aktivní operace média, počkejte na dokončení operace a pak akci opakujte. |
| CallDisconnected | 400 | 8559 | Akce nepodporuje pouze jednu povolenou aplikaci vytáčení | Duplicitní žádost o zahájení nahrávání, záznam již zahájený nebo probíhající. Před odesláním nového zahájení hovoru zkontrolujte stav záznamu a ujistěte se, že je neaktivní. |
| Odpověď se nezdařila. | 400 | 8528 | Akce se nedokončila. | Akce přidružená k chybové zprávě byla aktivována během ukončení hovoru. Ujistěte se, že se po ukončení hovoru nesicializovaly nové akce volání. Tato chyba může také vést k akcím vyvolaných během aktivního volání, pokud se blíží době ukončení volání. |
| Vytvoření hovoru se nezdařilo / Připojení se nezdařilo | 409 | 8519 | Conflict | Ujistěte se, že se na stejném prostředku paralelně neprovádí více akcí. Informace o tom, které dvě akce jsou v konfliktu, najdete v chybové zprávě. |
| CreateCallFailed | 403 | 7507 | Neplatná identita zdroje volání | Identita aplikace z autorizačního tokenu neodpovídá identitě aplikace ve zdroji volání. Zkontrolujte, jestli používáte připojovací řetězec z prostředku služby ACS, ve kterém byl webhook příchozího volání nakonfigurovaný (telefonní číslo musí vlastnit stejný prostředek služby ACS, který hovor přijme). |
| CreateCallFailed | 403 | 7504 | Nedostatečná oprávnění aplikace | Obecný kód pro nedostatečná oprávnění, zkontrolujte chybovou zprávu o kontextu, u jakého prostředku chybí oprávnění. |
| Odpověď se nezdařila. | 400 | 8585 | Akce není platná v aktuálním stavu volání | Volání není vytvořeno nebo je odpojeno: Před opakováním akce média počkejte, než se hovor naváže. |
| CreateCallFailed | 405 | 8520 | Funkce nejsou v tuto chvíli podporovány. | Očekávaná chyba: Pracovní postup není aktuálně podporován. Projděte si náš blog o vydání verze a zjistěte, jestli existuje aktualizovaná sada SDK, která tyto funkce povolila. Seznam nepodporovaných pracovních postupů najdete na stránce s známými omezeními služby Call Automation. |
| CreateCallFailed | 412 | 8583 | Předběžná podmínka selhala | Na tuto stránku se můžete odkazovat na nekompatibilní akce médií, abyste měli jistotu, že neběžíte nebo zařadíte do fronty nekompatibilní akce. |
| CreateCallFailed | 400 | 8567 | Instanční objekt prostředku služby ACS není povolený | Prostředek služby Azure Cognitive Service není správně nakonfigurovaný. Na této stránce najdete průvodce nastavením prostředku služby Azure Cognitive Service. |
| CreateCallFailed | 405 | 8522 | Chybějící konfigurace | Zkontrolujte chybovou zprávu, která obsahuje další kontext, ke kterému je potřeba navázat konfiguraci. Tato konfigurace se musí provést při vyvolání rozhraní ANSWERCall API. |
| CallDisconnected | 200 | 0 | Hovor byl úspěšně ukončen místním účastníkem. | Není nutná žádná akce; hovor skončil očekávaným způsobem. |
| CallDisconnected | 200 | 4521 | Účastník se náhle odpojil (např. uzavřená aplikace, karta nebo prohlížeč bez zavěsování). | Doporučte v klientovi logiku řádné zavěsit. Pomocí protokolů klienta ověřte, jestli byla aplikace vynuceně uzavřena. |
| CallDisconnected | 200 | 5000 | Účastník odebraný jiným účastníkem. | Zkontrolujte logiku řízení volání pro operace odebrání. Ověřte, jestli bylo odebrání úmyslné. |
| CallDisconnected | 200 | 5010 | Hovor skončil, protože zůstal jen jeden účastník. | Toto chování je očekávané. Pokud má hovor pokračovat, znovu se připojte k více účastníkům. |
| CallDisconnected | 200 | 5013 | Hovor skončil, protože se ke skupinovému hovoru nepřipojil nikdo jiný. | Zkontrolujte časování připojení účastníků. |
| CallDisconnected | 200 | 7000 | Volání skončilo službou Azure Communication Services Call Automation nebo robotem na straně serveru. | Ověřte, jestli logika robota aktivovala ukončení volání. Zkontrolujte implementaci robota a tok volání. |
| CallDisconnected | 200 | 7015 | Hovor skončil službou po úspěšném přenosu. | Není nutná žádná akce; volání bylo ukončeno jako součást očekávaného chování přenosu. |
| CallDisconnected | 487 | 0 | Hovor byl úspěšně ukončen, protože volající hovor zrušil. | Není potřeba žádná akce. Ujistěte se, že zrušení je úmyslné. |
| CallDisconnected | 487 | 10003 | Hovor přijal jiný koncový bod (např. jiný robot hovor přijal). Ujistěte se, že roboti odpovídají jenom na volání, která jsou na ně směrovaná. | Logika aplikace by měla zkontrolovat prioritu koncového bodu nebo logiku opětovné trasy. |
| CallDisconnected | 487 | 10024 | Volání odmítly všechny volané koncové body. | Není potřeba žádná akce. |
| CallDisconnected | 500 | 10045 | Chyba infrastruktury služby Azure Communication Services | Zachyťte protokoly a pokud problém přetrvává, obraťte se na podporu. |
| CallDisconnected | 503 | 560503 | Neočekávaná chyba serveru | Vnitřní chyba serveru, shromáždění protokolů a otevření lístku podpory |
| CreateCallFailed | 401 | 10009 | Neověřená identita | Ujistěte se, že je platný, vymezený a nevypršela platnost tokenu služby Azure Communication Services. |
| CreateCallFailed | 403 | 510403 | Volání označené jako spam a zablokované | Zkontrolujte vzor odchozího volání. Ujistěte se, že je v souladu se zásadami ochrany proti spamu. |
| CreateCallFailed | 403 | 560403 | Hovor byl zakázán, zrušen nebo odmítnut. | Ověřte oprávnění a stav cílového uživatele. |
| CreateCallFailed | 404 | 4500 | ID volání neexistuje nebo hovor již skončil. | Pečlivě zkontrolujte ID volání a životní cyklus volání. Ujistěte se, že neodkazujete na volání, jehož platnost vypršela. |
| CreateCallFailed | 480 | 10078 | Vzdálený účastník není zaregistrovaný nebo dostupný. | Ověřte, že je klientská aplikace volaná a zaregistrovaná. V případě potřeby to zkuste znovu později. |
| CreateCallFailed | 480 | 560480 | Žádná odpověď od volaný. | Potvrďte dostupnost uživatelů. |
| CreateCallFailed | 487 | 540487 | Hovor zrušený původcem. | Není potřeba žádná akce. Ověřte, že zdrojová aplikace zrušila volání podle očekávání. |
| Připojení selhalo | 408 | 10057 | Časový limit během připojení ke schůzce nebo přijetí hovoru | Ověřte připravenost účastníků a připravenost klienta. |
| Připojení selhalo | 429 | 10110 | Byla překročena maximální doba trvání volání. | Zkontrolujte zásady doby trvání volání. V případě potřeby zvažte plánování opětovného připojení. |
| Připojení selhalo | 480 | 10076 | Cílový uživatel je zaregistrovaný, ale offline. | Cíl musí být online. Potvrďte stav aplikace nebo náhradní zprávy do hlasové pošty nebo asynchronní zprávy. |
| Připojení selhalo | 484 | 560484 | Neplatná nebo neúplná volaná adresa | Ověřte volaný identifikátor (např. telefonní číslo, ID služby ACS). Opravte a zkuste to znovu. |
| Odpověď se nezdařila. | 401 | 71005 | Při odpovídání na volání došlo k chybě ověření tokenu. | Ujistěte se, že požadavek AnswerCall má platný token, jehož platnost nevypršela. |
| Odpověď se nezdařila. | 404 | 404 | Nelze odpovědět. | Shromažďování protokolů a otevření lístku podpory |
| Odpověď se nezdařila. | 408 | 4506 | Časový limit – volaný neodpověděl včas. | Ověřte dostupnost aplikací a nabízená oznámení. |
| Odpověď se nezdařila. | 495 | 4507 | Neplatný token služby Azure Communication Services | Zkontrolujte generování a obor tokenů. V případě potřeby znovu vygenerujte token. |
| Odpověď se nezdařila. | 430 | 10315 | Nepodařilo se doručit signální zprávu klientovi. | Ujistěte se, že klientská aplikace je dostupná a může přijímat signální zprávy. |
| Odpověď se nezdařila. | 430 | 10317 | Klient nepotvrdil požadavek na signalizaci. | Zkontrolujte rychlost odezvy klientských aplikací. V případě potřeby restartujte aplikaci nebo zařízení. |
| Odpověď se nezdařila. | 480 | 10077 | Cíl je zaregistrovaný, ale není online v době volání. | Ujistěte se, že volaný má aktivní relaci a není ve stavu pozadí nebo režimu spánku. |
| Odpověď se nezdařila. | 487 | 10004 | Časový limit – uživatel nepřijal nebo odmítl včas. | Zvažte přidání náhradní cesty nebo delší doby trvání vyzvánění. |
| Odpověď se nezdařila. | 487 | 4501 | Zamítnuto nebo se nepodařilo vygenerovat nabídku médií (např. neshoda koncových bodů). | Ověřte možnosti médií a zajistěte kompatibilitu mezi účastníky. |
| Odpověď se nezdařila. | 490 | 4502 | Problém se sítí – prohlížeč se nepodařilo dokončit požadavek. | Ověřte připojení klienta a seznam povolených domén služby ACS v nastavení sítě. |
| Odpověď se nezdařila. | 496 | 7 | Ztráta síťového připojení; opakování se nezdařilo. | Protokolování a monitorování opakovaných odpojení pro další analýzu |
Obecné kódy chyb
Kódy 2xx
Kód 2xx představuje úspěšnou odpověď. Podkód pro úspěšné odpovědi bude 0.
Kódy 4xx
Kód 4xx představuje chybu klienta.
| Stavový kód | Description |
|---|---|
| 400 | Chybný požadavek |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Nenalezeno |
| 405 | Metoda není povolena. |
| 406 | Není přijatelné |
| 408 | Vypršel |
| 409 | Conflict |
| 412 | Předběžná podmínka selhala |
| 413 | Příliš velká entita požadavku |
| 426 | Vyžaduje se upgrade. |
| 429 | Příliš mnoho žádostí |
| 481 | Transakce neexistuje. |
| 487 | Canceled |
Kódy 5xx
Kód 5xx představuje chybu serveru.
| Stavový kód | Description |
|---|---|
| 500 | Vnitřní chyba serveru |
| 501 | Neimplementované |
| 502 | Chybná brána |
| 503 | Služba není k dispozici |
| 504 | Časový limit brány |
Kódy 6xx
Kód 6xx představuje globální chybu.
| Stavový kód | Description |
|---|---|
| 603 | Declined |
Obecné podkódy
| Subcode | Description |
|---|---|
| 0 | Success |
| 7000 | Graceful |
| 7500 | Nepodporovaná identita AAD |
| 7501 | Neplatný token |
| 7502 | Přístup není povolený |
| 7504 | Nedostatečná oprávnění aplikace |
| 7505 | Neshoda tenanta organizace |
| 7506 | Nedůvěryhodný certifikát |
| 7507 | Neplatná identita zdroje volání |
| 7508 | Nepodporovaná identita služby ACS |
| 7509 | Chyba ověření Hmacu |
| 7510 | Chyba ověření spravované identity |
| 7600 | Přístup k prostředkům není povolený |
| 7601 | Neplatná zdrojová identita služby ACS |
| 7602 | Neplatná cílová identita služby ACS |
| 7603 | Neplatná identita služby ACS |
| 7604 | Scénář neoprávněné spolupráce Teams |
| 7605 | Scénář spolupráce s neoprávněným záznamem teams |
| 7606 | Neoprávněný prostředek služby ACS pro kognitivní akce |
| 8500 | Neplatný režim média |
| 8501 | Volání nenavázáno |
| 8502 | ID účastníka není k dispozici |
| 8503 | Neaktivní volání zvuku stavu multimédií |
| 8504 | Nedostupné datové proudy médií |
| 8505 | Více účastníků s nahrazením |
| 8506 | Hovor záznamu nedodržování předpisů |
| 8508 | Operace byla zrušena. |
| 8509 | Bylo dosaženo maximálního časového limitu ticha |
| 8510 | Byl dosažen časový limit počátečního ticha. |
| 8511 | Výzva k přehrávání se nezdařila. |
| 8512 | Přehrát pípnutí selhalo |
| 8513 | Časový limit příjmu médií |
| 8514 | Zjistilo se zastavení tónu |
| 8515 | Bylo dosaženo maximální doby trvání záznamu |
| 8516 | Omezení volání |
| 8517 | Neshoda ID tenanta volání |
| 8518 | Výjimka volání |
| 8519 | Conflict |
| 8520 | Neimplementované |
| 8521 | Příliš mnoho segmentů směrování |
| 8522 | Nenalezeno |
| 8523 | Neplatný argument |
| 8524 | Neplatný počet účastníků pro záznam dodržování předpisů |
| 8525 | Nezaznamenaná strana |
| 8526 | Neplatný token spojení |
| 8527 | Neplatná adresa URL připojení |
| 8528 | Hovor byl ukončen. |
| 8529 | Bylo dosaženo omezeného měsíčního limitu volání |
| 8530 | Bylo dosaženo limitu počtu omezených aktivních volání volání. |
| 8531 | Maximální počet přijatých číslic |
| 8532 | Bylo dosaženo časového limitu mezi číslicemi |
| 8533 | Možnost Dtmf – spárovaná |
| 8534 | Zadaný nesprávný tón |
| 8535 | Neplatný formát souboru |
| 8536 | Stažení souboru se nezdařilo. |
| 8537 | Dosažení časového limitu zachování |
| 8538 | Volaný odmítnutý |
| 8539 | Volaný zaneprázdněn |
| 8540 | Volaný zaneprázdněn všude |
| 8541 | Volaný není k dispozici |
| 8542 | Hovor zrušen |
| 8543 | Volání neexistuje |
| 8544 | Nedostupný volaný |
| 8545 | Spárovaná možnost řeči |
| 8546 | Volaný odeslaný neplatný požadavek |
| 8547 | Možnost převodu řeči se neshoduje |
| 8548 | Hovor není skupinový hovor |
| 8549 | Změna cíle při vytváření konverzací se nezdařila. |
| 8550 | Neúspěšné vyjednávání médií retarget |
| 8551 | Změna cílení není podporována |
| 8552 | Organizátora nejde odebrat |
| 8553 | Duplicitní záznam |
| 8554 | Účastník mimo schůzku Audio Mix |
| 8555 | Retarget již probíhá |
| 8556 | Akce není podporována pro volání CR |
| 8557 | Nesprávný typ formátu |
| 8558 | Účastník není k dispozici |
| 8559 | Duplikovat jeden vytáčení |
| 8560 | Připojení ke konverzaci zablokované kvůli uzamčené schůzce |
| 8561 | Neplatné ID připojení ke schůzce |
| 8562 | Režim nahrávání není podporován. |
| 8563 | Nerozpoznaná řeč |
| 8564 | Chyba připojení služby Speech |
| 8565 | Chyba služeb Cognitive Services |
| 8566 | Zrušit ztlumení operace není povoleno |
| 8567 | Instanční objekt prostředku služby ACS není povolený |
| 8568 | Spravovaná identita pro požadavek služby Cognitive Service selhala |
| 8571 | Konflikt operace záznamu |
| 8569 | Rozpoznávání řeči |
| 8570 | Chyba rozpoznávání řeči ve službách Cognitive Services |
| 8572 | Vypnutí služby Přehrávání |
| 8573 | Pause Resume – metoda není povolená |
| 8578 | Přepis se nezdařil. |
| 8579 | Přepis zrušen |
| 8580 | Vypnutí služby přepisu |
| 8581 | Neplatná adresa URL streamu |
| 8582 | Přehrání zdrojového textu nebo prázdného Ssml |
| 8583 | Předběžná podmínka selhala |
| 8585 | Akce není platná v aktuálním stavu volání |
| 8586 | Příchozí hovor není potvrzen robotem |
| 8587 | Příchozí hovor nepřipovídá včas |
| 8588 | Vypršení časového limitu příjmu záznamu a příjmu médií |
| 8589 | Omezení záznamu |
| 8594 | Aktualizace stavu schůzky selhala |
| 8603 | Streamování médií se nezdařilo. |
| 8604 | Streamování médií zrušeno |
| 8605 | Vlastní hlasový model přepisu není podporovaný. |
| 8606 | Vytvoření identifikátoru komunikace se nezdařilo. |
| 8607 | Konflikt operace přenosu |
| 8608 | Chyba klienta záznamu účastníka |
| 8609 | Neplatná odpověď na připojení od robota |
| 8610 | Žádná odpověď od robota při oznámení |
| 8613 | Bylo dosaženo limitu omezení živých titulků volání. |
| 9001 | Neznámá chyba z podkladové služby |
| 9002 | Chyba časového limitu z podkladové služby |
| 9003 | Chyba operace byla zrušena. |
| 9998 | Závažná chyba |
| 9999 | Unknown |
Diagnostické kódy SIP a Q.850 v událostech zpětného volání
Události zpětného volání služby Automation teď podporují diagnostická data nízké úrovně prostřednictvím SipDetails polí přidaných Q850Details do existujícího ResultInformation objektu.
Tyto diagnostické přehledy na úrovni protokolu z telekomunikační signalizační vrstvy pomáhají řešit problémy, jako jsou poklesy volání, nedostupné cíle nebo neočekávané odmítnutí ve scénářích veřejné telefonní sítě a SIP/VoIP.
Availability
Note
SipDetails
Q850Details Přítomnost a je zcela závislá na tom, zda zúčastněné společnosti SBC nebo telekomunikační operátor tyto informace poskytuje.
Pokud služba Session Border Control (SBC) nebo operátor vrátí příslušnou diagnostiku po odpovídající žádosti o signalizaci volání, výsledná událost bude zahrnuta SipDiagnosticInfo do ResultInformation.
Ovlivněné události
Následující události mohou zahrnovatSipDiagnosticInfo:ResultInformation
RemoveParticipantsFailedAddParticipantsFailedCreateCallFailedAnswerFailedCallDisconnectedTransferFailedCanAddParticipantFailed
V praxi můžou všechny události zpětného volání obsahující ResultInformation tuto diagnostiku přenášet, pokud je poskytuje SBC/operátor.
Struktura
Každá diagnostika je reprezentována jako objekt:
| Vlastnictví | Typ | Description |
|---|---|---|
Code |
Integer | KÓD SIP nebo Q.850 (např. 486, ) 16 |
Message |
String | Člověk čitelný důvod (např. "Zaneprázdněn zde") |
Tato pole jsou volitelná a zobrazují se pouze v případě, že je dodává SBC/operátor.
Example
{
"ResultInformation": {
"Code": 500,
"SubCode": 560503,
"Message": "Unexpected server error",
"SipDetails": {
"Code": 486,
"Message": "Busy Here"
},
"Q850Details": {
"Code": 17,
"Message": "User busy"
}
}
}
Kódy odpovědí volání do veřejné telefonní sítě s účastníkemEndReason
Tato část obsahuje informace o řešení potíží pro různé kombinace ParticipantEndReason kódů odpovědí a ParticipantEndSubCode kódů odpovědí. Pro tabulky v této části, ParticipantEndReason = Code a ParticipantEndSubCode = SubCode.
Obecně platí, že pokud ParticipantEndSubCode hodnota začíná 560 nebo 540, znamená to, že kód odpovědi vygeneroval řadič SBC uživatele/operátora. To je užitečné při řešení potíží s hovory přímého směrování, protože podkód může pomoci určit, zda je chyba ve vašem SBC nebo službě Microsoftu. Podkód začínající na 560 představuje odchozí volání, zatímco podkód od 540 představuje příchozí volání. V obou případech zkontrolujte protokoly SBC.
Například, pokud je hodnota ParticipantEndSubCode560403, znamená to, že se jednalo o odchozí volání, SBC vygeneroval konečný kód odpovědi a kód odpovědi SIP z SBC byl 403. Začněte řešit potíže s voláními kontrolou protokolů SBC.
U ParticipantEndSubCode odpovědí, které nezačínaly 560 nebo 540, služba Microsoftu vygenerovala konečný kód odpovědi.
ÚčastníkEndReason 0
Odpověď ParticipantEndReason s hodnotou 0 obvykle znamená normální vymazání volání a označuje volání, která se dokončila bez chyb.
| SubCode | Code | Message | Kategorie výsledků | Advice |
|---|---|---|---|---|
| 0 | 0 | Hovor byl úspěšně ukončen místním účastníkem. | Success | |
| 560000 | 0 | Normální ukončení volání do veřejné telefonní sítě: - Uživatel hovor ukončil. - Hovor skončil mediálním agentem. |
Success | |
| 540000 | 0 | Normální ukončení volání do veřejné telefonní sítě: - Uživatel hovor ukončil. - Hovor skončil mediálním agentem. |
Success |
ÚčastníkEndReason 4xx
Odpověď ParticipantEndReason s hodnotou 4xx znamená, že se volání nepřipojilo.
| SubCode | Code | Message | Kategorie výsledků | Advice |
|---|---|---|---|---|
| 510403 | 403 | Hovor je zablokovaný: - Pro vytočité číslo nebyla nalezena žádná odpovídající hlasová trasa. - Alternativní ID není zadáno pro volání. - Telefonní číslo nepovoluje řadič pro ohraničení relace uživatele (SBC). - Dříve označeno jako spam a nyní blokováno. |
Další informace o alternativním ID najdete v tématu Správa volání. – Potvrďte, že máte platnou hlasovou trasu pro vytočení čísla. – Ujistěte se, že jste zadali platné alternativní ID. Musí to být telefonní číslo, které patří k prostředku, který používáte. – Ověřte, že vlastníte prostředek, který používáte k volání. – U přímých volání směrování ověřte, proč váš řadič ohraničení relace nepovolil volání. – Ujistěte se, že je token komunikační služby platný a nevypršela jeho platnost. |
|
| 560403 | 403 | - Volat zakázáno. - Hovor byl zrušen. - Hovor byl odmítnut. |
Ujistěte se, že jste volali platné telefonní číslo ve správném formátu. Další informace o podporovaných formátech čísel naleznete v tématu https://en.wikipedia.org/wiki/E.164. | |
| 511532 | 403 | Konfigurace kmene PROTOKOLU SIP prostředku nebyla nalezena. | Zkontrolujte nastavení přímého směrování na webu Azure Portal. Další informace najdete v tématu Zřizování přímého směrování. | |
| 560404 | 404 | - Telefonní číslo nebylo nalezeno. - Telefonní číslo nepřiřazené k žádnému cíli. - Telefonní číslo není povoleno řadičem pro ohraničení relace. |
– Ujistěte se, že telefonní číslo patří k prostředku, který používáte, a že zdroj vlastníte. – Ověřte, že číslo, které voláte, existuje a je přiřazeno k platnému cíli. |
|
| 511404 | 404 | - Telefonní číslo nebylo nalezeno. – Prostředek použitý ve volání nebyl nalezen. |
– Ujistěte se, že jste použili telefonní číslo, které patří k používanému prostředku a které vlastníte. – Ověřte, že číslo, které voláte, existuje a je přiřazeno platnému cíli. – Ujistěte se, že prostředek, který používáte pro volání, není odstraněný nebo zakázaný. – Ujistěte se, že vaše předplatná Azure nejsou odstraněná nebo zakázaná. |
|
| 560408 | 408 | Volaná strana neodpověděla na zprávu o zřízení hovoru v předepsaném časovém období. | - Pečlivě zkontrolujte, proč volaná strana neodpověděla. – V případě volání přímého směrování zkontrolujte protokoly a nastavení ABC (Session Border Control) a konfiguraci časových limitů. |
|
| 500001 | 408 | Časový limit brány uživatele Služba Azure Communication Services neobdržela odpověď od klienta během zadaného časového limitu a ukončila žádost. |
- Pečlivě zkontrolujte, proč volaná strana neodpověděla. – U přímých volání směrování zkontrolujte konfiguraci protokolů a nastavení A časových limitů SBC. |
|
| 531004 | 410 | Kontroly interaktivního zřízení připojení (ICE) selhaly. | - Cestu k médiím nelze navázat. Příčinou může být nesprávná konfigurace sítě. Ověřte konfiguraci sítě a ujistěte se, že nejsou blokované požadované IP adresy a porty. Přečtěte si pokyny v článku https://www.rfc-editor.org/rfc/rfc5245#section-7. – V případě volání přímého směrování zkontrolujte protokoly a nastavení SBC pro konfiguraci a profil ICE. Požádejte o pomoc s konfigurací dodavatele SBC. Další informace najdete v tématu Seznam řadičů ohraničení relací certifikovaných pro přímé směrování služeb Azure Communication Services. |
|
| 560480 | 480 | - Žádná odpověď od volaný uživatel. – Volal se uživateli dočasně nedostupný. |
- Pečlivě zkontrolujte, proč volaná strana neodpověděla. - Zkuste to znovu později v případě, že volaná strana byla dočasná nedostupná. – U přímých volání směrování zkontrolujte konfiguraci protokolů a nastavení A časových limitů SBC. |
|
| 560484 | 484 | - Neúplná nebo neplatná volaná adresa. – Neúplný nebo neplatný formát volaných čísel. |
– V některých případech můžete tyto chyby ignorovat, protože uživatel vytočí neplatné číslo. – Ujistěte se, že jsou telefonní čísla správně naformátovaná. Další informace najdete na webu https://en.wikipedia.org/wiki/E.164. – U přímého směrování může SBC způsobit tyto chyby kvůli chybějící konfiguraci ve scénáři přenosu volání. |
|
| 540486 | 486 | Volané číslo bylo zaneprázdněno. | - Volací číslo může být připojeno k existujícímu hovoru nebo k technickému problému. – U přímých volání směrování zkontrolujte konfiguraci protokolů a nastavení A časových limitů SBC. |
|
| 560486 | 486 | Volané číslo bylo zaneprázdněno. | - Volací číslo může být připojeno k existujícímu hovoru nebo k technickému problému. – U přímých volání směrování zkontrolujte konfiguraci protokolů a nastavení A časových limitů SBC. |
|
| 540487 | 487 | Volající ukončil žádost o volání. | Zkuste hovor zopakovat. | |
| 560487 | 497 | - Volající ukončil žádost o volání. - Žádost byla ukončena normálním vymazáním hovorů. |
Zkuste hovor zopakovat. |
ÚčastníkEndReason 5xx
Odpověď ParticipantEndReason s hodnotou 5xx znamená, že volání selhalo kvůli problému se softwarovou nebo hardwarovou komponentou potřebnou k dokončení připojení.
| SubCode | Code | Message | Kategorie výsledků | Advice |
|---|---|---|---|---|
| 560500 | 500 | V některé ze služeb zapojených do volání došlo k vnitřní chybě serveru. | - Zkuste to znovu. Pokud problém přetrvává, obraťte se na poskytovatele telco nebo podporu Microsoftu. – V případě přímých volání směrování zkontrolujte protokoly a nastavení SBC a konfiguraci časových limitů, abyste zjistili, jestli vaše SBC způsobila chybu. |
|
| 560503 | 503 | – Volání selhalo kvůli vnitřní chybě serveru v některé ze služeb zapojených do volání. - Síť použitá k navázání volání je mimo pořadí. - Dočasná chyba v některé ze služeb zapojených do volání. |
– Zkontrolujte případné problémy v konfiguraci sítě a směrování. Ověřte správnost pravidel brány firewall sítě. - Zkuste to znovu. Pokud problém přetrvává, obraťte se na poskytovatele telco nebo podporu Microsoftu. – V případě přímých volání směrování zkontrolujte protokoly a nastavení SBC a konfiguraci časových limitů, abyste zjistili, jestli vaše SBC způsobila chybu. |
ÚčastníkEndReason 603
Odpověď ParticipantEndReason s hodnotou 603 znamená, že volání bylo odmítnuto bez připojení.
| SubCode | Code | Message | Kategorie výsledků | Advice |
|---|---|---|---|---|
| 560603 | 603 | - Hovor odmítnut příjemcem. - Hovor byl odmítnut z důvodu detekce podvodů. |
- Pokud příjemce odmítl, zkuste hovor zopakovat. – Ujistěte se, že nepřekračujete maximální počet souběžných volání povolených pro telefonní číslo služby Azure Communication Services. Další informace najdete v tématu Omezení volání do veřejné telefonní sítě. |
Kódy chyb chatovací sady SDK
Sada SDK chatu používá následující kódy chyb, které vám pomůžou při řešení potíží s chatem. Kódy chyb jsou zpřístupněny prostřednictvím error.code vlastnosti v odpovědi na chybu.
| Code | Message | Advice |
|---|---|---|
| 401 | Unauthorized | Ujistěte se, že je token komunikační služby platný a nevypršela jeho platnost. |
| 403 | Forbidden | Ujistěte se, že iniciátor požadavku má přístup k prostředku. |
| 429 | Příliš mnoho žádostí | Ujistěte se, že aplikace na straně klienta tento scénář zpracovává uživatelsky přívětivým způsobem. Pokud chyba přetrvává, vytvořte žádost o podporu. |
| 503 | Služba není k dispozici | Vytvořte žádost o podporu prostřednictvím webu Azure Portal. |
Kódy chyb SMS
Sada SMS SDK používá následující kódy chyb, které vám pomůžou při řešení potíží se serverem SMS. Kódy chyb jsou zpřístupněny prostřednictvím DeliveryStatusDetails pole ve zprávě o doručení SMS.
| Code | Message | Advice |
|---|---|---|
| 2000 | Zpráva byla úspěšně doručena. | |
| 4000 | Zpráva je odmítnuta kvůli detekci podvodů. | Ujistěte se, že nepřekračujete maximální počet zpráv povolených pro vaše číslo. |
| 4001 | Zpráva je odmítnuta kvůli neplatnému formátu zdroje nebo čísla z | Ujistěte se, že číslo To je ve formátu E.164 a Formát Od čísla je ve formátu E.164 nebo Krátký kód. |
| 4002 | Zpráva je odmítnuta z důvodu neplatného cílového nebo číselného formátu. | Ujistěte se, že číslo To je ve formátu E.164. |
| 4003 | Zpráva se nepovedla doručit kvůli nepodporovanému cíli. | Zkontrolujte, jestli je podporovaný cíl, na který se pokoušíte odeslat. |
| 4004 | Zpráva se nepodařilo doručit, protože neexistuje cíl nebo číslo do. | Ujistěte se, že číslo To, na které odesíláte, je platné. |
| 4005 | Zpráva blokovaná cílovým operátorem | |
| 4006 | Cíl/číslo do umístění není dostupné. | Zkuste zprávu odeslat znovu později. |
| 4007 | Cíl/číslo se odhlasuje od příjmu zpráv od vás. | Označte jako číslo Cíl/Na, aby se na číslo nezkoušely žádné další pokusy o zprávu. |
| 4008 | Překročili jste maximální počet zpráv povolených pro váš profil. | Ujistěte se, že nepřekračujete maximální počet zpráv povolených pro vaše číslo, nebo použijte fronty k dávkování zpráv. |
| 4009 | Zpráva odmítnutá systémem nároků společnosti Microsoft. | Nejčastěji k tomu dochází v případě, že se zjistí podvodná aktivita. Další podrobnosti získáte od podpory. |
| 4010 | Zpráva se zablokovala kvůli neověřeným číslu bezplatné linky. | Zkontrolujte neověřené limity odesílání a co nejdříve odešlete bezplatné ověření. |
| 4020 | Zpráva odmítnuta operátorem kvůli porušení objemových limitů. | Ujistěte se, že nepřekračujete maximální počet zpráv povolených pro vaše číslo, nebo použijte fronty k dávkování zpráv. |
| 5000 | Zpráva se nepodařilo doručit. Další podrobnosti získáte od týmu podpory Microsoftu. | Vytvořte žádost o podporu prostřednictvím webu Azure Portal. |
| 5001 | Zpráva se nepodařilo doručit kvůli dočasné nedostupnosti aplikace nebo systému. | |
| 5002 | Dopravce nepodporuje oznámení o doručení | Nejčastěji k tomu dochází v případě, že dopravce nepodporuje hlášení o doručení. Žádná akce se nevyžaduje, protože zpráva už možná byla doručena. |
| 9999 | Zpráva se nepodařilo doručit kvůli neznámé chybě nebo selhání. | Zkuste zprávu poslat znovu. |