support

POST `/v1/tickets/deflect`

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

Uwierzytelnianie

Wyślij klucz API jako token bearer. Klucz musi posiadać uprawnienie tickets.reply; klucz bez niego jest odrzucany z kodem 403, a nie 404.

Miejsce na identyfikator organizacji

Ten punkt końcowy przyjmuje org_id jako pole w treści JSON.

Identyfikator Twojej organizacji znajduje się na ekranie kluczy API w Twoim panelu, obok samego klucza. Jest to ten sam identyfikator w każdym wywołaniu, które wykonujesz.

Wypróbuj

Zastąp wszystko w nawiasach ostrych własnymi wartościami, a zastępczy znacznik klucza kluczem ze swojego pulpitu nawigacyjnego.

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

Zalogowany? Konsola API w Twoim panelu uzupełnia rzeczywiste identyfikator organizacji oraz Twój własny klucz i wykonuje żądanie względem aktywnego API, dzięki czemu możesz zobaczyć rzeczywistą odpowiedź. Otwórz ten punkt końcowy w konsoli API

Szczegóły

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.

Treść żądania

Nazwa	Typ	Wymagane	Co to jest
`subject`	`string`	Nie	—
`body`	`string`	Nie	—
`site_id`	`object`	Nie	The site they are asking about. When given, live checks run against it — including whether its nameservers still point at us.
`org_id`	`object`	Nie	—

Odpowiedź

Nazwa	Typ	Wymagane	Co to jest
`articles`	`object[]`	Tak	—
`findings`	`TicketDeflectionFinding[]`	Tak	—
`applied`	`string[]`	Tak	Remedies applied automatically. ⛔ Only remedies on an explicit, audited allow-list are ever applied without a human.
`checks_incomplete`	`boolean`	Tak	⛔ 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[]`	Tak	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`	Tak	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…

Błędy, które ten punkt końcowy może zwrócić

401 · 403 · 422 · 429