Перейти к основному содержимому
Действия

Отправка данных звонка в вашу систему

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

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

Настройка​

  1. Добавьте действие

    Откройте агента → Действия → Добавить инструмент → Post call → API-вызов.

  2. Направьте его на ваш эндпоинт
    ПолеЧто указать
    Названиенапример, Синхронизация лидов с CRM
    УсловиеКогда отправлять, например, если звонящий хочет купить. Пусто — после каждого звонка
    URL API-эндпоинтаВаш эндпоинт, например https://hooks.example.com/hanc
    HTTP-методPOST для большинства систем; работают и GET, PUT, PATCH, DELETE
    Заголовки, Query-параметрыНеобязательно, например 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-автоматизацию с данными звонка.
  • Вести собственный архив звонков.
На этой странице