Як передати дані з ConnectiveOne через send_request

Дія send_request надсилає довільні HTTP-запити з ConnectiveOne до зовнішніх сервісів. Це корисно для інтеграції з CRM, ERP, маркетинговими платформами та іншими системами.

Секрети для сценаріїв: якщо адміністратор увімкнув збережені секрети, автентифікацію можна вставити в поля запиту ноди Send Request. Див. керування секретами.

Відмінності від send_me

send_me:

Автоматично додає chat_id та channel до даних запиту
Підходить для webhook-інтеграцій, де потрібен контекст чату

send_request:

Не додає автоматично chat_id та channel
Більш гнучкий для довільних API-запитів
Підтримує Basic- та Bearer-автентифікацію

Конфігурація

В конфігурації цієї дії прописується:

url — адреса на яку відправити запит, можна використовувати {{плейсхолдери}}
method — метод відправки запиту (GET, POST, PUT, PATCH, DELETE)
data — додаткові параметри для відправки, можуть містити плейсхолдери
headers — заголовки запиту
basic_auth — дані для Basic-автентифікації (необов'язково)
bearer_auth — токен для Bearer-автентифікації (необов'язково)

Можливі варіанти розгалуження подіями

"ok" — запит успішно виконано
"not_ok" — помилка при виконанні запиту

Приклади конфігурації

Приклад 1: Простий POST-запит

{
  "url": "https://your-service.com/api/webhook",
  "method": "POST",
  "data": {
    "data_source": "ConnectiveOne",
    "client_id": "{{messenger_input_param}}"
  },
  "headers": {
    "Content-Type": "application/json",
    "X-Custom-Header": "MyValue"
  }
}

Приклад 2: GET-запит з параметрами

{
  "url": "https://api.example.com/users?name={{user_name}}&email={{user_email}}",
  "method": "GET",
  "headers": {
    "Content-Type": "application/json"
  }
}

Приклад 3: POST-запит з Basic-автентифікацією

{
  "url": "https://api.example.com/secure",
  "method": "POST",
  "data": {
    "message": "{{user_message}}"
  },
  "basic_auth": {
    "login": "username",
    "pass": "password"
  }
}

Приклад 4: POST-запит з Bearer-токеном

{
  "url": "https://api.example.com/data",
  "method": "POST",
  "data": {
    "action": "update",
    "value": "{{some_value}}"
  },
  "bearer_auth": {
    "token": "{{api_token}}"
  },
  "headers": {
    "Content-Type": "application/json"
  }
}

Обробка помилок

Якщо запит завершився помилкою, дія повертає "not_ok". У сценарії можна обробити цю подію, щоб:

Повторної спроби
Відправки повідомлення користувачу
Логування помилки
Передачі до оператора

Обмеження

URL повинен бути доступним з сервера ConnectiveOne
Підтримуються тільки HTTP та HTTPS протоколи
Тайм-аут запиту залежить від налаштувань системи
Максимальний розмір даних обмежений налаштуваннями системи