---
metadata:
  - name: generator
    content: Diplodoc Platform v5.66.0
alternate:
  - https://yandex.ru/dev/dialogs/smart-home/doc/en/reference-alerts/resources-alerts.md
  - https://yandex.ru/dev/dialogs/smart-home/doc/ru/reference-alerts/resources-alerts.md
  - href: https://yandex.ru/dev/dialogs/smart-home/doc/ru/reference-alerts/resources-alerts.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.ru/dev/dialogs/smart-home/doc/ru/llms.txt?revision=r21995741
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/dialogs/smart-home/doc/ru/llms.txt?revision=r21995741

# Протокол работы сервиса уведомлений

<!-- source: ru/_includes/reusables/neuroexpert-button.md -->



<!-- endsource: ru/_includes/reusables/neuroexpert-button.md -->


Схему работы сервиса уведомлений см. в разделе [С чего начать](https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/alerts.md). Обязательные требования к отправке уведомлений — в разделе [Требования к уведомлениям](https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/notifications-requirements.md).

#|
||
**Метод**
|
**Ресурс**
|
**Описание**
||

||
[POST](https://yandex.ru/dev/dialogs/smart-home/doc/ru/reference-alerts/post-skill_id-callback-discovery.md)
|
`/api/v1/skills/{skill_id}/callback/discovery`
|
Уведомление об изменении параметров устройства (`/callback/discovery`)
||

||
[POST](https://yandex.ru/dev/dialogs/smart-home/doc/ru/reference-alerts/post-skill_id-callback-state.md)
|
`/api/v1/skills/{skill_id}/callback/state`
|
Уведомление об изменении состояния устройства (`/callback/state`)
||
|#



{% note info "Условие работы сервиса уведомлений" %}

Уведомления принимаются, если навык был опубликован хотя бы один раз, включая приватную публикацию. На черновике навыка, который ни разу не публиковали, сервис уведомлений не работает — отлаживайте отправку уведомлений на опубликованном навыке.

Рекомендуемый порядок:

1. [Приватная публикация](https://yandex.ru/dev/dialogs/smart-home/doc/ru/access.md) навыка.
1. [Проверка уведомлений](https://yandex.ru/dev/dialogs/smart-home/doc/ru/testing.md#self-check) на приватном навыке.
1. Перевод навыка в публичный и [модерация](https://yandex.ru/dev/dialogs/smart-home/doc/ru/publishing.md).

{% endnote %}


## Доступ и авторизация {#oauth}

{% note warning %}

Использовать API сервиса уведомлений можно только от имени пользователя Яндекса, который создал навык в Диалогах. Для этого нужно получить [OAuth-токен для Диалогов](https://oauth.yandex.ru/authorize?response_type=token&client_id=c473ca268cd749d3a8371351a8f2bcbd).

{% endnote %}

Хост для всех запросов к API:

```bash translate=no
https://dialogs.yandex.net
```

Полученный токен необходимо указывать в каждом запросе к API сервиса уведомлений, в заголовке `Authorization`:

```http translate=no
curl -i -X POST 'https://dialogs.yandex.net/api/v1/skills/user-test-skill/callback/state' \
-H 'Authorization: OAuth OUR_OAUTH_TOKEN' \
-H 'Content-Type: application/json' \
```


<!-- source: ru/_includes/about/id-support/support-button.md -->
[![Служба поддержки](../_images/support-image.svg)](https://yandex.ru/dev/dialogs/smart-home/doc/ru/feedback.md)
<!-- endsource: ru/_includes/about/id-support/support-button.md -->