Типы матчингов в API методах

{
     "type": "leadContact",
     "leadContactParams": {
          "emails": ["name@server.com"],
          "phones": ["79157771122", "+7 (915) 888-11-22"],
          "date": "Дата и время лида",
          "tags": ["тег1","тег2"],
          "tagsLogic": "and",
          "leadTypeToMatch": "nearestUniq",
          "searchDepth": 262800
     }
}

...matching

.leadContactParams

...matching

.leadContactParams

.emails

Должен быть передан хотя бы один из параметров – phones, md5Phone, emails. Допустима передача сразу нескольких параметров, поиск будет идти по приоритету:
1) Поиск по phones.
2) Если не нашли, то поиск по md5Phones.
3) Если не нашли, то поиск по emails.

...matching

.leadContactParams

.phones

Можно перечислить несколько номеров телефонов (до 5 в одном параметре). Номера могут быть в любом формате, например 71234567890, +71234567890, 8 (123) 456-78-90.

...matching

.leadContactParams

.md5Phones

Можно перечислить несколько md5-хэшей номеров телефонов (до 5 в одном параметре). Хэши требуется передавать от номеров в формате +74953080100 (с плюсом вначале, далее номер в федеральном формате). При передаче хэшей от других форматов номеров телефонов поиск лида не сработает.

...matching

.leadContactParams

.searchAmongPhonesInText

Активация функционала поиска звонков по номерам телефонов распознанных в текстах звонков. Возможные значения:

• false - отключено (по умолчанию)
• true - включено.

При включении функционала поиска по номерам телефонов распознанных в тестах звонка поиск будет работать по следующей логике:

1) сначала будет совершен поиск по номерам звонящего в звонках.
2) если соответствий по пункту 1 не было найдено - то производится поиск по номерам распознанным в текстах звонков.

...matching

.leadContactParams

.withChats

Данный функционал доступен только в рамках API методов по сделкам.

Активация функционала поиска чатов по контактным данным. Возможные значения:

• false - отключено (по умолчанию)
• true - включено.

...matching

.leadContactParams

.date

Дата и время, относительно которой будет происходить поиск подходящего лида в прошлое на кол-во минут из параметра searchDepth. Формат: dd-mm-yyyy hh:mm:ss.

...matching

.leadContactParams

.tags

Если указан список тегов, то найденный лид перед склейкой будет дополнительно проверен на наличие указанных тегов. Лид считается подходящим для матчинга если его теги соответствуют указанным.

Фильтрация по тегам может передаваться вместе с типами call, request, chat, leadContact, callContact, requestContact, chatContact.

...matching

.leadContactParams

.tagsLogic

...matching

.leadContactParams

.leadTypeToMatch

Типы лидов, среди которых будет происходить поиск. Возможные значения:

• nearest - Любой ближайший лид
• nearestUniq - Ближайший уникальный лид
• nearestTarget - Ближайший целевой лид
• nearestUniqTarget - Ближайший уникально-целевой лид

...matching

.leadContactParams

.searchDepth

{
     "type": "requestContact",
     "requestContactParams": {
          "emails": ["name@server.com"],
          "phones": ["79157771122", "+7 (915) 888-11-22"],
          "date": "Дата и время заявки",
          "tags": ["тег1","тег2"],
          "tagsLogic": "and",
          "requestTypeToMatch": "nearestUniq",
          "searchDepth": 262800
     }
}

...matching

.requestContactParams

...matching

.requestContactParams

.emails

Должен быть передан хотя бы один из параметров – phones, md5Phone, emails. Допустима передача сразу нескольких параметров, поиск будет идти по приоритету:
1) Поиск по phones.
2) Если не нашли, то поиск по md5Phones.
3) Если не нашли, то поиск по emails.

...matching

.requestContactParams

.phones

Аналогично описанию из блока leadContactParams

...matching

.requestContactParams

.md5Phones

Аналогично описанию из блока leadContactParams

...matching

.requestContactParams

.date

Аналогично описанию из блока leadContactParams

...matching

.requestContactParams

.tags

...matching

.requestContactParams

.tagsLogic

...matching

.requestContactParams

.requestTypeToMatch

Аналогично описанию из блока leadContactParams

...matching

.requestContactParams

.searchDepth

{
     "type": "callContact",
     "callContactParams": {
          "phones": ["84953338877"],
          "date": "Дата и время звонка",
          "tags": ["тег1","тег2"],
          "tagsLogic": "and",
          "callTypeToMatch": "nearestUniq",
          "searchDepth": 262800
     }
}

...matching

.callContactParams

...matching

.callContactParams

.phones

...matching

.callContactParams

.md5phones

...matching

.callContactParams

.date

Аналогично описанию из блока leadContactParams

...matching

.callContactParams

.searchAmongPhonesInText

