Профили клиентов и тикеты
Просматривайте и синхронизируйте профили клиентов, создавайте тикеты из вашей системы.
4.4 Профиль клиента
Сессии одного и того же клиента объединяются в один профиль клиента, на который указывает contact_id в сессии. Правила идентификации: подписанный вами ID участника (user_token или user.id, переданный через API) > пользователь канала (например, openid в WeChat) > веб-посетитель. После входа анонимный посетитель объединяется с профилем участника; два разных участника не объединяются автоматически — при совпадении email или телефона в бэк-офисе появляется только подсказка, и объединение выполняется вручную сотрудником поддержки.
| Метод | Путь | Описание |
|---|---|---|
| GET | /v1/contacts?user_id= или ?email= | Найти профиль клиента по вашему ID участника или email |
| GET | /v1/contacts/{id} | Профиль клиента: имя, email, телефон, теги tags, заметки notes, пользовательские поля attributes, число сессий, время последнего визита, ID участника user_ids |
| PATCH | /v1/contacts/{id} | Синхронизировать данные из вашей системы: name, phone, tags (не более 30), notes, attributes (полная замена, не более 30 полей). Передавайте только поля, которые нужно изменить |
4.5 Тикеты
| Метод | Путь | Описание |
|---|---|---|
| POST | /v1/tickets | Создать тикет, например из формы «Свяжитесь с нами» на сайте: subject, description, priority (urgent / high / normal / low), name / email / phone клиента, опционально привязать conversation_id или contact_id. При наличии email ответ поддержки отправится клиенту по почте |
| GET | /v1/tickets/{id} | Тикет и хронология (сообщения клиента, ответы поддержки, изменения статуса; без внутренних заметок) |
Статусы тикетов: open — ожидает обработки, pending — ожидает клиента, resolved — решён, closed — закрыт. Сроки обработки по приоритетам задаются в разделе «Настройки бота».
Эта страница была полезной?
Обновлено:
