Пометить чат непрочитанным (GrayAPI)

Как ИИ-ассистент возвращает важный диалог в непрочитанные на Авито через GrayAPI: условия, настройка, примеры и отличия от настройки чат-бота и автоматизации.

Функция «Пометить чат непрочитанным (GrayAPI)» возвращает диалог в непрочитанные на Авито — через 10 секунд после того, как ИИ-ассистент её вызвал.

Зачем это нужно: когда ассистент отвечает клиенту, чат на Авито становится прочитанным. Если ваши менеджеры работают в приложении или на сайте Авито и смотрят на непрочитанные чаты, они могут пропустить диалог, где клиент уже готов купить или ждёт живого человека. Функция снова выделяет такой чат.

Что нужно для работы

  • Аккаунт Авито подключён через GrayAPI: в списке аккаунтов рядом с ним есть значок GRAYAPI. Как подключить — в статье Интеграция.

  • В разделе «Сообщения → Настройки» в блоке «GrayApi» заполнено поле «Токен доступа».

  • Тариф с ИИ-ассистентами: «Продвинутый», «Продвинутый + Вакансии», «Максимальный» или «Бизнес».

Функция работает только в диалогах Авито. Если одно из условий не выполнено, она просто ничего не делает — ошибок в диалоге не будет.

Где находится

«Сообщения → ИИ ассистенты» → нажмите на название ассистента → вкладка «Функционал» → блок «Конструктор функций» → кнопка «Открыть». В списке функций слева выберите «Пометить чат непрочитанным (GrayAPI)».

Настройка функции «Пометить чат непрочитанным (GrayAPI)» в конструкторе ИИ-ассистента

Как настроить

  1. Откройте ассистента и перейдите на вкладку «Функционал».

  2. В блоке «Конструктор функций» нажмите «Открыть».

  3. Отметьте галочкой «Пометить чат непрочитанным (GrayAPI)» и нажмите на её название.

  4. Заполните «Триггер вызова функции» — единственное поле функции. По умолчанию там написано: «Когда нужно вернуть диалог в непрочитанные на Авито, например после передачи менеджеру или если клиент не ответил». Лучше заменить его на конкретную ситуацию из вашего бизнеса.

  5. Нажмите «Применить функции». В поле «Дополнительные настройки» появится команда вида:
    Когда клиент просит связаться с менеджером, то вызови функцию "Пометить чат непрочитанным (GrayAPI)".

  6. Сохраните ассистента кнопкой «Сохранить изменения».

Как это работает

  • Когда срабатывает триггер, ИИ вызывает функцию, и через 10 секунд сервис через GrayAPI помечает диалог непрочитанным на Авито. Изменить задержку в функции нельзя.

  • Клиенту ничего не отправляется, ассистент продолжает работать в диалоге как обычно. Если после передачи менеджеру бот должен замолчать, дополнительно вызовите функцию «Остановить бота».

Как сервис понимает, что функция подключена

При сохранении ассистента сервис ищет в тексте промта (без учёта регистра) любое из слов: непрочитанным, grayapi, markUnreadChat, "MarkUnreadChatFnc". Если слово найдено — функция подключается.

Эти слова короткие и общие, поэтому функция может подключиться случайно. Например, фраза «не оставляй сообщения непрочитанными» или любое упоминание GrayAPI в промте тоже её подключат. Если функция вам не нужна, уберите такие слова из промта. Надёжнее всего добавлять функцию через «Конструктор функций».

Функция, настройка чат-бота или автоматизация?

Пометить чат непрочитанным можно тремя способами:

Способ

Когда срабатывает

Где настроить

Функция ИИ-ассистента

Только в ситуации из триггера, через 10 секунд после вызова

«Конструктор функций» ассистента

«Пометить непрочитанным» в чат-боте

После каждого ответа бота, через 10 секунд

Форма чат-бота, см. Добавление авто-ответа чат-бота

Действие «Пометить чат непрочитанным (GrayAPI)»

По событию (например, нет ответа оператора), задержку можно указать в поле «Задержка (сек)»

Автоматизация по событиям с GrayAPI

Функция подходит, когда выделять нужно не все диалоги, а только важные: где клиент готов купить, недоволен или ждёт менеджера.

Примеры

Горячий клиент. Салон мебели: ассистент консультирует, а оформляет заказ менеджер в приложении Авито.

Код
Когда клиент подтвердил, что готов купить или оформить заказ, то вызови функцию "Пометить чат непрочитанным (GrayAPI)".

Клиент просит менеджера. Вместе с уведомлением в Telegram и остановкой бота.

Код
Если клиент просит связать его с менеджером, то вызови функцию "Отправить в телеграм" с нужными параметрами: Шаблон сообщения: краткую выжимку из диалога. Затем вызови функцию "Остановить бота" и функцию "Пометить чат непрочитанным (GrayAPI)".

Недовольный клиент. Интернет-магазин: жалобы менеджер разбирает сам.

Код
Если клиент жалуется на товар, доставку или просит вернуть деньги, то вызови функцию "Пометить чат непрочитанным (GrayAPI)".

Частые вопросы

  • Чат не стал непрочитанным. Проверьте, что у аккаунта в списке аккаунтов есть значок GRAYAPI, в «Сообщения → Настройки» заполнен «Токен доступа», а аккаунт в GrayAPI активен и баланс там положительный.

  • Чат стал непрочитанным, а потом снова прочитанным. Любой ответ в диалоге — бота или ваш — снова помечает чат прочитанным. Функция срабатывает через 10 секунд после вызова, а не после отправки ответа бота, поэтому если ответ ушёл позже, чат может снова стать прочитанным.

  • Во вкладке «Тестирование» ничего не происходит. Тест идёт без реального диалога на Авито, поэтому пометка не ставится. Проверьте работу на реальном диалоге.

  • Функция подключилась, хотя я её не добавлял. В промте есть одно из слов, по которым сервис её находит, — см. блок «Как сервис понимает, что функция подключена».

См. также: Поддерживаемые функции, Интеграция, Возможности, Автоматизация по событиям с GrayAPI, Остановить бота, Отправить в телеграм, Настройки.

Инструкция помогла?

Помощник

Задайте вопрос по документации. Вопросы без ответа используются для улучшения помощи.

Ищу ответ…

Подготовить обращение

Открыть контакт
Отправьте подготовленный текст самостоятельно в выбранном канале.