Tallker
Tallker API v1

Документация для разработчиков

Подключайте серверные системы, передавайте контакты и заказы и безопасно узнавайте авторизованных пользователей в виджете.

OpenAPI 3.1Аутентификация и права →
fetch("https://tallker.com/api/v1/public/contacts/upsert", {
  method: "POST", headers: { Authorization: "Bearer " + process.env.TALLKER_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({ external_id: "customer_18452", name: "Ivan", email: "ivan@example.com" })
});
Замените пример своими тестовыми данными

Выберите задачу интеграции

Виджет

Установка виджета на сайт, передача контекста страницы и связь с авторизованным пользователем.

Открыть документацию

Безопасная идентификация

Создание подписанного короткоживущего токена, связывающего сессию виджета с клиентом вашей системы.

Открыть документацию

API контактов

Создание или обновление контактов из интернет-магазина, CRM либо другой серверной системы.

Открыть документацию

API заказов

Синхронизация заказа, покупателя, состава и статуса с автоматическим созданием сделки в CRM.

Открыть документацию

Аутентификация

Создание серверных API-ключей, выбор минимальных прав и безопасная ротация.

Открыть документацию

Ошибки

Единый формат ошибок, коды HTTP и безопасная стратегия повторных запросов.

Открыть документацию

Webhooks

Как Tallker принимает события подключённых каналов и что доступно разработчикам сейчас.

Открыть документацию

Спецификация OpenAPI

Форматы запросов, схемы данных и документированные операции серверного API.

Открыть YAML

Безопасность и данные

Права команды, работа с клиентскими данными и проверка требований перед запуском.

Проверить условия

Два частых сценария

Контакт из вашей системы

Передайте внешний идентификатор и данные контакта. Повторный запрос с тем же external_id обновляет существующую запись.

Формат контакта →

Заказ и продолжение в CRM

Передайте заказ вместе с покупателем. Используйте Idempotency-Key для безопасного повтора одного и того же запроса.

Формат заказа →

Проверьте подключение до запуска

  1. 1Определите необходимые операции и права
  2. 2Создайте отдельный серверный ключ для интеграции
  3. 3Выполните запрос на тестовых данных
  4. 4Проверьте ответ, повторы и обработку ошибок

Вопросы разработчиков

Можно ли использовать API-ключ в браузере?

Нет. Серверный ключ должен оставаться на сервере. Для авторизованного пользователя виджета получите короткоживущий identity token.

Есть ли исходящие webhooks для собственной системы?

Исходящие developer webhooks пока недоступны. Документация описывает входящие события подключённых каналов; для чтения контактов и заказов используйте GET API.

Какие ошибки можно повторять?

Для временных ошибок 429 и 5xx используйте задержку с увеличением интервала и учитывайте Retry-After. При повторе заказа сохраняйте исходный ключ идемпотентности.

Начните с тестового пространства

Проверьте путь данных и результат в интерфейсе Tallker.

Создать пространство →