---
title: API для «Мой диалог»
description: API «Мой диалог» — эндпоинты для сообщений, рассылок, получателей, диалогов
---

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

# API для «Мой диалог»

> **Коротко:** API «Мой диалог» позволяет отправлять сообщения, управлять рассылками, получателями и работать с диалогами. Те же эндпоинты, что у Multi API.

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

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

## Базовый URL

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

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

Заголовок X-API-Key с вашим ключом. Как получить ключ: [API-ключи](/06-reference/01-api/api-keys).

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

### OMNI API

Отправка сообщений через единый API.

| Эндпоинт | Метод | Для чего |
|---|---|---|
| /messages | POST | Отправка одного сообщения |
| /omnimessages | POST | Каскадная отправка |
| /balance | GET | Баланс компании |
| /channels | GET | Список каналов |
| /edrs | GET | Записи о доставке |
| /senders | GET | Список имён отправителей |
| /templates | GET | Шаблоны сообщений |
| /wa_templates | GET | Шаблоны WhatsApp |

### Broadcasts API

Управление рассылками.

### Recipients API

Управление получателями.

## Отличие от Multi API

API «Мой диалог» использует **те же эндпоинты**, что и Multi API. Различия:

- Домен — web.mydialogi.ru вместо web.multiapi.ru.
- В личном кабинете есть полный функционал — рассылки, контакты, диалоги, чат-боты.

## Формат запросов

Все запросы — POST или GET с заголовками:

- Content-Type: application/json
- X-API-Key: ваш-ключ

## Пример отправки сообщения

Эндпоинт: POST /messages

Параметры в теле:

- contact — номер получателя
- channel — номер канала
- senderId — имя отправителя
- payload — содержимое сообщения
- webhook — URL для статусов

## Ссылки на Swagger UI

- OMNI API: https://web.mydialogi.ru/api/v1/swagger-ui/index.html?urls.primaryName=OMNI_API
- Broadcasts API: https://web.mydialogi.ru/api/v1/swagger-ui/index.html?urls.primaryName=Broadcasts_API
- Recipients API: https://web.mydialogi.ru/api/v1/swagger-ui/index.html?urls.primaryName=Recipients_API

## См. также

- [Как создать API-ключ](/06-reference/01-api/api-keys)
- [Отправка шаблонов через Omni API](/04-mydialogi/06-assets/md-803-omni-api)
- [Вебхуки](/06-reference/01-api/api-webhooks)

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

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