Přehled push oznámení

SDK pro chat a SDK pro volání Azure Communication Services vytvářejí kanál pro zasílání zpráv v reálném čase, který umožňuje efektivní a spolehlivé doručování signálních zpráv připojeným klientům. Tato schopnost umožňuje vytvářet bohaté funkce komunikace v reálném čase do vašich aplikací, aniž byste museli implementovat složitou logiku dotazování HTTP. V mobilních aplikacích ale tento signalizační kanál zůstane připojený jenom v případě, že je vaše aplikace aktivní v popředí. Pokud chcete, aby vaši uživatelé dostávali příchozí hovory nebo chatové zprávy, když je vaše aplikace na pozadí, měli byste použít nabízená oznámení.

Nabízená oznámení umožňují odesílat informace z aplikace do mobilních zařízení uživatelů. Nabízená oznámení můžete použít k zobrazení dialogového okna, přehrávání zvuku nebo zobrazení uživatelského rozhraní příchozích hovorů. Služba Azure Communication Services poskytuje integrace se službou Azure Event Grid a Azure Notification Hubs , které umožňují přidávat nabízená oznámení do vašich aplikací.

Aktivace nabízených oznámení přes Azure Event Grid

Služba Azure Communication Services se integruje se službou Azure Event Grid , aby poskytovala oznámení událostí v reálném čase spolehlivým, škálovatelným a bezpečným způsobem. Pomocí této integrace můžete vytvořit službu oznámení, která uživatelům poskytuje mobilní push oznámení vytvořením odběru událostí Event Grid, který aktivuje Azure Function nebo webhook.

Diagram znázorňující, jak se komunikační služby integrují s Event Gridem

Přečtěte si další informace o zpracování událostí ve službě Azure Communication Services.

Doručování push oznámení prostřednictvím Azure Notification Hubs

Důležité

Služba Azure Notification Hubs oznámila, že rozhraní API služby Firebase Cloud Messaging (FCM) bylo v červenci 2024 zastaralé. To má vliv na všechny aplikace Azure Communication Services pro volání a chat, které odesílají push oznámení pro Android. Zákazníci, kteří jsou ovlivněni, musí migrovat své registrace ze starší verze FCM na FCM v1 a můžou to začít dělat v březnu 2024. Další informace, včetně kroků migrace, najdete v dokumentaci k centru oznámení.

Centrum oznámení Azure můžete připojit k prostředku komunikačních služeb, abyste mohli automaticky odesílat nabízená oznámení do mobilního zařízení uživatele, když obdrží příchozí hovor, nebo upozornit na zmeškanou chatovací aktivitu. Tato nabízená oznámení byste měli použít k probuzení aplikace z pozadí a zobrazení uživatelského rozhraní, které uživateli umožní přijmout nebo odmítnout hovor nebo přečíst nově přijatou chatovou zprávu.

Diagram znázorňující, jak se komunikační služby integrují se službou Azure Notification Hubs

Služba Communication Services používá Azure Notification Hub jako předávací službu ke komunikaci s různými službami nabízených oznámení specifických pro konkrétní platformu pomocí rozhraní API pro přímé odesílání . Tato funkce umožňuje opakovaně používat stávající prostředky a konfigurace služby Azure Notification Hub k zajištění nízké latence a spolehlivých oznámení pro vaše aplikace.

Poznámka:

Momentálně jsou podporována push oznámení o volání a chatu pro Android i iOS.

Zřizování centra oznámení

Pokud chcete do klientských zařízení doručovat push oznámení pomocí Notification Hubs, vytvořte Notification Hub ve stejném předplatném jako váš prostředek služby Communication Services. Musíte nakonfigurovat Centrum oznámení Azure pro systém oznámení platformy, který chcete použít. Informace o tom, jak v klientské aplikaci dostávat nabízená oznámení ze služby Notification Hubs, najdete v tématu Začínáme se službou Notification Hubs a v rozevíracím seznamu v horní části stránky vyberte cílovou klientskou platformu.

Poznámka:

V současné době se podporují sítě APN a platformy FCM.

Platforma APN musí být nakonfigurovaná s režimem ověřování tokenů. Režim ověřování certifikátů se teď nepodporuje.

Jakmile je centrum oznámení nakonfigurované, můžete ho přidružit k prostředku Communication Services tak, že zadáte připojovací řetězec pro centrum pomocí klienta Azure Resource Manageru nebo webu Azure Portal. Připojovací řetězec by měl obsahovat Send oprávnění. Doporučujeme vytvořit další zásady přístupu pouze s oprávněními Send speciálně pro vaše centrum. Další informace o zásadách zabezpečení a přístupu služby Notification Hubs

Pokud se chcete přihlásit k Azure Resource Manageru, spusťte následující příkaz a přihlaste se pomocí svých přihlašovacích údajů.

armclient login

Po úspěšném přihlášení spusťte následující příkaz pro zřízení centra oznámení:

