Интеграции
Как люди увидят бизнес-бота и как встроить входящий канал на сайт
Сейчас в Yullama есть не полноценный embedded messenger widget, а безопасный auth-first вход: человек нажимает кнопку на вашем сайте, переходит в Yullama, открывает диалог с source = widget, и этот диалог может попасть во вкладку «Бизнес», где уже отвечает бот или команда.
Где люди увидят бота
Бот не существует как отдельная публичная страница. Пользователь видит его только после того, как начинает диалог через публичную точку входа. В текущем продукте такими источниками являются публичный профиль, кнопка-виджет и публичная страница. Дальше создаётся business-диалог, и если в вашей вкладке «Бизнес» включён автоответ, бот даёт первый ответ и может запросить handoff человеку.
- Клиент нажимает кнопку на сайте или открывает публичный профиль.
- Yullama открывает chat flow с attribution source = `widget` или `public_profile`.
- Во вкладке «Бизнес» появляется входящий диалог.
- Если бот включён, он отвечает первым; если нет, диалог ждёт человека.
Что уже есть
- Auth-first контактная кнопка для сайта.
- Отдельная attribution-метка `widget` для Business inbox.
- Hosted bot и внешний webhook-бот для первого ответа.
- Переход от входящего диалога к задаче или сделке внутри приложения.
Чего пока нет
- Нет полноценного встроенного chat widget внутри чужого сайта.
- Нет iframe-мессенджера с перепиской прямо на странице.
- Нет отдельного SDK для React, Vue или Next.js.
- Нет отдельной модели брендов/подразделений с жёсткой изоляцией на уровне интерфейса.
Как встроить на сайт сейчас
На текущем этапе правильный способ интеграции это launcher-ссылка вида `/contact/[username]`, которая ведёт в Yullama и открывает диалог с меткой `widget` и конкретным `ref`. Так можно делать разные точки входа под продажи, поддержку, филиалы и подразделения.
- `YOUR_USERNAME` замените на username публичного профиля, через который принимаете входящие.
- `ref` используйте как стабильный код канала: `sales`, `support`, `clinic-a`, `clinic-b`.
- `title` нужен только для красивого заголовка на launcher page и не влияет на серверную логику.
HTML
<a href="https://yullama.ru/contact/YOUR_USERNAME?ref=website-sales&title=%D0%9F%D1%80%D0%BE%D0%B4%D0%B0%D0%B6%D0%B8" target="_blank" rel="noopener noreferrer">Написать нам в Yullama</a>React
export function ContactInYullama() {
return (
<a href="https://yullama.ru/contact/YOUR_USERNAME?ref=website-sales&title=%D0%9F%D1%80%D0%BE%D0%B4%D0%B0%D0%B6%D0%B8" target="_blank" rel="noreferrer">
Написать нам в Yullama
</a>
);
}Next.js
import Link from "next/link";
export function ContactInYullama() {
return (
<Link href="https://yullama.ru/contact/YOUR_USERNAME?ref=website-sales&title=%D0%9F%D1%80%D0%BE%D0%B4%D0%B0%D0%B6%D0%B8" target="_blank" rel="noreferrer">
Написать нам в Yullama
</Link>
);
}Vue
<template>
<a href="https://yullama.ru/contact/YOUR_USERNAME?ref=website-sales&title=%D0%9F%D1%80%D0%BE%D0%B4%D0%B0%D0%B6%D0%B8" target="_blank" rel="noreferrer">
Написать нам в Yullama
</a>
</template>Что заполнять в Бизнесе
- Если нужен автоответ, включите бота и задайте приветствие.
- Если хотите сначала только руками, бот можно не включать вообще.
- Шаблон intake выбирайте по типу потока: лид, поддержка, консультация.
- Внутренние заметки и теги используйте для маршрутизации внутри команды.
Как жить с несколькими бизнесами или подразделениями
Прямо сейчас это лучше моделировать через разные точки входа, разные публичные профили или разные ссылки-кнопки на сайте. Внутри одной вкладки «Бизнес» направления можно разводить через теги, шаблоны intake, пользовательские списки и отдельные правила handoff. Если вам нужно жёсткое разделение брендов, операторов и входящих потоков, это уже следующий продуктовый слой.