Отправьте любой текст, получите оценку тональности 1–10 в ответ
Создан для разработчиков, интегрирующих собственную службу поддержки, CRM или продукт: отправьте одно событие POST в API /ingest SentiTrack, и оно попадёт в те же «Net Graph», «Time Graph», отчёты и оповещения, что и любой другой канал. Если это текст, SentiTrack может его оценить.
API приёма SentiTrack — это REST-эндпоинт для каждой организации с аутентификацией по ключу API (POST /api/v1/ingest/sentiments), который принимает любое текстовое сообщение из вашей собственной службы поддержки, CRM или продукта и превращает его в событие тональности 1–10. Один вызов становится одной записью, которая попадает в ваши «Net Graph», «Time Graph», отчёты и оповещения.
Ваш самый честный сигнал заперт в собственных системах
Почта, звонки и чаты покрыты из коробки — но тон внутри ваших собственных тикетов поддержки, заметок CRM и сообщений в продукте никогда не доходит до ваших дашбордов. Без способа отправить эти сообщения каждый пользовательский канал остаётся слепой зоной, а нарастающие там трения проявляются только после того, как обходятся вам в клиента или коллегу.
Единый эндпоинт для всего, что является текстом
API /ingest даёт разработчикам способ, ограниченный арендатором, подавать любое сообщение в SentiTrack. Аутентифицируйтесь ключом API для организации, отправьте POST с источником-каналом, отправителем, получателем и текстом, и SentiTrack оценит его по шкале 1–10 и направит в тот же аналитический конвейер, что и почту, голос и чаты. Тела оцениваются, а затем удаляются — хранятся только оценка, участники, метка времени, направление и хеш темы.
- Аутентификация по ключу API для организации — каждое событие привязано к вашему арендатору, никогда к org_id, переданному клиентом
- Выбирайте любой источник-канал: email, phone, slack или пользовательский ключ, который определяет ваша организация
- Отправляйте external_id для безопасных идемпотентных повторов — дубликаты дедуплицируются, а не считаются дважды
- Одиночные события или пакеты до 500, поэтому исторический бэкфилл — это одна задача, а не тысячи вызовов
От вашей системы до вашего графа за три шага
В Настройках сгенерируйте ключ приёма для организации. Открытый текст показывается один раз; SentiTrack хранит только префикс и хеш. Вызовите GET /api/v1/ingest/whoami, чтобы подтвердить, что ключ привязан к вашей организации, прежде чем встраивать его.
Отправьте одно событие в /api/v1/ingest/sentiments с источником-каналом, отправителем, получателем (и необязательной копией), текстом сообщения и необязательным external_id. SentiTrack оценит текст по шкале 1–10 встроенным движком SentiAI, или вы можете передать уже вычисленную оценку.
Событие становится одной записью с темой, направлением и участниками — мгновенно видимой в «Net Graph», «Time Graph», кластерах тем, плановых PDF-отчётах и оповещениях, рядом с почтой, голосом и чатами. Без отдельного дашборда, без дополнительной настройки.
Тикеты поддержки, заметки CRM, сообщения в продукте, отзывы, транскрипты поддержки — всё текстовое становится событием тональности 1–10. Один контракт покрывает каждый пользовательский источник, какой только можно придумать.
Принятые события проходят через идентичный конвейер, что и почта, голос и чаты, поэтому появляются в ваших «Net Graph», «Time Graph», кластерах тем, отчётах и оповещениях без какой-либо дополнительной настройки.
Аутентификация — это ключ API для организации, и каждое событие привязывается на сервере к этой организации. Идентификаторы организации, переданные клиентом, никогда не считаются доверенными, поэтому утечка между арендаторами структурно невозможна.
Передайте external_id, и повторы безопасны — повторный вызов возвращает существующую запись вместо её дублирования. Заполняйте историю пакетами до 500 событий за запрос.
Применяется та же нативная оценка на 7 языках — английском, немецком, французском, итальянском, испанском, русском и турецком, плюс арабский — без настройки или маршрутизации под каждый язык с вашей стороны.
Тела оцениваются, а затем удаляются. SentiTrack хранит только оценку, участников, метку времени, направление и хеш темы — никогда текст сообщения, тему или вложения, которые вы отправили.
Мы оцениваем текст, а затем удаляем его
API приёма наследует подход к приватности всей платформы SentiTrack. Любое сообщение, которое вы отправляете POST, оценивается, а затем удаляется — оно никогда не сохраняется. Мы удерживаем только оценку 1–10, участников, метку времени, направление, тему и хеш темы, поэтому данные вашего пользовательского канала несут не больше риска, чем почта.
- Ноль сохранённых тел сообщений, текста темы или вложений — только оценка плюс метаданные
- Ключи API для организации зашифрованы в покое через Fernet; после создания хранятся только префикс и хеш
- Настраиваемое хранение (по умолчанию 365 дней) и эндпоинт жёсткого удаления применяются и к принятым событиям
- Хранение тональности с демографическими атрибутами может быть данными по статье 9 GDPR — оценка воздействия (DPIA), правовое основание и согласие остаются ответственностью клиента по Условиям обслуживания
API приёма для разработчиков — частые вопросы
Как программно отправлять данные тональности в SentiTrack?
Отправьте JSON-событие POST в /api/v1/ingest/sentiments с аутентификацией по ключу API для организации. Включите источник-канал, отправителя, получателя и текст сообщения, и SentiTrack оценит его по шкале 1–10 и направит в ваши дашборды. Для истории /ingest/sentiments/bulk принимает до 500 событий в одном пакете с максимальными усилиями.
Хранит ли API приёма тело сообщения?
Нет. API приёма следует тому же подходу к приватности, что и каждый канал SentiTrack: текст оценивается, а затем удаляется. Хранятся только оценка 1–10, участники, метка времени, направление, тема и хеш темы — никогда тело сообщения, текст темы или вложения, которые вы отправляете.
Как аутентифицируется API приёма?
Ключом API для организации, который вы генерируете в Настройках. Открытый текст ключа показывается один раз при создании; SentiTrack хранит только префикс плюс хеш. Каждое событие привязывается на сервере к организации-владельцу ключа, поэтому org_id, переданный клиентом, никогда не считается доверенным, и арендаторы не могут перетечь друг в друга.
Можно ли безопасно повторить запрос, не создавая дубликаты?
Да. Передайте external_id с каждым событием, и приём становится идемпотентным: повторный вызов с тем же {org, external_id} дедуплицируется и возвращает существующую запись вместо создания второй. Это делает безопасными повторы, переигрывания и доставку «хотя бы один раз» из вашей очереди.
Какие виды сообщений можно отправлять в API приёма?
Что угодно текстовое. Тикеты поддержки, заметки CRM, чат в продукте, транскрипты поддержки, отзывы и пользовательские каналы — всё работает; если это текст, SentiTrack может его оценить. Помечайте каждое событие источником-каналом (email, phone, slack или пользовательский ключ), чтобы оно правильно группировалось в ваших «Net Graph» и «Time Graph».
Появляются ли принятые события на тех же графах, что и почта?
Да. Каждое принятое событие становится одной записью, которая проходит через идентичный конвейер, что и почта по IMAP, голос и чаты. Оно появляется в «Net Graph», «Time Graph», кластерах тем, сохранённых представлениях, плановых PDF-отчётах и оповещениях без отдельного дашборда и без дополнительной настройки с вашей стороны.
Подключите первое сообщение уже сегодня
Сгенерируйте ключ API для организации, отправьте одно событие POST и наблюдайте, как оно попадает в ваши «Net Graph» и «Time Graph». Или откройте живое демо с тестовыми данными — без регистрации — чтобы увидеть точно, где появляются ваши принятые сообщения.