API и webhooks

Ключ создаётся один раз в Настройках. Секрет показывается только в момент создания — сразу скопируйте.

Отправить событие

POST https://perfomate.ru/public/v1/events
Authorization: Bearer pm_live_…
Content-Type: application/json

{
  "event_type": "LEAD",
  "event_id": "crm-lead-10041",
  "external_user_id": "tg:123456",
  "revenue": 0,
  "currency": "RUB",
  "properties": { "form": "quiz" }
}

Поле	Обязательно	Зачем
`event_type`	да	`LEAD`, `PAYMENT`, `REFUND` и любые свои
`event_id`	нет	Идемпотентность. Повтор с тем же id вернёт `duplicate`
`external_user_id`	нет	Склейка с человеком из мессенджера
`revenue`	нет	Для `PAYMENT` / `REFUND`, число
`timestamp`	нет	ISO-время исходного события
`platform`	нет	По умолчанию `public`

Вместо event_id можно заголовок Idempotency-Key. Ответ:

{ "data": { "event_id": "…", "duplicate": false, "status": "queued" } }

Оплата из своей кассы

{
  "event_type": "PAYMENT",
  "event_id": "order-8841",
  "external_user_id": "tg:123456",
  "revenue": 149000,
  "currency": "RUB"
}

Сумму кладите в тех же единицах, что и расход кампании: кабинет считает деньги в копейках.

Входящие вебхуки площадок

Их ставит кабинет сам. Менять вручную не нужно:

POST https://perfomate.ru/hooks/telegram/{ключ}
POST https://perfomate.ru/hooks/max/{ключ}
POST https://perfomate.ru/hooks/vk/{ключ}

Клиентский отчёт

JSON по токену шаринга: GET https://lk.perfomate.ru/api/public/report/{token} — без авторизации, только валидный токен.