Envoyez n'importe quel texte, recevez un score de sentiment de 1–10
Conçue pour les développeurs intégrant leur propre helpdesk, CRM ou produit : envoyez un événement via POST à l'API /ingest de SentiTrack et il alimente les mêmes "Net Graph", "Time Graph", Rapports et Alertes que tous les autres canaux. Si c'est du texte, SentiTrack peut le noter.
L'API d'ingestion SentiTrack est un endpoint REST par organisation, authentifié par clé API (POST /api/v1/ingest/sentiments), qui accepte n'importe quel message texte de votre propre helpdesk, CRM ou produit et le transforme en un événement de sentiment de 1–10. Un appel devient un enregistrement qui alimente votre "Net Graph", votre "Time Graph", vos Rapports et vos Alertes.
Votre signal le plus honnête est piégé dans des systèmes personnalisés
E-mail, appels et chat sont couverts prêts à l'emploi — mais le ton dans vos propres tickets de helpdesk, notes de CRM et messages intégrés au produit n'atteint jamais vos tableaux de bord. Sans moyen d'envoyer ces messages, chaque canal personnalisé reste un angle mort, et la friction qui s'y accumule n'apparaît qu'après vous avoir coûté un client ou un collègue.
Un seul endpoint pour tout ce qui est du texte
L'API /ingest donne aux développeurs un moyen limité à votre organisation d'alimenter n'importe quel message dans SentiTrack. Authentifiez-vous avec une clé API par organisation, envoyez un événement avec un canal source, un expéditeur, un destinataire et le texte, et SentiTrack le note de 1–10 et l'achemine dans le même pipeline d'analyse que l'e-mail, la voix et le chat. Les corps sont notés, puis supprimés — seuls le score, les participants, l'horodatage, le sens et une empreinte de l'objet sont conservés.
- Authentification par clé API par organisation — chaque événement est limité à votre client, jamais à un org_id fourni par le client
- Choisissez n'importe quel canal source : email, phone, slack ou une clé personnalisée que votre organisation définit
- Envoyez un external_id pour des nouvelles tentatives idempotentes sûres — les doublons sont dédupliqués, pas comptés deux fois
- Événements uniques ou lots groupés jusqu'à 500, pour qu'une reprise d'historique soit un seul travail, pas des milliers d'appels
De votre système à votre graphe en trois étapes
Dans les Paramètres, générez une clé d'ingestion par organisation. Le texte en clair est affiché une seule fois ; SentiTrack ne stocke qu'un préfixe et une empreinte. Appelez GET /api/v1/ingest/whoami pour confirmer que la clé correspond à votre organisation avant de la brancher.
Envoyez un événement à /api/v1/ingest/sentiments avec un canal source, un expéditeur, un destinataire (et un cc facultatif), le texte du message et un external_id facultatif. SentiTrack note le texte de 1–10 avec le moteur SentiAI intégré, ou vous pouvez transmettre un score déjà calculé.
L'événement devient un enregistrement avec un sujet, un sens et des participants — instantanément visible dans le "Net Graph", le "Time Graph", les clusters de sujets, les Rapports PDF planifiés et les Alertes, aux côtés de l'e-mail, de la voix et du chat. Aucun tableau de bord distinct, aucune configuration supplémentaire.
Tickets de helpdesk, notes de CRM, messages intégrés au produit, avis, transcriptions de support — tout ce qui est textuel devient un événement de sentiment de 1–10. Un seul contrat couvre toutes les sources personnalisées imaginables.
Les événements ingérés traversent le pipeline identique à celui de l'e-mail, de la voix et du chat, ils apparaissent donc dans votre "Net Graph", votre "Time Graph", vos clusters de sujets, vos Rapports et vos Alertes sans configuration supplémentaire.
L'authentification se fait par clé API par organisation, et chaque événement est limité côté serveur à cette organisation. Les identifiants d'organisation fournis par le client ne sont jamais approuvés, de sorte qu'une fuite entre clients est structurellement impossible.
Transmettez un external_id et les nouvelles tentatives sont sûres — un appel répété renvoie l'enregistrement existant au lieu de le dupliquer. Reprenez l'historique avec des lots groupés jusqu'à 500 événements par requête.
La même notation native en 7 langues s'applique — anglais, allemand, français, italien, espagnol, russe et turc, plus l'arabe — sans configuration ni routage par langue de votre côté.
Les corps sont notés puis supprimés. SentiTrack ne conserve que le score, les participants, l'horodatage, le sens et une empreinte de l'objet — jamais le texte du message, l'objet ni les pièces jointes que vous avez envoyés.
Nous notons le texte, puis nous le jetons
L'API d'ingestion hérite de la posture de confidentialité de toute la plateforme SentiTrack. Quel que soit le message que vous envoyez via POST, il est noté puis supprimé — il n'est jamais conservé. Nous ne conservons que le score de 1–10, les participants, l'horodatage, le sens, le sujet et une empreinte de l'objet, de sorte que les données de votre canal personnalisé ne comportent pas plus de risque que l'e-mail.
- Zéro corps de message, texte d'objet ou pièce jointe stocké — seulement score plus métadonnées
- Les clés API par organisation sont chiffrées par Fernet au repos ; seuls un préfixe et une empreinte sont conservés après création
- La rétention configurable (365 jours par défaut) et un endpoint de suppression définitive s'appliquent aussi aux événements ingérés
- Stocker un sentiment avec des attributs démographiques peut être une donnée de l'article 9 du GDPR — AIPD, base légale et consentement restent de la responsabilité du client au titre des CGU
API d'ingestion développeur — FAQ
Comment envoyer des données de sentiment à SentiTrack par programmation ?
Envoyez un événement JSON via POST à /api/v1/ingest/sentiments authentifié par une clé API par organisation. Incluez un canal source, un expéditeur, un destinataire et le texte du message, et SentiTrack le note de 1–10 et l'achemine dans vos tableaux de bord. Pour l'historique, /ingest/sentiments/bulk accepte jusqu'à 500 événements dans un seul lot au mieux.
L'API d'ingestion stocke-t-elle le corps du message ?
Non. L'API d'ingestion suit la même posture de confidentialité que chaque canal SentiTrack : le texte est noté, puis supprimé. Seuls le score de 1–10, les participants, l'horodatage, le sens, le sujet et une empreinte de l'objet sont stockés — jamais le corps du message, le texte de l'objet ni les pièces jointes que vous envoyez.
Comment l'API d'ingestion est-elle authentifiée ?
Avec une clé API par organisation que vous générez dans les Paramètres. La clé en clair est affichée une seule fois à la création ; SentiTrack ne stocke qu'un préfixe et une empreinte. Chaque événement est limité côté serveur à l'organisation propriétaire de la clé, de sorte qu'un org_id fourni par le client n'est jamais approuvé et que les clients ne peuvent pas se mélanger.
Puis-je réessayer une requête en toute sécurité sans créer de doublons ?
Oui. Transmettez un external_id avec chaque événement et l'ingestion devient idempotente : un appel répété avec le même {org, external_id} est dédupliqué et renvoie l'enregistrement existant au lieu d'en créer un second. Cela rend sûrs à brancher les nouvelles tentatives, les rejeux et la livraison au moins une fois depuis votre file d'attente.
Quels types de messages puis-je envoyer à l'API d'ingestion ?
Tout ce qui est textuel. Tickets de helpdesk, notes de CRM, chat intégré au produit, transcriptions de support, avis et canaux personnalisés fonctionnent tous — si c'est du texte, SentiTrack peut le noter. Étiquetez chaque événement avec un canal source (email, phone, slack ou une clé personnalisée) pour qu'il se regroupe correctement dans votre "Net Graph" et votre "Time Graph".
Les événements ingérés apparaissent-ils dans les mêmes graphes que l'e-mail ?
Oui. Chaque événement ingéré devient un enregistrement qui traverse le pipeline identique à celui de l'e-mail IMAP, de la voix et du chat. Il apparaît dans le "Net Graph", le "Time Graph", les clusters de sujets, les vues sauvegardées, les Rapports PDF planifiés et les Alertes sans tableau de bord distinct ni configuration supplémentaire de votre côté.
Branchez votre premier message dès aujourd'hui
Générez une clé API par organisation, envoyez un événement via POST, et regardez-le arriver dans votre "Net Graph" et votre "Time Graph". Ou ouvrez la démo en direct avec des données d'exemple — sans inscription — pour voir exactement où apparaissent vos messages ingérés.