Аналогично описанию из блока leadContactParams

...matching

.callContactParams.tags

...matching

.callContactParams

.tagsLogic

...matching

.callContactParams

.callTypeToMatch

...matching

.callContactParams

.searchDepth

{
     "type": "chatContact",
     "chatContactParams": {
          "emails": ["name@server.com"],
          "phones": ["79157771122", "+7 (915) 888-11-22"],
          "waPhones": ["79999999999", "+7 (911) 222-33-44"],
          "tgIds": [123456],
          "tgUsernames": ["@username", "username"],
          "vkIds": [123456],
          "date": "Дата и время чата",
          "tags": ["тег1","тег2"],
          "tagsLogic": "and",
          "chatTypeToMatch": "nearestUniq",
          "searchDepth": 262800
     }
}

...matching

.chatContactParams

Данный тип матчинга доступен только в рамках API методов по сделкам.

Параметр поиска чата по номеру телефона / почте / телефону Whatsapp / ID Телеграм / username Телеграм / ID VK / дате.

...matching

.chatContactParams

.emails

Должен быть передан хотя бы один из параметров – phones, md5Phone, emails, waPhones, tgIds, tgUsernames, vkIds Допустима передача сразу нескольких параметров, поиск будет идти по приоритету:
1) Поиск по phones.
2) Если не нашли, то поиск по md5Phones.
3) Если не нашли, то поиск по emails.
4) Если не нашли, то поиск по waPhones.
5) Если не нашли, то поиск по tgIds.
6) Если не нашли, то поиск по vkIds.
7) Если не нашли, то поиск по tgUsernames.

...matching

.chatContactParams

.phones

Аналогично описанию из блока leadContactParams

...matching

.chatContactParams

.md5Phones

Аналогично описанию из блока leadContactParams

...matching

.chatContactParams

.waPhones

Телефон Whatsapp. Можно перечислить несколько номеров телефонов Whatsapp (до 5 в одном параметре). Номера могут быть в любом формате, например 71234567890, +71234567890, 8 (123) 456-78-90.

...matching

.chatContactParams

.tgIds

ID пользователя в Telegram. Можно перечислить несколько tgId (до 5 в одном параметре). Строка из цифр, максимум 20 символов в одном ID.

...matching

.chatContactParams

.tgUsernames

Username пользователя в Telegram. Можно перечислить несколько Username (до 5 в одном параметре). Формат: @username, username. Латинские буквы a-z, цифры 0-9, и нижнее подчеркивание. Минимум 3 символа. Максимальная длина 100 символов в одном tgUsernames (без учета @).

...matching

.chatContactParams

.vkIds

ID пользователя в VK. Можно перечислить несколько vkId (до 5 в одном параметре). Строка из цифр, максимум 20 символов в одном ID.

...matching

.chatContactParams

.date

Аналогично описанию из блока leadContactParams

...matching

.chatContactParams

.tags

...matching

.chatContactParams

.tagsLogic

...matching

.chatContactParams

.chatTypeToMatch

Аналогично описанию из блока leadContactParams

...matching

.chatContactParams

.searchDepth

{
     "type": "call",
     "callParams": {
          "callId": 12345
     }
}

...matching

.callParams

...matching

.callParams.callId

 ID звонка в Calltouch

...matching

.callParams.callReferenceId 

...matching

.callParams.sipCallId 

...matching

.callParams.tags

...matching

.callParams.tagsLogic

{
     "type": "request",
     "requestParams": {
          "requestNumber": 12345
     }
}

...matching

.requestParams

...matching

.requestParams.requestId

ID заявки в Calltouch

...matching

.requestParams.requestNumber 

...matching

.requestParams.tags

Аналогично описанию из блока leadContactParams

...matching

.requestParams.tagsLogic

{
     "type": "chat",
     "chatParams": {
          "chatId": 12345
     }
}

...matching

.chatParams

Данный тип матчинга доступен только в рамках API методов по сделкам.

Параметры поиска чата по ID

...matching

.chatParams.chatId

ID чата в Calltouch

...matching

.chatParams.tags

Аналогично описанию из блока leadContactParams

...matching

.chatParams.tagsLogic

{
     "type": "session",
     "sessionParams": {
          "sessionId": 1234567
     }
}

{
     "type": "customSources",
     "customSourceParams": {
          "source": "Произвольный источник",
          "medium": "Произвольный канал",
          "campaign": "Произвольная кампания",
          "content": "Произвольное объявление",
         "term": "Произвольная ключевая фраза"
     }
}

orders.matching

.customSourceParams

orders.matching

.customSourceParams

.source

orders.matching

.customSourceParams

.medium

orders.matching

.customSourceParams

.campaign

orders.matching

.customSourceParams

.content

orders.matching

.customSourceParams

.term

{
     "type": "withoutSource"
}