Перейти до основного вмісту
Дії

Надсилання даних дзвінка у вашу систему

Після кожного дзвінка надсилайте підсумок, транскрипт і зібрані дані у вашу CRM, вебхук або базу даних.

API-виклик після завершення дзвінка надсилає його у вашу власну систему — підсумок, транскрипт, настрій і все, що зібрав агент. За його допомогою можна створити ліда в CRM, запустити автоматизацію або вести власний облік. Якщо ваша система недоступна, запит повториться, і нічого не загубиться.

Налаштування​

  1. Додайте дію

    Відкрийте агента → Дії → Додати інструмент → Post call → API-виклик.

  2. Спрямуйте його на ваш ендпоінт
    ПолеЩо вказати
    Названаприклад, Синхронізація лідів із CRM
    УмоваКоли надсилати, наприклад, якщо абонент хоче купити. Порожньо — після кожного дзвінка
    URL API-ендпоінтуВаш ендпоінт, наприклад https://hooks.example.com/hanc
    HTTP-методPOST для більшості систем; працюють і GET, PUT, PATCH, DELETE
    Заголовки, Параметри запитуНеобов'язково, наприклад API-ключ
  3. Налаштуйте вигляд запиту (необов'язково)
    • Тіло (JSON) — ваші власні поля. Наберіть {{, щоб вставити змінну дзвінка, наприклад {"lead": "{{firstname}} {{lastname}}", "phone": "{{call_from}}"}.
    • Надсилати лише мої поля — не надсилає стандартні дані дзвінка; для системи, яка приймає лише свою структуру.
  4. Вирішіть, що робити в разі помилки
    • Повтори при помилці — паузи перед кожною новою спробою, якщо ваш ендпоінт відповідає не 2xx. За замовчуванням: 1 хв, 5 хв, 30 хв, 2 год, 6 год, 24 год, 48 год.
    • Сповіщення про збій — лист після останньої спроби (за замовчуванням), після кожної невдалої спроби або ніколи. Куди писати: порожньо — власнику акаунта.

Кнопка Що отримає мій сервер? у редакторі показує точний запит.

Що отримує ваш ендпоінт​

Для POST, PUT і PATCH — тіло JSON: ваші поля, об'єднані з полями дзвінка:

{
  "id": "6ac7ea6eca60c6024b465c70",
  "agent_id": "6ac2a93e36bad261cf088684",
  "call_from": "+431234567890",
  "call_to": "+439876543210",
  "direction": "inbound",
  "call_type": "phone",
  "call_status": "success",
  "start_timestamp": 1730000000000,
  "end_timestamp": 1730000187000,
  "duration": 187000,
  "transcription": [
    { "speaker": "agent", "content": "Hello…", "timestamp": 1730000001000 },
    { "speaker": "user", "content": "Hi…", "timestamp": 1730000003000 }
  ],
  "call_summary": "Customer asked about pricing…",
  "task_achieved": true,
  "sentiment": { "sentiment": "positive", "explanation": "…" },
  "custom_analysis_data": { "name": "John", "email": "john@example.com" },
  "collected_data": {},
  "transfer_history": [],
  "recording_url": "https://…",
  "disconnection_reason": "user_hangup",
  "is_anonymous": false,
  "is_simulation": false,
  "created_at": 1730000000000,
  "updated_at": 1730000187000
}

Для GET і DELETE ті самі поля передаються в рядку запиту, без вкладених (транскрипт, настрій, зібрані дані).

Кожен запит містить X-Hanc-Delivery-Id — однаковий в усіх спробах однієї доставки, щоб можна було відсіяти дублікати, — і X-Hanc-Attempt із номером спроби. Кожна спроба чекає на відповідь 30 секунд. Усі спроби видно в CRM → Комунікації, де невдалу доставку можна надіслати знову. Докладніше: Вебхуки та доставка.

Приклади використання​

  • Створити ліда або тікет у вашій CRM.
  • Запустити no-code-автоматизацію з даними дзвінка.
  • Вести власний архів дзвінків.
На цій сторінці