---
title: Категории контактов
summary: У каждой карточки одна категория — Клиенты, Не разобраны, Спам, категории набора вроде Поставщиков или свои категории бизнеса. От категории зависит, что Talemo делает с человеком.
tools: [talemo_list_contact_categories, talemo_create_contact_category, talemo_update_contact_category, talemo_remove_contact_category, talemo_categorize_contacts]
related: [contact-card, contact-history, notes-and-hidden-fields]
search: [сегменты, метки, поставщики, спам]
---

# Категории контактов

У каждой карточки ровно одна категория, и от неё зависит, что Talemo делает с
человеком: визиты и напоминания — для клиентов. Список категорий — часть
настройки бизнеса, как прайс.

## Три категории, которые есть у каждого бизнеса

- **Клиенты** — все, кто записывается. Запись карточки из «Не разобраны» сама
  переносит её в «Клиенты».
- **Не разобраны** — новый человек, которого ещё не узнали. Переписки кладут
  новых людей сюда, а отсюда человек относит каждого в его категорию.
- **Спам** — карточки хранятся, а не удаляются: попавшую сюда по ошибке можно
  вернуть. Перенос карточки в «Спам» закрывает открытые передачи
  онлайн-администратора по этому человеку без ответа. Переписки карточек из
  «Спама» не видят те, чьей роли закрыта категория карточки.

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

## Категории набора и свои

Установка отраслевого набора добавляет категории, которые нужны отрасли:
например, «Поставщики», «Ищут работу», «Партнёры». Бизнес может добавить свои,
переименовать любую категорию и убрать любую, кроме трёх выше.

## Порядок списка

«Клиенты» первыми и открыты по умолчанию, «Не разобраны» вторыми, дальше
категории набора и свои в том порядке, который задал бизнес, «Спам» последним.

## Как убрать категорию

Категория не удаляется, а убирается: история карточки называет её и потом.
Убирая категорию, человек выбирает, куда переедут её карточки, и сначала видит,
сколько их. Тому, кто видит только свои карточки или никакие, число не называется:
переезжают все карточки категории, в том числе чужие, и ему остаётся выбрать, куда.
У каждой перенесённой карточки в истории остаётся строка: кто перенёс и когда.

## Перенос карточек

Человек переносит в другую категорию одну карточку или до 500 сразу; каждый
перенос — строка в истории карточки.

## Кто что может

Список категорий со счётом карточек видит всякий, кто видит карточки. Заводить, переименовывать, переставлять и убирать категории — это
настройка бизнеса, поэтому это может только роль на весь бизнес.

## Инструменты и отказы

- `talemo_list_contact_categories` перечисляет категории по порядку с числом контактов в каждой. Системные — «клиенты», «не разобраны», «спам» — убрать нельзя. `name` пуст у категории, которая держит стандартное название. Новому контакту нужна категория, поэтому перед созданием посмотрите список.
- `talemo_create_contact_category` добавляет категорию в конец; название, которое занято другой категорией, отклоняется с `record.duplicate`. `talemo_update_contact_category` переименовывает категорию или двигает её по списку (`position`); системную можно переименовать, но место она сохраняет.
- `talemo_remove_contact_category` переносит её контакты в `move_to` тем же шагом, и у каждого остаётся строка в истории. Системная категория отклоняется со статусом 409 и кодом `party_category.system`. Вызов меняет много сразу, поэтому сначала `dry_run`: в ответе `moved` — число контактов, которые переедут, но только у роли, которая видит все контакты. У роли, которая видит только свои контакты или никакие, поля `moved` нет: в категории могут быть контакты, которых она не видит, а переезжают все, поэтому `move_to` всё равно нужно назвать. Покажите человеку, и настоящий вызов — только когда он скажет «да».
- `talemo_categorize_contacts` переносит несколько контактов (`parties`) в одну `category`, всё или ничего, и возвращает, сколько сменило категорию; уже лежавшие в ней не считаются. Он тоже меняет много сразу: сначала `dry_run`.
- Запись визита на контакт из категории «Не разобраны» делает его клиентом; отдельный вызов не нужен.