Chat widget
Hemû dawînên ku widgetê sohbetê li malperên xerîdar bi kar tîne.
Ev kom hemû endpoint-ên giştî yên ku Chat-Widget-a tevlihevkirî li ser malperên xerîdaran bikar tîne, kom dike: kontrola gihîştinê (`GET /api/public/widget/health`), anîna veavakirina giştî ya widget-ê (`GET /api/public/widget/config/:widget_code`) û herwiha şandin û dîroka peyaman (`POST /api/public/widget/message`, `GET /api/public/widget/history`). Vekirina domainê di dema afirandina widget-ê de ji hêla Zentor ve tê temîn kirin; ji bo vê yekê di Panela Tenantê de tu rûerûya mîhengê tune ye. Di rewşa jêderek nevekirî de dibe ku koda çewtiyê `WIDGET_ORIGIN_DENIED` derkeve. Afirandina widget-ê bi xwe tenê ji bo Master-Admin hatiye veqetandin, lê tenant koda tevlihevkirinê ya amade werdigire.
Pergaleke gişti ya API-Key-a pêşdebiran tune ye. `health` û `config` bêyî erêkirin gihîştî ne, ji ber ku ew ji bo destpêkirina widget-ê di gerokê de hatine destnîşankirin. `message` û `history` li aliyekî din serê `X-Widget-Token` hewce dikin û zêde li gorî lîsteya jêderên rêpêdayî ya serverê tên kontrolkirin. Embed-Token di dema afirandina widget-ê de carekê wek nivîsa vekirî tê nîşandan û divê ne di depoyên giştî, wêneyên piştgiriyê, an tomarên gerokê de xuya bibe.
Her rûpela hûrgiliyan a vê komê metod, rê, erêkirin, îdempotency û kodên çewtiyê yên belgekirî yên endpoint-a têkildar bi awayekî cuda vedibêje. Bangkirineke serkeftî ya endpoint-ekê bi xweber îspat nake ku endpoint-eke din a heman komê jî wê bi serkeftî biqede — bi taybetî kontrolek `health` a kesk ne widget-eke derbasdar, ne jî jêderek vekirî an gihîştîbariya peydakerê KI piştrast dike.
Sînorê API-yê yê piştrastkirî yê seranserê platformê 2.000 daxwaz di 15 xulekan de ye. Sînorek cihê ji bo endpoint-eke widget-ê ya taybet tenê dema ku ji bo wê endpoint-ê bi eşkere hatiye piştrastkirin tê behskirin. `message` ne îdempotent e; klientek ne divê şandineke bi awayekî nediyar hatiye betalkirin bi xweber dubare bike, bêyî ku pêşî kontrol bike gelo peyama yekem berê hatiye pêvajokirin an na.
Kontrola teknîkî ya vê komê xwe li ser Registry-ya di bin `app/frontend/src/content/api-reference/groups/widget.ts` de û rêyên backend-ê yên têkildar bingeh dike. Her rûpela hûrgiliyan destnîşan dike gelo rêyeke serkeftî bi zindî, rêyeke neyînî, an tenê analojiyeke kodê hatiye kontrolkirin — ev cudahî ji bo tevahiya komê derbasdar e û nabe ku bi gotinên serkeftinê yên giştî were guhertin.