Как отправить письмо с помощью SMTPlib

SMTP — Simple Mail Transfer Protocol (Простой Протокол Передачи Почты). Но слово простой совсем не значит, что есть крутой. SMTP — самый популярный протокол для отправки почты между серверами.

По итогу этого туториала вы сможете правильно оформить своё письмо и отправить его по почте.

1. Оформите письмо с помощью заголовков

Чтобы отправить письмо, ваша программа должна связаться с сервером почтового сервиса (Gmail, Yandex, Mail.ru и т.д.) и передать ему всю нужную информацию: кому, от кого, что в письме. Протокол устанавливает правила, как должно выглядеть такое сообщение:

From: Адрес отправителя
To: Адрес получателя
Subject: Заголовок письма
Content-Type: text/plain; charset="UTF-8";

Начало вашего текста ...

Например, если нужно отправить письмо Привет! с адреса mymail@gmail.com на адрес friend@gmail.com с заголовком Важно!, сообщение должно выглядеть так:

From: mymail@gmail.com
To: friend@gmail.com
Subject: Важно!
Content-Type: text/plain; charset="UTF-8";

Привет!

2. Закодируйте письмо

Русский язык не поддерживается в протоколе SMTP, поэтому письмо надо предварительно закодировать в UTF-8. Вот как это делается:

letter = """\
From: mymail@gmail.com
To: friend@gmail.com
Subject: Важно!
Content-Type: text/plain; charset="UTF-8";

Привет!"""

letter = letter.encode("UTF-8")

print(letter)

Вот что выведет этот код:

b'From: mymail@gmail.com\nTo: friend@gmail.com\nSubject: \xd0\x92\xd0\xb0\xd0\xb6\xd0\xbd\xd0\xbe!\nContent-Type: text/plain; charset="UTF-8";\n\n\xd0\x9f\xd1\x80\xd0\xb8\xd0\xb2\xd0\xb5\xd1\x82!'

3. Подключитесь к почтовому сервису

С письмом понятно, но как же передать всё это серверу? Чтобы с ним общаться, нужно знать его адрес. Почтовые сайты сами публикуют адреса своих SMTP серверов.

Адреса для нескольких популярных сервисов:

Сайт	Хост и порт сервера
Яндекс.Почта	`smtp.yandex.ru:465`
GMail	`smtp.gmail.com:465`
Mail.ru	`smtp.mail.ru:465`

Для примера возьмём Gmail. В первую очередь свяжемся с сервером:

import smtplib

server = smtplib.SMTP_SSL('smtp.gmail.com', 465)  # хост и порт передаём разными аргументами

Затем зайдём в свой почтовый ящик. Для этого передайте методу .login() свои логин и пароль:

import smtplib

server = smtplib.SMTP_SSL('smtp.gmail.com', 465)
server.login(login, password)

4. Отправьте письмо

Теперь, когда письмо закодировано, его можно наконец-то отправить. Метод .sendmail() ждёт от вас 3 значения: от кого, кому и что передать. Да, вы уже указали это в письме, но придётся указать второй раз:

import smtplib

server = smtplib.SMTP_SSL('smtp.gmail.com', 465) 
server.login(login, password)
server.sendmail(email_from, email_to, message)
server.quit()

Обратите внимание, что в конце мы прощаемся с сервером методом .quit(), чтобы он больше не ждал от нас писем. Это правило хорошего тона. Соблюдать его не обязательно, но бездушной машине будет приятно.

Error: authentication failed: This user does not have access rights to this service

Это переводится как “Пользователь не имеет доступа к этому сервису”. На свежих аккаунтах Яндекса доступ к отправке писем через код надо открывать вручную.

Нажмите кнопку в виде шестерёнки справа сверху рядом с именем аккаунта на сайте Яндекс Почты.

Во всплывающем окне нажмите ссылку “Все настройки ->” В настройках отметьте галочки как на скриншоте.

Если нет пункта “Портальный пароль”, то просто проигнорируйте его.

Далее выберите в меню слева пункт Безопасность и перейдите на страницу создания паролей приложения.

Выберите пункт Почта drawing

Укажите название Пароля (не требуется для работы вашего кода, нужен только для удобства управления в настройках Почты), нажмите кнопку Далее, после чего обязательно сохраните появившийся в окне пароль. Если этого не сделать, повторно просмотреть его уже не получится.

Именно этот пароль укажите в вашем коде в качестве пароля от Яндекс Почты. drawing

Этот пароль не позволяет зайти в ваш аккаунт Яндекс, однако даёт доступ к отправке сообщений от вашего имени. Вы можете удалить созданный для Почты пароль в любой момент без сброса пароля аккаунта Яндекс. Для этого:

Найдите пароль по имени в списке на странице “Пароли приложений”
Нажмите на имя пароля
Нажмите кнопку “Удалить пароль” во всплывающем окне

После удаления пароля не получится отправлять письма с помощью кода на Python.

Бонус: если хочется отправить письмо через Gmail

При запуске кода вы можете получить ошибку SSL такого вида:

smtplib ssl.SSLError: [SSL: WRONG_VERSION_NUMBER] wrong version number (_ssl.c:1131)

Проблема связана с устаревшей версией протокола шифрования SSL. Чинится ошибка добавлением ещё нескольких строк кода с явным указанием номера версии. Подробно проблема обсуждается на StackOverflow.

...
server = smtplib.SMTP('smtp.gmail.com', 587)

import ssl  # переместите в шапку файла
context = ssl.SSLContext(ssl.PROTOCOL_TLS)

server.ehlo()
server.starttls(context=context)
server.ehlo()
...

При запуске код либо заработает, либо вывалится ошибка с кодом 535-5.7.8:

SMTPAuthenticationError 535-5.7.8 Username and Password not accepted

Эта ошибка связана с настройками безопасности на Gmail. Зайдите из-под своего аккаунта на страницу Ненадежные приложения и разрешите доступ “Небезопасным приложениям”. Подробно проблема обсуждается на StackOverlfow.