Чатва
API: Контакты

Контакты

Обновлено 7 сентября 2026 г.

Контакт собирается из диалогов: имя из мессенджера или формы, телефон и почта из сбора контактов в виджете. Список удобно забирать в CRM, рассылки или аналитику.

GET /contacts

ПараметрТипОписание
channelqueryФильтр по каналу первого обращения
tagqueryФильтр по тегу
updatedSincequeryISO-дата: только изменённые после неё — для инкрементальной синхронизации
limitquery1–100, по умолчанию 50
cursorqueryкурсор следующей страницы

Ответ 200

{
  "items": [
    {
      "id": "ct_7731",
      "name": "Кира Мещерякова",
      "phone": null,
      "email": null,
      "channel": "telegram",
      "tags": ["доставка"],
      "dialogsCount": 4,
      "ratingAvg": 4.7,
      "firstSeenAt": "2026-08-21T09:12:00Z",
      "updatedAt": "2026-09-07T12:01:00Z"
    }
  ],
  "nextCursor": null
}

Для регулярной синхронизации с CRM храните время последнего запроса и передавайте его в updatedSince — будут приходить только изменившиеся контакты.