Как подключить envyCRM к Strelo

Что подготовить

• Полный домен кабинета envyCRM из адресной строки, например https://company.envycrm.com.
• API-ключ envyCRM с правами на нужные операции.
• Доступ администратора workspace Strelo или роль, которая разрешает менять интеграции.

Если вы не видите API-ключ в envyCRM, запросите его у администратора CRM или поддержки envyCRM. Не отправляйте ключ в чат и не вставляйте его в ноду сценария.

Подключение по шагам

1. Откройте раздел Интеграции.
2. В блоке CRM-интеграции нажмите Новое подключение.
3. Задайте понятное название. Это особенно важно, если у вас несколько аккаунтов envyCRM.
4. Вставьте домен или адрес любой страницы из кабинета. Strelo оставит безопасный домен и добавит https://.
5. Вставьте API-ключ.
6. Нажмите Проверить доступ. Strelo выполнит безопасный запрос основных данных CRM.
7. Дождитесь статуса Доступ проверен. До успешной проверки кнопка сохранения недоступна.
8. Нажмите Подключить envyCRM.
9. Если нужны входящие события, нажмите Настроить события в сообщении об успешном подключении. Позже ту же панель можно открыть кнопкой События в карточке подключения.

API-ключ хранится только на сервере. При редактировании оставьте поле нового ключа пустым, если хотите сохранить прежний. Браузер не получает сохраненный ключ обратно. Домен фиксируется после создания подключения, чтобы события разных аккаунтов не смешались. Для другого домена создайте отдельное подключение.

Messenger-секреты

Для операций, которым нужны operator_key, channel_connected_key или channel_key, нажмите Messenger-секреты у сохраненного подключения. Укажите alias, выберите тип ключа и один раз введите значение. Alias может содержать латинские буквы, цифры, _ и -.

Повторное сохранение того же alias заменяет значение, но не меняет тип секрета. Само значение хранится server-side и не возвращается в браузер. В ноде выбирается только alias, поэтому ключ не попадает в граф, MCP-ответ или переменные сценария. Не публикуйте значения и не вставляйте их в JSON вручную.

Несколько подключений

В одном workspace можно сохранить несколько аккаунтов envyCRM через кнопку Новое подключение. В каждой ноде выбирается конкретное подключение. В карточке доступны Проверить связь, События, Messenger-секреты, Изменить и Управление.

Выключение не стирает настройки, но блокирует новые вызовы и события. Удаление предназначено для окончательного отключения. Если remote webhook не удалось убрать, Strelo покажет ошибку и сохранит данные, нужные для повторной очистки.

Как подключить события мессенджера

В карточке подключения нажмите События. Strelo загрузит messenger integrations из envyCRM. Выберите каналы, задайте название webhook и нажмите Подключить события.

Повторное сохранение не создает дубль. Кнопка Сохранить и сверить сравнивает локальную конфигурацию с envyCRM. При расхождении или удаленном remote webhook появляется действие Восстановить конфигурацию. Также доступны Обновить статус, Отключить и Удалить webhook.

Если список пуст, сначала подключите messenger channel в самой envyCRM. Создание messenger app имеет побочные эффекты, поэтому Strelo не делает его автоматически без отдельного действия пользователя.

Callback URL и секрет

После создания подключения один раз появляется блок Callback URL готовы. В нем есть отдельные кнопки копирования для Webhook событий и Messenger app. Полные URL не показываются текстом. Managed webhook настраивается через панель События, а URL Messenger app нужно вручную вставить в настройки приложения envyCRM, если вы используете app events. Скопируйте нужные URL до закрытия блока, не публикуйте их и не отправляйте посторонним.

При подозрении на утечку откройте Управление, нажмите Сменить callback, обновите URL в envyCRM и нажмите Восстановить конфигурацию. Старый URL перестанет проходить проверку.

Какие события доступны

envyCRM документирует только сообщения, ответы на сообщения и callback messenger app. В конструкторе Strelo доступна одна нода Событие. Внутри нее выбирается один из четырех документированных типов:

• Сообщение custom messenger webhook.
• Ответ custom messenger webhook.
• Сообщение messenger app.
• Статус messenger app.

Для первых двух событий фильтр выбирается из messenger integrations. Для событий приложения Strelo отдельно загружает подключенные app channels и сохраняет только SHA-256 хеш их channel_connected_key.

OpenAPI не документирует webhook изменения лида, сделки, клиента, задачи или счета. Таких триггеров в интеграции нет.

Если проверка не проходит

• 401: API-ключ неверный, отозван или скопирован не полностью.
• 403: ключу не хватает прав на запрос основных данных.
• timeout: envyCRM не ответила вовремя. Проверьте доступность домена и повторите проверку позже.
• Ошибка домена: вставлен путь страницы вместо корня аккаунта или указан домен, который не относится к envyCRM.
• Нужно восстановление: выбранный messenger integration удален или remote webhook изменен. Откройте События и нажмите Восстановить конфигурацию.