Skip to content

Communication

4 modules

ModuleDescription
이메일 읽기IMAP 서버에서 이메일 읽기
이메일 전송SMTP 서버를 통해 이메일 전송
Slack 메시지 전송수신 웹훅을 통해 Slack 채널에 메시지 전송
웹훅 트리거웹훅 URL로 HTTP POST 요청 전송

Modules

이메일 읽기

email.read

IMAP 서버에서 이메일 읽기

Parameters:

NameTypeRequiredDefaultDescription
folderstringNoINBOXMailbox folder to read from
limitnumberNo10Maximum number of emails to fetch
unread_onlybooleanNoFalseOnly fetch unread emails
since_datestringNo-Fetch emails since this date (YYYY-MM-DD)
from_filterstringNo-Filter by sender email address
subject_filterstringNo-Filter by subject (contains)
imap_hoststringNo-IMAP server host
imap_portnumberNo993IMAP server port
imap_userstringNo-IMAP username
imap_passwordstringNo-IMAP password

Output:

FieldTypeDescription
emailsarray이메일 객체 목록
countnumber이메일 객체 목록

Example: Read recent unread emails

yaml
folder: INBOX
unread_only: true
limit: 5

이메일 전송

email.send

SMTP 서버를 통해 이메일 전송

Parameters:

NameTypeRequiredDefaultDescription
tostringYes-Recipient email address(es), comma-separated for multiple
subjectstringYes-Email subject line
bodystringYes-Email body content
htmlbooleanNoFalseSend as HTML email
from_emailstringNo-Sender email (uses SMTP_FROM_EMAIL env if not provided)
ccstringNo-CC recipients, comma-separated
bccstringNo-BCC recipients, comma-separated
attachmentsarrayNo[]List of file paths to attach
smtp_hoststringNo-SMTP server host (uses SMTP_HOST env if not provided)
smtp_portnumberNo587SMTP server port (uses SMTP_PORT env if not provided)
smtp_userstringNo-SMTP username (uses SMTP_USER env if not provided)
smtp_passwordstringNo-SMTP password (uses SMTP_PASSWORD env if not provided)
use_tlsbooleanNoTrueUse TLS encryption

Output:

FieldTypeDescription
sentboolean이메일 전송 성공 여부
message_idstring이메일 전송 성공 여부
recipientsarray이메일 전송 성공 여부

Example: Send simple email

yaml
to: user@example.com
subject: Hello
body: This is a test email.

Slack 메시지 전송

slack.send

수신 웹훅을 통해 Slack 채널에 메시지 전송

Parameters:

NameTypeRequiredDefaultDescription
messagestringYes-Message text to send
webhook_urlstringNo-Slack incoming webhook URL
channelstringNo-Override channel (optional)
usernamestringNo-Override bot username
icon_emojistringNo-Emoji to use as icon (e.g., :robot_face:)
blocksarrayNo-Slack Block Kit blocks for rich formatting
attachmentsarrayNo-Message attachments

Output:

FieldTypeDescription
sentboolean메시지 전송 성공 여부

Example: Send simple message

yaml
message: Hello from Flyto!

Example: Send with formatting

yaml
message: Task completed successfully
username: Flyto Bot
icon_emoji: :white_check_mark:

웹훅 트리거

webhook.trigger

웹훅 URL로 HTTP POST 요청 전송

Parameters:

NameTypeRequiredDefaultDescription
urlstringYes-Target webhook URL
methodselect (GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS)NoPOSTHTTP request method
payloadobjectNo-JSON payload to send
headersobjectNo{}HTTP request headers as key-value pairs
content_typeselect (application/json, application/x-www-form-urlencoded, multipart/form-data, text/plain, text/html, application/xml)Noapplication/jsonContent type of the request body
auth_tokenstringNo-Bearer token for authorization
timeoutnumberNo30Maximum time to wait in seconds

Output:

FieldTypeDescription
status_codenumberHTTP 응답 상태 코드
responseobjectHTTP 응답 상태 코드
headersobjectHTTP 응답 상태 코드

Example: Simple POST webhook

yaml
url: https://example.com/webhook
payload: {"event": "task_completed", "data": {}}

Released under the Apache 2.0 License.