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

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

Відмінності від 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"
  }
}

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

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

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

Обмеження

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

Пов'язані статті