Справочник методов

Все методы версии v1. Каждый называет право, которое ему нужно.

Me

GET/v1/meПрава не нужны

Who am I

Key, company and limits. No scope required.

Ответ · 200 · MeDto

curl -X GET "https://api.tygy.ru/v1/me" \
  -H "Authorization: Bearer $TYGY_API_KEY"

Conversations

GET/v1/conversationsПраво: conversations:read

List conversations

Newest activity first. Scope: `conversations:read`.

Параметры

Поле	Тип	Описание
limit	`string` query · необязательный	Page size, 1…100
starting_after	`string` query · необязательный	Cursor from the previous page’s `next_cursor`
status	`string` query · необязательный
assignee_id	`string` query · необязательный	User id of the assigned operator
contact_id	`string` query · необязательный
tag	`string` query · необязательный	Tag id
channel	`string` query · необязательный	Channel the conversation came in on
updated_since	`string` query · необязательный	Only conversations changed at or after this ISO-8601 instant — for polling

Ответ · 200 · ConversationPageDto

curl -X GET "https://api.tygy.ru/v1/conversations" \
  -H "Authorization: Bearer $TYGY_API_KEY"

GET/v1/conversations/{id}Право: conversations:read

Get a conversation

Параметры

Поле	Тип	Описание
id	`string` path · обязательный

Ответ · 200 · ConversationDto

curl -X GET "https://api.tygy.ru/v1/conversations/<id>" \
  -H "Authorization: Bearer $TYGY_API_KEY"

PATCH/v1/conversations/{id}Право: conversations:write

Update a conversation

Status, assignee and team. Goes through the same transitions the inbox uses — audit line, notifications and scenarios fire as for an operator. Scope: `conversations:write`.

Параметры

Поле	Тип	Описание
id	`string` path · обязательный

Тело запроса

Поле	Тип	Описание
status	`string` необязательный	`open` reopens a closed/spam dialog, wakes a snoozed one or unassigns an assigned one; `snoozed` needs `snoozed_until`; to assign, set `assignee_id` instead. `open`, `closed`, `snoozed`, `spam`
assignee_id	`string \| null` необязательный	User id, or null to unassign
team_id	`string \| null` необязательный	Team id, or null to clear
snoozed_until	`string` необязательный	Required with `status: snoozed`

Ответ · 200 · ConversationDto

curl -X PATCH "https://api.tygy.ru/v1/conversations/<id>" \
  -H "Authorization: Bearer $TYGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

GET/v1/conversations/{id}/messagesПраво: conversations:read

List messages of a conversation

Oldest first by default. Internal notes (`type: note`) are returned only to keys holding `notes:write`.

Параметры

Поле	Тип	Описание
id	`string` path · обязательный
limit	`string` query · необязательный	Page size, 1…100
starting_after	`string` query · необязательный	Cursor from the previous page’s `next_cursor`
order	`string` query · необязательный	Oldest first by default

Ответ · 200 · MessagePageDto

curl -X GET "https://api.tygy.ru/v1/conversations/<id>/messages" \
  -H "Authorization: Bearer $TYGY_API_KEY"

POST/v1/conversations/{id}/messagesПраво: messages:send

Send a reply or leave a note

Attributed to the key («API · <name>» in the inbox). `type: reply` needs `messages:send` and is delivered on the conversation’s channel; `type: note` needs `notes:write` and stays internal.

Параметры

Поле	Тип	Описание
id	`string` path · обязательный

Тело запроса

Поле	Тип	Описание
body	`string` обязательный	Plain text; Markdown is rendered where the channel supports it
type	`string` необязательный	`reply` reaches the customer (scope `messages:send`); `note` stays internal (scope `notes:write`) `reply`, `note`

Ответ · 201 · MessageDto

curl -X POST "https://api.tygy.ru/v1/conversations/<id>/messages" \
  -H "Authorization: Bearer $TYGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"body": "…"}'

POST/v1/conversations/{id}/tagsПраво: conversations:write

Add a tag to a conversation

Idempotent.

Параметры

Поле	Тип	Описание
id	`string` path · обязательный

Тело запроса

