Веб чат виджет

Зочидтой чатлах,
өөрийн сайтаас.

Ганц script таг таны вэбсайт дээр чат товч суулгана. Зочид тэндээс тань руу бичих ба яриа бүр Airbnb, Vrbo-гийн харилцаатай нэг Prohost инбокс руу ирнэ — таны AI эхэлж хариулна.

Ганц script таг
Хариултууд таны инбокст
tany-sait.mn
Бидэнтэй холбогдоорой
Ихэвчлэн хэдэн минутад хариулдаг
Ням гарагт хожуу гарах боломжтой юу?
Тийм ээ, 14:00 цаг хүртэл байрыг тань хадгална.

Виджет юу хийдэг вэ

Энэ бол Prohost-ийн шууд захиалгын сайтад ажилладаг яг тэр зочны чат — таны удирддаг ямар ч вэбсайтад тохируулсан хувилбар.

Таны вэбсайт дээр ажиллана

Сайтынхаа хөлд эсвэл нэмэлт кодын хэсэгт нэг script таг наана. Плагин ч, build алхам ч, өөрөө байршуулах зүйл ч байхгүй.

Бүх зүйлд нэг инбокс

Веб чатын яриа Prohost инбокст OTA-гийн харилцааны хажууд ирдэг тул таны баг бүгдийг нэг дороос хариулна.

Таны AI эхэлж хариулна

Зочидтой харилцдаг яг тэр AI энд ч хариулж, таны байрны мэдээллийг ашиглан ажиллаад, шаардлагатай үед хүнд шилжүүлнэ.

Гурван алхмаар суулгана

Виджетийн тохиргооноос кодыг хуулж, сайтдаа наагаад нийтэл.

  1. Виджетээ үүсгэ

    Prohost дээр AI чат виджет аппыг нээж, зочдын харах нэр, мэндчилгээ, товчны загварыг тохируул.

  2. Кодоо хуул

    Өөр вэбсайтад нэмэх хэсгээс кодыг хуул. Түүнд таны виджетийн id, embed түлхүүр, товчны тохиргоо аль хэдийн орсон байгаа.

  3. Хаах body тагийн өмнө наа

    Сайтынхаа нийтлэг хөл эсвэл нэмэлт кодын хэсэгт байрлуулаад нийтэл. Дараагийн ачаалалтад товч булангаас гарч ирнэ.

html
<script
  src="https://app.prohost.ai/webchat.js"
  data-widget="WIDGET_ID"
  data-api-key="WIDGET_API_KEY"
  data-position="bottom-right"
  data-launcher-color="#4F46E5"
  data-launcher-icon="chat"
  data-sound="on"
  async></script>

WIDGET_ID болон WIDGET_API_KEY-г виджетийн тохиргооны утгуудаар солино уу — эсвэл аппаас бэлэн кодыг шууд хуулж аваарай, тэр хоёрыг өөрөө бөглөнө. Embed түлхүүр нь нийтийн бөгөөд зөвхөн тэр виджетэд хамаарна: таны бүртгэл рүү ямар ч хандалт өгөхгүй. Prohost түлхүүрийг эхний удаа харуулсны дараа нуудаг тул хуулж болох шинэ код хэрэгтэй бол Түлхүүр солих товчийг ашигла.

Ажиллах хамгийн богино хувилбар

Зөвхөн виджетийн id болон embed түлхүүр заавал шаардлагатай. Товчны атрибутуудыг орхивол товч нь аппад юу сонгосноос үл хамааран өөрийн үндсэн утгуудыг — индиго өнгийн бөмбөлөг, чат тэмдэг — авна. Чат цонх өөрөө таны тохиргоог дагасаар байна.

html
<script
  src="https://app.prohost.ai/webchat.js"
  data-widget="WIDGET_ID"
  data-api-key="WIDGET_API_KEY"
  async></script>

Ихэнх сайт бүтээгчид дээр ажиллана: Webflow, WordPress, Squarespace, Wix бүгд хөлдөө нэмэлт код тавих хэсэгтэй.

Атрибутын лавлах

Ачаалагчийн уншдаг бүх data-* атрибут. Script таг дээрх бусад зүйлийг үл тоомсорлоно.

АтрибутУтгуудҮндсэн утгаЮу хийдэг
data-widgetТаны виджетийн idЗаавалЯриа аль виджетэд хамаарахыг заана.
data-api-keyТаны нийтийн embed түлхүүрЗаавалТухайн виджетийн нийтийн embed түлхүүр. Зөвхөн виджетэд хамаарах бөгөөд бүртгэлд хандах эрх өгөхгүй.
data-positionbottom-right · bottom-leftbottom-rightТовч болон чат цонх аль буланд байрлахыг заана.
data-launcher-colorHex өнгө#4F46E5Чат товчны дүүргэлтийн өнгө.
data-accentHex өнгөБайхгүйdata-launcher-color-ийн хуучин нэр. Зөвхөн data-launcher-color байхгүй үед хэрэглэгдэнэ.
data-launcher-iconchat · lettermarkchatТовчин дээрх тэмдэг: чат бөмбөлөг эсвэл Prohost-ийн цагаан монограм.
data-hide-mobileЗөвхөн байх эсэхУнтраалттай768px-ээс доош өргөнтэй үед товчийг нууна. Цонхыг өөрийн товчоор нээх боломж хэвээр — доор үзнэ үү.
data-soundonВиджетийн тохиргооВиджетийн тохиргоо юу ч байсан энэ суулгацад хариултын дууг асаана. Доор үзнэ үү.

