S Amazon Alexou ovládáte zařízení připojená k Home Assistantu hlasem – přes reproduktory Echo, aplikaci Alexa v mobilu nebo třeba wearable s Alexou na zápěstí. Níže najdete návod jak propojení aktivovat, a to buď jedním klikem v Richpear Cloudu, nebo plně manuálně pro pokročilé uživatele.
1 Přehled funkcí
- Smart Home Skill – nativní ovládání světel, zásuvek aj. bez nutnosti vyslovovat název dovednosti („Alexa, turn off the light“).
- Alexa Routines – spouštění automatizací Home Assistantu přes předdefinované věty.
- Custom Skill – vlastní příkazy s vlastním wake‑word (pokročilé).
- Flash Briefing – čtení personalizovaných hlášení z Home Assistantu.
- Alternativa: Integrace Emulated Hue dokáže Alexu „obelstít“ a tvářit se jako Philips Hue Bridge.
2 Rychlé připojení přes Richpear Cloud (doporučeno)
Využívá službu Home Assistant Cloud, takže odpadá DDNS, certifikáty i port‑forwarding.
- V Home Assistantu otevřete Nastavení ▸ Richpear Cloud a přihlaste se (30 denní trial zdarma).
- Na kartě Integrace vyberte Amazon Alexa ▸ Přidat.
- Přepnete se do aplikace Amazon Alexa, potvrďte oprávnění a vyberte domácnost.
- Vaše entity se během pár vteřin importují – přiřaďte je do místností a případně přejmenujte.
Výhody Richpear Cloudu • Šifrované spojení bez veřejné IP.
• Žádná konfigurace SSL.
• Lze kdykoli zrušit, Alexa pak zařízení dál vidí lokálně.
3 Manuální nastavení (bez Cloudu)
3.1 Možnosti integrace
| Ovládací metoda | Popis | Vyžaduje AWS |
|---|---|---|
| Smart Home Skill (doporučeno) | Nativní zap./vyp., jas, barva … | ✔️ Lambda |
| Custom Skill | Vlastní příkazy (např. „Alexa, ask Home Assistant to start vacuum“). | ❌ |
| Flash Briefing | Krátké hlasové zprávy (např. stav sensorů) | ❌ |
| Emulated Hue | Home Assistant se tváří jako Hue Bridge | ❌ |
3.2 Požadavky
- Amazon Developer účet: developer.amazon.com.
- Veřejně dostupný Home Assistant přes HTTPS (port 443).
- AWS účet (pouze pro Smart Home Skill) – AWS Lambda má zdarma 1 mil. volání/ měsíc.
3.3 Vytvoření Smart Home Skill (zkrácený postup)
- Přihlaste se na developer.amazon.com/alexa/console a klikněte Create Skill.
- Zadejte název (např. Richpear Home), vyberte Smart Home šablonu a oblast Europe (Ireland).
- V sekci Permissions zaškrtněte Device Address, Alexa :: Household list, Alexa :: All Smart Home.
- Otevřete AWS Management Console → Lambda a vytvořte novou funkci Author from scratch:
- Runtime: Python 3.12
- Role: Create a new role with basic Lambda permissions.
- Po vytvoření vložte kód z oficiální dokumentace (viz odkaz níže) a nahraďte
SMART_HOME_ENDPOINTURL svého Home Assistantu:https://vaše‑domena.cz/api/alexa/smart_home - V nastavení funkce zkopírujte ARN a vložte jej v Alexa Console do Endpoint → Default Region.
- V Alexa Console přejděte na Smart Home → Build Model → Invoke Name a nastavte české jméno dovednosti (např. “Richpear”).
- Klikněte Save & Build Model.
- V kartě Test přepněte na Development a vyzkoušejte: „Alexa, discover devices“.
- V aplikaci Alexa se objeví nalezená zařízení a lze je přiřadit do místností.
Tip: Pokud potřebujete jen pár světel a nechcete AWS, zkuste Emulated Hue – stačí zapnout integraci v Home Assistantu, zapnout Enable UPnP a spustit v Alexe detekci zařízení.
3.4 Konfigurace Home Assistantu
Do configuration.yaml přidejte (příklad pro Smart Home Skill):
# Alexa Smart Home
alexa:
smart_home:
locale: "en-US"
endpoint: https://vaše‑domena.cz/api/alexa/smart_home
client_id: amzn1.application-oa2-client.XXX
client_secret: YOUR_SECRET
filter:
include_domains:
- light
- switch
exclude_entities:
- switch.test_device
entity_config:
light.kitchen:
name: Kuchyňské světlo
description: LED pásek nad linkou
- locale podporuje
de-DE,en-GB,fr-FR,it-IT,es-ES… client_idaclient_secretzískáte v Alexa Console → Account Linking.
Po úpravě konfigurace restartujte Home Assistant.
4 Bezpečnost a PIN kódy
Zařízení považovaná za bezpečná (zámky, garážová vrata) vyžadují při odemykání PIN kód. V dovednosti Alexa jej nastavte v sekci Smart Home > Security Settings a v configuration.yaml přidejte odpovídající pin: "1234".
5 Nejčastější potíže
| Problém | Řešení |
| Alexa hlásí „Skill endpoint is invalid“ | Ověřte, že veřejná URL Home Assistantu používá HTTPS a je dosažitelná z internetu. |
| „No new devices found“ po „discover“ | V Alexa Console klikněte Smart Home ▸ Manage Skill a před znovu‑hledáním Save & Build. |
| Lambda 403 Forbidden | V IAM roli povolte alexa:SmartHomeInvokeSkill nebo nahraďte funkci novou. |
Další zdroje
- Příručka Amazon Developing a Smart Home Skill: https://developer.amazon.com/en-US/docs/alexa/smarthome/understand-the-smart-home-skill-api.html
- Fórum podpory Richpear: forum.richpear.cz