Поле	Тип	Описание
tag_id	`string` обязательный

Ответ · 200 · ConversationDto

curl -X POST "https://api.tygy.ru/v1/conversations/<id>/tags" \
  -H "Authorization: Bearer $TYGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tag_id": "…"}'

DELETE/v1/conversations/{id}/tags/{tagId}Право: conversations:write

Remove a tag from a conversation

Idempotent.

Параметры

Поле	Тип	Описание
id	`string` path · обязательный
tagId	`string` path · обязательный

Ответ · 200 · ConversationDto

curl -X DELETE "https://api.tygy.ru/v1/conversations/<id>/tags/<tagId>" \
  -H "Authorization: Bearer $TYGY_API_KEY"

Contacts

GET/v1/contactsПраво: contacts:read

List contacts

Most recently updated first. Scope: `contacts:read`.

Параметры

Поле	Тип	Описание
limit	`string` query · необязательный	Page size, 1…100
starting_after	`string` query · необязательный	Cursor from the previous page’s `next_cursor`
q	`string` query · необязательный	Case-insensitive substring of the name
email	`string` query · необязательный	Exact e-mail (any identifier)
phone	`string` query · необязательный	Exact phone (any identifier)
organization_id	`string` query · необязательный
updated_since	`string` query · необязательный

Ответ · 200 · ContactPageDto

curl -X GET "https://api.tygy.ru/v1/contacts" \
  -H "Authorization: Bearer $TYGY_API_KEY"

POST/v1/contactsПраво: contacts:write

Create a contact

An e-mail / phone / Telegram username already known in the project answers 409 with the existing id — the same address never creates a second person. Scope: `contacts:write`.

Тело запроса

Поле	Тип	Описание
name	`string` обязательный
email	`string` необязательный
phone	`string` необязательный	E.164 preferred; national formats are normalised
telegram_username	`string` необязательный
organization_id	`string` необязательный	Client organization to link the contact to

Ответ · 201 · ContactDto

curl -X POST "https://api.tygy.ru/v1/contacts" \
  -H "Authorization: Bearer $TYGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "…"}'

GET/v1/contacts/{id}Право: contacts:read

Get a contact

Параметры

Поле	Тип	Описание
id	`string` path · обязательный

Ответ · 200 · ContactDto

curl -X GET "https://api.tygy.ru/v1/contacts/<id>" \
  -H "Authorization: Bearer $TYGY_API_KEY"

PATCH/v1/contacts/{id}Право: contacts:write

Update a contact

Absent fields stay; null clears.

Параметры

Поле	Тип	Описание
id	`string` path · обязательный

Тело запроса

Поле	Тип	Описание
name	`string \| null` необязательный
email	`string \| null` необязательный	Replaces the primary e-mail; null removes it
phone	`string \| null` необязательный
telegram_username	`string \| null` необязательный
organization_id	`string \| null` необязательный	null unlinks

Ответ · 200 · ContactDto

curl -X PATCH "https://api.tygy.ru/v1/contacts/<id>" \
  -H "Authorization: Bearer $TYGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

POST/v1/contacts/{id}/identifiersПраво: contacts:write

Add an e-mail / phone / Telegram username to a contact

Параметры

Поле	Тип	Описание
id	`string` path · обязательный

Тело запроса

Поле	Тип	Описание
type	`string` обязательный	`email`, `phone`, `telegram`
value	`string` обязательный

Ответ · 200 · ContactDto

curl -X POST "https://api.tygy.ru/v1/contacts/<id>/identifiers" \
  -H "Authorization: Bearer $TYGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type": "email", "value": "…"}'

DELETE/v1/contacts/{id}/identifiers/{identifierId}Право: contacts:write

Remove an identifier from a contact

Параметры

Поле	Тип	Описание
id	`string` path · обязательный
identifierId	`string` path · обязательный

Ответ · 200 · ContactDto

curl -X DELETE "https://api.tygy.ru/v1/contacts/<id>/identifiers/<identifierId>" \
  -H "Authorization: Bearer $TYGY_API_KEY"

POST/v1/contacts/{id}/tagsПраво: contacts:write

Add a tag to a contact

Idempotent.

