API Assistenza

Ricezione JSON anonima dalla stessa origine per il modulo di contatto del sito. Richiede l’intestazione Origin del sito e una Idempotency-Key di 20–128 lettere, cifre, trattini o trattini bassi. Non crea account né sessioni. Salva il messaggio e l’email per la risposta prima di confermare la ricezione; il servizio di assistenza li invia al canale Slack di supporto configurato.

L’email fornita dal visitatore è un dato di contatto, mai una prova di identità. I tentativi identici ricevono la stessa conferma senza un’altra consegna; un corpo modificato con la stessa chiave genera idempotency_mismatch.

Al massimo 10 nuovi messaggi per IP client all’ora (IPv6 raggruppati per /64), 3 per email al giorno e 200 complessivi all’ora; tutte le richieste condividono il limite di 120 per IP al minuto. Retry-After è vincolante. In caso di errori di consegna, i messaggi restano in coda; i record consegnati scadono dopo 30 giorni.

Disponibilità e orari per ogni progetto attivo. chat_allowed è true per ogni progetto attivo, incluso Standard. human_available è true quando una persona può unirsi alla chat su richiesta (Education, Premium ed Enterprise); Standard e Plus hanno documentazione e assistenza AI. staffed indica se lo staff è nel suo orario in questo momento. Luna risponde subito su ogni piano.

Conversazioni del progetto, le più recenti per prime, massimo 100. Il conteggio dei messaggi non letti dallo staff è per persona o agente autenticato.

Disponibile su ogni piano; Luna risponde per prima, subito. Dove una persona può unirsi (human_available nello stato dell’assistenza), la richiesta mette in pausa Luna per lo staff; su Standard e Plus viene ignorata e Luna risponde. Controllato prima dell’archiviazione o Slack.

Un messaggio iniziale sotto gli 8 caratteri o 3 parole restituisce submission_too_short; uno che non è domanda o problema restituisce submission_unclear; spam, testo con molti link, prompt injection e testo non sicuro restituiscono submission_rejected. Il testo rifiutato non viene conservato né inviato a Luna, e il dettaglio del problema non lo ripete mai.

Testi con forma di credenziali diversi da credenziali ScreenRig (token bearer, chiavi cloud e API, chiavi private) sono sostituiti con [redacted] prima della memorizzazione; materiale di credenziali ScreenRig restituisce invalid_request. Una nuova conversazione inizia un thread Slack; i follow-up restano in esso. Richieste con la stessa chiave vengono riprodotte per 24 ore, incluso un rifiuto.

Messaggi nella conversazione del progetto, sequenza ascendente, massimo 100. Continua dopo l’ultima sequenza messaggi per la paginazione di conversazioni più vecchie. La lettura non riconosce lo stato di non letto dello staff.

Aggiunge un messaggio cliente a una conversazione aperta. Un seguito non ha lunghezza minima e non è mai rifiutato come poco chiaro da solo ("grazie", "sì"); è controllato per sicurezza, iniezione prompt e spam di link, rifiutato con submission_rejected, e testo a forma di credenziali è gestito come per una nuova conversazione.

Il testo rifiutato non viene conservato, e un rifiuto si ripete con la stessa chiave per 24 ore.

Riconoscere monotonamente i messaggi tramite sequenza per questo lettore. Non è possibile riconoscere oltre la conversazione last_sequence.

Termina questa conversazione di progetto e annulla le risposte AI in sospeso. Ripetibile; conserva la cronologia. Lo staff può riaprirla in Slack.

Messaggi assistenza progetto su ogni piano come SSE riprendibile. event è support.message; id è la sequenza assistenza progetto, data è SupportMessage. after ha priorità su Last-Event-ID. Il cursore 0 riproduce la cronologia. I messaggi di staff, cliente e AI si distinguono per ruolo. I flussi rivalidano credenziali e accesso attivo al progetto.

Nessun dato di screenshot o credenziali viene inviato.