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

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

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

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

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

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

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

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

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

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

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

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

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

• Контакт — карточка любого, с кем имеет дело бизнес: клиента, поставщика, того, кто написал и ещё не разобран. У неё ровно одна категория.
• 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. Язык клиента берётся из его первых слов; то, что поставил человек, последующие сообщения не перезаписывают.