support

POST `/v1/tickets/deflect`

Knowledge-base articles and a live diagnosis, before a ticket is opened.

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

API кілтін bearer токені ретінде жіберіңіз. Кілтте tickets.reply рұқсаты болуы тиіс; онсыз кілтке 404 емес, 403 қатесі қайтарылады.

Ұйымыңыздың идентификаторы орналасатын жер

Бұл соңғы нүкте JSON корпусында өріс ретінде org_id қабылдайды.

Сіздің ұйым идентификаторыңыз басқару панеліндегі API кілттері экранында, кілттің өзінің жанында орналасқан. Бұл сіз жасайтын әрбір шақырудағы бірдей идентификатор.

Әрекет етіп көру

Бұрыштық жақшалардағы кез келген нәрсені өз мәндеріңізбен, ал кілт орналастырушысын басқару тақтасынан алынған кілтпен алмастырыңыз.

curl -X POST https://api.zinndigital.com/v1/tickets/deflect \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{  }'

Жүйеге кіргенсіз бе? Бақылау тақтасындағы API консолі ұйымыңыздың нақты идентификаторы мен жеке кілтіңізді автоматты түрде толтырады да, нақты жауапты көре алуыңыз үшін сұрауды тікелей жұмыс істеп тұрған API арқылы орындайды. Бұл соңғы нүктені API консолінде ашыңыз

Мәліметтер

The KB + AI in front of the ticket form (#2661). Given what the customer has typed so far, returns matching published KB articles and — when a site is named — findings from live checks against it, including whether its nameservers still point at us. ⛔ This never refuses to open a ticket and must never be made to. Everything it returns is offered; the form's submit button is unaffected. Requires `tickets.reply`. ⛔ `checks_incomplete` is `true` when a check could not run. "We found nothing wrong" and "we could not look" are different answers and the client must render them differently.

Сұрау денесі

Аты	Tүрі	Міндетті	Мазмұны
`subject`	`string`	Жоқ	—
`body`	`string`	Жоқ	—
`site_id`	`object`	Жоқ	The site they are asking about. When given, live checks run against it — including whether its nameservers still point at us.
`org_id`	`object`	Жоқ	—

Жауап

Аты	Tүрі	Міндетті	Мазмұны
`articles`	`object[]`	Иә	—
`findings`	`TicketDeflectionFinding[]`	Иә	—
`applied`	`string[]`	Иә	Remedies applied automatically. ⛔ Only remedies on an explicit, audited allow-list are ever applied without a human.
`checks_incomplete`	`boolean`	Иә	⛔ True when a live check could not run. "We found nothing wrong" and "we could not look" are different answers and must render differently.
`incidents`	`TicketDeflectionIncident[]`	Иә	Open public incidents affecting this customer. ⛔ NOTHING HERE BLOCKS THE FORM — owner ruling 2026-08-24 was warn prominently, still let them submit. A customer with a genuinel…
`status_url`	`string`	Иә	The public status page in the reader's language, for the "follow this to resolution" link. ⛔ A separate origin with no shared fate with the platform (docs/121 §1), so it cannot…

Бұл соңғы нүкте қайтара алатын қателер

401 · 403 · 422 · 429