Как настроить API и SMTP в QWERTYMAIL

API и SMTP позволяют отправлять письма из сайта, CRM или собственного приложения. API подходит для программной интеграции, а SMTP — для систем, которые умеют работать с обычным почтовым протоколом.

Откройте параметры подключения

1. В личном кабинете откройте «Автоматизация».
2. Перейдите в раздел «API и SMTP».
3. Откройте «Параметры подключения API и SMTP».
4. Если API ещё не используется, нажмите «Активировать API ключ».

Подключение по API

1. Передайте разработчику адрес API из документации и ключ через защищённый канал.
2. Храните ключ в переменной окружения или закрытом хранилище сервера.
3. Сначала отправьте одно тестовое сообщение.
4. Проверьте ответ API и появление операции в журнале QWERTYMAIL.

Подключение по SMTP

1. Скопируйте сервер, порт, логин и пароль из кабинета.
2. Укажите защищённое соединение в соответствии с параметрами сервиса.
3. Выберите подтверждённый email отправителя.
4. Выполните тестовую отправку на собственный адрес.

Не угадывайте порт или тип шифрования: используйте именно значения, показанные в вашем кабинете.

Что проверить после подключения

• письмо появилось в журнале API и SMTP;
• адрес отправителя подтверждён;
• домен настроен и письмо не попало в спам;
• приложение обрабатывает ошибочные ответы и не повторяет запрос бесконечно;
• секреты не записываются в открытые логи.

Если ключ оказался раскрыт

Сразу отключите или перевыпустите его в личном кабинете, обновите секрет в подключённой системе и проверьте журнал отправок.

Частые вопросы

Что выбрать: API или SMTP?

API удобнее для собственной разработки и детального контроля ответа. SMTP проще подключить к готовому приложению, если оно уже поддерживает этот протокол.

Можно использовать ключ на нескольких сайтах?

Технически это зависит от интеграции, но безопаснее разделять подключения и ограничивать распространение одного секрета.