---
title: Телефон, почта и мессенджеры контакта
summary: Номера телефона, почта и мессенджеры карточки; какие из них подтверждены и какой основной — куда уходят напоминания.
tools: [talemo_add_contact_point, talemo_remove_contact_point, talemo_set_primary_contact, talemo_get_contact]
related: [contact-card, reminders-opt-out, contact-history]
search: [номер телефона, почта, ник в инстаграме]
---

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

У карточки может быть несколько адресов: номера телефона, почта, WhatsApp,
Instagram и Telegram.

## Номера телефона

У номера, который начинается с `+` или `00`, страну решает префикс. Номеру
без них нужна страна из списка, иначе он не принимается. Часовой пояс филиала
страну не решает. Talemo хранит номер в международном виде вместе со страной и
показывает его так, как номера пишут в этой стране. Имя в Instagram хранится
строчными без `@`; в Telegram подходит имя пользователя или номер.

## Один адрес — одна карточка

Адрес в бизнесе может быть только у одной карточки. Добавить адрес, который уже
есть у другой карточки, нельзя, и отказ не говорит, чья это карточка: для
человека, который видит только своих, это была бы утечка. Веб сам находит ту
карточку поиском по цифрам и предлагает её открыть. Если такой адрес уже есть
у этой же карточки, добавление просто возвращает его.

## Подтверждённые адреса

Адрес подтверждается только тогда, когда клиент с него пишет: номер WhatsApp
или имя в Instagram, с которых пришло сообщение бизнесу. Сотрудник не может
подтвердить адрес руками, и выгрузка переписки Instagram его тоже не
подтверждает. В карточке у каждого адреса видно: подтверждён (с датой, когда
клиент впервые писал отсюда) или ещё нет.

## Основной контакт

Подтверждения и напоминания о визитах уходят на основной контакт. Основным
может быть только подтверждённый адрес: так сообщение точно дойдёт.

- Первый подтвердившийся адрес становится основным, если основного у карточки
  нет.
- Если клиент писал с двух мест, основным остаётся первый; сменить его можно в
  окне **Куда отправлять напоминания?** в карточке.
- Если основной адрес убрали, основным становится подтверждённый адрес, с
  которого клиент писал последним.

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

- `talemo_add_contact_point` принимает `party_id`, `channel` (телефон, почта, WhatsApp, Telegram или Instagram) и `address`. Номеру телефона, WhatsApp или Telegram без `+` и без `00` нужна `country` — код ISO 3166-1, например `RU` или `DE`. Если вы её не знаете, спросите человека: часовой пояс филиала страну не называет, а +7 — и Россия, и Казахстан. Без неё вызов отклоняется с `contact.country_required`.
- Адрес, который уже есть у другой карточки бизнеса, отклоняется со статусом 409 и кодом `contact.taken`: найдите эту карточку по цифрам через `talemo_find_contacts`. Адрес, который у карточки уже есть, возвращается как есть.
- `talemo_remove_contact_point` убирает адрес, а в истории контакта остаётся строка о том, что он убран.
- `talemo_get_contact` показывает каждый адрес с `primary` и `confirmed_at`. Адрес WhatsApp или Instagram подтверждается, когда клиент с него пишет, и сотрудник не может подтвердить его руками. Первый подтверждённый становится основным, и именно на него идут напоминания о визите.
- `talemo_set_primary_contact` переносит основной на другой адрес, а основным может быть только подтверждённый: неподтверждённый отклоняется со статусом 409 и кодом `contact.unconfirmed`.