Skip to content

Communication

4 modules

ModuleDescription
Read EmailRead emails from IMAP server
Send EmailSend email via SMTP server
Send Slack MessageSend messages to Slack channels via incoming webhook
Trigger WebhookSend HTTP POST request to a webhook URL

Modules

Read Email

email.read

Read emails from IMAP server

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
emailsarrayList of email objects
countnumberList of email objects

Example: Read recent unread emails

yaml
folder: INBOX
unread_only: true
limit: 5

Send Email

email.send

Send email via SMTP server

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
sentbooleanWhether email was sent successfully
message_idstringWhether email was sent successfully
recipientsarrayWhether email was sent successfully

Example: Send simple email

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

Send Slack Message

slack.send

Send messages to Slack channels via incoming webhook

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
sentbooleanWhether message was sent successfully

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:

Trigger Webhook

webhook.trigger

Send HTTP POST request to a webhook URL

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 response status code
responseobjectHTTP response status code
headersobjectHTTP response status code

Example: Simple POST webhook

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

Released under the Apache 2.0 License.