---
title: Как создать API-ключ
description: Получение API-ключа для интеграции с «Мой диалог» — через раздел 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-ключ — ваш пропуск для интеграции с «Мой диалог». Создаётся в личном кабинете за 1 минуту.

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

- Роль: Разработчик, Клиент
- Уровень: Новичок

## Что вы получите

API-ключ для отправки запросов в «Мой диалог».

## Перед началом

- [ ] У вас есть доступ к личному кабинету «Мой диалог».
- [ ] Вы знаете, какие права нужны для вашей интеграции.

## Шаги

### Шаг 1. Откройте раздел «API Подключения»

В левом меню: API Подключения.

### Шаг 2. Нажмите «Создать API подключение»

Кнопка в правом верхнем углу.

### Шаг 3. Заполните форму

| Поле | Что указать |
|---|---|
| Название | Понятное имя, например «Тестовый ключ» |
| Вебхук | URL, куда будут отправляться статусы (необязательно) |
| Права доступа | Выберите нужные права |

### Шаг 4. Выберите права доступа

| Право | Для чего |
|---|---|
| omni-api | Отправка сообщений, проверка статусов |
| statistics | Доступ к статистике и EDR |
| recipients | Управление получателями |
| broadcasts | Управление рассылками |
| dids | Управление DID-номерами |
| crm | Интеграция с CRM |

### Шаг 5. Выберите имена отправителей

Укажите, для каких имён отправителей будет действовать этот ключ.

### Шаг 6. Нажмите «Получить API ключ»

### Шаг 7. Скопируйте ключ

Важно: ключ показывается только один раз. Сохраните его в надёжном месте.

## Как использовать

Ключ передаётся в заголовке X-API-Key в каждом запросе.

Формат заголовка:
X-API-Key: ваш-ключ

## Результат

API-ключ создан. Вы можете использовать его для интеграции с «Мой диалог».

## Управление ключом

| Действие | Что делает |
|---|---|
| Просмотр | Показывает название, права, вебхук |
| Редактирование | Изменяет права, вебхук, имена отправителей |
| Удаление | Отзывает ключ — все запросы с ним перестанут работать |

Совет: создавайте отдельный ключ для каждого окружения (тест, продакшн) и для каждого приложения.

## Частые проблемы

| Симптом | Причина | Решение |
|---|---|---|
| Ключ не показывается | Уже создан, но потерян | Создайте новый, удалите старый |
| 401 Unauthorized | Неверный ключ | Проверьте X-API-Key |
| 403 Forbidden | Нет нужного права | Отредактируйте ключ, добавьте право |
| Вебхук не работает | Неверный URL | Проверьте доступность URL |

## См. также

- [Отправьте первую рассылку](/04-mydialogi/01-for-developers/md-303-first-broadcast)
- [Отправка шаблонов через Omni API](/04-mydialogi/06-assets/md-803-omni-api)
- [Обработка ошибок API](/06-reference/03-troubleshooting/ts-api-http-codes)

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

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