Параметры

Поле	Тип	Описание
id	`string` path · обязательный

Тело запроса

Поле	Тип	Описание
tag_id	`string` обязательный

Ответ · 200 · ContactDto

curl -X POST "https://api.tygy.ru/v1/contacts/<id>/tags" \
  -H "Authorization: Bearer $TYGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tag_id": "…"}'

DELETE/v1/contacts/{id}/tags/{tagId}Право: contacts:write

Remove a tag from a contact

Idempotent.

Параметры

Поле	Тип	Описание
id	`string` path · обязательный
tagId	`string` path · обязательный

Ответ · 200 · ContactDto

curl -X DELETE "https://api.tygy.ru/v1/contacts/<id>/tags/<tagId>" \
  -H "Authorization: Bearer $TYGY_API_KEY"

Organizations

GET/v1/organizationsПраво: contacts:read

List client organizations

The B2B accounts contacts work for. Scope: `contacts:read`.

Параметры

Поле	Тип	Описание
limit	`string` query · необязательный	Page size, 1…100
starting_after	`string` query · необязательный	Cursor from the previous page’s `next_cursor`
q	`string` query · необязательный	Case-insensitive substring of the name
updated_since	`string` query · необязательный

Ответ · 200 · OrganizationPageDto

curl -X GET "https://api.tygy.ru/v1/organizations" \
  -H "Authorization: Bearer $TYGY_API_KEY"

POST/v1/organizationsПраво: contacts:write

Create a client organization

Scope: `contacts:write`.

Тело запроса

Поле	Тип	Описание
name	`string` обязательный
email	`string` необязательный
phone	`string` необязательный
website	`string` необязательный

Ответ · 201 · OrganizationDto

curl -X POST "https://api.tygy.ru/v1/organizations" \
  -H "Authorization: Bearer $TYGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "…"}'

GET/v1/organizations/{id}Право: contacts:read

Get a client organization

Параметры

Поле	Тип	Описание
id	`string` path · обязательный

Ответ · 200 · OrganizationDto

curl -X GET "https://api.tygy.ru/v1/organizations/<id>" \
  -H "Authorization: Bearer $TYGY_API_KEY"

PATCH/v1/organizations/{id}Право: contacts:write

Rename a client organization

Параметры

Поле	Тип	Описание
id	`string` path · обязательный

Тело запроса

Поле	Тип	Описание
name	`string` необязательный

Ответ · 200 · OrganizationDto

curl -X PATCH "https://api.tygy.ru/v1/organizations/<id>" \
  -H "Authorization: Bearer $TYGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

POST/v1/organizations/{id}/tagsПраво: contacts:write

Add a tag to a client organization

Idempotent.

Параметры

Поле	Тип	Описание
id	`string` path · обязательный

Тело запроса

Поле	Тип	Описание
tag_id	`string` обязательный

Ответ · 200 · OrganizationDto

curl -X POST "https://api.tygy.ru/v1/organizations/<id>/tags" \
  -H "Authorization: Bearer $TYGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tag_id": "…"}'

DELETE/v1/organizations/{id}/tags/{tagId}Право: contacts:write

Remove a tag from a client organization

Idempotent.

Параметры

Поле	Тип	Описание
id	`string` path · обязательный
tagId	`string` path · обязательный

Ответ · 200 · OrganizationDto

curl -X DELETE "https://api.tygy.ru/v1/organizations/<id>/tags/<tagId>" \
  -H "Authorization: Bearer $TYGY_API_KEY"

Поле	Тип	Описание
scope	`string` query · необязательный

Team

GET/v1/usersПраво: team:read

List users (operators)

Active members only. Scope: `team:read`.

Ответ · 200 · UserListDto

curl -X GET "https://api.tygy.ru/v1/users" \
  -H "Authorization: Bearer $TYGY_API_KEY"

GET/v1/teamsПраво: team:read

List teams

Scope: `team:read`.

Ответ · 200 · TeamListDto

curl -X GET "https://api.tygy.ru/v1/teams" \
  -H "Authorization: Bearer $TYGY_API_KEY"

Help center

GET/v1/kb/handbooksПраво: kb:read

