Register a Device
Add hardware devices and connect them to an assistant via the Admin Panel.
Overview
This guide covers ESP32 boards. 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-digit activation code. This code appears on the device screen when it is online but not yet connected to an assistant.
Watches use a separate pairing flow with an alphanumeric code. Do not enter a Watch code in this ESP32 6-digit flow.
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-digit code
Step 2: Find the Device 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 Add a device, enter the 6-digit code in 1. Find your device
- Click Look up — the system verifies the device and shows its code, status, MAC address, and type
Step 3: Assign the Device
- In 2. Assign the device, select the user who will own the verified device
- Click Assign device
- Confirm the Device connected state; 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/<assistant_id>/devices
If You Cannot Find the Code
- Make sure the device is powered on and connected to Wi-Fi.
- Enter the 6 digits currently shown on the device, including a leading
0if it has one. - If the code is no longer valid, restart the device or wait for a new code, then look it up again.
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 an online ESP32 device theme |
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.