Бесплатная CRM система онлайн

Документация Webhook

Что такое Webhook

Webhook - это технология, позволяющая взаимодействовать CRM с вашими внешними скриптами по средствам передачи данных на их URL методом POST запроса(в том числе в виде отправки на них данных в формате JSON). CRM умеет передавать данные о новых созданных: сделках, задачах, клиентах, а также о их изменении и удалении.

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

Для подключения Webhook, в личном кабинете, перейдите в раздел Настройки -> Webhook, выберите "Добавить", затем заполните форму параметрами вызова Webhook указав название, URL, тип передачи данных и при каких событиях в CRM он будет срабатывать. При каждом изменении настроек Webhook, система отправляет тестовый запрос на указанный URL, в качестве отправляемых данных переменная test с содержимым test.

При каких событиях вызывается

В настройках Webhook вы можете опционально задать вызов URL с передачей на него данных, при следующих событиях:

Системные значения

Время ожидания ответа от вашего сервера не более 3 секунд. Это значит, если система при отправке webhook, не дождалась ответа от вашего сервера в течении этого времени, подключение будет сброшено.

Добавление и изменение сделки

Описание полей запроса:
ПеременнаяТип поляОписание
namestringНазвание сделки
pricefloatСумма стоимости сделки
id_catintID категории (можно получить в ЛК -> Категории сделок -> Редактировать категорию)
id_statusintID статуса(шага воронки) сделки (можно получить в ЛК -> Статусы сделок -> Редактировать статус)
id_originintID источника (можно получить в ЛК -> Источники сделок -> Редактировать источник)
id_clientintID клиента (можно получить в ЛК -> Клиенты -> Редактировать клиента)
archivebooleanПереместить сделку в архив
tagsstringТеги через запятую
colorstringЦвет сделки на доске Канбан в формате HEX, пример: AD3939
textstringОписание сделки
componentstringНазвание компонента - order (сделки)
eventstringНазвание действия - add/edit (добавление или изменение)

Удаление сделки

Описание полей запроса:
ПеременнаяТип поляОписание
idintID удаляемой сделки
componentstringНазвание компонента - order (сделки)
eventstringНазвание действия - delete (удаление)

Добавление и изменение задачи

Описание полей запроса:
ПеременнаяТип поляОписание
namestringНазвание задачиДа
date_fromintДата и время начала задачи (Unixtime)
date_tointДата и время окончания задачи (Unixtime)
all_daybooleanУстановить задачу, как задачу периодом на весь день
colorstringЦвет задачи на доске Канбан/Календаре в формате HEX, пример: AD3939
textstringОписание задачи
id_dealintID сделки (можно получить в ЛК -> Сделки -> Редактировать сделки)
id_statusintID статуса задачи (можно получить в ЛК -> Статусы задач -> Редактировать статус)
id_typeintID типа задачи (можно получить в ЛК -> Типы задач -> Редактировать тип задачи)
componentstringНазвание компонента - task (задачи)
eventstringНазвание действия - add/edit (добавление или изменение)

Удаление задачи

Описание полей запроса:
ПеременнаяТип поляОписание
idintID удаляемой задачи
componentstringНазвание компонента - task (сделки)
eventstringНазвание действия - delete (удаление)

Удаление всех задач в рамках сделки

Описание полей запроса:
ПеременнаяТип поляОписание
id_orderintID сделки в рамках которой удаляются задачи
componentstringНазвание компонента - task (сделки)
eventstringНазвание действия - delete (удаление)

Добавление изменение клиента

Описание полей запроса:
ПеременнаяТип поляОписание
realnamestringФИО клиента
emailstringE-Mail клиента
phonestringТелефон клиента
positionstringДолжность клиента
id_statusintID статуса клиента (можно получить в ЛК -> Статусы клиентов -> Редактировать статус клиента)
textstringОписание клиента
fieldsarray assocАссоциативный массив с дополнительными полями, содежащими информацию по клиенту, где ключ - имя поля, значение - данные

Удаление клиента

Описание полей запроса:
ПеременнаяТип поляОписание
idintID удаляемого клиента
componentstringНазвание компонента - client (сделки)
eventstringНазвание действия - delete (удаление)

Пример скрипта принимающего данные от Webhook

Скрипт принимает данные и отправлеят их на E-Mail:

Пример 1. Скрипт принимает POST данные.
header('Access-Control-Allow-Origin: *');
$headers = "From: [email protected]";​
/* замените электронную почту на действующую почту, с которой вам будет приходить письмо */
​ $message = print_r($_POST,true); @mail('[email protected]', 'Leve-CRM TEST', $message, $headers);
/* замените электронную почту на вашу действующую почту, на которую вам будет приходить письмо */
echo"ok";
Пример 2. Скрипт принимает JSON данные.
header('Access-Control-Allow-Origin: *');
$json = file_get_contents("php://input"); // Входящие данные в формате JSON
$data = json_decode($json, true);
$headers = "From: [email protected]";​
/* замените электронную почту на действующую почту, с которой вам будет приходить письмо */
​ $message = print_r($data, true); @mail('[email protected]', 'Leve-CRM TEST', $message, $headers);
/* замените электронную почту на вашу действующую почту, на которую вам будет приходить письмо */
echo"ok";