Platform Documentation

Platform Overview

NEQTO.ai turns device data into dashboards, alerts, and analysis without writing code. Inside your Account, Applications are scoped workspaces, each holding the device endpoints, devices, dashboards, alerts, maps, and tags assigned to it. A Device Endpoint is the secure inbound channel your hardware connects to, a Device is one piece of equipment sending data, and an Attribute is one measurement from that device, such as temperature, humidity, or battery.

Quick Start

The shortest path from a new account to a device you can chart and alert on.

  • 1
    Create your account and invite your team
    Sign-in starts with a magic link emailed to your address. Open Administrator > User Management to invite teammates. See Administration.
  • 2
    Create an Application
    Open Applications, select +, and enter a name. Choose a template to preselect the sidebar sections, then assign device endpoints or individual devices.
  • 3
    Add a Device Endpoint
    Inside the application, go to Devices > Device Endpoints, click Add Device Endpoint, and pick a connectivity type: MQTT, HTTPS, or WSS. Copy the credentials from the final step and store them securely.
  • 4
    Send your first payload
    Use the endpoint’s How to connect a device helper, which shows a working example for your protocol. After the first valid message is processed, the Device appears and its readings become Attributes.
  • 5
    Build on the data
    Add widgets in Dashboards, set conditions in Alerts, review the period in Analytics, and pin devices on a Map.
Tip: no hardware yet? Create a Demo Device Endpoint and use the built-in Simulator to send realistic data and test alerts before anything is wired up.

Accounts, Applications, and Users

Five layers stack from your organization down to a single reading. Each one is managed in a different place.

Layer What it is Where you manage it
Account Your organization. Holds users, roles, billing, and every application. Administrator > Account Settings
Application A scoped workspace for a project, site, or team. Devices, dashboards, alerts, maps, Systems, tags, and members all belong to one. Applications
Device Endpoint One protocol and authentication configuration. The devices that publish through it are grouped underneath it. Devices > Device Endpoints
Device One piece of equipment sending data. Devices
Attribute One measurement from a device, such as temperature or battery. Mapped automatically

Access is granted through roles, and permissions come in two scopes that never mix: account scope covers the whole organization, and application scope covers one workspace. A user can hold an account-wide role, a role in one or more applications, or both. For the full role and permission reference, see Administration.

The Default Application. Every account starts with one. It includes all account devices and endpoints, including those added later, and its assignments cannot be changed. Screens that are not opened from inside a specific application — Alert History, for example — fall back to scoping their data to it.

Applications

An Application is the highest-level organizational unit in your account, a dedicated project environment where your team builds and manages a complete IoT solution.

One account, multiple applications. A single account can contain as many applications as needed — one per client site, product line, or geographic region. Assigning a device endpoint includes all of its current devices and any added to it later, and the same device can belong to more than one application.

Creating an application is a three-step wizard: details, template, then devices. The template only selects a starting set of sidebar sections, and you can change them later.

Template Sections enabled
Smart Environment Dashboard, Analytics, Map, Devices, and Alerts
Default Dashboard, Devices, and Alerts
Custom Devices initially, plus any other sections you select
Note: enabling a section does not grant access to it. A user must also have the required permissions. See Applications.

How Data Gets In

Data reaches NEQTO.ai in two ways, and the difference is simply which side opens the connection.

Path Use it when What you configure
Device Endpoint Your hardware or software connects to NEQTO.ai. A connectivity type and authentication type. NEQTO.ai issues the credentials.
Integration NEQTO.ai must connect out to an external service. The service URL and credentials. A pull integration brings data in; a push integration sends it out.

Either way the result is the same: a Device with auto-mapped Attributes, usable in dashboards, alerts, analytics, and maps.

Connectivity types

You choose the type when you create the endpoint, and it cannot be changed afterward. To change it, you create a new endpoint.

Type Use it for
MQTT Most IoT devices and gateways. A persistent, low-overhead connection.
HTTPS Devices, scripts, or services that push data with an HTTP request.
WSS Apps and gateways that keep a live WebSocket open and stream frames.
Note: unencrypted MQTT, HTTP, and WS are still available for device endpoints, but they are discouraged, use the TLS-secured variant wherever your hardware supports it. Integrations are stricter: they must use TLS, so only HTTPS, WSS, and MQTTS are offered there.

NEQTO.ai accepts flexible JSON, with neqtoai-std as the recommended envelope rather than a required one. Incoming payloads go through automatic data normalization: Auto-Parsing recognizes the payload shape, registers the Device from a stable identifier, and maps each reading to an Attribute, so differently shaped payloads end up in one consistent structure with no manual field configuration. Auto-Parsing also decodes EnOcean radio telegrams and BLE gateway scans natively, so those families need little or no payload shaping. For payload guidance and the device families covered, see Endpoints & Devices and Supported Devices. Guided setups exist for HPE Networking and Blues hardware.

The Four Pillars of an Application

Every application is built from four functional blocks covering the full lifecycle of your IoT data, from hardware ingestion to actionable intelligence.

📡
Endpoints & Devices

The hardware foundation of your network. Register endpoints, then let devices and their attributes map themselves as data arrives.

  • MQTT, HTTPS & WSS endpoints
  • Auto-created devices & attributes
  • Real-time ingestion feedback
  • Connectivity status & timeouts
📊
Dashboards

The grid of widgets that shows your data. Build real-time views from a catalog of widget types, no coding required.

  • Charts, gauges, tables & maps
  • Widget calculations
  • PDF report export
  • Tabs, autosave & history
🧠
Analytics

A read-only review of one application over a period you choose. An AI report interprets the aggregated readings and alert activity.

  • AI Analysis Report
  • Critical, Warning & Normal cards
  • Alert events timeline
  • CSV export
🔔
Alerts

The proactive monitoring layer. Define a condition, and every reading is checked against it from then on.

  • Threshold, connectivity & anomaly types
  • Email & SMS notifications
  • Payload push to an endpoint
  • Alert History & triage

Organizing and Extending

Beyond the four pillars, these features organize your devices and extend what you can do with their data.

Feature What it does
Tags Reusable key:value labels you attach to devices, such as floor:3. Tags are flat — they filter the Devices list but have no hierarchy.
Systems Named, nested groups of devices representing a site, building, machine, or fleet. Each System has its own image canvas, so a System tree can act as a digital twin.
Maps Device pins placed on an image of a physical space, such as a floor plan. Each pin shows a live reading and changes color when an alert fires. This is an image overlay, not a geographic latitude and longitude map.
Integrations Outbound connections to external APIs and brokers, either pulling data in or pushing it out.
Data Push Sends a payload on demand from NEQTO.ai to an MQTT or WebSocket endpoint.
Ask AI Ask questions about device data in plain language, and draft widgets, alerts, and tag changes from the reply. It proposes; you confirm and save in the normal editor.
Widget Calculations Display a computed value instead of a raw reading.
Tip: the Glossary of Key Terms is a general primer on the platform and IoT vocabulary. For what a feature actually does, use its own page.