Senden Sie beliebigen Text, erhalten Sie eine Sentiment-Bewertung von 1–10 zurück
Gebaut für Entwickler, die ihr eigenes Helpdesk, CRM oder Produkt integrieren: POSTen Sie ein Ereignis an SentiTracks /ingest-API, und es fließt in denselben Net Graph, Time Graph, dieselben Berichte und Alerts wie jeder andere Kanal. Wenn es Text ist, kann SentiTrack es bewerten.
Die SentiTrack-Ingest-API ist ein pro Organisation per API-Schlüssel authentifizierter REST-Endpunkt (POST /api/v1/ingest/sentiments), der jede Textnachricht aus Ihrem eigenen Helpdesk, CRM oder Produkt akzeptiert und in ein Sentiment-Ereignis von 1–10 verwandelt. Ein Aufruf wird zu einem Datensatz, der in Ihren Net Graph, Time Graph, Ihre Berichte und Alerts fließt.
Ihr ehrlichstes Signal ist in benutzerdefinierten Systemen gefangen
E-Mail, Anrufe und Chat sind ab Werk abgedeckt — aber der Ton in Ihren eigenen Helpdesk-Tickets, CRM-Notizen und In-Produkt-Nachrichten erreicht Ihre Dashboards nie. Ohne eine Möglichkeit, diese Nachrichten einzuspeisen, bleibt jeder benutzerdefinierte Kanal ein blinder Fleck, und die dort anwachsende Reibung taucht erst auf, nachdem sie Sie einen Kunden oder Teamkollegen gekostet hat.
Ein einziger Endpunkt für alles, was Text ist
Die /ingest-API gibt Entwicklern eine mandantenbeschränkte Möglichkeit, jede Nachricht in SentiTrack einzuspeisen. Authentifizieren Sie sich mit einem API-Schlüssel pro Organisation, POSTen Sie ein Ereignis mit einem Quellkanal, From, To und dem Text, und SentiTrack bewertet es von 1–10 und leitet es in dieselbe Analyse-Pipeline wie E-Mail, Sprache und Chat. Inhalte werden bewertet und dann verworfen — nur die Bewertung, die Beteiligten, der Zeitstempel, die Richtung und ein Betreff-Hash werden behalten.
- Authentifizierung per API-Schlüssel pro Organisation — jedes Ereignis ist auf Ihren Mandanten beschränkt, nie auf eine vom Client gelieferte org_id
- Wählen Sie einen beliebigen Quellkanal: email, phone, slack oder einen benutzerdefinierten Schlüssel, den Ihre Organisation definiert
- Senden Sie eine external_id für sichere idempotente Wiederholungen — Duplikate werden dedupliziert, nicht doppelt gezählt
- Einzelne Ereignisse oder Massenstapel von bis zu 500, sodass ein Backfill ein Job ist, nicht Tausende Aufrufe
Von Ihrem System zu Ihrem Graphen in drei Schritten
Generieren Sie in den Einstellungen einen Ingest-Schlüssel pro Organisation. Der Klartext wird einmal angezeigt; SentiTrack speichert nur ein Präfix und einen Hash. Rufen Sie GET /api/v1/ingest/whoami auf, um zu bestätigen, dass der Schlüssel zu Ihrer Organisation aufgelöst wird, bevor Sie ihn einbinden.
Senden Sie ein Ereignis an /api/v1/ingest/sentiments mit einem Quellkanal, From, To (und optional Cc), dem Nachrichtentext und einer optionalen external_id. SentiTrack bewertet den Text von 1–10 mit der mitgelieferten SentiAI-Engine, oder Sie können eine bereits berechnete Bewertung übergeben.
Das Ereignis wird zu einem Datensatz mit einem Thema, einer Richtung und Beteiligten — sofort sichtbar im Net Graph, Time Graph, in Themen-Clustern, geplanten PDF-Berichten und Alerts, neben E-Mail, Sprache und Chat. Kein separates Dashboard, keine zusätzliche Einrichtung.
Helpdesk-Tickets, CRM-Notizen, In-Produkt-Nachrichten, Bewertungen, Support-Transkripte — alles Textuelle wird zu einem Sentiment-Ereignis von 1–10. Ein Vertrag deckt jede benutzerdefinierte Quelle ab, die Sie sich vorstellen können.
Eingespeiste Ereignisse fließen durch dieselbe Pipeline wie E-Mail, Sprache und Chat, sodass sie in Ihrem Net Graph, Time Graph, Ihren Themen-Clustern, Berichten und Alerts ohne zusätzliche Konfiguration erscheinen.
Die Authentifizierung ist ein API-Schlüssel pro Organisation, und jedes Ereignis wird serverseitig auf diese Organisation beschränkt. Vom Client gelieferte Organisationskennungen werden nie vertraut, sodass mandantenübergreifendes Durchsickern strukturell unmöglich ist.
Übergeben Sie eine external_id, und Wiederholungen sind sicher — ein wiederholter Aufruf gibt den vorhandenen Datensatz zurück, statt ihn zu duplizieren. Füllen Sie Verlauf mit Massenstapeln von bis zu 500 Ereignissen pro Anfrage nach.
Dieselbe native Bewertung in 7 Sprachen gilt — Englisch, Deutsch, Französisch, Italienisch, Spanisch, Russisch und Türkisch, plus Arabisch — ohne Einrichtung oder Routing pro Sprache auf Ihrer Seite.
Inhalte werden bewertet und dann verworfen. SentiTrack behält nur die Bewertung, die Beteiligten, den Zeitstempel, die Richtung und einen Betreff-Hash — nie den Nachrichtentext, den Betreff oder Anhänge, die Sie gesendet haben.
Wir bewerten den Text und werfen ihn dann weg
Die Ingest-API erbt SentiTracks plattformweite Datenschutzhaltung. Welche Nachricht Sie auch POSTen, sie wird bewertet und dann verworfen — sie wird nie dauerhaft gespeichert. Wir behalten nur die Bewertung von 1–10, die Beteiligten, den Zeitstempel, die Richtung, das Thema und einen Betreff-Hash, sodass Ihre Daten aus benutzerdefinierten Kanälen kein größeres Risiko tragen als E-Mail.
- Null Nachrichteninhalte, Betreff-Text oder Anhänge gespeichert — nur Bewertung plus Metadaten
- API-Schlüssel pro Organisation sind ruhend Fernet-verschlüsselt; nach der Erstellung werden nur ein Präfix und Hash behalten
- Konfigurierbare Aufbewahrung (Standard 365 Tage) und ein Endpunkt zum harten Löschen gelten auch für eingespeiste Ereignisse
- Das Speichern von Sentiment mit demografischen Attributen kann DSGVO-Artikel-9-Daten sein — DSFA, Rechtsgrundlage und Einwilligung bleiben gemäß den ToS in der Verantwortung des Kunden
Entwickler-Ingest-API — FAQ
Wie sende ich Sentiment-Daten programmatisch an SentiTrack?
POSTen Sie ein JSON-Ereignis an /api/v1/ingest/sentiments, authentifiziert mit einem API-Schlüssel pro Organisation. Geben Sie einen Quellkanal, From, To und den Nachrichtentext an, und SentiTrack bewertet es von 1–10 und leitet es in Ihre Dashboards. Für Verlauf akzeptiert /ingest/sentiments/bulk bis zu 500 Ereignisse in einem Best-Effort-Stapel.
Speichert die Ingest-API den Nachrichteninhalt?
Nein. Die Ingest-API folgt derselben Datenschutzhaltung wie jeder SentiTrack-Kanal: Der Text wird bewertet und dann verworfen. Nur die Bewertung von 1–10, die Beteiligten, der Zeitstempel, die Richtung, das Thema und ein Betreff-Hash werden gespeichert — nie der Nachrichteninhalt, der Betreff-Text oder Anhänge, die Sie senden.
Wie wird die Ingest-API authentifiziert?
Mit einem API-Schlüssel pro Organisation, den Sie in den Einstellungen generieren. Der Klartext-Schlüssel wird einmal bei der Erstellung angezeigt; SentiTrack speichert nur ein Präfix plus einen Hash. Jedes Ereignis wird serverseitig auf die Organisation beschränkt, die den Schlüssel besitzt, sodass eine vom Client gelieferte org_id nie vertraut wird und Mandanten nicht ineinander durchsickern können.
Kann ich eine Anfrage sicher wiederholen, ohne Duplikate zu erzeugen?
Ja. Übergeben Sie eine external_id mit jedem Ereignis, und die Einspeisung wird idempotent: Ein wiederholter Aufruf mit demselben {org, external_id} wird dedupliziert und gibt den vorhandenen Datensatz zurück, statt einen zweiten zu erstellen. Das macht Wiederholungen, Replays und At-least-once-Zustellung aus Ihrer Warteschlange sicher einzurichten.
Welche Arten von Nachrichten kann ich an die Ingest-API senden?
Alles Textuelle. Helpdesk-Tickets, CRM-Notizen, In-Produkt-Chat, Support-Transkripte, Bewertungen und benutzerdefinierte Kanäle funktionieren alle — wenn es Text ist, kann SentiTrack es bewerten. Versehen Sie jedes Ereignis mit einem Quellkanal (email, phone, slack oder einem benutzerdefinierten Schlüssel), sodass es in Ihrem Net Graph und Time Graph korrekt gruppiert wird.
Erscheinen eingespeiste Ereignisse in denselben Graphen wie E-Mail?
Ja. Jedes eingespeiste Ereignis wird zu einem Datensatz, der durch dieselbe Pipeline wie IMAP-E-Mail, Sprache und Chat fließt. Es erscheint im Net Graph, Time Graph, in Themen-Clustern, gespeicherten Ansichten, geplanten PDF-Berichten und Alerts, ohne separates Dashboard und ohne zusätzliche Konfiguration auf Ihrer Seite.
Binden Sie Ihre erste Nachricht heute ein
Generieren Sie einen API-Schlüssel pro Organisation, POSTen Sie ein Ereignis und beobachten Sie, wie es in Ihrem Net Graph und Time Graph landet. Oder öffnen Sie die Live-Demo mit Beispieldaten — keine Anmeldung erforderlich — um genau zu sehen, wo Ihre eingespeisten Nachrichten erscheinen.