Аналитические методы:

Что делаетМетодЗапросСтруктура ответаОписание структуры
Метод возвращает данные по сделкам

GET https://домен/api/hs/extint/api/dealsprogress


header 'Authorization: токен базы

 

{
        "number": "000000000001",
        "date": "16.08.2024 20:41:33",
        "manager": "4Dev",
        "stage": "Взято в работу",
        "phone_number": "89499489944"
    }

number - номер сделки

date - Дата создания сделки

manager - Ответственный в сделке

stage - Текущий этап сделки

phone_number - Телефон клиента

Метод возвращает историю этапов по сделкам. Используются параметры

POST https://домен/api/hs/extint/api/timestamp


header 'Authorization: токен базы


{
    "date_from":"2026-03-04",
    "date_to":"2026-03-06",
    "deal_number":""
}

{
        "client": {
            "deal_number": "000000047204",
            "phone": "79990000000"
        },
        "status_history": [
            {
                "stage_name": "Новые обращения",
                "entry_time": "2026-03-04T09:18:32"
            },
            {
                "stage_name": "Взято в работу",
                "entry_time": "2026-03-04T09:27:37"
            },
            {
                "stage_name": "Закрыто",
                "entry_time": "2026-03-04T09:29:29"
            }
        ]
    }

Запрос:

date_from - Период От

date_to - Период По

deal_number - Номер сделки

Ответ:

deal_number - Номер сделки

phone - Телефон клиента

stage_name - Этап сделки

entry_time - Время перехода на этап


Доработанный метод Call для тг бота для агентов


https://wiki.4dev.app/x/HABvAQ

POST https://домен/api/hs/extint/call/main/




{"requestType":"cons_notice","typeform":"Бот TG КУ","dateTime":"1771329618","contacts":{"phone":"9009999999","name":"Петр","email":"","project":"Проект","city":"Город","agent":"Василий","agency":"Ложка дегтя"},"data":{"flatId":"","comment":"Агент: Вася агент, Тел: 89990000000","source":"Консультационное уведомление","chanell":"Агентский канал","yclid":"","utm":{"utm_source":"Консультационное уведомление","utm_medium":"Агентство недвижимости","utm_campaign":"ЖК","utm_content":"Ложка дегтя","utm_term":""}},"referer":{"url":"https://t.me/bot_bot","urlsite":""}}

 

200 OK

requestType - Тип запроса

typeform - Название формы

dateTime - Дата запроса

phone - Телефон клиента

name - Имя клиента

email - Почта клиента

project - Проект ЖК

city - Город

agent - Агент риелтор

agency - Агентство

flatId - ID объекта из Битрикса

comment - Комментарий

source - Источник интереса

chanell - Канал интереса

yclid - ID клиента из яндекс директа

utm_source - УТМ метка

utm_medium - УТМ метка

utm_campaign - УТМ метка

utm_content - УТМ метка

utm_term - УТМ метка

url - Сайт

urlsite - Страница сайта откуда отправлена заявка


Методы Calltouch


МетодСодержание запросаРасшифровка полейОписание метода
https://api.calltouch.ru/lead-service/v1/api/client-order/update