List handbooks

Active help centers of the project. Scope: `kb:read`.

Ответ · 200 · HandbookListDto

curl -X GET "https://api.tygy.ru/v1/kb/handbooks" \
  -H "Authorization: Bearer $TYGY_API_KEY"

GET/v1/kb/handbooks/{id}/categoriesПраво: kb:read

List categories of a handbook

Параметры

Поле	Тип	Описание
id	`string` path · обязательный

Ответ · 200 · CategoryListDto

curl -X GET "https://api.tygy.ru/v1/kb/handbooks/<id>/categories" \
  -H "Authorization: Bearer $TYGY_API_KEY"

GET/v1/kb/articlesПраво: kb:read

List published articles

Titles only; fetch one article for its body.

Параметры

Поле	Тип	Описание
limit	`string` query · необязательный	Page size, 1…100
starting_after	`string` query · необязательный	Cursor from the previous page’s `next_cursor`
q	`string` query · необязательный	Search words. Matches the article title and its short description, case-insensitively. The body is not searched — ask for the article to read it.
handbook_id	`string` query · необязательный	Restrict to one handbook
category_id	`string` query · необязательный	Restrict to one category
updated_since	`string` query · необязательный

Ответ · 200 · ArticlePageDto

curl -X GET "https://api.tygy.ru/v1/kb/articles" \
  -H "Authorization: Bearer $TYGY_API_KEY"

POST/v1/kb/articlesПраво: kb:write

Create an article

The body is Markdown. Creates a DRAFT unless `status` says otherwise — a sync that goes wrong should not publish. Publishing is also what re-indexes the article for the AI operator. Scope: `kb:write`.

Тело запроса

Поле	Тип	Описание
handbook_id	`string` обязательный	Which handbook the article belongs to
title	`string` обязательный	Title of the article in this locale
markdown	`string` обязательный	The body, as Markdown. Headings, paragraphs, lists and tables are understood; the same reader the file import uses converts it, so the result is identical to a typed article.
locale	`string` необязательный	Defaults to the handbook's own locale
category_id	`string \| null` необязательный
slug	`string` необязательный	Derived from the title when omitted
status	`string` необязательный	Defaults to `draft`. Publishing is what re-indexes it for the AI operator. `draft`, `published`, `archived`

Ответ · 201 · ArticleDto

curl -X POST "https://api.tygy.ru/v1/kb/articles" \
  -H "Authorization: Bearer $TYGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"handbook_id": "…", "title": "…", "markdown": "…"}'

GET/v1/kb/articles/{id}Право: kb:read

Get a published article with its body

Параметры

Поле	Тип	Описание
id	`string` path · обязательный
locale	`string` query · необязательный	Return only this locale’s body (all locales by default)

Ответ · 200 · ArticleDto

curl -X GET "https://api.tygy.ru/v1/kb/articles/<id>" \
  -H "Authorization: Bearer $TYGY_API_KEY"

PATCH/v1/kb/articles/{id}Право: kb:write

Update an article

Every field is optional. Sending `markdown` replaces the body for that locale and requires `title` alongside it, because a translation carries both. Scope: `kb:write`.

Параметры

Поле	Тип	Описание
id	`string` path · обязательный

Тело запроса

Поле	Тип	Описание
title	`string` необязательный
markdown	`string` необязательный	Requires `title` alongside it
locale	`string` необязательный
category_id	`string \| null` необязательный
slug	`string` необязательный
status	`string` необязательный	`draft`, `published`, `archived`

Ответ · 200 · ArticleDto

curl -X PATCH "https://api.tygy.ru/v1/kb/articles/<id>" \
  -H "Authorization: Bearer $TYGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

POST/v1/kb/categoriesПраво: kb:write

Create a category

Scope: `kb:write`.

Тело запроса

Поле	Тип	Описание
handbook_id	`string` обязательный
slug	`string` обязательный
translations	`CategoryTranslationInputDto[]` обязательный
parent_id	`string \| null` необязательный	Nest under another category

Ответ · 201 · CategoryDto

curl -X POST "https://api.tygy.ru/v1/kb/categories" \
  -H "Authorization: Bearer $TYGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"handbook_id": "…", "slug": "…", "translations": "…"}'

