Un pulsante, il tuo flusso di lavoro

Crea un flusso di lavoro richiamabile

1. Trigger con nomeStream Deck / API
2. Condizioni e azioniIl tuo Event Flow salvato
3. DestinazioneFlow Actions, OBS o un'altra integrazione

1. Apri Event Flow da SSN. Crea un flusso dedicato oppure scegli il modello Pulsante Stream Deck / API .
2. Aggiungi Esegui da Stream Deck / API nel gruppo di trigger Stream Deck e API .
3. Assegnagli il nome intermission. I nomi devono corrispondere esattamente e distinguono maiuscole e minuscole; usa un nome breve e descrittivo.
4. Collega la sua uscita a Mostra testo (Show Text). Imposta il testo su Back in five minutes, e scegli la durata e il livello desiderati.
5. Salva il flusso, poi attivalo. Un flusso non salvato esiste solo nell'editor; un flusso disattivato non può essere richiamato. Il modello iniziale è volutamente disattivato finché non termini la configurazione.
6. Apri il tuo Overlay Flow Actions usando il link generato da SSN. Per il pubblico, aggiungi quell'URL come sorgente browser OBS. L'editor stesso non è l'overlay.

I flussi privi di questo trigger con nome non possono essere richiamati tramite l'API dei flussi di lavoro. Richiamare un flusso non inserisce chat fittizia nel dock. Gli eventi OBS esistenti e la normale chat continuano a usare i propri trigger.

Un flusso può combinare il proprio trigger con nome con dei filtri tramite nodi logici. Mantieni le automazioni non correlate in flussi separati: tutti i rami di trigger/logica del flusso selezionato vengono valutati con l'evento API. Pressioni ripetute avviano esecuzioni separate; inserisci un nodo di stato Limitatore di frequenza (Rate Limiter) dopo il trigger se vuoi un tempo di attesa.

Collega un tasto Stream Deck

1. Configura nel plugin Configurazione con la tua sessione SSN e la password facoltativa. Usa Verifica connessione (Test Connection).
2. Trascina Comando preimpostato (Preset Command) su un tasto.
3. Seleziona Flussi di lavoro Event Flow → Esegui flusso di lavoro.
4. Scegli Aggiorna flussi di lavoro, quindi seleziona il flusso e il trigger salvati. Il tasto memorizza sia l'ID del flusso sia il nome del trigger.
5. Premi una volta e osserva l'overlay Flow Actions. Il segno di spunta del tasto significa che SSN ha accettato l'esecuzione.

Il selettore dei flussi di lavoro conserva le selezioni mancanti. Dopo aver rinominato, disattivato, eliminato o importato un flusso, aggiorna l'elenco e selezionalo di nuovo. Un flusso importato come nuovo ha un ID diverso. Usa invece il campo Value per indirizzare per nome più flussi.

Comando personalizzato: imposta Action su triggerWorkflow, lascia vuoto Target, inserisci {"trigger":"intermission"} come Value e attiva Attendi risposta (Wait for response). Il preset offre una selezione guidata e filtra in base alle funzionalità.

Azioni multiple: ogni richiesta di flusso di lavoro conferma rapidamente l'accettazione. Il passaggio successivo di Stream Deck può partire prima che terminino le azioni ritardate del flusso. Gestisci sequenza e ritardi dentro Event Flow quando l'ordine è importante.

Passa valori personalizzati

Nel campo Value del tasto o nella richiesta API:

{
  "trigger": "intermission",
  "flowId": "YOUR_SAVED_FLOW_ID",
  "data": { "name": "Back in five minutes", "minutes": 5 }
}

Imposta Mostra testo (Show Text) su {meta.workflow.data.name}. Confronta proprietà (Compare Property) può leggere meta.workflow.data.minutes. Data è un oggetto JSON facoltativo; rimane in meta.workflow.data e non può sostituire l'identità dell'evento né concedere privilegi di chat.

Ometti flowId per richiamare ogni flusso attivo con quel nome esatto di trigger. Più nodi trigger corrispondenti nello stesso flusso lo valutano comunque una sola volta. Per eseguire un solo flusso, mantieni il suo ID ottenuto dal selettore o dalla risposta di rilevamento.

L'evento usato nel flusso selezionato ha type: "api", event: "workflow_trigger", chatname: "Stream Deck / API", un campo vuoto chatmessage, e i dati riportati sopra. Una normale chat che copia quei campi non può attivare il trigger API con nome.

Esempi API

Mantieni SSN attivo e in esecuzione. Queste sono chiamate di controllo remoto di Social Stream; non usano l'API AI/MCP locale separata di SSApp. Mantieni privato il tuo vero ID di sessione.

Scopri i trigger disponibili

{"action":"getWorkflowTriggers","get":"list-1","apiid":"YOUR_SESSION"}

La callback contiene result.payload.triggers:

{"triggers":[{"flowId":"flow-123","flowName":"Intermission","trigger":"intermission"}]}

Esegui un flusso di lavoro con nome

{
  "action": "triggerWorkflow",
  "value": {"trigger":"intermission","flowId":"flow-123","data":{"name":"Back shortly"}},
  "get": "run-1",
  "apiid": "YOUR_SESSION"
}

Usa un valore univoco get per ogni richiesta. Una callback riuscita contiene result.ok: true, result.status: "accepted", e result.payload.matchedFlows. L'accettazione indica che il flusso attivo è stato trovato e pianificato. Non significa che ogni azione ritardata, webhook, chiamata OBS o riproduzione multimediale sia terminata.

WebSocket

