---
title: Карточка контакта (карточка клиента)
summary: Карточка — любой, с кем бизнес имеет дело: клиент, поставщик, человек, который ищет работу. Одна карточка на человека на весь бизнес.
tools: [talemo_find_contacts, talemo_get_contact, talemo_create_contact, talemo_update_contact]
related: [contact-points, contact-categories, contact-history, reminders-opt-out, notes-and-hidden-fields]
search: [профиль клиента, карточка клиента, запись в CRM]
---

# Карточка контакта

Карточка контакта описывает одного человека, с которым бизнес имеет дело.
Чаще всего это клиент, но карточкой может быть и поставщик, и партнёр, и
человек, который написал насчёт работы. Кто человек для бизнеса — это
категория карточки (см. [Категории контактов](contact-categories.md)).

## Что в карточке

- **Имя** (обязательно) и **фамилия**.
- **Контакты:** номера телефона, почта, WhatsApp, Instagram, Telegram (см.
  [Контакты карточки](contact-points.md)).
- **Одна категория.**
- **Заметка** для команды (см. [Заметка и закрытые поля](notes-and-hidden-fields.md)).
- **Язык.** На нём клиенту уходят подтверждения и напоминания о визитах. Пока
  язык пуст, они уходят на первом языке обслуживания бизнеса. Первые слова
  клиента заполняют пустой язык сами, если бизнес на этом языке обслуживает:
  кириллица даёт русский, латиница — английский; смайлики и цифры языка не дают, и карточка ждёт следующих слов.
  Если язык поставил или снял человек, входящие сообщения его больше не
  меняют. Выбрать можно только язык, на котором бизнес обслуживает.
- **Визиты коротко:** сколько состоялось, последний и ближайший.

## Одна карточка на весь бизнес

Карточка принадлежит бизнесу, а не филиалу. У клиента, который ходит в два
филиала, одна карточка, и филиалы список карточек не делят.

## Откуда берутся карточки

- Человек заводит её в **Контакты → Новый контакт**; категория обязательна.
- Её заводит переписка. Когда человек впервые пишет бизнесу и ни у одной
  карточки нет такого адреса, Talemo заводит карточку в **Не разобраны**, берёт
  имя из профиля мессенджера и добавляет адрес, с которого человек написал.
- Её заводит помощник или агент, подключённый по MCP, по просьбе человека.
- Её заводит запись: если на визит записывают нового клиента по имени и номеру и такого номера в контактах
  нет, Talemo заводит карточку клиента и записывает на неё (см. [Визиты](../booking/visits.md)). Есть —
  визит ложится на найденную карточку, второй не будет.

## Свои карточки

Роль можно ограничить своими карточками. Карточка своя, если у неё есть визит
на ресурс, которым работает сам человек: например, мастер видит только своих
клиентов. Такой человек видит в списке только свои карточки, а чужая
отвечает «не найдено». Под заголовком **Контакты** у него подпись «Ваши клиенты — те, кого вы принимаете», а колонки
**Как связаться** в списке нет, если роль не видит ни телефона, ни почты, ни мессенджеров. У новой карточки визитов ещё нет, поэтому она пока
ничья.

## Как найти карточку

Поиск берёт начало имени или фамилии, от трёх цифр номера, начало почты или
@имени. Список можно сузить до одной категории.

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

- Контакт — карточка любого, с кем имеет дело бизнес: клиента, поставщика, того, кто написал и ещё не разобран. У неё ровно одна категория.
- `talemo_find_contacts` ищет карточки по `q`: начало имени или фамилии, три и больше цифр номера или начало почты или @имени. `category` сужает поиск до одной категории. Чтобы получить ещё, `next` из ответа передают как `after`. Роль, которая держит только свои карточки, видит только их.
- `talemo_get_contact` показывает одну карточку по `party_id`: имя, категорию, заметку, язык, `opt_out` и адреса. Полей, которые роль закрывает, в ответе нет.
- `talemo_create_contact` требует `name` и `category`. Перед созданием найдите карточку: адрес, который уже есть у другой карточки бизнеса, отклоняется со статусом 409 и кодом `contact.taken`, и отказ не говорит, чья это карточка, поэтому найдите её по цифрам через `talemo_find_contacts` и пользуйтесь ею, а не заводите вторую. Номеру без `+` и без `00` нужна страна: статус 400, код `contact.country_required`.
- `talemo_update_contact` меняет имя, фамилию, заметку, язык или категорию; чего нет в запросе, остаётся. Язык — один из тех, на которых бизнес обслуживает клиентов, например `ru` или `en`, и на нём клиенту идут подтверждения и напоминания. Поле, которое роль закрывает, отклоняется с `role.field_forbidden`. Язык клиента берётся из его первых слов; то, что поставил человек, последующие сообщения не перезаписывают.