Esto No Es Un Tutorial - Cómo integrar tu cerradura TTLock a Home Assistant paso a paso

En Chile se están vendiendo cada vez más cerraduras inteligentes compatibles con la plataforma TTLock, similar a cómo funciona Tuya con otros dispositivos del ecosistema smart home.

Últimamente, la app TTLock ha comenzado a mostrar publicidad, y fue ahí cuando decidí revisar si la integración con Home Assistant había mejorado respecto a cuando intenté configurarla hace algunos años.

Si bien aún no existe una integración oficial, actualmente es posible usarla a través de una integración disponible en HACS.


Nuestro caso

Nosotros tenemos la Cerradura Digital V-21 Black comprada en Vohk junto al hub WiFi que permite su apertura remota.

La instalamos primero en un departamento, y luego la movimos a nuestra casa sin inconvenientes.

Hasta ahora ha funcionado sin fallas, y nos solucionó completamente el problema de olvidar las llaves.

Usa pilas y con nuestro caso de uso las pilas recargables nos duran unos 6 a 8 meses.

Funciona con huella, clave numérica, tarjeta y por supuesto la app TTLock.


Requisitos previos

Antes de comenzar, asegúrate de tener:

  • Cerradura TTLock instalada y operativa
  • App TTLock configurada con acceso remoto
  • Usuario y contraseña de la app TTLock
  • Home Assistant funcionando con HACS instalado

Paso 1: Crear cuenta de desarrollador en TTLock

  1. Ve a https://euopen.ttlock.com/login
  2. Regístrate usando el mismo correo que tienes en la app TTLock
  3. Ingresa y haz clic en “Create New Application”
  4. Completa el formulario:
    • Application Name: El nombre que quieras (ej. MiCerradura)
    • Logo: Carga una imagen cualquiera
    • Type: App
    • Description: Algo como “Proyecto de apertura de cerradura TTLock”
  5. Haz clic en Submit

Importante: La aprobación puede demorar entre algunas horas y 1-2 días.
Revisa tu correo con frecuencia.


Paso 2: Obtener las credenciales API

Una vez aprobada tu aplicación:

  1. Vuelve a https://euopen.ttlock.com
  2. Entra a tu aplicación
  3. Copia los valores de:
    • client_id
    • client_secret

Los vas a necesitar al configurar Home Assistant.


Paso 3: Instalar la integración TTLock en Home Assistant

  1. Abre HACS
  2. Busca TTLock
  3. Haz clic en el resultado y luego en Descargar
  4. Reinicia Home Assistant


Paso 4: Configurar la integración

  1. Ve a Configuración → Dispositivos y Servicios → Agregar integración

  2. Busca TTLock

  3. Ingresa:

  4. Ingresa las credenciales de la aplicación TTLock:


¡Listo!

Ahora verás tu cerradura como una entidad en Home Assistant

Puedes integrarla a automatizaciones, scripts, dashboards

1 me gusta