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

curl -X POST https://tallker.com/api/v1/public/widget/identity \ -H "Authorization: Bearer tk_live_..." \ -H "Content-Type: application/json" \ -d '{"external_user_id":"customer_18452","email":"ivan@example.com","widget_id":"YOUR_PUBLIC_WIDGET_ID"}'

POST/api/v1/public/widget/identityscope: widget_identity:write

Как это работает

1Ваш backend авторизует пользователя обычным способом.
2Backend запрашивает identity token у Tallker с API-ключом.
3Браузер получает только identity token и передаёт его виджету.

Примеры

curl -X POST https://tallker.com/api/v1/public/widget/identity \
  -H "Authorization: Bearer tk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"external_user_id":"customer_18452","email":"ivan@example.com","widget_id":"YOUR_PUBLIC_WIDGET_ID"}'

Параметры и требования

Параметр	Требование	Описание
`external_user_id`	обязательно	Стабильный ID пользователя в вашей системе
`widget_id`	необязательно	Public Widget ID нужного сайта
`name / email / phone`	одно из полей	Данные контакта для Tallker
`company / metadata`	необязательно	Компания и произвольный JSON-контекст

Результат

{"identity_token":"…","expires_in":300,"contact_id":"…"}

Лимиты и идемпотентность

120 requests / minute · HTTP 429 · Retry-After · Idempotency-Key 24h

Безопасность

Токен действует 5 минут и предназначен для однократной передачи в браузер.

Повторный запрос обновляет существующий контакт по external_user_id.

OpenAPI 3.1