PATCH/v1/kb/categories/{id}Право: kb:write

Update a category

Scope: `kb:write`.

Параметры

Поле	Тип	Описание
id	`string` path · обязательный

Тело запроса

Поле	Тип	Описание
slug	`string` необязательный
parent_id	`string \| null` необязательный
translations	`CategoryTranslationInputDto[]` необязательный

Ответ · 200 · CategoryDto

curl -X PATCH "https://api.tygy.ru/v1/kb/categories/<id>" \
  -H "Authorization: Bearer $TYGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Analytics

GET/v1/analytics/overviewПраво: analytics:read

Overview

Headline numbers, the daily series and when the load actually lands. Scope: `analytics:read`.

Параметры

Поле	Тип	Описание
from	`string` query · необязательный	ISO-8601 start. Default: 30 days back.
to	`string` query · необязательный	ISO-8601 end. Default: now. The period must not exceed 366 days.
channel	`string` query · необязательный	Narrow to channels. Comma-separated, or repeat the parameter.
team	`string` query · необязательный	Team ids, comma-separated or repeated.
operator	`string` query · необязательный	User ids, comma-separated or repeated.

Ответ · 200 · OverviewReportDto

curl -X GET "https://api.tygy.ru/v1/analytics/overview" \
  -H "Authorization: Bearer $TYGY_API_KEY"

GET/v1/analytics/channelsПраво: analytics:read

By channel

Volume, share, resolved share and resolution speed per channel. Scope: `analytics:read`.

Параметры

Поле	Тип	Описание
from	`string` query · необязательный	ISO-8601 start. Default: 30 days back.
to	`string` query · необязательный	ISO-8601 end. Default: now. The period must not exceed 366 days.
channel	`string` query · необязательный	Narrow to channels. Comma-separated, or repeat the parameter.
team	`string` query · необязательный	Team ids, comma-separated or repeated.
operator	`string` query · необязательный	User ids, comma-separated or repeated.

Ответ · 200 · ChannelsReportDto

curl -X GET "https://api.tygy.ru/v1/analytics/channels" \
  -H "Authorization: Bearer $TYGY_API_KEY"

GET/v1/analytics/teamsПраво: analytics:read

By team

The same numbers per team, plus the team × channel breakdown. Scope: `analytics:read`.

Параметры

Поле	Тип	Описание
from	`string` query · необязательный	ISO-8601 start. Default: 30 days back.
to	`string` query · необязательный	ISO-8601 end. Default: now. The period must not exceed 366 days.
channel	`string` query · необязательный	Narrow to channels. Comma-separated, or repeat the parameter.
team	`string` query · необязательный	Team ids, comma-separated or repeated.
operator	`string` query · необязательный	User ids, comma-separated or repeated.

Ответ · 200 · TeamsReportDto

curl -X GET "https://api.tygy.ru/v1/analytics/teams" \
  -H "Authorization: Bearer $TYGY_API_KEY"

GET/v1/analytics/operatorsПраво: analytics:read

By operator

Taken, closed and replies per operator. Scope: `analytics:read`.

Параметры

Поле	Тип	Описание
from	`string` query · необязательный	ISO-8601 start. Default: 30 days back.
to	`string` query · необязательный	ISO-8601 end. Default: now. The period must not exceed 366 days.
channel	`string` query · необязательный	Narrow to channels. Comma-separated, or repeat the parameter.
team	`string` query · необязательный	Team ids, comma-separated or repeated.
operator	`string` query · необязательный	User ids, comma-separated or repeated.

Ответ · 200 · OperatorsReportDto

curl -X GET "https://api.tygy.ru/v1/analytics/operators" \
  -H "Authorization: Bearer $TYGY_API_KEY"

GET/v1/analytics/revenueПраво: analytics:read

Revenue

Won revenue, conversion and the split by channel and operator. Scope: `analytics:read`.

Параметры

