# Рассылка через VK Notify

VK Notify – это сервис от ВКонтакте для отправки по номеру телефона сервисных и транзакционных уведомлений.

* Сервисные уведомления – приходят от официальной группы компании (даже если пользователь не подписан на нее). Здесь пользователь может взаимодействовать с компанией и общаться с чат-ботом.
* Бизнес-уведомления – приходят в специальный бизнес-раздел ВКонтакте. Пользователь не может ответить, но точно знает, что это официальное сообщение от компании.

## Настройка интеграции

Для интеграции Fasttrack c VK Notify необходимо предоставить:

* `application` – идентификатор приложения;
* `signature_key` – токен для подписи запросов;
* `service` – канал отправки, содержащий список шаблонов;

Данные предоставляются вашему менежеру на стороне Fasttrack.

Все 3 параметра хранятся в вашем аккаунте VK Notify, который доступен по ссылке - <https://notify.mail.ru/self/>

Чтобы узнать `application` и `signature_key`, перейдите в настройки созданного сервиса, на вкладку \[ Доступы API ]:

<figure><img src="/files/O6PZD9jcOzJWylpm0TmM" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/muhf7aiSoP8lrzaJ7FWh" alt=""><figcaption></figcaption></figure>

Если у вас еще нет зарегистрированного приложения, то его необходимо создать. Используйте кнопку \[ + Добавить приложение ].

Все шаблоны в VK Notify регистрируются в рамках определенного "Сервиса" или канала отправки. Нам потребуется наименование вашего сервиса, чтобы иметь возможность отправлять шаблоны, которые с ним связаны.

Перейдите в раздел \[ Сервисы и шаблоны ]. Если сервиса еще нет, то его необходимо создать. Для этого в разделе есть кнопка \[ + Новый сервис ].

Название сервиса также нужно передать вашему менеджеру в Fasttrack.

## Регистрация шаблонов

Откройте раздел \[ Сервисы и шаблоны ]. Перейдите в сервис, чтобы открыть список шаблонов, связанных с этим сервисом.

Нажмите на кнопку \[ Шаблон по телефону ], чтобы открыть форму создания нового шаблона.

{% hint style="info" %}
Для отправки шаблонов VK Notify через Fasttrack используйте только шаблоны с текстом и переменными (без кнопок и вложений).
{% endhint %}

<figure><img src="/files/LG34C3LhemJpEcce3ove" alt=""><figcaption></figcaption></figure>

Введите название для нового шаблона и добавьте текст сообщения. Если необходимо, то вы можете использовать переменные в сообщении. Значение переменных может быть заполнено в момент отправки сообщения персонально для каждого получателя.

Если необходимо, чтобы у пользователя была возможность ответить на ваше сообщение, то не забудьте отметить галочку на против пункта \[ принимать от пользователей ответные сообщения ].

{% hint style="info" %}
Не заполняйте раздел Одноклассники. На текущий момент уведомления в одноклассники через VK Notify не поддерживается.
{% endhint %}

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

## Отправка уведомлений по телефону

Для отправки уведомлений по номеру телефона в VK через VK Notify необходимо воспользоваться API для каскадных рассылок в Fasttrack.

Пример запроса на создание каскадной рассылки через VK Notify:

```url
curl -i -X POST \
  https://cascades.fstrk.io/api/v1/transactions/async/ \
  -H 'api-key: <КЛЮЧ ДОСТУПА>' \
  -H 'Content-Type: application/json' \
  -d '{
    "phone_number": "<НОМЕР ТЕЛЕФОНА>",
    "routing": [
      "VK_NOTIFY"
    ],
    "vk_notify_template_name": "<НАЗВАНИЕ ШАБЛОНА>",
    "vk_notify_template_variables": {
      "v1": "<ЗНАЧЕНИЕ ПЕРЕМЕННОЙ>"
    },
    "waiting_time_route": 60
    "validity_period_seconds": 600,
    "tag": "nedozvon",
    "context": {
      "cascade": "nedozvon",
      "deal_id": "18547661"
    }
  }'
```

## Получение статусов в Mindbox

Для получения статусов отправленных уведолений в Mindbox, необходимо на стороне Mindbox настроить специальную операцию, которая будет принимать уведомления об изменении статуса.&#x20;

Когда, операцию будет настроена, предоставьте вашему менеджеру в Fasttrack следующую информацию:

* Название операции
* Точку интеграции
* Секретный ключ

Пример операции в MindBox для получения статуса каскадного сообщения:

```json
{
    "customerAction": {
        "customFields": {
            "cascade": "nedozvon",
            "deal_id": "18547661",
            "fasttackCascadeDetails": "<FasttackCascadeDetails>",
            "fasttackCascadeStatus": "<FasttackCascadeStatus>",
            "fasttrackDetailedStatus": "<Статус WhatsApp-сообщений>"
        }
    },
    "customer": {
        "ids": {
            "mindboxId": "<Id клиента в Mindbox>"
         },
        "mobilePhone": "<Мобильный телефон>"
    },
    "executionDateTimeUtc": "<Дата и время выполнения (можно использовать для выполнения запроса задним числом)>"
}
```


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.fstrk.io/knowledge_base/cascades/rassylka-cherez-vk-notify.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.