armclient POST /subscriptions/<sub_id>/resourceGroups/<resource_group>/providers/Microsoft.Communication/CommunicationServices/<resource_id>/linkNotificationHub?api-version=2020-08-20-preview "{'connectionString': '<connection_string>','resourceId': '<resource_id>'}"

  1. Na portálu přejděte k prostředku Azure Communication Services.

  2. Uvnitř zdroje Komunikačních služeb vyberte v levé nabídce na stránce Komunikační služby Push oznámení a připojte centrum oznámení, které jste zřídili dříve.

  3. Vyberte Připojit centrum oznámení. Zobrazí se seznam center oznámení dostupných pro připojení.

  4. Vyberte centrum oznámení, které chcete pro tento prostředek použít.

    • Pokud potřebujete vytvořit nové centrum oznámení, vyberte Vytvořit nové centrum oznámení, aby bylo vaše centrum zřízeno pro tento prostředek.

    Snímek obrazovky s nastavením nabízených oznámení na webu Azure Portal

Teď uvidíte centrum oznámení, které jste propojili se stavem připojení.

Pokud chcete pro prostředek použít jiné centrum, vyberte Odpojit a opakujte kroky pro propojení jiného centra oznámení.

Poznámka:

Jakákoli změna způsobu propojení centra se projeví v rovině dat (tj. při odesílání oznámení) během maximálně 10 minut. Stejné chování platí při prvním propojení centra, pokud byla oznámení odeslána před změnou.

Registrace zařízení

Odkazy na rychlý start hlasových hovorů a rychlý start chatu vám ukážou, jak zaregistrovat identifikátor vašeho zařízení ve službě Communication Services.

Průvodce odstraňováním potíží pro nabízená oznámení

Pokud na svém zařízení nevidíte nabízená oznámení, můžou se oznámení vynechat na třech místech:

  • Služba Azure Notification Hubs nepřijala oznámení ze služby Azure Communication Services.
  • Systém oznámení platformy (například APNs a FCM) nepřijal oznámení ze služby Azure Notification Hubs.
  • Systém oznámení platformy nedoručil oznámení do zařízení.

První místo, kde je možné oznámení vynechat (Služba Azure Notification Hubs nepřijala oznámení ze služeb Azure Communication Services), najdete v následujícím popisu. Další informace najdete v tématu Diagnostika vynechaných oznámení ve službě Azure Notification Hubs.

Jedním ze způsobů, jak zjistit, jestli prostředek komunikační služby odesílá oznámení do služby Azure Notification Hubs, je zobrazením incoming messages metriky z propojených metrik centra oznámení Azure.

Následuje několik běžných chybných konfigurací, které můžou být příčinou, proč Centrum oznámení Azure nepřijímá oznámení z vašeho prostředku služby Communication Services.

Centrum oznámení Azure není propojené s prostředkem služby Communication Services

Může se stát, že jste centrum oznámení Azure nespojovali s prostředkem služby Communication Services. V části zařizování centra oznámení si můžete prohlédnout, jak je propojit.

Propojené centrum oznámení Azure není nakonfigurované.

Musíte nakonfigurovat propojené centrum oznámení pomocí přihlašovacích údajů systému oznámení platformy pro platformu (například iOS nebo Android), které chcete použít. Další podrobnosti o tom, jak to udělat, najdete v části Nastavení push oznámení v oznamovacím centru.

Propojené centrum oznámení Azure neexistuje.

Centrum oznámení Azure propojené s prostředkem služby Communication Services už neexistuje. Zkontrolujte, že propojené centrum oznámení stále existuje.

Platforma APN služby Azure Notification Hub je nakonfigurovaná s režimem ověřování certifikátů.

V případě, že chcete používat platformu APN s režimem ověřování certifikátů, v současné době se nepodporuje. Platformu APN byste měli nakonfigurovat s režimem ověřování tokenů, jak je uvedeno v části Nastavení nabízených oznámení v centru oznámení.

Propojený připojovací řetězec nemá Send oprávnění.

Připojovací řetězec, které jste použili k propojení centra oznámení s prostředkem služby Communication Services, musí mít Send oprávnění. Další podrobnosti o tom, jak vytvořit nový připojovací řetězec nebo zobrazit aktuální připojovací řetězec z centra oznámení Azure, najdete v tématu Zásady zabezpečení a přístupu služby Notification Hubs.

Neplatný připojovací řetězec nebo ID prostředku centra oznámení Azure.

Ujistěte se, že nakonfigurujete prostředek Communication Services se správným připojovacím řetězcem a ID prostředku Azure Notification Hub.

Propojený připojovací řetězec se znovu vygeneruje.

Pokud jste znovu vygenerovali připojovací řetězec propojeného centra oznámení Azure, musíte připojovací řetězec aktualizovat novým připojovacím řetězcem v prostředku služby Communication Services opětovným propojením centra oznámení.

Další kroky

  • Last updated on