Поле	Тип	Описание
recognition	`string` query · необязательный	Which date the money counts on. Default: `won`.
from	`string` query · необязательный	ISO-8601 start. Default: 30 days back.
to	`string` query · необязательный	ISO-8601 end. Default: now. The period must not exceed 366 days.
channel	`string` query · необязательный	Narrow to channels. Comma-separated, or repeat the parameter.
team	`string` query · необязательный	Team ids, comma-separated or repeated.
operator	`string` query · необязательный	User ids, comma-separated or repeated.

Ответ · 200 · RevenueReportDto

curl -X GET "https://api.tygy.ru/v1/analytics/revenue" \
  -H "Authorization: Bearer $TYGY_API_KEY"

GET/v1/analytics/qualityПраво: analytics:read

Dialog quality

AI evaluation of dialogs: average, distribution and the weekly trend. Scope: `analytics:read`.

Параметры

Поле	Тип	Описание
from	`string` query · необязательный	ISO-8601 start. Default: 30 days back.
to	`string` query · необязательный	ISO-8601 end. Default: now. The period must not exceed 366 days.
channel	`string` query · необязательный	Narrow to channels. Comma-separated, or repeat the parameter.
team	`string` query · необязательный	Team ids, comma-separated or repeated.
operator	`string` query · необязательный	User ids, comma-separated or repeated.

Ответ · 200 · QualityReportDto

curl -X GET "https://api.tygy.ru/v1/analytics/quality" \
  -H "Authorization: Bearer $TYGY_API_KEY"

GET/v1/analytics/botПраво: analytics:read

AI operator

How often the agent was used, and how those dialogs ended. Scope: `analytics:read`.

Параметры

Поле	Тип	Описание
from	`string` query · необязательный	ISO-8601 start. Default: 30 days back.
to	`string` query · необязательный	ISO-8601 end. Default: now. The period must not exceed 366 days.
channel	`string` query · необязательный	Narrow to channels. Comma-separated, or repeat the parameter.
team	`string` query · необязательный	Team ids, comma-separated or repeated.
operator	`string` query · необязательный	User ids, comma-separated or repeated.

Ответ · 200 · BotReportDto

curl -X GET "https://api.tygy.ru/v1/analytics/bot" \
  -H "Authorization: Bearer $TYGY_API_KEY"

GET/v1/analytics/filtersПраво: analytics:read

Filter values

The channels, teams and operators that actually appear in this project — so a caller filters by real values instead of guessing. Scope: `analytics:read`.

Ответ · 200 · AnalyticsFiltersDto

curl -X GET "https://api.tygy.ru/v1/analytics/filters" \
  -H "Authorization: Bearer $TYGY_API_KEY"

Meetings

GET/v1/meetingsПраво: conferences:read

List meetings

Newest first. Scope: `conferences:read`.

Параметры

Поле	Тип	Описание
limit	`string` query · необязательный	Page size, 1…100
starting_after	`string` query · необязательный	Cursor from the previous page’s `next_cursor`

Ответ · 200 · MeetingPageDto

curl -X GET "https://api.tygy.ru/v1/meetings" \
  -H "Authorization: Bearer $TYGY_API_KEY"

GET/v1/meetings/{id}Право: conferences:read

Get a meeting with its summary and transcript

The summary and the transcript are present once the meeting reaches `ready`; before that they are null. Scope: `conferences:read`.

Параметры

Поле	Тип	Описание
id	`string` path · обязательный

Ответ · 200 · MeetingDetailDto

curl -X GET "https://api.tygy.ru/v1/meetings/<id>" \
  -H "Authorization: Bearer $TYGY_API_KEY"

Webhooks

GET/v1/webhooksПраво: webhooks:manage

List webhook subscriptions

Scope: `webhooks:manage`.

Ответ · 200 · WebhookListDto

curl -X GET "https://api.tygy.ru/v1/webhooks" \
  -H "Authorization: Bearer $TYGY_API_KEY"

POST/v1/webhooksПраво: webhooks:manage

Create a webhook subscription

The signing secret is returned once, here. Verify a delivery as `HMAC-SHA256("<X-Webhook-Timestamp>.<raw body>", secret)` against `X-Webhook-Signature`.

Тело запроса