Attiva controllo API remoto dell'estensione in SSN. Connettiti a wss://io.socialstream.ninja. Collegati con {"join":"YOUR_SESSION","out":1,"in":2}, quindi invia la richiesta riportata sopra. Il canale 1 trasporta i controlli; il canale 2 trasporta le callback. Non serve attivare il canale chat per i flussi di lavoro.

HTTP

Attiva la stessa impostazione di controllo API remoto. Sostituisci il segnaposto della sessione prima dell'uso:

POST https://io.socialstream.ninja/YOUR_SESSION
Content-Type: application/json

{"action":"triggerWorkflow","value":{"trigger":"intermission","data":{"name":"Back shortly"}}}

Per un semplice trigger con nome puoi usare anche GET https://io.socialstream.ninja/YOUR_SESSION/triggerWorkflow/null/intermission. Il quarto segmento del percorso può contenere JSON con codifica URL per valori strutturati. Codifica l'intero valore JSON con encodeURIComponent(JSON.stringify(value)). I canali di invio personalizzati usano ?channel=N.

P2P

La modalità P2P predefinita del plugin invia lo stesso payload tramite il trasporto sui canali dati VDO.Ninja già usato da SSN. L'opzione API WebSocket ospitata non è necessaria per P2P. I client P2P esistenti devono inviare questa richiesta tramite la loro connessione di controllo SSN già stabilita; non serve aprire l'API AI locale.

Errori e compatibilità

• WORKFLOW_NOT_FOUND: nessun flusso salvato e attivo corrisponde al trigger/ID flusso.
• INVALID_VALUE: trigger mancante/non valido, JSON malformato, ID flusso non valido o dati che non sono un oggetto.
• CONTROL_UNAVAILABLE: SSN o il controllo remoto del conduttore è disattivato.
• TARGET_UNAVAILABLE: Event Flow è ancora in caricamento.
• Le risorse Social Stream meno recenti potrebbero non pubblicizzare queste azioni. Controlla getCapabilities → ssn.actions.triggerWorkflow e getWorkflowTriggers. Devono essere installati sia il nuovo trigger sia il plugin aggiornato; il solo numero di versione di SSApp non identifica le risorse Social Stream caricate da remoto.

Non riprovare automaticamente una chiamata che modifica lo stato dopo la perdita di una conferma: il flusso potrebbe essere già partito. Controlla prima il suo output. Questa API non fornisce una coda degli stati di esecuzione.

Cosa serve a ogni integrazione

Guida completa a Event Flow · Ricette · Riferimento API

Gesti per timer e chat

Timer: ruota di uno scatto per ±10 secondi, come impostazione predefinita; tieni premuta la manopola mentre la ruoti per ±1 minuto (6× l'incremento configurato). Premi e rilascia senza ruotare per avviare/mettere in pausa. Tocca il display del timer per aggiornarlo; tieni premuto il display per azzerare. Tenere premuta solo la manopola fisica non azzera il timer.

Revisione chat: ruota a sinistra per la chat più vecchia, a destra per quella più recente; premi la manopola per fissare il messaggio esaminato. Tocca il display per mettere in evidenza il messaggio fissato successivo; tieni premuto il display per rimuovere il messaggio esaminato dai fissati. Mantieni aperto il dock predefinito. In modalità WebSocket attiva l'inoltro della chat sul canale 4.

Apri Aiuto e diagnostica → Guida a controlli, icone e flussi di lavoro nel plugin per la guida offline completa, tutti e cinque i tipi di azione, ogni preset/icona, il comportamento di ripristino, le impostazioni predefinite e la risoluzione dei problemi.

Riferimento della tavolozza Event Flow

La tavolozza contiene 45 trigger, 67 azioni, cinque nodi logici e quattro nodi di stato. Ogni voce ha un'etichetta testuale accanto al simbolo. Seleziona un nodo per vederne le impostazioni e i prerequisiti di integrazione; un'icona nella tavolozza non dimostra che una destinazione sia connessa.

Trigger decidono quando parte un flusso. Collega le condizioni con AND/OR quando necessario. Azioni vengono eseguite nell'ordine dei collegamenti. Nodi di stato ricordano i valori tra un evento e l'altro. Per un tempo di attesa del pulsante scegli Limitatore di frequenza (Rate Limiter) (THROTTLE), non un'azione Ritardo (Delay): Delay posticipa ogni esecuzione e non blocca le pressioni ripetute.

I filtri dei messaggi, i punti degli spettatori e le azioni sugli utenti memorizzati richiedono dati significativi su messaggi/utenti. Un pulsante del conduttore non fornisce né uno spettatore reale né una destinazione di risposta nella sorgente. Scegli controlli del conduttore o una destinazione configurata esplicitamente; non usare un flusso con nome per impersonare uno spettatore.

Per i dettagli dei collegamenti, consulta la Guida a Event Flow, guida ai nodi di stato, guida alla memoria utenti, e Guida OBS.

Individuare un errore

1. Inizia con un semplice flusso Mostra testo (Show Text) e verificane l'output.
2. Salva e attiva; aggiorna l'elenco dei flussi di lavoro di Stream Deck. Verifica sia il nome del trigger sia l'ID del flusso.
3. Verifica che SSN sia attivo, che la connessione sia Online e che l'overlay di destinazione sia connesso alla stessa sessione.
4. Controlla la callback API o la diagnostica del plugin per gli errori di ricerca/convalida. Per gli errori successivi all'accettazione, controlla la destinazione e i log di esecuzione di Event Flow.
5. Aggiungi altre integrazioni una alla volta. Prova pressioni ripetute, un flusso disattivato e una riconnessione prima di usarlo in diretta.

Il normale pannello di test della chat dell'editor invia un evento chat. Non simula un trigger API con nome. Prova questo trigger tramite Stream Deck o l'API per verificare il percorso completo.