---
title: Быстрый старт для тестировщика
description: Первое сообщение через Multi API — имя отправителя, ключ, отправка через curl
---
> **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.
> **Коротко:** за 10–15 минут вы получите API-ключ и отправите первое сообщение через Multi API.
## Кому подходит
- Роль: Клиент, Разработчик
- Уровень: Новичок / Опытный
## Что это
Пошаговая инструкция для быстрого запуска Multi API. К концу страницы у вас будет:
- ✅ Зарегистрированное имя отправителя
- ✅ API-ключ для интеграции
- ✅ Первое отправленное сообщение со статусом доставки
**Если вы уже зарегистрированы** — переходите к шагам ниже.
**Если вы ещё не зарегистрированы** — сначала:
1. [Как зарегистрироваться в Multi API →](https://docs.mydialogi.ru/03-multiapi/00-start-here/mapi-003-register)
2. [Первый вход в Multi API →](https://docs.mydialogi.ru/03-multiapi/00-start-here/mapi-004-login)
**Тестовое подключение** — договор не требуется, мы предоставляем баланс для тестирования. Для продолжения работы после теста — запросите договор через поддержку сервиса.
## Перед началом
- [ ] Вы зарегистрированы в Multi API.
- [ ] Вы вошли в личный кабинет.
- [ ] У вас есть номер телефона получателя.
## Шаги
### 1. Зарегистрируйте имя отправителя
**Без имени отправителя отправить сообщение нельзя.** Это обязательный шаг.
1. В левом меню: **Активы** → **Имена отправителей**.
2. Нажмите **«Добавить имя отправителя»**.
3. Выберите канал (например, SMS).
4. Укажите отображаемое название.
5. Нажмите **«Отправить заявку»**.
**В тестовом режиме** документы не нужны — регистрация занимает до 1 дня. Дождитесь статуса **«Активно»** — без одобрения имени отправка невозможна.
[Как зарегистрировать имя отправителя в Multi API →](https://docs.mydialogi.ru/03-multiapi/01-for-developers/mapi-301-sender-id)
### 2. Получите API-ключ
1. В левом меню: **API Подключения**.
2. Нажмите **«Создать API подключение»**.
3. Укажите название (например, «Тестовый ключ»).
4. В блоке **«Права доступа»** выберите из списка:
- `omni-api` — для отправки сообщений.
- `statistics` — для просмотра статистики.
5. В блоке **«Имена отправителей»** выберите из списка нужное имя — для канала, по которому будете отправлять.
6. Нажмите **«Получить API ключ»**.
7. **Скопируйте ключ и сохраните его** — он показывается только один раз.
**Какие каналы будут доступны ключу — зависит от выбранных имён отправителей.**
У каждого имени отправителя есть свой канал. Чтобы ключ мог отправлять по SMS — выберите имя для SMS. Чтобы по SMS и WhatsApp — выберите два имени. Каналы не выбираются напрямую — они определяются именами отправителей.
[Как зарегистрировать имя отправителя в Multi API →](https://docs.mydialogi.ru/03-multiapi/01-for-developers/mapi-301-sender-id)
[Подробнее: Как создать API-ключ →](https://docs.mydialogi.ru/06-reference/01-api/api-keys)
### 3. Отправьте первое сообщение
**Адрес запроса:**
```
POST https://web.multiapi.ru/api/v1/messages
```
**Заголовки:**
- `Content-Type: application/json`
- `X-API-Key: ВАШ_API_КЛЮЧ`
**Тело запроса (JSON):**
```json
{
"contact": "79123456789",
"channel": 1,
"senderId": "ВАШ_ОТПРАВИТЕЛЬ",
"payload": {
"text": "Привет! Это тестовое сообщение."
}
}
```
**Замените три значения на свои:**
- `ВАШ_API_КЛЮЧ` — на ключ из шага 2.
- `79123456789` — на номер получателя.
- `ВАШ_ОТПРАВИТЕЛЬ` — на имя из шага 1.
**`contact`** указывается в международном формате, без знака `+`. Например, для России: `79123456789`.
**`channel: 1` — это SMS.** Полный список каналов — в обзоре.
[Подробнее: Отправка сообщений через OMNI API →](https://docs.mydialogi.ru/03-multiapi/02-api/mapi-103-omni-api)
### 4. Проверьте статус
Статус отправленного сообщения можно посмотреть двумя способами.
### В личном кабинете
Откройте **Статистика** → **Записи сообщений (EDR)**. Найдите ваше сообщение по номеру получателя и проверьте статус: **Доставлено** или **Отправлено**.
### В своей программе
Статус приходит в вашу программу двумя способами:
- **Push (вебхук)** — платформа сама отправляет статус на ваш URL.
- **Pull (запрос к API)** — вы запрашиваете статусы через `GET /edrs`.
Оба способа получения статусов в вашу программу — push и pull — подробно описаны в статье [Статусы сообщений →](https://docs.mydialogi.ru/03-multiapi/02-api/mapi-106-api-statuses).
## Результат
Вы отправили первое сообщение через Multi API и увидели статус доставки.
**Дальше:** [Карта интеграции Multi API →](https://docs.mydialogi.ru/03-multiapi/02-api/mapi-110-product-map) — что вызывать и в каком порядке.
## Частые проблемы
### Имя отправителя не одобрено
**Причина:** имя ещё в обработке.
**Решение:** дождитесь статуса **«Активно»** — обычно до 1 дня.
[Что такое имя отправителя →](https://docs.mydialogi.ru/06-reference/05-sender-id-overview)
### Ошибка 401 при отправке
**Причина:** неверный или отсутствующий API-ключ.
**Решение:** проверьте заголовок `X-API-Key` и ключ.
[Ошибка 401 →](https://docs.mydialogi.ru/06-reference/03-troubleshooting/ts-mapi-401)
### Сообщение не доставляется
**Причина:** номер телефона недоступен или имя отправителя неактивно.
**Решение:** проверьте номер телефона и статус отправителя.
[Сообщение не доставляется →](https://docs.mydialogi.ru/06-reference/03-troubleshooting/ts-not-delivered)
### Ошибка 400 при отправке
**Причина:** неверные параметры запроса.
**Решение:** проверьте тело запроса — обязательные поля: `contact`, `channel`, `senderId`, `payload`.
[Обработка ошибок API →](https://docs.mydialogi.ru/06-reference/01-api/api-errors)
### 400 Bad Request: sender not found
**Причина:** в запросе указано имя отправителя, которое не привязано к этому ключу.
**Решение:** откройте ключ в разделе **API Подключения** и добавьте нужное имя отправителя в блок **«Имена отправителей»**.
[Как создать API-ключ →](https://docs.mydialogi.ru/06-reference/01-api/api-keys)
### Не приходят статусы в мою программу
**Причина:** не указан webhook URL, или ваш сервер недоступен извне.
**Решение:** укажите `webhook` в запросе, в настройках имени отправителя или в настройках API-ключа. Убедитесь, что ваш сервер отвечает кодом `200 OK`.
[Статусы сообщений →](https://docs.mydialogi.ru/03-multiapi/02-api/mapi-106-api-statuses)
## См. также
Что такое Multi API и как начать
Самостоятельная регистрация или по приглашению
Логин, пароль, 2FA
Имя отправителя для Multi API
OMNI API и Broadcasts API
Push и pull — два способа получения
13 каналов Multi API
Ответы на частые вопросы
## Нужна помощь?
- **Multi API:** support@multiapi.ru