Invia qualsiasi testo, ricevi un punteggio di sentiment 1–10
Pensata per gli sviluppatori che integrano il proprio helpdesk, CRM o prodotto: invia un evento all'API /ingest di SentiTrack e confluisce negli stessi Net Graph, Time Graph, Report e Avvisi di ogni altro canale. Se è testo, SentiTrack può valutarlo.
L'API di ingest di SentiTrack è un endpoint REST per organizzazione, autenticato con chiave API (POST /api/v1/ingest/sentiments), che accetta qualsiasi messaggio di testo dal tuo helpdesk, CRM o prodotto e lo trasforma in un evento di sentiment 1–10. Una chiamata diventa un record che confluisce nel tuo Net Graph, Time Graph, Report e Avvisi.
Il tuo segnale più onesto è intrappolato nei sistemi personalizzati
Email, chiamate e chat sono coperte di serie, ma il tono dentro i tuoi ticket di helpdesk, le note del CRM e i messaggi in-app non raggiunge mai le tue dashboard. Senza un modo per inviare quei messaggi, ogni canale personalizzato resta un punto cieco, e gli attriti che vi covano emergono solo dopo che ti sono costati un cliente o un collega.
Un unico endpoint per qualsiasi cosa sia testo
L'API /ingest offre agli sviluppatori un modo circoscritto al tenant per inviare qualsiasi messaggio in SentiTrack. Autenticati con una chiave API per organizzazione, invia un evento con un canale di origine, mittente, destinatario e il testo, e SentiTrack lo valuta 1–10 e lo indirizza nella stessa pipeline di analisi di email, voce e chat. I corpi vengono valutati e poi scartati: si conservano solo il punteggio, i partecipanti, l'orario, la direzione e un hash dell'oggetto.
- Autenticazione con chiave API per organizzazione: ogni evento è circoscritto al tuo tenant, mai a un org_id fornito dal client
- Scegli qualsiasi canale di origine: email, telefono, slack o una chiave personalizzata definita dalla tua organizzazione
- Invia un external_id per ripetizioni idempotenti sicure: i duplicati vengono deduplicati, non conteggiati due volte
- Eventi singoli o lotti in blocco fino a 500, così un caricamento storico è un solo job, non migliaia di chiamate
Dal tuo sistema al tuo grafo in tre passi
Nelle Impostazioni, genera una chiave di ingest per organizzazione. Il testo in chiaro viene mostrato una sola volta; SentiTrack memorizza solo un prefisso e un hash. Chiama GET /api/v1/ingest/whoami per confermare che la chiave si risolva nella tua organizzazione prima di collegarla.
Invia un evento a /api/v1/ingest/sentiments con un canale di origine, mittente, destinatario (e cc opzionale), il testo del messaggio e un external_id opzionale. SentiTrack valuta il testo 1–10 con il motore SentiAI incluso, oppure puoi passare un punteggio già calcolato.
L'evento diventa un record con un argomento, una direzione e i partecipanti, visibile all'istante nel Net Graph, Time Graph, cluster di Argomenti, Report PDF programmati e Avvisi, accanto a email, voce e chat. Nessuna dashboard separata, nessuna configurazione aggiuntiva.
Ticket di helpdesk, note del CRM, messaggi in-app, recensioni, trascrizioni di supporto: qualsiasi cosa testuale diventa un evento di sentiment 1–10. Un unico contratto copre ogni fonte personalizzata che ti venga in mente.
Gli eventi acquisiti attraversano l'identica pipeline di email, voce e chat, così appaiono nel tuo Net Graph, Time Graph, cluster di Argomenti, Report e Avvisi senza alcuna configurazione aggiuntiva.
L'autenticazione è una chiave API per organizzazione, e ogni evento è circoscritto lato server a quell'organizzazione. Gli identificatori di organizzazione forniti dal client non sono mai considerati attendibili, così la fuga tra tenant è strutturalmente impossibile.
Passa un external_id e le ripetizioni sono sicure: una chiamata ripetuta restituisce il record esistente invece di duplicarlo. Carica lo storico con lotti in blocco fino a 500 eventi per richiesta.
Si applica la stessa valutazione nativa in 7 lingue, inglese, tedesco, francese, italiano, spagnolo, russo e turco, più l'arabo, senza configurazione o instradamento per singola lingua dalla tua parte.
I corpi vengono valutati e poi scartati. SentiTrack conserva solo il punteggio, i partecipanti, l'orario, la direzione e un hash dell'oggetto, mai il testo del messaggio, l'oggetto o gli allegati che hai inviato.
Valutiamo il testo, poi lo eliminiamo
L'API di ingest eredita la postura sulla privacy dell'intera piattaforma SentiTrack. Qualunque messaggio invii viene valutato e poi scartato: non viene mai conservato. Conserviamo solo il punteggio 1–10, i partecipanti, l'orario, la direzione, l'argomento e un hash dell'oggetto, così i dati dei tuoi canali personalizzati non comportano più rischi delle email.
- Zero corpi di messaggi, testo dell'oggetto o allegati memorizzati: solo punteggio più metadati
- Le chiavi API per organizzazione sono cifrate con Fernet a riposo; dopo la creazione si conservano solo un prefisso e un hash
- La conservazione configurabile (predefinita 365 giorni) e un endpoint di cancellazione definitiva si applicano anche agli eventi acquisiti
- Memorizzare il sentiment con attributi demografici può essere dato ai sensi dell'articolo 9 del GDPR: DPIA, base giuridica e consenso restano responsabilità del cliente ai sensi dei ToS
API di ingest per sviluppatori — FAQ
Come invio dati di sentiment a SentiTrack in modo programmatico?
Invia un evento JSON a /api/v1/ingest/sentiments autenticato con una chiave API per organizzazione. Includi un canale di origine, mittente, destinatario e il testo del messaggio, e SentiTrack lo valuta 1–10 e lo indirizza nelle tue dashboard. Per lo storico, /ingest/sentiments/bulk accetta fino a 500 eventi in un singolo lotto best-effort.
L'API di ingest memorizza il corpo del messaggio?
No. L'API di ingest segue la stessa postura sulla privacy di ogni canale SentiTrack: il testo viene valutato, poi scartato. Si memorizzano solo il punteggio 1–10, i partecipanti, l'orario, la direzione, l'argomento e un hash dell'oggetto, mai il corpo del messaggio, il testo dell'oggetto o gli allegati che invii.
Come viene autenticata l'API di ingest?
Con una chiave API per organizzazione che generi nelle Impostazioni. La chiave in chiaro viene mostrata una sola volta alla creazione; SentiTrack memorizza solo un prefisso più un hash. Ogni evento è circoscritto lato server all'organizzazione proprietaria della chiave, così un org_id fornito dal client non è mai considerato attendibile e i tenant non possono trafilare l'uno nell'altro.
Posso ripetere una richiesta in sicurezza senza creare duplicati?
Sì. Passa un external_id con ogni evento e l'acquisizione diventa idempotente: una chiamata ripetuta con lo stesso {org, external_id} viene deduplicata e restituisce il record esistente invece di crearne un secondo. Questo rende sicuri ripetizioni, riproduzioni e la consegna at-least-once dalla tua coda.
Che tipi di messaggi posso inviare all'API di ingest?
Qualsiasi cosa testuale. Ticket di helpdesk, note del CRM, chat in-app, trascrizioni di supporto, recensioni e canali personalizzati funzionano tutti: se è testo, SentiTrack può valutarlo. Contrassegna ogni evento con un canale di origine (email, telefono, slack o una chiave personalizzata) così si raggruppa correttamente nel tuo Net Graph e Time Graph.
Gli eventi acquisiti compaiono negli stessi grafi delle email?
Sì. Ogni evento acquisito diventa un record che attraversa l'identica pipeline delle email IMAP, della voce e della chat. Appare nel Net Graph, Time Graph, cluster di Argomenti, viste salvate, Report PDF programmati e Avvisi senza alcuna dashboard separata e senza configurazione aggiuntiva dalla tua parte.
Collega oggi il tuo primo messaggio
Genera una chiave API per organizzazione, invia un evento e guardalo arrivare nel tuo Net Graph e Time Graph. Oppure apri la demo live con dati di esempio, senza registrazione, per vedere esattamente dove appaiono i tuoi messaggi acquisiti.