---
title: Обзор API Мой диалог
description: API Мой диалог — OMNI API, Broadcasts API и Recipients API. Эндпоинты, базовый URL, аутентификация, Swagger UI
---

> **For AI agents:** the complete documentation index is at [llms.txt](https://docs.mydialogi.ru/llms.txt). Append `.md` to any page URL for its markdown version.



> **Коротко:** Мой диалог предоставляет доступ к трём группам API — OMNI API для отправки сообщений, Broadcasts API для рассылок и Recipients API для управления получателями.

## Кому подходит

- Роль: Разработчик, Интегратор
- Уровень: Опытный

## Что такое API Мой диалог

Через API «Мой диалог» можно:

- Отправлять одиночные и массовые сообщения по всем каналам.
- Запускать каскадную отправку с автоматическим переключением между каналами.
- Управлять рассылками и их шаблонами.
- Работать с получателями: контактами, атрибутами, фильтрами, тегами.
- Получать баланс, список каналов, имена отправителей, EDR-записи.
- Работать с шаблонами сообщений и WhatsApp.


## Базовый URL

```
https://web.mydialogi.ru/api/v1
```

## Аутентификация

Заголовок `X-API-Key` с вашим API-ключом в каждом запросе.

**Как получить ключ:** [API-ключи](https://docs.mydialogi.ru/06-reference/01-api/api-keys).

<Note>
При создании ключа вы выбираете имена отправителей. От выбранных имён зависит, по каким каналам сможет отправлять ключ.
</Note>

## Три группы API

| API | Что делает | Доступен в «Мой диалог» |
|---|---|---|
| **OMNI API** | Отправка сообщений, работа с балансом, каналами, EDR, шаблонами | ✅ |
| **Broadcasts API** | Запуск рассылок, управление шаблонами рассылок | ✅ |
| **Recipients API** | Управление контактами, атрибутами, фильтрами, тегами | ✅ |

<Note>
Recipients API доступен только в сервисе Мой диалог. В OTP-кодах и Multi API его нет.
</Note>

## Карта интеграции

| Задача | Эндпоинт | Где читать |
|---|---|---|
| Отправить сообщение | `POST /messages` | [OMNI API](https://docs.mydialogi.ru/04-mydialogi/09-api/md-api-omni) |
| Отправить каскад | `POST /omnimessages` | [OMNI API](https://docs.mydialogi.ru/04-mydialogi/09-api/md-api-omni) |
| Запустить рассылку | `POST /broadcast/broadcasts` | [Broadcasts API](https://docs.mydialogi.ru/04-mydialogi/09-api/md-api-broadcasts) |
| Создать/обновить шаблон рассылки | `/broadcast/templates` | [Broadcasts API](https://docs.mydialogi.ru/04-mydialogi/09-api/md-api-broadcasts) |
| Управлять контактами | `/recipient/recipients` | [Recipients API](https://docs.mydialogi.ru/04-mydialogi/09-api/md-api-recipients) |
| Управлять атрибутами | `/recipient/attributes` | [Recipients API](https://docs.mydialogi.ru/04-mydialogi/09-api/md-api-recipients) |
| Фильтры и теги | `/recipient/filters`, `/recipient/tags` | [Recipients API](https://docs.mydialogi.ru/04-mydialogi/09-api/md-api-recipients) |
| Получить статусы | `GET /edrs` | [Статусы сообщений](https://docs.mydialogi.ru/04-mydialogi/09-api/md-api-statuses) |

## OMNI API — эндпоинты

| Метод | Эндпоинт | Для чего |
|---|---|---|
| POST | `/messages` | Отправка одного сообщения |
| POST | `/omnimessages` | Каскадная отправка |
| POST | `/messages/revoke` | Отозвать верификационное сообщение Telegram Gateway |
| POST | `/messages/verification` | Проверить статус верификации Telegram Gateway |
| GET | `/balance` | Баланс компании |
| GET | `/channels` | Список каналов, доступных компании |
| GET | `/edrs` | Записи о доставке сообщений |
| GET | `/senders` | Список имён отправителей компании |
| GET | `/templates` | Список шаблонов сообщений |
| GET | `/wa_templates` | Список шаблонов WhatsApp |

## Broadcasts API — эндпоинты

| Метод | Эндпоинт | Для чего |
|---|---|---|
| POST | `/broadcast/broadcasts` | Запуск рассылки |
| GET | `/broadcast/templates` | Список шаблонов рассылок |
| POST | `/broadcast/templates` | Создать шаблон рассылки |
| GET | `/broadcast/templates/{id}` | Детали шаблона рассылки |
| PUT | `/broadcast/templates/{id}` | Обновить шаблон рассылки |
| DELETE | `/broadcast/templates/{id}` | Удалить шаблон рассылки |

## Recipients API — эндпоинты

| Метод | Эндпоинт | Для чего |
|---|---|---|
| GET | `/recipient/recipients` | Список получателей |
| POST | `/recipient/recipients` | Создать получателя |
| PUT | `/recipient/recipients` | Обновить получателя |
| DELETE | `/recipient/recipients` | Удалить получателя |
| GET | `/recipient/attributes` | Список атрибутов |
| POST | `/recipient/attributes` | Создать атрибут |
| PUT | `/recipient/attributes/{id}` | Обновить атрибут |
| DELETE | `/recipient/attributes/{id}` | Удалить атрибут |
| GET | `/recipient/attributes/types` | Типы атрибутов |
| GET | `/recipient/filters` | Список фильтров (таргетов) |
| GET | `/recipient/tags` | Список тегов |

## Swagger UI

- <a href="https://web.mydialogi.ru/api/v1/swagger-ui/index.html?urls.primaryName=OMNI_API" target="_blank" rel="noopener noreferrer">OMNI API</a> — отправка сообщений, каскад
- <a href="https://web.mydialogi.ru/api/v1/swagger-ui/index.html?urls.primaryName=Broadcasts_API" target="_blank" rel="noopener noreferrer">Broadcasts API</a> — рассылки и шаблоны рассылок
- <a href="https://web.mydialogi.ru/api/v1/swagger-ui/index.html?urls.primaryName=Recipients_API" target="_blank" rel="noopener noreferrer">Recipients API</a> — контакты, атрибуты, фильтры, теги

<Note>
Полный список ссылок на Swagger UI для всех сервисов — в статье [Swagger UI](https://docs.mydialogi.ru/06-reference/01-api/api-swagger).
</Note>

## Что дальше

<Columns cols={2}>
  <Card title="Подключение к API" icon="plug" href="/04-mydialogi/09-api/md-api-connection">
    Аутентификация, базовый URL, формат запросов
  </Card>
  <Card title="OMNI API" icon="paper-plane" href="/04-mydialogi/09-api/md-api-omni">
    Отправка сообщений и шаблонов, каскад
  </Card>
  <Card title="Broadcasts API" icon="bullhorn" href="/04-mydialogi/09-api/md-api-broadcasts">
    Запуск рассылок, шаблоны рассылок
  </Card>
  <Card title="Recipients API" icon="users" href="/04-mydialogi/09-api/md-api-recipients">
    Контакты, атрибуты, фильтры, теги
  </Card>
</Columns>

## Нужна помощь?

- Мой диалог: support@mydialogi.ru