Модуль дозволяє викликати API методи для інтеграції з третіми системами. Для запуску сценарію вам знадобиться метод call_node
Формат виклику:
POST <https://engine>.{{название проекта}}.kwizbot.io/kw/api/call_node/
або
POST https://engine-{{название проекта}}.kwizbot.io/kw/api/call_node/
Де:
Викликає виконання сценарію з точки входу (докладніше дивіться тут Компоненти) зазначену у виклику для користувача з зазначеним chat_id зазначеного каналу.
На этом скриншоте видна точка входа с алиасом crm_entry_point
Формат JSON запита (JSON body):
{
"chat_id":"398866372",
"channel":"telegram",
"bot_id":1,
"connector_alias":"crm_entry_point",
"data":{
"phone":"380961234567",
"name":"Sergey"
}
}
Де:
connector_alias
це унікальний аліас точки входуchat_id
це унікальний ідентифікатор чата в межах каналу channel
який заберегли при підписці користувача на нотифікації Підписка користувача на нотифікації із ботуbot_id
цеid бота в Kwizbot. За замовчуванням 1, якщо у вас розгорнуто 2 або більше ботів можна подивитись який у бота id в Налаштування - Список ботівdata
можна передавати будь-які параметри, які потім сценарій зможе обробити як звичайні змінні, наприклад вивести використовуючи {{ім'я змінної}}
Формат відповіді:
{
"status": "error" или "success"
"message": "сообщение с ответом",
"data": {...данные ответа...}
}
Приклад curl - запиту:
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://{{engine-url}}/kw/api/call_node/',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS =>'{
"chat_id":"999999999",
"channel":"telegram",
"bot_id":1,
"connector_alias":"node_alias",
"data":{
"phone":"380111111111",
"name":"Randomname"
},
"callback_url": "[<https://callback-getter.site>](<https://callback-getter.site/>)"
}',
CURLOPT_HTTPHEADER => array(
'Content-Type: application/json'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>