Getting Started with Rules Notifications to Monitor your IoT Network - TeamViewer Support
<main> <article class="userContent"> <p><em>This article applies to all TeamViewer IoT users who monitor their IoT network.</em></p><p> </p><p>A key part of managing your IoT network is being able to respond as soon as possible to events or anomalies requiring action. TeamViewer IoT allows you to create flexible notifications to easily manage your messages and alerts.</p><h3 data-id="getting-started-with-rules-notifications-topics-channels">Getting Started with Rules, Notifications, Topics, & Channels</h3><p>You can manage all your notifications from the <a href="https://community.teamviewer.com/English/home/leaving?target=https%3A%2F%2Fteamviewer-iot.com" rel="nofollow noreferrer ugc">TeamViewer IoT Cloud</a> <em>Notifications </em>page or, if you have the Rule Engine on the Edge installed, from the <a href="https://community.teamviewer.com/t5/TeamViewer-IoT-Knowledge-Base/Edge-Device-Management-Real-Time-Edge-Visualization-amp-more/ta-p/37206" rel="nofollow noreferrer ugc">TeamViewer IoT Edge Management Application</a>.</p><p>Once you set up your Rules and notification preferences, you will receive alerts when a <strong>Rule </strong>exceeds its defined threshold (e.g. Temperature exceeding 25ºC).<strong> </strong></p><p>A <strong>Rule </strong>is comprised of a <strong>Condition </strong>(e.g. Device is offline, Temperature > 25ºC) and a <strong>Topic</strong>. If the <strong>Rule</strong> condition is met, a message will be published to the specified <strong>Topic</strong>. A <strong>Topic</strong> is simply a method to associate one or more <strong>Channels </strong>to a Rule, where a <strong>Channel</strong> is a communication method (an email or webhook).</p><h3 data-id="creating-rules">Creating Rules</h3><p><strong>Rules </strong>can be created for any of your metrics or devices:</p><ul><li>You can create Device <strong>Rules</strong>, which will monitor your device status, from the <em>Devices </em>page, by clicking the <strong>Rule </strong>icon next to your Device status.</li><li>You can create Metric <strong>Rules</strong>, which will monitor your sensors/metrics, from the <em>Metrics </em>page, by clicking the <strong>Rule </strong>icon next to your metric.</li></ul><h3 data-id="creating-topics">Creating Topics</h3><p><strong>Topics </strong>can be created from the <em>Notifications -> Topics page. </em></p><p>A <strong>Topic </strong>is comprised of a name and one or more subscribers, called <strong>Channels</strong>. Once a <strong>Topic</strong> is linked to a <strong>Rule</strong>, notifications will be sent to all <strong>Channels</strong> linked to the <strong>Topic</strong>.</p><p><strong>Caution</strong>: <strong>Topics</strong> can be created without any <strong>Channels</strong> and linked to <strong>Rules. </strong>In this scenario, notifications will not be sent as there are no specified <strong>Channels.</strong> You can add <strong>Channels</strong> to your <strong>Topics</strong> at any time, during or after creation of the <strong>Topic.</strong></p><h3 data-id="creating-channels">Creating Channels</h3><p><strong>Channels </strong>can be created from the <em>Notifications -> Channels</em> page. </p><p>A <strong>Channel </strong>is comprised of a <em>Type </em>(webhook or email) , an <em>Endpoint</em> (webhook URL or email address), and one or more subscribed <strong>Topics</strong>. Once a <strong>Topic</strong> is linked to a <strong>Rule</strong>, notifications will be sent to all <strong>Channels</strong> linked to the <strong>Topic</strong>.</p><p>Webhooks and emails need to be confirmed prior to being activated (ready for use) in order to prevent abuse of non-owned mediums. Once a <strong>Channel</strong> is created, a confirmation message is sent to the endpoint to allow the owner to confirm it within a 24 hour period.</p><p><strong>Note</strong>:<strong> Channels </strong>can be created without any subscribed <strong>Topics.</strong> You can subscribe to <strong>Topics </strong>at any time, during or after the creation of the <strong>Channel.</strong></p><p>Reference <a href="https://community.teamviewer.com/t5/TeamViewer-IoT-Knowledge-Base/Webhook-Payload-Templates/ta-p/17155" rel="nofollow noreferrer ugc">Webhook Sample Messages</a><strong> </strong>for details regarding webhook message formats.</p> </article> </main>
