Register a Device
Add hardware devices and connect them to an assistant via the Admin Panel.
Overview
Registering a device adds a hardware board to the system so an assistant can recognize and use it. After registration, the platform knows which assistant the device belongs to, which user owns it, which board and firmware it runs, and whether it can receive configuration, voice sessions, themes, or hardware commands.
For ESP32 devices, the registration method uses a 6-character activation code. This code appears on the device screen when it is online but not yet connected to an assistant.
Before You Start
- You have an account on Admin Panel and have created at least one assistant.
- The assistant has at least one user registered (under the Users section in Admin Panel).
- The device has compatible firmware installed.
- The device is connected to Wi-Fi and can fetch platform configuration.
If you don't have an admin account or haven't created an assistant yet, you need to do that before registering a device.
Register with Activation Code
Step 1: Get the Activation Code from the Device
- Power on the ESP32 board
- Wait for it to connect to Wi-Fi
- The device screen will display a 6-character code (letters + numbers)
Step 2: Look Up the Code in Admin Panel
- Log in to the Admin Panel
- Select the assistant to connect from the sidebar dropdown
- Go to Devices in the sidebar
- In the Look Up Activation Code section, enter the 6-character code
- Click Look Up — the system will show device details (code, status, MAC, device type)
Step 3: Bind the Device
- In the Bind Device section, select the user who will own the device
- Click Bind
- The device will appear in the device list below
After binding, the device receives assistant configuration on its next OTA check and can start voice sessions.
Direct URL to the devices page: https://admin.assistantcore.com/assistants/devices?assistant=<assistant_id>
Managing Devices
After registration, you can manage devices directly in the device table:
| Field | Description |
|---|---|
| Alias | Friendly name, editable inline in the table |
| Type | ESP32 or Watch, with online/offline status indicator |
| User | Device owner, changeable via dropdown |
| MAC Address | Unique hardware identifier |
| Version | Current firmware version |
| Last Connected | When the device last connected to the platform |
| Auto Update | Toggle OTA firmware updates on/off |
| Theme | Customize device theme (only available when online) |
Change Device Owner
In the device list, click the User dropdown in the corresponding column and select a new user.
Delete a Device
Click the Delete button at the end of the device row. This will unbind the device from the assistant.
Device Limits
Device limits depend on the owner's plan and current platform configuration. See Plans & Pricing for the latest limits.
You can bind multiple devices to the same assistant. Voice usage still consumes credits according to the active model and session usage.
A device should be connected to one assistant at a time so voice sessions, memory, and device tools do not mix context.