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

У карточки может быть несколько адресов: номера телефона, почта, 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.