62 lines
3.9 KiB
Markdown
62 lines
3.9 KiB
Markdown
Создание задач через email
|
||
==========================
|
||
|
||
|
||
Вы можете создавать задачи отправляя email (сообщения через электронную почту). Эта возможность доступна при использовании плагинов.
|
||
|
||
В настоящий момент, Канборд поддерживает три внешних плагина:
|
||
|
||
|
||
- [Mailgun](https://github.com/kanboard/plugin-mailgun)
|
||
- [Sendgrid](https://github.com/kanboard/plugin-sendgrid)
|
||
- [Postmark](https://github.com/kanboard/plugin-postmark)
|
||
|
||
Эти плагины позволяют обрабатывать входящие электронные сообщения (email) без дополнительной настройки SMTP сервера.
|
||
|
||
При получении плагином email сообщения, плагин передает это сообщение в веб транслятор Канборда.
|
||
|
||
|
||
Обработка входящих email сообщений[¶](#incoming-emails-workflow "Ссылка на этот заголовок")
|
||
-------------------------------------------------------------------------------------------
|
||
|
||
|
||
1. Вы отправляете email сообщение на определенный адрес, например **something+myproject@inbound.mydomain.tld**
|
||
2. Email сообщение перенаправляется на SMTP сервер
|
||
3. SMTP провайдер передает в веб сервис Канборда email сообщение в JSON формате или в формате multipart/form-data
|
||
4. Канборд обрабатывает полученное email сообщение и создает задачу в указанном проекте
|
||
|
||
**Заметка**: Новые задачи автоматически создаются в первой колонке.
|
||
|
||
|
||
Формат email сообщения[¶](#email-format "Ссылка на этот заголовок")
|
||
-------------------------------------------------------------------
|
||
|
||
- Email адрес до знака **@** должен содержать разделитель **плюс**, например **kanboard+project123**
|
||
- Строка следующая после знака плюс означает **Идентификатор проекта**, например, проект **Проект 123** может иметь идентификатор проекта **project123**. Идентификатор проекта можно задать в свойствах проекта **Меню** -\> **Настройки** -\> **Изменить проект** -\> **Идентификатор**. **Идентификатор** должен быть из цифр и латинских букв.
|
||
- Тема из email сообщения становится названием задачи
|
||
- Текст email сообщения становится описанием задачи (в формате Markdown)
|
||
|
||
Email сообщения могут быть написаны в текстовом или HTML формате. **Канборд сам переконвертирует формат сообщения в Markdown**
|
||
|
||
|
||
Безопастность и требования[¶](#security-and-requirements "Ссылка на этот заголовок")
|
||
------------------------------------------------------------------------------------
|
||
|
||
- Веб транслятор Канборд защищен случайным ключом
|
||
- Email адрес отправителя должен быть такой же как и у пользователя Канборд
|
||
- Проект в Канборде должен иметь уникальный идентификатор
|
||
- Отправитель email сообщения должен быть участником проекта
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
[Русская документация Kanboard](http://kanboard.ru/doc/)
|
||
|