Проследите одну тестовую сделку от события CRM до конечного payload Slack. Нужны идентификатор именно сделки, доверенный адрес её портала и поддерживаемое место для ссылки в сообщении. Наличие слова «Открыть» в макете ещё не означает, что адаптер передал URL и Slack распознал его как ссылку.
Сначала соберите адрес правильного объекта
Не подставляйте в маршрут сделки ID контакта, заявки или события доставки. Эти значения могут выглядеть одинаково, но описывать разные сущности. Для нескольких CRM-порталов храните связь события с его организацией; один общий origin способен открыть чужой портал даже при правильном числовом ID.
Условная модель уведомления:
crm_account -> разрешённый портал
entity_type -> deal
entity_id -> ID тестовой сделки
entity_url -> маршрут по контракту этой CRM
slack_target -> разрешённый разговор
link_label -> Открыть сделку
render_mode -> формат конкретного блокаМаршрут карточки берите из документации или поддерживаемого механизма выбранной CRM. Универсальной строки /deal/ID для всех систем нет. Проверьте итоговый адрес в разрешённом тестовом аккаунте и убедитесь, что он открывает нужную карточку, а не список, поиск или страницу другого типа сущности.
| Симптом | Что сравнить |
|---|---|
| URL отсутствует в payload | Преобразование события в уведомление |
| Виден текст с разметкой | Тип текстового объекта Slack |
| Открывается другая карточка | Тип сущности и её ID |
| Переход ведёт на другой портал | Связь организации и origin |
| Карточка просит доступ | Учётную запись получателя |
Разметка зависит от места в сообщении
В документации Slack formatting message text, проверенной 25 октября 2026 года, описаны plain_text и mrkdwn. Ручная ссылка с подписью в mrkdwn имеет форму <URL|подпись>. Этот синтаксис нельзя без проверки переносить в поле, которое принимает только обычный текст. Используйте контракт того блока, который реально отправляет адаптер.
Для искусственного примера запись <https://crm.example.test/deals/demo|Открыть сделку> показывает только синтаксис Slack, а не маршрут реальной CRM. На сервере статья отображает её как текст. В интеграции подставьте проверенный URL своей системы и корректно сформируйте JSON; не собирайте весь объект конкатенацией непроверенных названий из события.
Убедитесь, что ссылка не прошла лишнее экранирование между шаблоном и отправкой. Иногда редактор показывает красивое превью, а второй слой превращает управляющую разметку в буквальные символы. Сравнивайте итоговый сериализованный запрос и сообщение в клиенте, а не только промежуточную строку в шаблоне.
Ссылка должна помогать получателю, а не обходить доступ
- Создать искусственную сделку в разрешённом портале.
- Сопоставить ID события с карточкой.
- Проверить URL до формирования Slack-разметки.
- Посмотреть сообщение и перейти по ссылке получателем.
- Повторить с отсутствующим ID и вторым тестовым порталом.
Рабочая ссылка не выдаёт прав на CRM. Если сотрудник видит уведомление, но не имеет доступа к карточке, решайте вопрос роли отдельно. Не добавляйте в URL токен сессии или секрет интеграции ради беспрепятственного открытия: адрес сообщения может попасть в историю, пересылку и журналы.
Для неизвестного объекта выберите честный запасной вариант: уведомление без кнопки с понятным объяснением либо остановку формирования до получения нужного ID. Ссылка на главную страницу, подписанная «Открыть сделку», лишь переносит поиск на сотрудника и затрудняет обнаружение дефекта.
Проверьте мобильный клиент и длинное название сделки: подпись должна оставаться понятной, а соседний текст — не поглощать URL. Приёмка заканчивается на открытой правильной карточке под учётной записью получателя. Сохраните обезличенный пример события, итогового payload и выбранного маршрута, чтобы следующая смена шаблона не потеряла эту связь.