Коллаба партнёра по ключу
Сценарий для двух порталов. Диалог живёт в коллабе на портале владельца, а партнёр на другом портале получает зеркало этого чата. Сообщения пересылаются в обе стороны: партнёр отвечает из своей Зарубки, и его ответ уходит клиенту в исходную коллабу.
Что понадобится:
- Зарубка установлена на обоих порталах: у владельца и у партнёра.
- Администратор портала партнёра, чтобы подключить ключ. Обычный сотрудник не подключит коллабу партнёра.
- Канал для передачи ключа: любой, хоть почта, хоть мессенджер.
Ключ одноразовый: его активирует один партнёрский портал. Чтобы поделиться чатом с ещё одним порталом, создайте новый ключ.
Срок действия ключа — это время на его активацию: партнёр должен успеть ввести ключ, пока тот не истёк. После подключения срок больше ни на что не влияет: зеркало работает бессрочно, пока вы не отзовёте ключ.
Вы создаёте ключ в инфо-панели своего чата и передаёте его партнёру.
Шаг 1. Пригласите бота «Зарубка» в коллабу
Ключ создаётся у диалога, поэтому чат сначала должен появиться в Зарубке. Откройте коллабу в Битрикс24 и добавьте в участники бота «Зарубка», как обычного участника.
Результат: чат коллабы сам появился в Зарубке, уже привязанным к проекту. Если бота в коллабе нет, а приложение только что установлено, обновите страницу Зарубки.
Не уверены, что ваш чат — коллаба? Начните приглашать кого-нибудь в чат: если в окне приглашения есть вкладка «Гости», это коллаба.
Шаг 2. Откройте «Поделиться с партнёром»
Откройте диалог в Зарубке и перейдите в инфо-панель чата. Нажмите «Поделиться с партнёром».
Шаг 3. Создайте ключ
Нажмите «Создать ключ» и выберите срок действия: 7, 30 или 90 дней. По умолчанию стоит 30 дней.
Примечание
Срок действия — это время, за которое ключ нужно активировать. Как только партнёр подключился, срок больше ни на что не влияет: связь работает бессрочно, пока вы её не отзовёте.
Шаг 4. Сохраните ключ
Внимание
Полный ключ показывается один раз. Он сразу копируется в буфер обмена. Сохраните его сейчас: позже вы увидите только конец ключа.
Результат: ключ вида ccl_… сохранён и ждёт подключения.
Шаг 5. Передайте ключ партнёру
Отправьте ключ партнёру любым способом вместе со ссылкой на эту страницу: инструкция для него на вкладке «Партнёр».
В списке ключей чата вы увидите текущее состояние каждого ключа:
| Статус | Что означает |
|---|---|
| «ждёт подключения» | Ключ создан, партнёр пока не подключился |
| «подключён · {домен}» | Партнёр подключился, зеркало работает |
| «истёк, не использован» | Срок вышел, никто не подключился |
| «отозван» | Вы отозвали ключ до подключения |
| «связь разорвана · {домен}» | Вы отозвали ключ после подключения |
Вместо {домен} стоит адрес портала партнёра, например partner.bitrix24.ru.
Шаг 6. Управляйте ключами
У каждого ключа два действия:
- «Перевыпустить» создаёт новый ключ на тот же срок. Старый ключ перестанет работать сразу. Используйте, если ключ потерялся или истёк до того, как партнёр подключился.
- «Отозвать» гасит ключ немедленно. Если партнёр уже подключён, связь разорвётся: зеркало у партнёра станет доступно только для чтения, а история сохранится.
Вы получили ключ от владельца диалога и подключаете зеркало чата к своему порталу.
Шаг 1. Подключите ключ
Откройте Зарубку на своём портале и нажмите «Подключить коллабу партнёра по ключу». Эту кнопку видит только администратор портала. Она также есть в списке «Непривязанные».
В модалке «Подключить коллабу партнёра» вставьте ключ в поле «Ключ вида ccl_…» и нажмите «Подключить».
Если ключ не подошёл, проверьте, что он скопирован целиком, или попросите у владельца новый.
Результат: зеркало чата появится в списке «Непривязанные» с уведомлением «Коллаба с портала {domain} подключена — привяжите её к проекту».
Шаг 2. Привяжите зеркало к проекту
Нажмите «Привязать» у зеркала чата и выберите свою рабочую группу. По желанию укажите «Направление работ».
Результат: зеркало переехало в «Мои диалоги» и привязано к вашему проекту.
Шаг 3. Проверьте переписку
Напишите что-нибудь в зеркало. Сообщение уйдёт в исходную коллабу на портал владельца, а ответ владельца появится у вас в Зарубке.
Если владелец разорвёт связь, вы увидите в зеркале сообщение «Владелец разорвал связь — переписка остановлена, история сохранена». Писать в чат станет нельзя, прочитать историю — можно.