Envíe cualquier texto y reciba una puntuación de sentimiento del 1–10
Hecho para desarrolladores que integran su propio helpdesk, CRM o producto: envíe un evento mediante POST a la API /ingest de SentiTrack y fluye al mismo Net Graph, Time Graph, Informes y Alertas que cualquier otro canal. Si es texto, SentiTrack puede puntuarlo.
La API de ingesta de SentiTrack es un endpoint REST por organización, autenticado con clave de API (POST /api/v1/ingest/sentiments) que acepta cualquier mensaje de texto de su propio helpdesk, CRM o producto y lo convierte en un evento de sentimiento del 1–10. Una llamada se convierte en un registro que fluye a su Net Graph, Time Graph, Informes y Alertas.
Su señal más honesta está atrapada en sistemas personalizados
El correo, las llamadas y el chat están cubiertos de inmediato, pero el tono dentro de los tickets de su propio helpdesk, las notas del CRM y los mensajes en el producto nunca llega a sus paneles. Sin una forma de enviar esos mensajes, cada canal personalizado sigue siendo un punto ciego, y la fricción que se acumula allí aparece solo después de que le cuesta un cliente o un compañero.
Un único endpoint para cualquier cosa que sea texto
La API /ingest da a los desarrolladores una forma limitada por inquilino de alimentar cualquier mensaje a SentiTrack. Autentique con una clave de API por organización, envíe mediante POST un evento con un canal de origen, from, to y el texto, y SentiTrack lo puntúa del 1–10 y lo enruta al mismo pipeline de analítica que el correo, la voz y el chat. Los cuerpos se puntúan y luego se descartan: solo se conservan la puntuación, los participantes, la marca de tiempo, la dirección y un hash del asunto.
- Autenticación con clave de API por organización: cada evento se limita a su inquilino, nunca a un org_id suministrado por el cliente
- Elija cualquier canal de origen: email, phone, slack o una clave personalizada que su organización defina
- Envíe un external_id para reintentos idempotentes seguros: los duplicados se deduplican, no se cuentan dos veces
- Eventos individuales o lotes masivos de hasta 500, así que una recarga histórica es un solo trabajo, no miles de llamadas
De su sistema a su grafo en tres pasos
En Configuración, genere una clave de ingesta por organización. El texto plano se muestra una sola vez; SentiTrack almacena solo un prefijo y un hash. Llame a GET /api/v1/ingest/whoami para confirmar que la clave se resuelve a su organización antes de integrarla.
Envíe un evento a /api/v1/ingest/sentiments con un canal de origen, from, to (y cc opcional), el texto del mensaje y un external_id opcional. SentiTrack puntúa el texto del 1–10 con el motor SentiAI incluido, o puede pasar una puntuación que ya haya calculado.
El evento se convierte en un registro con un tema, una dirección y participantes, visible al instante en el Net Graph, Time Graph, clústeres de temas, Informes PDF programados y Alertas, junto al correo, la voz y el chat. Sin panel aparte, sin configuración extra.
Tickets de helpdesk, notas de CRM, mensajes en el producto, reseñas, transcripciones de soporte: cualquier cosa textual se convierte en un evento de sentimiento del 1–10. Un solo contrato cubre cada fuente personalizada que pueda imaginar.
Los eventos ingeridos fluyen por el pipeline idéntico al del correo, la voz y el chat, así que aparecen en su Net Graph, Time Graph, clústeres de temas, Informes y Alertas con cero configuración adicional.
La autenticación es una clave de API por organización, y cada evento se limita del lado del servidor a esa organización. Los identificadores de organización suministrados por el cliente nunca se confían, así que la fuga entre inquilinos es estructuralmente imposible.
Pase un external_id y los reintentos son seguros: una llamada repetida devuelve el registro existente en lugar de duplicarlo. Recargue el historial con lotes masivos de hasta 500 eventos por solicitud.
Se aplica la misma puntuación nativa en 7 idiomas —inglés, alemán, francés, italiano, español, ruso y turco, más árabe— sin configuración por idioma ni enrutamiento de su parte.
Los cuerpos se puntúan y luego se descartan. SentiTrack conserva solo la puntuación, los participantes, la marca de tiempo, la dirección y un hash del asunto: nunca el texto del mensaje, el asunto ni los adjuntos que envió.
Puntuamos el texto y luego lo desechamos
La API de ingesta hereda la postura de privacidad de toda la plataforma de SentiTrack. Cualquier mensaje que envíe mediante POST se puntúa y luego se descarta: nunca se persiste. Conservamos solo la puntuación del 1–10, los participantes, la marca de tiempo, la dirección, el tema y un hash del asunto, así que los datos de su canal personalizado no conllevan más riesgo que el correo.
- Cero cuerpos de mensaje, texto del asunto o adjuntos almacenados: solo puntuación más metadatos
- Las claves de API por organización se cifran con Fernet en reposo; solo se conservan un prefijo y un hash tras la creación
- La retención configurable (365 días por defecto) y un endpoint de borrado definitivo también se aplican a los eventos ingeridos
- Almacenar el sentimiento con atributos demográficos puede ser dato del Artículo 9 del GDPR: la DPIA, la base legal y el consentimiento siguen siendo responsabilidad del cliente bajo los ToS
API de ingesta para desarrolladores — Preguntas frecuentes
¿Cómo envío datos de sentimiento a SentiTrack mediante programación?
Envíe mediante POST un evento JSON a /api/v1/ingest/sentiments autenticado con una clave de API por organización. Incluya un canal de origen, from, to y el texto del mensaje, y SentiTrack lo puntúa del 1–10 y lo enruta a sus paneles. Para el historial, /ingest/sentiments/bulk acepta hasta 500 eventos en un solo lote de mejor esfuerzo.
¿La API de ingesta almacena el cuerpo del mensaje?
No. La API de ingesta sigue la misma postura de privacidad que cada canal de SentiTrack: el texto se puntúa y luego se descarta. Solo se almacenan la puntuación del 1–10, los participantes, la marca de tiempo, la dirección, el tema y un hash del asunto: nunca el cuerpo del mensaje, el texto del asunto ni los adjuntos que envíe.
¿Cómo se autentica la API de ingesta?
Con una clave de API por organización que genera en Configuración. La clave en texto plano se muestra una sola vez al crearla; SentiTrack almacena solo un prefijo más un hash. Cada evento se limita del lado del servidor a la organización dueña de la clave, así que un org_id suministrado por el cliente nunca se confía y los inquilinos no pueden filtrarse entre sí.
¿Puedo reintentar una solicitud de forma segura sin crear duplicados?
Sí. Pase un external_id con cada evento y la ingesta se vuelve idempotente: una llamada repetida con el mismo {org, external_id} se deduplica y devuelve el registro existente en lugar de crear un segundo. Esto hace que los reintentos, las repeticiones y la entrega al-menos-una-vez desde su cola sean seguros de integrar.
¿Qué tipos de mensajes puedo enviar a la API de ingesta?
Cualquier cosa textual. Tickets de helpdesk, notas de CRM, chat en el producto, transcripciones de soporte, reseñas y canales personalizados funcionan todos: si es texto, SentiTrack puede puntuarlo. Etiquete cada evento con un canal de origen (email, phone, slack o una clave personalizada) para que se agrupe correctamente en su Net Graph y Time Graph.
¿Los eventos ingeridos aparecen en los mismos grafos que el correo?
Sí. Cada evento ingerido se convierte en un registro que fluye por el pipeline idéntico al del correo IMAP, la voz y el chat. Aparece en el Net Graph, Time Graph, clústeres de temas, vistas guardadas, Informes PDF programados y Alertas sin panel aparte ni configuración extra de su parte.
Integre su primer mensaje hoy
Genere una clave de API por organización, envíe un evento mediante POST y véalo aterrizar en su Net Graph y Time Graph. O abra la demo en vivo con datos de ejemplo —sin registro— para ver exactamente dónde aparecen sus mensajes ingeridos.