← Назад к заметкам

Заметки

Как создать групповой чат из карточки CRM

Как создать групповой чат из карточки CRM через IM API, добавить участников и сохранить связь с CRM.

Создание чата из карточки CRM обычно делится на две части: создать IM-чат с нужными участниками и отдельно сохранить связь с CRM-сущностью, чтобы потом понимать, к какой сделке или компании он относится.

Задача

Из сделки или компании нужно быстро создать рабочий чат с менеджером, руководителем, юристом и другими участниками.

Такой чат удобен для обсуждения конкретной карточки, но сам по себе IM-чат не становится CRM-сущностью. Связь нужно сохранить отдельно.

Создание чата

Для обычного группового чата используется метод создания чата и список участников.

BX24.callMethod(
    'im.chat.add',
    {
        TYPE: 'CHAT',
        TITLE: 'Обсуждение сделки #123',
        USERS: [1, 5, 9],
        MESSAGE: 'Чат создан для обсуждения сделки #123',
    },
    function (result) {
        console.log(result.error() || result.data());
    }
);

После создания полезно отправить первое сообщение со ссылкой на карточку CRM и коротким описанием, зачем создан чат.

Связь с CRM

ID созданного чата можно записать в пользовательское поле, HL-блок или служебный смарт-процесс.

Если чат создаётся по сделке, сохраните пару DEAL_ID и CHAT_ID. Тогда позже можно найти чат, не создавая дубли.

Ограничения БП

В чистом дизайнере БП создать полноценный IM-чат может быть неудобно.

Чаще всего делают локальное приложение, ajax-обработчик или PHP-активити в коробке. Это позволяет собрать участников, проверить права и аккуратно сохранить связь.