support

POST `/v1/tickets/deflect`

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

Autenticazione

Invia una chiave API come token di tipo bearer. La chiave deve disporre dell'autorizzazione tickets.reply; una chiave sprovvista di tale autorizzazione viene rifiutata con 403 anziché 404.

L'ID della tua organizzazione va qui

Questo endpoint accetta org_id come campo nel corpo JSON.

L'identificativo della tua organizzazione si trova nella schermata delle chiavi API nella tua dashboard, accanto alla chiave stessa. È lo stesso identificativo in ogni chiamata che effettui.

Provalo

Sostituisci qualsiasi elemento tra parentesi angolari con i tuoi valori e il segnaposto key con una chiave dalla tua dashboard.

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

Hai effettuato l'accesso? La console API nella tua dashboard inserisce il tuo ID organizzazione reale e la tua chiave personale, ed esegue la richiesta sull'API live in modo da poter vedere la risposta effettiva. Apri questo endpoint nella console API

Dettagli

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.

Corpo della richiesta

Nome	Tipo	Obbligatorio	Che cos'è
`subject`	`string`	No	—
`body`	`string`	No	—
`site_id`	`object`	No	The site they are asking about. When given, live checks run against it — including whether its nameservers still point at us.
`org_id`	`object`	No	—

Risposta

Nome	Tipo	Obbligatorio	Che cos'è
`articles`	`object[]`	Sì	—
`findings`	`TicketDeflectionFinding[]`	Sì	—
`applied`	`string[]`	Sì	Remedies applied automatically. ⛔ Only remedies on an explicit, audited allow-list are ever applied without a human.
`checks_incomplete`	`boolean`	Sì	⛔ 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[]`	Sì	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`	Sì	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…

Errori che questo endpoint può restituire

401 · 403 · 422 · 429