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

У каждой карточки ровно одна категория, и от неё зависит, что 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.
• Запись визита на контакт из категории «Не разобраны» делает его клиентом; отдельный вызов не нужен.