Skip to main content
Ачкычлар белән Chattler кушымтасында, агентның Интеграцияләр битендәге API аша керү карточкасында идарә ителә. Бер API чакыруы да ачкыч ясамый.

​
Ачкыч ясау

1

Агентны ачыгыз

Кушымтада тышка чыгарасы агентны ачыгыз һәм аның Интеграцияләр битенә керегез.
2

API аша керү карточкасында ачкыч өстәгез

Ачкычка исем бирегез һәм рөхсәтен сайлагыз:
  • read-only: диалоглар исемлеге һәм хәбәрләрне уку.
  • full: өстәге барысы, өстәвенә чат эндпоинтлары.
3

Ачкычны хәзер үк күчереп алыгыз

Чын ачкыч ясалганнан соң бер генә тапкыр күрсәтелә. Ул менә болай күренә:
Аутентификацияне сер өлеше генә үти. key_id өлеше ачык һәм дашбордта һәр җирдә ачкычның идентификаторы булып тора. Серне югалтсагыз, ачкычны яңартыгыз.

​
Ачкычны яңарту

Яңарту яңа сер бирә һәм искесен шунда ук гамәлдән чыгара. Ачкычның идентификаторы, аның диалоглары һәм статистикасы шул ук ачкычта кала, шуңа күрә сер ачылган дип шикләнгәндә яңарту — дөрес адым: башка бернәрсә дә үзгәрми.

​
Ачкычны юю

Ачкычны юю аны бетерә. Шул мизгелдән аның белән һәр сорау 401 invalid_api_key хатасы белән туктый, һәм бу беркайчан булмаган ачкычтан аерылмый. Аның диалоглары һәм сораулар тарихы дашбордта укырлык булып кала. Ююны кире кайтарып булмый; аның урынына яңа ачкыч ясагыз.
Ачкычны беркайчан да браузер бандлына, мобиль кушымтага яки сез контрольдә тотмаган башка клиентка салмагыз. Ачкыч — хуҗаның балансын тотучы озак гамәлдәге хуҗа таныклыгы. API-га үз бэкендыгыздан мөрәҗәгать итегез һәм ачкыч ачылган дип шикләнгән мизгелдә үк аны яңартыгыз.

​
Ачкыч белән аутентификация

Bearer схемалы Authorization башламы гына кабул ителә. Сорау юлындагы (query-string) таныклыклар санга сугылмый, дашборд токены да, Browser-ID башламы да катнашмый.
Ачкыч бер агентка бәйләнгән. Аны башка {agent_id} белән куллану 403 agent_mismatch кайтара.

​
Статистика

Куллану API аша керү карточкасында күрсәтелми. Агентның Статистика битен ачыгыз һәм Интеграция фильтрында ачкычны сайлагыз; анда һәр ачкыч аерым интеграция буларак күрсәтелә. Бит һәр ачкыч һәм һәр UTC көне буенча сораулар санын, уңышлы һәм хаталы сорауларны, хаталар өлешен, уртача һәм p95 кичегүне, уникаль кулланучыларны, актив диалогларны, токеннарны һәм алынган сумманы, өстәвенә эндпоинтлар, HTTP-статуслар һәм хата кодлары буенча бүленешне күрсәтә. Провайдер бәясе беркайчан да күрсәтелми; күрсәтелгән сумма — баланстан алынган сумма.