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

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

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

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

Базовый URL

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

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

Заголовок X-API-Key с вашим ключом. Как получить ключ: API-ключи.

Три группы 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

См. также

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

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