> For the complete documentation index, see [llms.txt](https://doc.nextbot.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.nextbot.ru/functional/integrations/yclients/uvedomleniya-v-whatsapp-i-max-pri-sozdanii-udalenii-zapisi-v-yclients.md).

# Уведомления в WhatsApp и Max при создании/переносе/удалении записи в YCLIENTS

Автоматическая отправка агентом сообщения по номеру телефона клиента в каналы связи WhatsApp/Max при создании/переносе/удалении записи вручную в интерфейсе YClients.

{% hint style="info" %}
Для включения этой опции у агента должна быть подключена интеграция YClients и хотя бы один из двух мессенджеров: WhatsApp или Max.
{% endhint %}

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

Когда в YClients создают, переносят или удаляют запись, сервис передаёт данные о событии в Nextbot через webhook. Nextbot обрабатывает событие и отправляет клиенту сообщение в формате, выбранном на странице интеграции:

* **«Стандартное сообщение»** — заранее подготовленный шаблон, в который подставляются данные записи с помощью переменных;
* **«Инструкция для ИИ»** — ИИ сам составляет сообщение по вашей инструкции и данным записи.

Пример: администратор добавляет запись в журналYClients → Nextbot получает событие через webhook → клиент получает сообщение о записи в WhatsApp и/или Max.

### Куда придёт сообщение

Для записей, созданных вручную в интерфейсе YClients, Nextbot находит клиента по номеру телефона. Поэтому сообщения по таким записям отправляются только в WhatsApp и Max:

* если к агенту подключён один из этих мессенджеров, сообщение придёт только в него;
* если подключены оба, сообщение придёт и в WhatsApp, и в Max.

Если запись создал ИИ-агент в переписке, а администратор удалил её в YClients, сообщение об удалении придёт в тот же диалог — в любом мессенджере. Подробнее — в разделе «Удаление записи».

### Как подключить webhook

1. В Nextbot откройте **Интеграции →** **YClients** и в блоке **«Уведомления»** скопируйте ссылку **Webhook URL**.
2. В YClients перейдите в раздел **«Мои приложения»**.
3. Откройте **«Настройки подключения»**.
4. Вставьте ссылку в поле **«Адрес, на который отправлять уведомления»**.
5. Нажмите **«Сохранить»** внизу страницы.

{% hint style="warning" %}
Важно: если интеграция уже была подключена ранее, после добавления webhook-ссылки в YClients необходимо обязательно переподключить интеграцию в интерфейсе Nextbot.
{% endhint %}

### 1. Новая запись

Сообщение отправляется, когда администратор добавляет запись в интерфейсе YClients.

1. В блоке **«Новая запись»** включите **«Отправить сообщение при добавлении записи в интерфейсе YClients»**.
2. В поле **«Формат»** выберите **«Стандартное сообщение»** или **«Инструкция для ИИ»**.
3. Напишите текст сообщения или инструкцию. Список переменных — в разделе «Переменные».

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FcHi9f6tuewt4dMYlQzGg%2Fnextbot-yclients-new-record-flow.svg?alt=media&amp;token=b4366f60-e19d-4d08-b0ec-dacaeb645aab" alt=""><figcaption></figcaption></figure>

Пример стандартного сообщения:

```
Здравствуйте, {{yclientsClientName}}!
Ваша запись успешно создана ✅
Дата: {{yclientsBookingDate}}
Время: {{yclientsBookingTime}}
Специалист: {{yclientsSpecialist}}
Услуга: {{yclientsServices}}
Номер записи: {{yclientsRecordId}}
```

**Последующие сообщения**

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

Также последующие сообщения нужны для уведомления о переносе — подробнее в разделе «Перенос записи».

1. Включите **«Отправить напоминание или запросить обратную связь»**.
2. Настройте сообщение:
   * **«Тип сообщения»** — готовый текст или инструкция для ИИ;
   * **«Когда отправить»** — относительно времени записи или в точное время со сдвигом по дням;
   * **«Смещение в минутах»** — на сколько минут раньше или позже времени записи отправить сообщение: отрицательное значение — до записи, положительное — после;
   * **«Текст сообщения»** — текст с переменными.
3. Чтобы добавить ещё одно сообщение, нажмите **«Добавить сообщение»**.

Примеры смещения:

* `-1440` — за сутки до записи;
* `-60` — за час до записи;
* `180` — через 3 часа после времени записи.

Пример напоминания:

```
{{yclientsClientName}}, напоминаем: {{yclientsBookingDate}} в {{yclientsBookingTime}} у вас запись на {{yclientsServices}} к специалисту {{yclientsSpecialist}}. Ждём вас!
```

### 2. Перенос записи

Сообщение о переносе отправляется, когда администратор меняет дату или время записи в интерфейсе YClients. В текст можно подставить прежние и новые дату и время — клиент сразу увидит, что изменилось.

{% hint style="info" %}
**Сначала настройте последующие сообщения в блоке «Новая запись».** Nextbot определяет перенос по запланированным последующим сообщениям: без них перенос не распознаётся и уведомление не отправляется.
{% endhint %}

**Когда клиент получит сообщение**

Уведомление о переносе придёт, если выполнены все условия:

1. Запись создана вручную в интерфейсе YClients.
2. Клиент получил сообщение о новой записи, и по записи запланированы последующие сообщения.
3. Администратор изменил в журнале дату или время записи.

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

1. В блоке **«Перенос записи»** включите **«Отправить сообщение при переносе записи в интерфейсе YClients»**.
2. В поле **«Формат»** выберите **«Стандартное сообщение»** или **«Инструкция для ИИ»**.
3. Напишите текст сообщения или инструкцию. Прежние дата и время подставляются переменными `{{yclientsOldBookingDate}}` и `{{yclientsOldBookingTime}}`, новые — `{{yclientsBookingDate}}` и `{{yclientsBookingTime}}`.

Пример стандартного сообщения:

```
Здравствуйте, {{yclientsClientName}}!
Ваша запись была перенесена 🔄
Было: {{yclientsOldBookingDate}} в {{yclientsOldBookingTime}}
Стало: {{yclientsBookingDate}} в {{yclientsBookingTime}}
Специалист: {{yclientsSpecialist}}
Услуга: {{yclientsServices}}
Номер записи: {{yclientsRecordId}}
```

Пример инструкции для ИИ:

```
Сообщи клиенту, что его запись перенесли. Назови новые дату и время, услугу и специалиста. Пиши коротко и дружелюбно. Если новое время неудобно, предложи ответить на это сообщение, чтобы подобрать другое.
```

### 3. Удаление записи

Сообщение отправляется, когда администратор удаляет запись в интерфейсе YClients.

1. В блоке **«Удаление записи»** включите **«Отправить сообщение при удалении записи в интерфейсе YClients»**.
2. В поле **«Формат»** выберите **«Стандартное сообщение»** или **«Инструкция для ИИ»**.
3. Напишите текст сообщения или инструкцию.

Пример стандартного сообщения:

```
Здравствуйте, {{yclientsClientName}}!
Ваша запись отменена.
Дата записи: {{yclientsBookingDate}}
Время: {{yclientsBookingTime}}
Специалист: {{yclientsSpecialist}}
Услуга: {{yclientsServices}}
Номер записи: {{yclientsRecordId}}
```

Куда придёт сообщение об удалении, зависит от того, как создавалась запись:

* **вручную в интерфейсе YClients** — в WhatsApp и/или Max по номеру телефона клиента;
* **ИИ-агентом в переписке** — в тот же диалог, где клиент записывался, независимо от мессенджера. Например, если клиент записался через Telegram, сообщение придёт в Telegram.

{% hint style="info" %}
Если запись по просьбе клиента удалил сам ИИ-агент (действие «Удалить событие»), повторное сообщение не отправляется: клиент уже обсудил отмену с агентом в диалоге.
{% endhint %}

### Переменные

Переменные подставляют в текст данные конкретной записи. Впишите переменную в двойных фигурных скобках или нажмите на неё в списке **«Доступные переменные»** под полем.

<table data-search="false"><thead><tr><th>Переменная</th><th>Что подставляется</th><th>Где доступна</th></tr></thead><tbody><tr><td><code>{{yclientsClientName}}</code></td><td>Имя клиента</td><td>Во всех сообщениях</td></tr><tr><td><code>{{yclientsBookingDate}}</code></td><td>Дата записи. В сообщении о переносе — новая дата</td><td>Во всех сообщениях</td></tr><tr><td><code>{{yclientsBookingTime}}</code></td><td>Время записи. В сообщении о переносе — новое время</td><td>Во всех сообщениях</td></tr><tr><td><code>{{yclientsSpecialist}}</code></td><td>Специалист</td><td>Во всех сообщениях</td></tr><tr><td><code>{{yclientsServices}}</code></td><td>Услуги из записи</td><td>Во всех сообщениях</td></tr><tr><td><code>{{yclientsRecordId}}</code></td><td>Номер записи в YClients</td><td>Во всех сообщениях</td></tr><tr><td><code>{{yclientsOldBookingDate}}</code></td><td>Дата записи до переноса</td><td>Только в сообщении о переносе</td></tr><tr><td><code>{{yclientsOldBookingTime}}</code></td><td>Время записи до переноса</td><td>Только в сообщении о переносе</td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://doc.nextbot.ru/functional/integrations/yclients/uvedomleniya-v-whatsapp-i-max-pri-sozdanii-udalenii-zapisi-v-yclients.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
