Как устроена интеграция
При каждом событии PingDesk вызывает метод POST /api/v4/tasks официального API amoCRM от имени вашей приватной интеграции и создаёт задачу. Тип задачи — «Связаться», срок — через час после события, ответственный — сотрудник из поля «ID ответственного» или владелец токена, если поле не заполнено.
В тексте задачи — полное уведомление на русском языке: что случилось и с каким монитором, адрес, детали проверки, время по Москве и ссылка, которая открывает монитор в PingDesk. Менеджеру не нужно ничего расшифровывать — по тексту понятно, что сломалось и куда смотреть.
Задача не привязывается к сделке, контакту или компании: она появляется в списке задач ответственного. Если сбой касается конкретного клиента, менеджер может связать задачу с его карточкой уже в amoCRM.
Сценарии для агентств и интернет-магазинов
Связка мониторинга и CRM полезна, когда за сайтом стоит клиент или ответственный менеджер: задача в amoCRM не теряется среди сообщений и остаётся просроченной, пока её не закроют.
- Агентство: сайт клиента упал — менеджер проекта получает задачу связаться с клиентом и предупредить его раньше, чем тот заметит сам.
- Продление услуг: домен или SSL-сертификат клиента истекает — задача на продление и повод для допродажи.
- Интернет-магазин: магазин недоступен — задача ответственному, чтобы связать простой с просевшими заявками.
Как не получать задачу каждые 5 минут
Стандартное правило «Сайт недоступен» повторяет уведомление каждые 5 минут, пока сайт лежит. Для мессенджера это напоминание, а в CRM каждое повторение — новая задача. Поэтому для amoCRM напоминания стоит отключить.
- «Повторять каждые» — укажите 0, чтобы на один сбой создавалась одна задача.
- «Кулдаун сценария» — одинаковые события по одному монитору не чаще заданного срока, минимум 60 секунд.
- Восстановление сайта создаёт отдельную задачу. Если она не нужна, создайте для amoCRM своё правило только с нужными событиями и выберите в поле «Каналы» этот канал.
- Если amoCRM не приняла задачу или не ответила вовремя, PingDesk повторяет попытку через 1, 5, 15, 30 и 60 минут, пока событие актуально. В конце текста каждой задачи стоит код уведомления вида PD-3f9a1c7b2e: перед повторной попыткой PingDesk ищет задачу с этим кодом, созданную за последние 3 часа, и не создаёт вторую, если amoCRM уже приняла первую. Каждая попытка видна в «Журнале уведомлений».
Безопасность токена
Долгосрочный токен хранится в базе PingDesk в зашифрованном виде (AES-256-GCM) и после сохранения больше не показывается ни в интерфейсе, ни через API. PingDesk отправляет его только на указанный вами адрес аккаунта на доменах amocrm.ru, amocrm.com или kommo.com — на другие адреса токен не уходит.
Если токен утёк, удалите интеграцию в amoCRM или перевыпустите токен, а затем обновите канал в PingDesk. Каналы amoCRM, подключённые раньше через поле «Webhook URL», продолжают работать как прежде: PingDesk отправляет JSON на указанный адрес, теперь с русским заголовком и текстом уведомления в полях title и message.
Частые вопросы
PingDesk сам создаёт задачу в amoCRM?
+
Да. При каждом событии мониторинга PingDesk создаёт через API amoCRM задачу «Связаться» с текстом уведомления и сроком в один час. Сделки, контакты и примечания не создаются.
Где взять долгосрочный токен?
+
В amoCRM: «Настройки» → «Интеграции» → «Создать интеграцию» → внешняя интеграция. После сохранения откройте вкладку «Ключи и доступы» и сгенерируйте долгосрочный токен.
Что указать в поле «Адрес аккаунта amoCRM»?
+
Адрес, по которому вы открываете amoCRM, например mycompany.amocrm.ru. Можно вставить полную ссылку или только имя аккаунта — PingDesk приведёт его к нужному виду. Поддерживаются домены amocrm.ru, amocrm.com и kommo.com.
Кому назначается задача?
+
Сотруднику, чей числовой ID указан в поле «ID ответственного». Если поле пустое, задача достаётся владельцу долгосрочного токена.
Привязывается ли задача к сделке или контакту?
+
Нет. Задача создаётся без привязки и появляется в списке задач ответственного. Связать её с карточкой клиента можно вручную в amoCRM.
Доступен ли канал на бесплатном тарифе?
+
Да, если это ваш единственный канал: на бесплатном тарифе доступен один канал уведомлений. На Starter их 5, на Pro — 10, на Agency — 50.
Что будет, если amoCRM не ответила?
+
Попытка будет отмечена ошибкой в «Журнале уведомлений», а PingDesk повторит её через 1, 5, 15, 30 и 60 минут, пока событие актуально: задача о падении не появится, если сайт уже восстановился. Ошибки, которые сами не исправятся, например не заполненные поля канала, не повторяются.
У меня канал amoCRM с полем «Webhook URL». Он продолжит работать?
+
Да. Такие каналы по-прежнему отправляют JSON на указанный адрес. Чтобы PingDesk создавал задачи сам, подключите новый канал amoCRM с адресом аккаунта и долгосрочным токеном.