{
"orders": [
{
"statusDate": "05-03-2026 20:37:55", 
"updateDate": "05-03-2026 20:37:55",
"status": "Бронь",
"orderNumber": "c2d67824-188d-11f1-a2fe-005056b7a94b",
"requestId": "c2d67824-188d-11f1-a2fe-005056b7a94b",
"funnel": "Основная воронка",
"currency": "rub",
"revenue": "10230000",
"manager": "Тараканкова Анна Васильевна",
"products": [
{
"name": "Совушки Екатеринбург, ГП 33.1, Парадная 3, кв. №37"
}


"statusDate": "05-03-2026 20:37:55",  - Дата создания сделки

"updateDate": "05-03-2026 20:37:55", - Дата обновления этапа сделки

"status": "Бронь", - Статусы: Бронь/Договор/Свободно

"orderNumber": "c2d67824-188d-11f1-a2fe-005056b7a94b", - Номер сделки для системы Calltouch

"requestId": "c2d67824-188d-11f1-a2fe-005056b7a94b", - ID запроса для системы Calltouch

"funnel": "Основная воронка", - Текущая воронка из канбана 1С

"currency": "rub", - Вид валюты

"revenue": "10230000", - Выручка со сделке

"manager": "Тараканкова Анна Васильевна", - Ответственный в сделке

На данный метод 1С выгружает сделки (заявки)

https://домен/api/hs/extint/calltouch

leadtype=request&changedFields=null&requestId=7279652&requestNumber=7279652&subject=Zayavka s доменсайта.рф tilda&callerphone=79000000000&requestDate=2025-12-16 20:47:59&uniquerequest=true&targetrequest=target&uniqtargetrequest=uniqtarget&rating=0&tags_all=city,project&tags_auto_gr=null&tags_auto_ct=null&tags_auto_pn=null&

tags_manual=null&tags_api=Ekaterinburg,Sovushki&tags_request=null&tags_triggers=null&tags_xls=null&attribution=0&source=yapokupayu.ru&medium=referral&utm_source=<ne ukazano>&utm_medium=<ne ukazano>&utm_campaign=<ne ukazano>&utm_content=<ne ukazano>&utm_term=<ne ukazano>&yaClientId=1765907196280995037&sessionId=2231075956&ctClientId=800000001023371112&ctGlobalId=null&hostname=доменсайта.рф&url=https://доменсайта.рф/&attrs={}&requestUrl=доменсайта.рф/#form4&ref=https://www.yapokupayu.ru/&city=ufa&browser=Safari&os=iOS&device=smartphone&ip=Ipadress&orderId=null&siteId=11111&siteName=Сайт.рф&userAgent=Mozilla/5.0 (iPhone; CPU iPhone OS 16_6 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6 Mobile/15E148 Safari/604.1&sendingTimestamp=1765907280&manager=null

leadtype — тип обращения (например, request — заявка с формы или call - звонок)

changedFields — список полей, изменённых при обновлении заявки (null, если не использовалось)

requestId — уникальный системный идентификатор заявки

requestNumber — порядковый номер заявки для отображения менеджерам

subject — тема письма/уведомления (обычно содержит название сайта и платформы)

callerphone — телефон клиента в международном формате без + (например, 79150847937)

requestDate — дата и время создания заявки в формате ГГГГ-ММ-ДД ЧЧ:ММ:СС

uniquerequest — флаг уникальности заявки (true = новая, без дублей)

targetrequest — тип цели (target = целевое действие выполнено)

uniqtargetrequest — флаг уникальности целевого действия (uniqtarget = уникальная конверсия)

rating — рейтинг/приоритет лида (число, 0 — по умолчанию)

tags_all — все теги, применённые к заявке (город, проект)

tags_auto_gr — автоматические теги по группе/сегменту (null, если не задано)

tags_auto_ct — автоматические теги по городу (null, если не задано)

tags_auto_pn — автоматические теги по проекту/направлению (null, если не задано)

tags_manual — теги, добавленные вручную менеджером (null, если не было ручных правок)

tags_api — теги, переданные через интеграцию/API (например, Ekaterinburg,Sovushki)

tags_request — теги, сформированные на основе содержимого заявки (null, если не используется)

tags_triggers — теги, выставленные по триггерам/правилам (null, если не настроено)

tags_xls — теги, импортированные из Excel/внешних файлов (null, если не применялось)

attribution — тип атрибуции конверсии (0 — стандартная модель)

source — источник перехода: (direct) — прямой заход, yapokupayu.ru — реферал и т.д.

medium — тип канала трафика: (none), referral, cpc, organic и др.

utm_source — метка источника кампании (если передана в ссылке)

utm_medium — метка типа трафика (если передана)

utm_campaign — название рекламной кампании (если передана)

utm_content — метка креатива/объявления (если передана)

utm_term — ключевое слово или термин (если передана)

yaClientId — ID клиента в Яндекс.Метрике

sessionId — идентификатор текущей сессии пользователя на сайте

ctClientId — ID клиента в системе колл-трекинга

ctGlobalId — глобальный идентификатор звонка/клиента в колл-трекинге (null, если не задан)

hostname — домен сайта, с которого отправлена форма

url — полный URL страницы, на которой находилась форма

attrs — дополнительные атрибуты формы в формате JSON ({} — если пусто)

requestUrl — точный адрес, куда была отправлена форма (может включать якорь, например #form4)

ref — реферер: страница, с которой пользователь перешёл на форму (может быть пустым)

city — город, определённый по IP-адресу пользователя

browser — браузер клиента (например, Chrome, Safari)

os — операционная система устройства (Windows, iOS, Android)

device — тип устройства: desktop, smartphone, tablet

ip — IP-адрес пользователя (может быть маскирован в целях безопасности)

orderId — идентификатор заказа/сделки (заполняется при конвертации лида, null — если ещё не создан)

siteId — внутренний ID сайта в системе управления лидами

siteName — человеко-читаемое название сайта (например, domain-site.ru)

userAgent — полная строка User-Agent браузера (для определения устройства и ОС)

sendingTimestamp — Unix-timestamp момента отправки заявки (для синхронизации времени)

manager — логин или ID менеджера, за которым закреплена заявка (null — если ещё не распределена)

На данный метод 1С получает данные с Calltoch 

 

 


 


  • Нет меток