Assistela Assistela Documentation
Supported services

Home Assistant

Connect Home Assistant, test access, and decide for every entity whether Assistela may only read it or also control it.

What the connection enables

Assistela can read the current state of your smart home and call Home Assistant services after a clear request. It can check a temperature sensor, read a light state, capture a snapshot from an allowed camera, run a scene, or control a specifically allowed device.

The connection has two layers of protection: the Home Assistant access token and the entity allowlist in Assistela. Even if the token permits more, Assistela refuses to work with an entity that you did not allow in its list.

1. Create a long-lived access token

1

Open your profile

In Home Assistant, open your user profile and find Long-Lived Access Tokens.

2

Create a token

Choose to create a new token and name it something recognizable, such as Assistela Mac.

3

Copy it immediately

Home Assistant normally shows the value only once. Copy it and keep the dialog open until it is saved in Assistela.

The token is a secret

Do not paste it into Chat, Memory, or an ordinary note. Enter it only in the Home Assistant access-key field. Assistela stores it as a protected credential; if you suspect exposure, revoke the token in Home Assistant and create a new one.

2. Pair Assistela

1

Open Integrations

In Assistela, choose Assistela → Settings → Integrations → Home Assistant and open the Pairing tab.

2

Enter the address

In Home Assistant address, enter the same URL you use in a browser, including http:// or https:// and any port. A local example is http://homeassistant.local:8123.

3

Paste the access key

Paste the token you just created into Home Assistant access key.

4

Save and test

Click Save and test connection. For a local address, macOS may request Local Network access; allow it for this use.

3. Allow only selected entities

Open Allowed Entities and refresh the items. You can search the list and filter it by type. Every entity has two separate choices:

  • Read: Assistela may obtain its state and attributes. Use this for sensors and devices it should only report on.
  • Control: Assistela may call actions such as turning on a light or running a scene. Enabling Control also enables Read.

Start with a few harmless items, such as a temperature sensor and one test light. Leave locks, alarms, garage doors, heating, or other safety-relevant devices without Control until you know exactly which instructions and approvals you want.

First test

  1. Ask: “What is the current state of the living-room sensor?”
  2. If reading works, try an allowed test light: “Turn on the office test light briefly.”
  3. Afterwards, verify the state directly in Home Assistant.

If an entity is missing, refresh the list. A Missing state usually means it was renamed or deleted in Home Assistant and you need to select the current entity ID.