Сайтка виджет

ATLA AI виджети - бул баракчанын бурчунда турган калкыма чат баскычы, аны басканда ИИ-кызматкер менен диалог ачылат. Туташтыруу 1 мүнөттө бүтөт: жабуучу </body> тегинин алдына эки <script> коюу жетиштүү - иштеп чыгуучу да, бирдик курулуштар да керек эмес.

Виджет аркылуу ачылган бардык диалогдор платформанын жалпы чат борборуна түшүп, WhatsApp, Instagram же Telegramдан келген билдирүүлөр сыяктуу эле иштетилет: ИИ-кызматкер жооп берет, ATLA AI CRMде кардар карточкасын жүргүзөт жана керек учурда чатты операторго өткөрөт.

Иш жүзүндөгү мисал

Виджет иш жүзүндө кантип иштээрин көрүңүз: myphone.kg.

1-кадам. Organization ID алыңыз

organizationId - бул сиздин компаниянын ATLA AIдеги уникалдуу идентификатору. Аны жеке кабинеттен көчүрсө болот: Жөндөөлөр → Каналдар → Сайт виджети.

2-кадам. Кодду сайтка кошуңуз

Сайтыңыздын HTML-шаблонун (же </body> бар PHP-файлды) ачып, жабуучу </body> тегинин алдына төмөнкү блокту коюңуз:

<script>
  window.AtlaChatConfig = {
    organizationId: 'СИЗДИН_ORG_ID',
    wsUrl:          'wss://ai.atlabyte.com/api/widget/ws',
    channel:        'widget',

    botName:        'Менин Телефонум',
    primaryColor:   '#a91111',
    welcomeMessage: 'Саламатсызбы! 👋 Кантип жардам берейин?',
  };
</script>
<script src="https://ai.atlabyte.com/static/atlabyte-chat-widget.js"></script>

Бул минималдуу жетиштүү конфигурация - виджет баракчанын төмөнкү оң бурчунда пайда болуп, кардарларга жооп бере баштайт.

Маанилүү

window.AtlaChatConfig объекти виджет скриптине чейин жарыяланышы керек. <script>-тегдердин ирети алмаштырылса, виджет демейки жөндөөлөр менен ишке кирет.

Бардык параметрлери менен толук мисал

<script>
  window.AtlaChatConfig = {
    // — Милдеттүү —
    organizationId: '40c0ec7d-e27c-4660-ad9b-d4100a970249',

    // — API / WebSocket —
    wsUrl:          'wss://ai.atlabyte.com/api/widget/ws',
    channel:        'widget',
    leadUsername:   'Конок',

    // — Көрүнүшү —
    botName:        'Менин Телефонум',
    avatarUrl:      'https://example.com/avatar.jpg',
    avatarInitials: 'МТ',
    primaryColor:   '#a91111',
    primaryHover:   '#8b0d0d',
    position:       'right',
    zIndex:         99999,

    // — Тексттер —
    launcherText:   'Бизге жазыңыз',
    welcomeMessage: 'Саламатсызбы! 👋 Кантип жардам берейин?',
    placeholder:    'Билдирүү жазыңыз...',
    todayLabel:     'Бүгүн',
    onlineLabel:    'Онлайн',
    typingLabel:    'жазып жатат...',
    errorMessage:   'Бир нерсе туура эмес болду. Кийинчерээк аракет кылыңыз.',

    // — Брендинг —
    poweredBy:      'ATLABYTE',
    poweredByUrl:   'https://atlabyte.com',

    // — Тез баскычтар —
    quickReplies: [
      { label: 'Бар сатылыгы?', text: 'Сизде эмнелер бар?' },
      { label: 'Иш убактысы',   text: 'Иш убактыңыз кандай?' },
      { label: 'Ким иштейт?',   text: 'Азыр ким иштеп жатат?' },
      { label: 'Баалары',       text: 'Баалар жөнүндө айтып бериңиз' },
    ],
  };
</script>
<script src="https://ai.atlabyte.com/static/atlabyte-chat-widget.js"></script>

Параметрлердин сыпаттамасы

Милдеттүү

Параметр	Багытталышы
organizationId	ATLA AIдеги компаниянын UUIDси. Болбосо виджет ишке кирбейт.

