Веб чат виджет
Зочидтой чатлах,
өөрийн сайтаас.
Ганц script таг таны вэбсайт дээр чат товч суулгана. Зочид тэндээс тань руу бичих ба яриа бүр Airbnb, Vrbo-гийн харилцаатай нэг Prohost инбокс руу ирнэ — таны AI эхэлж хариулна.
Виджет юу хийдэг вэ
Энэ бол Prohost-ийн шууд захиалгын сайтад ажилладаг яг тэр зочны чат — таны удирддаг ямар ч вэбсайтад тохируулсан хувилбар.
Таны вэбсайт дээр ажиллана
Сайтынхаа хөлд эсвэл нэмэлт кодын хэсэгт нэг script таг наана. Плагин ч, build алхам ч, өөрөө байршуулах зүйл ч байхгүй.
Бүх зүйлд нэг инбокс
Веб чатын яриа Prohost инбокст OTA-гийн харилцааны хажууд ирдэг тул таны баг бүгдийг нэг дороос хариулна.
Таны AI эхэлж хариулна
Зочидтой харилцдаг яг тэр AI энд ч хариулж, таны байрны мэдээллийг ашиглан ажиллаад, шаардлагатай үед хүнд шилжүүлнэ.
Гурван алхмаар суулгана
Виджетийн тохиргооноос кодыг хуулж, сайтдаа наагаад нийтэл.
- Виджетээ үүсгэ
Prohost дээр AI чат виджет аппыг нээж, зочдын харах нэр, мэндчилгээ, товчны загварыг тохируул.
- Кодоо хуул
Өөр вэбсайтад нэмэх хэсгээс кодыг хуул. Түүнд таны виджетийн id, embed түлхүүр, товчны тохиргоо аль хэдийн орсон байгаа.
- Хаах body тагийн өмнө наа
Сайтынхаа нийтлэг хөл эсвэл нэмэлт кодын хэсэгт байрлуулаад нийтэл. Дараагийн ачаалалтад товч булангаас гарч ирнэ.
WIDGET_ID болон WIDGET_API_KEY-г виджетийн тохиргооны утгуудаар солино уу — эсвэл аппаас бэлэн кодыг шууд хуулж аваарай, тэр хоёрыг өөрөө бөглөнө. Embed түлхүүр нь нийтийн бөгөөд зөвхөн тэр виджетэд хамаарна: таны бүртгэл рүү ямар ч хандалт өгөхгүй. Prohost түлхүүрийг эхний удаа харуулсны дараа нуудаг тул хуулж болох шинэ код хэрэгтэй бол Түлхүүр солих товчийг ашигла.
Зөвхөн виджетийн id болон embed түлхүүр заавал шаардлагатай. Товчны атрибутуудыг орхивол товч нь аппад юу сонгосноос үл хамааран өөрийн үндсэн утгуудыг — индиго өнгийн бөмбөлөг, чат тэмдэг — авна. Чат цонх өөрөө таны тохиргоог дагасаар байна.
Ихэнх сайт бүтээгчид дээр ажиллана: Webflow, WordPress, Squarespace, Wix бүгд хөлдөө нэмэлт код тавих хэсэгтэй.
Атрибутын лавлах
Ачаалагчийн уншдаг бүх data-* атрибут. Script таг дээрх бусад зүйлийг үл тоомсорлоно.
| Атрибут | Утгууд | Үндсэн утга | Юу хийдэг |
|---|---|---|---|
data-widget | Таны виджетийн id | Заавал | Яриа аль виджетэд хамаарахыг заана. |
data-api-key | Таны нийтийн embed түлхүүр | Заавал | Тухайн виджетийн нийтийн embed түлхүүр. Зөвхөн виджетэд хамаарах бөгөөд бүртгэлд хандах эрх өгөхгүй. |
data-position | bottom-right · bottom-left | bottom-right | Товч болон чат цонх аль буланд байрлахыг заана. |
data-launcher-color | Hex өнгө | #4F46E5 | Чат товчны дүүргэлтийн өнгө. |
data-accent | Hex өнгө | Байхгүй | data-launcher-color-ийн хуучин нэр. Зөвхөн data-launcher-color байхгүй үед хэрэглэгдэнэ. |
data-launcher-icon | chat · lettermark | chat | Товчин дээрх тэмдэг: чат бөмбөлөг эсвэл Prohost-ийн цагаан монограм. |
data-hide-mobile | Зөвхөн байх эсэх | Унтраалттай | 768px-ээс доош өргөнтэй үед товчийг нууна. Цонхыг өөрийн товчоор нээх боломж хэвээр — доор үзнэ үү. |
data-sound | on | Виджетийн тохиргоо | Виджетийн тохиргоо юу ч байсан энэ суулгацад хариултын дууг асаана. Доор үзнэ үү. |
data-hide-mobile зөвхөн байгаа эсэхээр тооцогдоно: хоосон мөр ч гэсэн ямар ч утга түүнийг асаана. Бусад атрибутыг утгаар нь шалгах бөгөөд ялангуяа data-sound зөвхөн жижиг үсгээр бичсэн яг on гэсэн утгад хариу үзүүлнэ.
Хариултын дуу хэрхэн ажилладаг вэ
Хариулт ирэхэд зочин өөр тийш харж байвал чат цонхонд богино, намуухан дохио дуугарна.
Зочдод дуу тоглуулах
Виджетийн тохиргоон дахь унтраалга бөгөөд энэ нь гол эх сурвалж. Prohost дээр байршуулсан шууд захиалгын сайт зэрэг виджет ажиллаж буй бүх газарт хамаарна. Код өөрчлөхгүйгээр хүссэн үедээ солино.
data-sound="on"
Таны наасан script таг дахь илэрхий давхарлалт. Энэ нь дууг зөвхөн асаах чадвартай: унтраах утга гэж байхгүй. Тохиргоо гарахаас өмнө наасан кодууд ажилласаар байх, мөн тодорхой нэг сайтад дууг албадан асаах боломж олгохын тулд байдаг.
Хоёрын аль нэг нь хангалттай
Тохиргоо асаалттай, эсвэл атрибут яг on гэсэн утгатай бол дохио дуугарна. Аппын үүсгэсэн код хоёрыг нь зэрэгцүүлж барина: тохиргоо асаалттай үед атрибутыг оруулж, унтраалттай үед орхино.
Хаа сайгүй дууг унтраахын тулд тохиргоог унтраагаад кодыг сайтдаа дахин хуулж наа. Өмнө нь наасан атрибут тохиргоог давсаар байх бөгөөд энэ нь зориудын шийдэл.
- Зочин эхлээд хуудастай харьцах ёстой
Хөтчүүд хэн нэгэн товших, хүрэх, бичих хүртэл аудиог хааж байдаг. Товчийг нээх нь тооцогдоно, цонхонд бичих ч мөн адил — тиймээс хариулт авахуйц мессеж бичсэн зочин дууг сонсоно. Хөтөч тоглуулалтыг хаасан ч эвдрэх зүйл байхгүй: товчин дээрх уншаагүйн тэмдэг үндсэн дохио бөгөөд дуу нь нэмэлт.
- Уншиж байх үед хэзээ ч дуугарахгүй
Цонх нээлттэй, таб урд талд байх үед дохио гарахгүй: хариулт аль хэдийн дэлгэц дээр байна. Цонх хаалттай эсвэл таб ард байх үед дуугарна. Уншаагүйн тэмдэг арай нарийн дүрэм баримталдаг: зөвхөн цонх хаалттай үед гарч ирнэ.
- Олон хариулт нэг дохио
Хэд хэдэн мессеж зэрэг ирвэл мессеж тус бүрд биш, ганц дохио өгнө.
Өөрийн хуудаснаас удирдах
Ачаалагч window.ProhostWebchat дээр жижиг эвент шугам гаргадаг тул таны сайт цонхыг нээж, дотор нь болж буй зүйлд хариу үйлдэл үзүүлж чадна.
webchat_session_startedЯриа үүслээ: зочин анхны мессежээ илгээв. payload дотор conversationId ирнэ.webchat_message_sentЗочин мессеж илгээв.webchat_host_messageТанай багаас эсвэл AI-аас хариулт ирлээ. Энэ нь уншаагүйн тэмдэг, идэвхжсэн үед дууг ажиллуулна.data-hide-mobile-тэй хослуулахад тохиромжтой: утсан дээр үндсэн товчийг нууж, цонхыг өөрийн товчоороо нээ. Эвентүүд зөвхөн Prohost-ийн суулгацаас ирсэн тохиолдолд дамжуулагдана, өөр эх сурвалжаас хэзээ ч биш.
Аппаас удирдана
Нэр, мэндчилгээ, цонхны онцлох өнгө, хариултын дуу нь AI чат виджет аппад байдаг бөгөөд таны виджет ажиллаж буй бүх сайт эдгээр өөрчлөлтийг өөрөө авна. Товчны өнгө, дүрс нь өөр: тэдгээр нь кодод бичигдсэн тул өөрчилсний дараа кодыг дахин хуулж наах хэрэгтэй — embed түлхүүрээ солисны дараах шиг.