Что такое IMAP и SMTP?
IMAP (Internet Message Access Protocol) и SMTP (Simple Mail Transfer Protocol) — это стандартные протоколы, питающие коммуникацию электронной почты по всему интернету.- IMAP используется для чтения и управления письмами. Он позволяет почтовым клиентам синхронизироваться с почтовым сервером, сохраняя ваши сообщения организованными на нескольких устройствах. Когда вы проверяете свой входящий ящик в Outlook или Thunderbird, вы используете IMAP.
- SMTP используется для отправки писем. Когда вы нажимаете “Отправить” на письме, SMTP обрабатывает доставку этого сообщения на почтовый сервер получателя.
Зачем использовать IMAP/SMTP с AgentInbox?
- Интеграция почтового клиента: подключите Outlook, Thunderbird, Apple Mail или любой IMAP/SMTP-совместимый клиент к входящему ящику AgentInbox
- Программный доступ: отправляйте и получайте письма, используя стандартные библиотеки (такие как Python
imaplibилиsmtplib) на любом языке программирования - Интеграция наследованных систем: соедините AgentInbox с существующими системами, поддерживающими только протоколы IMAP/SMTP
- Знакомые инструменты: используйте почтовые инструменты, которые вы уже знаете, во время разработки и тестирования
Поиск ваших учетных данных
Перед настройкой IMAP или SMTP вам потребуются две информации из консоли AgentInbox:Получите ID входящего ящика (имя пользователя)
Перейдите на Dashboard → Inboxes и найдите колонку Inbox ID. Ваш ID входящего ящика — это адрес электронной почты входящего ящика (например,
myinbox@agentinbox.ru). Это будет ваше имя пользователя для аутентификации IMAP.Конфигурация IMAP
Используйте IMAP для чтения писем из входящего ящика AgentInbox.SSL/TLS требуется для всех соединений IMAP. Соединения без SSL будут отклонены. Убедитесь, что SSL/TLS включен в настройках почтового клиента.
| Параметр | Значение |
|---|---|
| Host | imap.agentinbox.ru |
| Port | 993 |
| Username | Электронная почта входящего ящика (например, myinbox@agentinbox.ru) |
| Password | Ваш API ключ |
| SSL/TLS | Обязателен (должен быть включен) |
В настоящее время только папка INBOX доступна через IMAP. Другие папки (Sent, Drafts, Trash) недоступны через IMAP. Используйте API AgentInbox для полного доступа к папкам.
Пример Python IMAP
Пример TypeScript IMAP
Конфигурация SMTP
Используйте SMTP для отправки писем из входящего ящика AgentInbox.SSL/TLS требуется для всех соединений SMTP. Соединения без SSL будут отклонены. Убедитесь, что SSL/TLS включен в настройках почтового клиента.
| Параметр | Значение |
|---|---|
| Host | smtp.agentinbox.ru |
| Port | 465 |
| Username | agentinbox |
| Password | Ваш API ключ |
| SSL/TLS | Обязателен (должен быть включен) |
Адрес “От” в вашем письме должен совпадать с адресом электронной почты входящего ящика (например,
myinbox@agentinbox.ru). Использование другого адреса От может привести к сбоям доставки.Ограничения SMTP
- Макс. получателей: 50 на письмо
- Макс. размер сообщения: 10MB
- Время ожидания сеанса: 30 минут
Пример Python SMTP
Пример TypeScript SMTP
Решение проблем
| Ошибка | Причина | Решение |
|---|---|---|
| ”Authentication failed” | Неверные учетные данные | Проверьте электронную почту входящего ящика и API ключ из консоли |
| ”Connection refused” | SSL не включен | Включите SSL/TLS в настройках клиента |
| ”Connection timeout” | Брандмауэр блокирует порты | Убедитесь, что порты 993 (IMAP) и 465/587 (SMTP) открыты |
| ”Sender not authorized” | Неверный адрес От | Используйте адрес электронной почты входящего ящика как адрес От |
| ”Folder not found” | Папка не INBOX | Поддерживается только INBOX; используйте API для других папок |
Когда использовать IMAP/SMTP вместо API
| Вариант использования | Рекомендация |
|---|---|
| Интеграция почтового клиента | IMAP/SMTP |
| Простая программная отправка | SMTP |
| Полное управление входящим ящиком | API |
| Уведомления в реальном времени | API (Webhooks) |
| Доступ ко всем папкам | API |
| Массовые операции | API |
