SDK

Sapportly TypeScript SDK (@sapportly/sdk) — эталонный клиент публичного API Sapportly. Для остальных языков — генерация из OpenAPI.

Исходники: sdks/typescript. Поведение сверх OpenAPI (ретраи, идемпотентность, пагинация, подпись вебхука, wire v2) — sdks/SPEC.md. Панель оператора в SDK нет. Гайд приёма и отправки сообщений: Входящие и живой канал.

Поддерживаемый SDK

Язык	Пакет	Установка	Registry
TypeScript	`@sapportly/sdk`	`npm install @sapportly/sdk`	npm

Другой язык

Остальные клиенты (Python (historical), Go (historical), Rust (historical), C# (historical), PHP (historical), Kotlin (historical), Java (historical), Swift (historical)) в архиве. Актуальный путь — OpenAPI:

openapi-generatorbash

npx @openapitools/openapi-generator-cli generate \
  -i https://docs.sapportly.pro/openapi.json \
  -g python \
  -o ./supportly-client

Спека: openapi.json. Что клиент обязан делать — sdks/SPEC.md.

Виджет в браузере

Отдельный пакет @sapportly/widget-sdk. В браузере — Site ID (wgt_…), не API-ключ. Имя на npm — org sapportly, не @supportly/widget-sdk. SDK включает React/Next/Vue/Svelte-обёртки, а все пользовательские секреты остаются на сервере.

npm install @sapportly/widget-sdk

pnpm add @sapportly/widget-sdk

yarn add @sapportly/widget-sdk

App.tsxTSX

import { SapportlyWidget } from "@sapportly/widget-sdk/react";

<SapportlyWidget siteId="wgt_..." />

Гайд по виджету

Страница полезна?