Hola a todos,
Quiero presentarles mi nueva integración de agente FF externo para Gladys Assistant. Con esto, se pueden recibir alertas de FF-Agent en Gladys, mostrar en el panel y usar como activador de escenas. Además, pueden enviar un aceptación o rechazo a FF-Agent directamente desde Gladys.
La integración está disponible públicamente y ya ha sido probada en producción.
¿Qué puede hacer la integración?
La integración conecta dos áreas:
- Alertas entrantes: FF-Agent envía una alerta a Gladys. Esto aparece en el panel y puede activar escenas.
- Respuestas personales: A través del widget o una acción de escena, pueden informar a FF-Agent si aceptan o rechazan.
La interfaz y la documentación están disponibles en alemán, inglés y francés.
¿Para qué se puede usar esto?
El caso de uso más importante es hacer que su propia casa reaccione de manera significativa ante una alerta. Por ejemplo, con una escena de Gladys:
- encender la luz en el dormitorio, pasillo o entrada por la noche;
- emitir una notificación adicional o una indicación sobre las funciones de Gladys ya configuradas;
- encender dispositivos seleccionados o iniciar una escena existente;
- mostrar la alerta en una tablet de pared en el panel de Gladys.
Los dispositivos y acciones que utilicen dependen, por supuesto, de su instalación de Gladys. La integración proporciona el activador de la alerta; la reacción deseada la definen ustedes mismos en sus escenas.
También se pueden integrar las respuestas en escenas, por ejemplo, para un pulsador accionado de manera consciente. No se requiere una aceptación o rechazo automático para el uso.
El widget del panel
El widget muestra si hay una alarma recibida localmente abierta. En caso de alarma, aparecen la hora de recepción y dos botones:
- Aceptar
- Rechazar
La respuesta se envía inmediatamente al hacer clic, sin solicitar confirmación adicional.
Después de una aceptación transferida con éxito, la indicación verde permanece hasta que seleccionen „Finalizar misión“. Este botón finaliza exclusivamente la visualización local en Gladys — no envía ninguna solicitud adicional y no finaliza ninguna misión en FF-Agent.
Después de un rechazo transferido con éxito, el widget vuelve directamente al estado de reposo. La última decisión enviada y su hora permanecen visibles, es decir, „Aceptación enviada“ o „Rechazo enviado“. Las horas aparecen en la zona horaria local de su navegador.
Una nueva alarma entrante abre la visualización de la alarma nuevamente. El estado de la alarma y la última respuesta solo se mantienen en la memoria y se pierden al reiniciar la integración.
¿Cómo funciona la recepción de alarmas?
Para las alertas entrantes, la integración utiliza un webhook a través de Gladys Plus:
- FF-Agent envía un HTTP-POST a la URL personal del webhook al recibir una alerta.
- Gladys Plus reenvía la señal a su instancia de Gladys.
- La integración actualiza el widget y activa el activador de escena „Misión recibida“.
Intencionalmente sin detalles de la misión
La integración procesa exclusivamente la señal de alarma. El contenido del webhook se ignora. No se almacenan ni se transmiten a las escenas palabras clave de la misión, direcciones, IDs de la misión u otros detalles de la misión.
El activador de la escena contiene solo el momento de recepción generado localmente. Por lo tanto, no hay filtros por tipo de misión o evaluaciones similares.
¿Cómo funcionan las aceptaciones y rechazos?
Las respuestas utilizan los enlaces web personales de FF-Agent de:
FF-Agent → Perfil personal → „Enlaces web para notificación de misión“
En Gladys, solo registran su UUID de respuesta, no el enlace completo.
Para las aceptaciones, pueden seleccionar un tipo de viaje estándar:
- Auto
- Bicicleta
- A pie
Las coordenadas transmitidas provienen de la casa Gladys seleccionada. Por lo tanto, no se trata de una ubicación en vivo de su teléfono inteligente. Al aceptar a través de una acción de escena, se puede sobrescribir opcionalmente el tipo de viaje para esta única llamada.
Los rechazos solo requieren el UUID de respuesta. Ninguna de las dos respuestas requiere ingresar un ID de misión.
Probar e importantes notas
Pueden probar el widget incluso sin un webhook de FF-Agent entrante a través de „Simular misión“.
Importante: Una simulación no es un modo de prueba protegido. Activa el mismo activador de escena que una alarma real. Los botones de respuesta y las acciones de aceptación/rechazo integradas también envían solicitudes reales a FF-Agent en este caso. Por lo tanto, verifiquen sus escenas antes de una prueba.
Me encantaría recibir comentarios, experiencias y sugerencias de mejora, especialmente de otros usuarios de FF-Agent que deseen conectar sus alertas con Gladys y su hogar inteligente.