API / WebSocket

Параметр	Демейки	Багытталышы
wsUrl	wss://ai.atlabyte.com/api/widget/ws	ATLA AI WebSocket-сервердин дареги. Өзүнүн серверин койгон Enterprise клиенттер үчүн гана өзгөрөт.
channel	widget	CRMдеги канал белгиси. Бир компаниянын ар башка сайттарындагы виджеттерди айырмалоо үчүн каалаган маанини коюуга болот (мисалы, widget-landing, widget-shop).
leadUsername	Конок	Келүүчү өзүн тааныштырганга чейинки демейки аты. Оператор панелинде көрүнөт.

Көрүнүшү

Параметр	Багытталышы
botName	Чат терезесинин шапкасындагы боттун аты.
avatarUrl	Боттун аватарынын URL'и. Бош болсо - avatarInitials колдонулат.
avatarInitials	Аватардын ордуна көрүнүүчү 1-2 тамга.
primaryColor	Брендтин негизги түсү: ишке кирүү баскычы, чаттын шапкасы, бот билдирүүлөрүнүн көбүкчөлөрү.
primaryHover	Курсор үстүнө келгендеги түс. Көрсөтүлбөсө - primaryColor'ден автоматтык эсептелет.
position	right же left - баракчанын кайсы бурчунда баскыч турат.
zIndex	Виджет контейнеринин z-index'и. Виджеттин үстүнө сайттын башка элементтери чыгып калса, көтөрүңүз.

Интерфейс тексттери

Бардык жазуулар сиздин сайттын тилине жана үнүнө ылайыкталат:

Параметр	Демейки
launcherText	Бизге жазыңыз ('' берсеңиз - сүрөтчө гана калат)
welcomeMessage	Чат ачылганда боттун биринчи фразасы
placeholder	Киргизүү талаасынын кеңеши
todayLabel	Ар башка күндөрдүн билдирүүлөрүнүн ортосундагы «Бүгүн» бөлгүчү
onlineLabel	Боттун атынын алдындагы статус
typingLabel	Бот жоопту даярдап жатканда көрүнүүчү статус
errorMessage	Сервер менен байланыш үзүлгөндө чыгуучу билдирүү

Брендинг

Параметр	Багытталышы
poweredBy	Чаттын астындагы кол тамга. Жашыруу үчүн '' бериңиз.
poweredByUrl	Кол тамга шилтемеси. Демейки - atlabyte.com.

Тез баскычтар

quickReplies - тосуу билдирүүсүнүн астында чыгуучу кеңеш баскычтарынын массиви. Ар бир баскыч эки талаалуу объект:

• label - баскычтын өзүндө көрүнүүчү кыска текст.
• text - келүүчү баскычты басканда чындыгында ботко жөнөтүлүүчү билдирүү.

quickReplies: [
  { label: 'Баалары',     text: 'Баалар жөнүндө айтып бериңиз' },
  { label: 'Иш убактысы', text: 'Иш убактыңыз кандай?' },
]

Бул биринчи жоопко чейинки убакытты кескин кыскартат: келүүчү жазбайт, ИИ түшүнүктүү жана так суроо алат.

Туташтыруудан кийин эмне болот

• Виджет 24/7 иштейт жана келүүчү чат терезесин ачаары менен диалогду өзү баштайт.
• Бардык чаттар WhatsApp, Telegram, Instagram менен бирге жалпы панелде көрүнөт.
• ATLA AI CRMде UTM-белгилер, булак жана келүүчү келген баракча менен лид карточкасы автоматтык түрдө түзүлөт.
• Эгер кардар товар шилтемесин жөнөтсө - ИИ ага кирип, ошол продукт боюнча кеңеш берет.
• Оператор каалаган учурда CRM-карточкасынан түз чатты кармап ала алат - кеңири маалымат Чаттарды кармоо бөлүмүндө.

Бир компанияда бир нече сайт

Виджеттердин саны чектелбейт. Аларды CRMде так бөлүү үчүн ар башка channel маанилерин бериңиз - мисалы, лендинг үчүн widget-landing, интернет-дүкөн үчүн widget-shop. Лиддер жана аналитика автоматтык түрдө бөлүнөт.