Поле	Тип	Описание
name	`string` обязательный	How the subscription is labelled in the settings list
url	`string` обязательный	https:// endpoint (http:// allowed for localhost only)
events	`string[]` обязательный

Ответ · 201 · WebhookWithSecretDto

curl -X POST "https://api.tygy.ru/v1/webhooks" \
  -H "Authorization: Bearer $TYGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "…", "url": "…", "events": ["…"]}'

GET/v1/webhooks/{id}Право: webhooks:manage

Get a webhook subscription

Параметры

Поле	Тип	Описание
id	`string` path · обязательный

Ответ · 200 · WebhookDto

curl -X GET "https://api.tygy.ru/v1/webhooks/<id>" \
  -H "Authorization: Bearer $TYGY_API_KEY"

PATCH/v1/webhooks/{id}Право: webhooks:manage

Update a webhook subscription

Параметры

Поле	Тип	Описание
id	`string` path · обязательный

Тело запроса

Поле	Тип	Описание
name	`string` необязательный
url	`string` необязательный
events	`string[]` необязательный
active	`boolean` необязательный	false pauses deliveries; true clears a pause

Ответ · 200 · WebhookDto

curl -X PATCH "https://api.tygy.ru/v1/webhooks/<id>" \
  -H "Authorization: Bearer $TYGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE/v1/webhooks/{id}Право: webhooks:manage

Delete a webhook subscription

Параметры

Поле	Тип	Описание
id	`string` path · обязательный

Ответ · 204

curl -X DELETE "https://api.tygy.ru/v1/webhooks/<id>" \
  -H "Authorization: Bearer $TYGY_API_KEY"

POST/v1/webhooks/{id}/rotate-secretПраво: webhooks:manage

Rotate the signing secret

The new secret is returned once. Deliveries in flight are signed with the new one.

Параметры

Поле	Тип	Описание
id	`string` path · обязательный

Ответ · 200 · WebhookWithSecretDto

curl -X POST "https://api.tygy.ru/v1/webhooks/<id>/rotate-secret" \
  -H "Authorization: Bearer $TYGY_API_KEY"

POST/v1/webhooks/{id}/testПраво: webhooks:manage

Send a test event

Queues a `webhook.test` delivery with a sample body; watch it in the log. The delivery is asynchronous, so the answer is `202` — it says the event was queued, not that the endpoint replied.

Параметры

Поле	Тип	Описание
id	`string` path · обязательный

Ответ · 202 · WebhookTestResultDto

curl -X POST "https://api.tygy.ru/v1/webhooks/<id>/test" \
  -H "Authorization: Bearer $TYGY_API_KEY"

GET/v1/webhooks/{id}/deliveriesПраво: webhooks:manage

Delivery log of a subscription

Newest first, kept for 7 days.

Параметры

Поле	Тип	Описание
id	`string` path · обязательный
limit	`string` query · обязательный

Ответ · 200 · WebhookDeliveryListDto

curl -X GET "https://api.tygy.ru/v1/webhooks/<id>/deliveries" \
  -H "Authorization: Bearer $TYGY_API_KEY"

Справочник методов

Me

Who am I

Conversations

List conversations

Get a conversation

Update a conversation

List messages of a conversation

Send a reply or leave a note

Add a tag to a conversation

Remove a tag from a conversation

Contacts

List contacts

Create a contact

Get a contact

Update a contact

Add an e-mail / phone / Telegram username to a contact

Remove an identifier from a contact

Add a tag to a contact

Remove a tag from a contact

Organizations

List client organizations

Create a client organization

Get a client organization

Rename a client organization

Add a tag to a client organization

Remove a tag from a client organization

Tags

List tags

Team

List users (operators)

List teams

Help center

List handbooks

List categories of a handbook

List published articles

Create an article

Get a published article with its body

Update an article

Create a category

Update a category

Analytics

Overview

By channel

By team

By operator

Revenue

Dialog quality

AI operator

Filter values

Meetings

List meetings

Get a meeting with its summary and transcript

Webhooks

List webhook subscriptions

Create a webhook subscription

Get a webhook subscription

Update a webhook subscription

Delete a webhook subscription

Rotate the signing secret

Send a test event

Delivery log of a subscription