data-hide-mobile зөвхөн байгаа эсэхээр тооцогдоно: хоосон мөр ч гэсэн ямар ч утга түүнийг асаана. Бусад атрибутыг утгаар нь шалгах бөгөөд ялангуяа data-sound зөвхөн жижиг үсгээр бичсэн яг on гэсэн утгад хариу үзүүлнэ.

Хариултын дуу хэрхэн ажилладаг вэ

Хариулт ирэхэд зочин өөр тийш харж байвал чат цонхонд богино, намуухан дохио дуугарна.

Тохиргоо

Зочдод дуу тоглуулах

Виджетийн тохиргоон дахь унтраалга бөгөөд энэ нь гол эх сурвалж. Prohost дээр байршуулсан шууд захиалгын сайт зэрэг виджет ажиллаж буй бүх газарт хамаарна. Код өөрчлөхгүйгээр хүссэн үедээ солино.

Атрибут

data-sound="on"

Таны наасан script таг дахь илэрхий давхарлалт. Энэ нь дууг зөвхөн асаах чадвартай: унтраах утга гэж байхгүй. Тохиргоо гарахаас өмнө наасан кодууд ажилласаар байх, мөн тодорхой нэг сайтад дууг албадан асаах боломж олгохын тулд байдаг.

Хоёрын аль нэг нь хангалттай

Тохиргоо асаалттай, эсвэл атрибут яг on гэсэн утгатай бол дохио дуугарна. Аппын үүсгэсэн код хоёрыг нь зэрэгцүүлж барина: тохиргоо асаалттай үед атрибутыг оруулж, унтраалттай үед орхино.

Хаа сайгүй дууг унтраахын тулд тохиргоог унтраагаад кодыг сайтдаа дахин хуулж наа. Өмнө нь наасан атрибут тохиргоог давсаар байх бөгөөд энэ нь зориудын шийдэл.

  • Зочин эхлээд хуудастай харьцах ёстой

    Хөтчүүд хэн нэгэн товших, хүрэх, бичих хүртэл аудиог хааж байдаг. Товчийг нээх нь тооцогдоно, цонхонд бичих ч мөн адил — тиймээс хариулт авахуйц мессеж бичсэн зочин дууг сонсоно. Хөтөч тоглуулалтыг хаасан ч эвдрэх зүйл байхгүй: товчин дээрх уншаагүйн тэмдэг үндсэн дохио бөгөөд дуу нь нэмэлт.

  • Уншиж байх үед хэзээ ч дуугарахгүй

    Цонх нээлттэй, таб урд талд байх үед дохио гарахгүй: хариулт аль хэдийн дэлгэц дээр байна. Цонх хаалттай эсвэл таб ард байх үед дуугарна. Уншаагүйн тэмдэг арай нарийн дүрэм баримталдаг: зөвхөн цонх хаалттай үед гарч ирнэ.

  • Олон хариулт нэг дохио

    Хэд хэдэн мессеж зэрэг ирвэл мессеж тус бүрд биш, ганц дохио өгнө.

Өөрийн хуудаснаас удирдах

Ачаалагч window.ProhostWebchat дээр жижиг эвент шугам гаргадаг тул таны сайт цонхыг нээж, дотор нь болж буй зүйлд хариу үйлдэл үзүүлж чадна.

javascript
function wireUpWebchat() {
  window.ProhostWebchat.on('webchat_host_message', (event) => {
    console.log(event.type);
  });

  document.querySelector('#my-chat-button')?.addEventListener('click', () => {
    window.ProhostWebchat.open();
    // window.ProhostWebchat.close() collapses it again.
  });
}

if (window.ProhostWebchat) {
  wireUpWebchat();
} else {
  // src*= rather than src$= — the tag may carry a cache-busting query string.
  document
    .querySelector('script[src*="/webchat.js"]')
    ?.addEventListener('load', wireUpWebchat);
}
webchat_session_startedЯриа үүслээ: зочин анхны мессежээ илгээв. payload дотор conversationId ирнэ.
webchat_message_sentЗочин мессеж илгээв.
webchat_host_messageТанай багаас эсвэл AI-аас хариулт ирлээ. Энэ нь уншаагүйн тэмдэг, идэвхжсэн үед дууг ажиллуулна.

data-hide-mobile-тэй хослуулахад тохиромжтой: утсан дээр үндсэн товчийг нууж, цонхыг өөрийн товчоороо нээ. Эвентүүд зөвхөн Prohost-ийн суулгацаас ирсэн тохиолдолд дамжуулагдана, өөр эх сурвалжаас хэзээ ч биш.

Аппаас удирдана

Нэр, мэндчилгээ, цонхны онцлох өнгө, хариултын дуу нь AI чат виджет аппад байдаг бөгөөд таны виджет ажиллаж буй бүх сайт эдгээр өөрчлөлтийг өөрөө авна. Товчны өнгө, дүрс нь өөр: тэдгээр нь кодод бичигдсэн тул өөрчилсний дараа кодыг дахин хуулж наах хэрэгтэй — embed түлхүүрээ солисны дараах шиг.