Tallker API v1

Identidade segura

Identidade segura. Ligue sistemas de servidor, envie contactos e pedidos e identifique com segurança os utilizadores do widget.

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

How it works

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

Exemplos

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"}'

Parameters and requirements

external_user_idобязательноСтабильный ID пользователя в вашей системе

widget_idнеобязательноPublic Widget ID нужного сайта

name / email / phoneодно из полейДанные контакта для Tallker

company / metadataнеобязательноКомпания и произвольный JSON-контекст

Result

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

Limites e idempotência

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

Segurança

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

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

OpenAPI 3.1