---
title: "Siri \u0026 Widget"
description: "Comanda i dispositivi TapHome con Siri, widget Android o tag NFC tramite richieste URL alla TapHome API, protette da un token di sicurezza."
url: "https://taphome.com/it/docs/applications/siri-widgets/"
language: it
lastmod: 2025-11-21
generator: hugo
ai:
  topics: ["siri-shortcuts","android-widgets","voice-control","taphome-api","remote-control"]
  questions: ["Come posso controllare i dispositivi TapHome con Siri?","Come creare un widget Android per TapHome?","Dove trovo l'URL dell'API TapHome per le scorciatoie Siri?","Come impostare una scorciatoia Siri per aprire il cancello?","Cosa devo fare se il mio token di sicurezza API TapHome è stato compromesso?","Quale app mi serve per le scorciatoie TapHome su Android?","Come attivare l'API TapHome sul mio Core?"]
---

# Siri & Widget

Ultimo aggiornamento: 2025-11-21

> "Ehi Siri, apri il cancello"

L'unità di controllo TapHome stabilisce una connessione sicura con il suo server cloud, consentendo il controllo remoto immediato dei dispositivi definiti dall'utente tramite richieste URL. Questa integrazione permette azioni rapide senza la necessità di aprire l'app TapHome o persino sbloccare il telefono (ad es. tramite Siri).

## Misure di sicurezza

**Ogni richiesta web deve contenere un token di sicurezza.** Questo token previene accessi non autorizzati. È importante:

* **Non rivelare mai questo token su internet.**
* **Non inviarlo mai tramite comunicazioni non sicure.**
* Se sospetti una compromissione, **cambia immediatamente il token di sicurezza.**

## Attivazione dell'API TapHome su Core

Per attivare l'API TapHome:

1. Apri **Impostazioni** sul tuo TapHome Core.
2. Vai a **Pubblica dispositivi**.
3. Aggiungi una nuova interfaccia: **API TapHome**.
4. **Definisci quali dispositivi vuoi controllare** in questo modo. Ricorda che chiunque abbia il tuo token di sicurezza può controllare questi dispositivi definiti.
5. Apri il dispositivo dall'elenco. Verranno mostrati esempi di richieste URL per azioni tipiche.
   * **Esempio: premere un pulsante per aprire il garage:**
     https://api.taphome.com/api/TapHomeApi/v1/setDeviceValue/5?token=abcdef01-2345-6789-0abc-def012345678&valueTypeId=52&value=1
6. Clicca sull'URL per **copiarlo negli appunti**.

Ulteriori dettagli tecnici sulla modifica del contenuto dell'URL sono disponibili nella [documentazione API TapHome](https://taphome.com/it/docs/expose-devices/taphome-api/).

## iOS: Scorciatoie Siri

Per impostare una scorciatoia Siri:

1. Apri (o installa) l'app **Scorciatoie** di Apple.
2. Seleziona **Crea scorciatoia**.
3. Seleziona **Aggiungi azione**.
4. Nella prima sezione, seleziona **Web**.
5. Sotto **Richieste web**, seleziona **Ottieni contenuto URL**.
6. **Incolla l'URL** che hai copiato dall'app TapHome (**Impostazioni → Pubblica dispositivi → API TapHome**) nel campo URL.
7. **Assegna un nome alla scorciatoia** (ad es. "Apri il cancello").
![Comando rapido nell'app Comandi con l'azione Ottieni contenuti che chiama l'URL della TapHome API](https://taphome.com/documentation/applications/siri1.webp)
8. **Salvala**.
9. Puoi testare la scorciatoia premendo il pulsante di riproduzione nell'angolo in basso a destra oppure dicendo "Ehi Siri," seguito dal nome della tua scorciatoia (ad es. "Ehi Siri, apri il cancello").

## Android: Widget personalizzati

Per creare un widget personalizzato su Android:

1. Scarica un'app di terze parti che supporti l'invio di richieste HTTP, come [HTTP Request Shortcuts](https://github.com/roberttoyon/HTTP-Request-Shortcuts).
2. Crea una **Nuova scorciatoia** nell'app.
3. Imposta il suo nome e scegli un'icona.
4. Nelle **Impostazioni di base della richiesta**, seleziona il metodo **GET** e incolla l'**URL** copiato dall'app TapHome.
5. (Opzionale) Puoi modificare **Elaborazione della risposta** in "Risposta in Toast (solo errori)" per un feedback migliore.
6. Nel menu contestuale, seleziona **Posiziona sulla schermata home**.
7. La tua nuova scorciatoia dovrebbe ora apparire sulla schermata home del telefono.