Webhook API: получение событий во внешние системы

Webhook API позволяет получать уведомления о событиях MaxSurge в реальном времени: отправка сообщения, новый лид, ответ от клиента, завершение кампании.

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

Зайдите в «Webhook API» (раздел в панели управления).
Нажмите «Добавить вебхук».
Укажите URL, на который MaxSurge будет слать POST-запросы. Это может быть: ваш сервер, Zapier webhook, n8n webhook, Google Apps Script URL.
Выберите события, которые хотите получать (или * = все).
Сохраните. MaxSurge сгенерирует Secret-ключ для проверки подписи.

Доступные события

Событие	Когда
`message_sent`	Сообщение отправлено
`message_delivered`	Сообщение доставлено
`reply_received`	Получен ответ на рассылку
`lead_collected`	Новый лид собран (2GIS / чаты / бот)
`campaign_completed`	Кампания рассылки завершена
`account_blocked`	MAX-аккаунт заблокирован
`payment_success`	Успешный платёж
`trial_expiring`	Триал заканчивается (за 1 день)

Формат запроса

POST https://your-server.com/webhook
Content-Type: application/json
X-MaxSurge-Event: lead_collected
X-MaxSurge-Signature: sha256=abc123...

{
  "event": "lead_collected",
  "timestamp": "2026-04-11T15:30:00Z",
  "data": {
    "phone": "+79991234567",
    "name": "ООО Ромашка",
    "city": "Краснодар",
    "source": "2gis"
  }
}

Проверка подписи

Каждый запрос подписан HMAC-SHA256 с вашим Secret-ключом. Проверяйте подпись, чтобы убедиться, что запрос пришёл от MaxSurge:

# Python
import hmac, hashlib

def verify(body: bytes, secret: str, signature: str) -> bool:
    expected = hmac.new(secret.encode(), body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(f"sha256={expected}", signature)

Retry-логика

Если ваш сервер не ответил 2xx, MaxSurge повторит через 5 сек, 30 сек и 5 минут (3 попытки). После 3-й неудачи — событие помечается как failed. Лог попыток доступен в «Webhook API» → «Логи».

Идеи интеграций

amoCRM / Bitrix24: при lead_collected создавать сделку в CRM.
Telegram-бот: при reply_received пересылать ответ менеджеру.
Google Sheets: при lead_collected добавлять строку в таблицу через Apps Script.
n8n / Zapier: любая автоматизация по webhook-триггеру.