Быстрый старт для тестировщика
Первое сообщение через Multi API — имя отправителя, ключ, отправка через curl
Коротко: за 10–15 минут вы получите API-ключ и отправите первое сообщение через Multi API.
Кому подходит
- Роль: Клиент, Разработчик
- Уровень: Новичок / Опытный
Что это
Пошаговая инструкция для быстрого запуска Multi API. К концу страницы у вас будет:
- ✅ Зарегистрированное имя отправителя
- ✅ API-ключ для интеграции
- ✅ Первое отправленное сообщение со статусом доставки
Если вы уже зарегистрированы — переходите к шагам ниже.
Если вы ещё не зарегистрированы — сначала:
Тестовое подключение — договор не требуется, мы предоставляем баланс для тестирования. Для продолжения работы после теста — запросите договор через поддержку сервиса.
Перед началом
- Вы зарегистрированы в Multi API.
- Вы вошли в личный кабинет.
- У вас есть номер телефона получателя.
Шаги
Без имени отправителя отправить сообщение нельзя. Это обязательный шаг.
- В левом меню: Активы → Имена отправителей.
- Нажмите «Добавить имя отправителя».
- Выберите канал (например, SMS).
- Укажите отображаемое название.
- Нажмите «Отправить заявку».
В тестовом режиме документы не нужны — регистрация занимает до 1 дня. Дождитесь статуса «Активно» — без одобрения имени отправка невозможна.
- В левом меню: API Подключения.
- Нажмите «Создать API подключение».
- Укажите название (например, «Тестовый ключ»).
- В блоке «Права доступа» выберите из списка:
omni-api— для отправки сообщений.statistics— для просмотра статистики.
- В блоке «Имена отправителей» выберите из списка нужное имя — для канала, по которому будете отправлять.
- Нажмите «Получить API ключ».
- Скопируйте ключ и сохраните его — он показывается только один раз.
Какие каналы будут доступны ключу — зависит от выбранных имён отправителей.
У каждого имени отправителя есть свой канал. Чтобы ключ мог отправлять по SMS — выберите имя для SMS. Чтобы по SMS и WhatsApp — выберите два имени. Каналы не выбираются напрямую — они определяются именами отправителей.
Адрес запроса:
POST https://web.multiapi.ru/api/v1/messages
Заголовки:
Content-Type: application/jsonX-API-Key: ВАШ_API_КЛЮЧ
Тело запроса (JSON):
{
"contact": "79123456789",
"channel": 1,
"senderId": "ВАШ_ОТПРАВИТЕЛЬ",
"payload": {
"text": "Привет! Это тестовое сообщение."
}
}Замените три значения на свои:
ВАШ_API_КЛЮЧ— на ключ из шага 2.79123456789— на номер получателя.ВАШ_ОТПРАВИТЕЛЬ— на имя из шага 1.
contact указывается в международном формате, без знака +. Например, для России: 79123456789.
channel: 1 — это SMS. Полный список каналов — в обзоре.
Статус отправленного сообщения можно посмотреть двумя способами.
В личном кабинете
Откройте Статистика → Записи сообщений (EDR). Найдите ваше сообщение по номеру получателя и проверьте статус: Доставлено или Отправлено.
В своей программе
Статус приходит в вашу программу двумя способами:
- Push (вебхук) — платформа сама отправляет статус на ваш URL.
- Pull (запрос к API) — вы запрашиваете статусы через
GET /edrs.
Оба способа получения статусов в вашу программу — push и pull — подробно описаны в статье Статусы сообщений →.
Результат
Вы отправили первое сообщение через Multi API и увидели статус доставки.
Дальше: Карта интеграции Multi API → — что вызывать и в каком порядке.
Частые проблемы
Причина: имя ещё в обработке.
Решение: дождитесь статуса «Активно» — обычно до 1 дня.
Причина: неверный или отсутствующий API-ключ.
Решение: проверьте заголовок X-API-Key и ключ.
Причина: номер телефона недоступен или имя отправителя неактивно.
Решение: проверьте номер телефона и статус отправителя.
Причина: неверные параметры запроса.
Решение: проверьте тело запроса — обязательные поля: contact, channel, senderId, payload.
Причина: в запросе указано имя отправителя, которое не привязано к этому ключу.
Решение: откройте ключ в разделе API Подключения и добавьте нужное имя отправителя в блок «Имена отправителей».
Причина: не указан webhook URL, или ваш сервер недоступен извне.
Решение: укажите webhook в запросе, в настройках имени отправителя или в настройках API-ключа. Убедитесь, что ваш сервер отвечает кодом 200 OK.
См. также
Нужна помощь?
- Multi API: support@multiapi.ru