Help Center SMSBAT ChatHub API

SMSBAT ChatHub API

Bainistíonn ChatHub REST API comhráite gnó Viber, comhráite cliant, agus sreafaí oibre uathoibrithe tacaíochta custaiméara.

Bun-URL

CÓD_BLOCK_0_

Doiciméadúchán Swagger

Tá doiciméadú idirghníomhach API ar fáil ag:

CÓD_BLOCK_1_

Fíordheimhniú

Úsáideann ChatHub córas fíordheimhnithe bunaithe ar chomharthaí Bearer le comharthaí JWT. Is féidir comharthaí a chur ar aghaidh ar dhá bhealach:

Modh 1: Ceanntásc Údaraithe

CÓD_BLOCK_2_

Modh 2: Ceanntásc X-Údarú-Eochair

CÓD_BLOCK_3_

Sreabhadh Fíordheimhnithe

Úsáideann ChatHub córas comharthaíochta dhá leibhéal:

  1. ** Chomhartha Cuideachta** - Comhartha rochtana ar leibhéal na heagraíochta
  2. ** Chomhartha Oibreora** - Comhartha rochtana oibritheora aonair

Sreabhadh Oibre

CÓD_BLOCK_4_

Príomhphointí Deiridh

ModhCríochphointeCur Síos
POST/api/cuideachta/get-tokenFaigh chomhartha údaraithe cuideachta
FAIGH/api/cuideachta/eagraíochtAisghabh liosta eagraíochta
FAIGH/api/oibreoirLiostaigh oibreoirí de réir eagraíochta
POST/api/oibreoir/sioncrónaighCuir oibreoirí nua leis
POST/api/oibreoir/stádasAthraigh stádas oibreora
POST/api/operator/get-tokenGin comharthaí oibreora (24h ar a mhéad)
POST/api/operator/validate-tokenFíoraigh bailíocht an chomhartha

Príomhghnéithe

Bainistíocht Chomhartha na Cuideachta

Faigh agus bainistigh comharthaí ar leibhéal na heagraíochta le haghaidh rochtain API.

Bainistíocht Eagraíochta

  • Liostaigh na heagraíochtaí go léir
  • Aisghabh sonraí eagraíochta
  • Bainistigh socruithe eagraíochta

Bainistíocht Oibreora

  • Liostaigh oibreoirí de réir eagraíochta
  • Cuir oibreoirí nua leis
  • Athraigh stádas oibreora (Gníomhach/Neamhghníomhach/Scriostha)
  • Gin comharthaí a bhaineann go sonrach leis an oibreoir (24 uair an chloig ar a mhéad)
  • Deimhnigh comharthaí oibreora

Comhtháthú Giuirléid

Comhtháthaigh giuirléid ChatHub le feidhmchláir ghréasáin le haghaidh tacaíocht fíor-ama do chustaiméirí.

Tús Tapa

  1. Fíordheimhniú - Faigh comharthaí do chuideachta agus d’oibreoir
  2. Eagraíochtaí - Bainistigh eagraíochtaí
  3. Oibreoirí - Cuir leis agus bainistigh oibreoirí
  4. Comhtháthú Giuirléid - Comhtháthaigh an ghiuirléid chomhrá

Formáid Iarratas

Úsáideann gach iarratas formáid JSON:

CÓD_BLOCK_5_

Formáid Freagartha

Freagraí rathúla ar ais:

CÓD_BLOCK_6_

Láimhseáil Earráide

Cóid stádais HTTP:

  • 200 OK - D’éirigh leis an iarratas
  • 400 Drochiarratas - Formáid iarratais neamhbhailí
  • 401 Neamhúdaraithe - Theip ar fhíordheimhniú
  • 403 Toirmiscthe - Ceadanna neamhleor
  • 404 Gan Aimsiú - Ní bhfuarthas an acmhainn
  • Earráid Freastalaí Inmheánach 500 - Earráid fhreastalaí

Éaga Chomhartha

Tá am éaga ag comharthaí. Nuair a théann comhartha in éag:

  1. Tabharfaidh an API ar ais 401 Neamhúdaraithe
  2. Iarr comhartha nua ag baint úsáide as an críochphointe fíordheimhnithe
  3. Nuashonraigh d’iarratas leis an comhartha nua

Na Chéad Chéimeanna Eile