Mail actions are commands you can send via emailing a channel to take an action. The goal of these actions is to make sure that your team members that prefer email instead of using the app can still be productive.
Mail actions basics
Mail actions are always in the form of
actionName(). The name is not case sensitive (
ACTIONNAME() is also valid), though the parentheses at the end are mandatory; that is how you tell Aether Pro to execute this.
If the action needs you to supply any extra bit of information, it will go inside the parentheses. For example,
replyTo(7) means a reply to the post numbered 7.
If the action requires some text, such as an email, use double-quotes. For example,
addGuest("firstname.lastname@example.org") adds email@example.com as a guest.
If the action requires multiple variables, use a comma between, and follow the order in the action description. For example,
exampleAction("some text here", 42).
Where to put them
Mail actions are always put to the first line of the email you’re sending. For example, if you’re trying to make sure your response is added as a reply to post 7, this is how you would do it:
replyto(7) Sounds great! I think we can cancel that meeting - seems everyone got to an agreement through here. Alice
- Make it the first thing on an email.
- Put a blank line between your action and the rest of the email.
- Only use one action per email. If you use multiple actions, only the last one will be executed. If you need multiple actions, feel free to send them in separate emails.
- Actions except for
replyTo()will make the rest your email be ignored, so you don’t have to worry about the rest of your email accidentally creating a new thread.
replyTois special because it controls to whom the rest of the email is posted as a reply to.
In Aether, there are three basic types of members, channel members, team members and admins.
Channel members are members that are added to only one channel at a time, and use Aether Pro via email only, with no app access. Channel members cannot create new channels, nor can they add other team or channel members.
A channel member can be a member of multiple channels, but the member has to be explicitly added to every channel (or if public, sign up for them through the web sign-up form.)
If you’ve received an email that says you’ve been added to a specific channel in a team, you’re a channel member.
Team members are members who can sign in with the app or post through email. They can both create new channels and add members themselves. These people are usually core team members of the team.
Admins are members who have either created the team or assigned explicitly by people who have created the team. Admins can do all of the above, plus moderate content, and control other people’s memberships.
Actions available to everyone
These actions are available to everyone, to channel members, team members and admins.
replyTo(number) (Takes a number)
Makes your reply go to a specific reply in the email thread. This is useful because it allows you to specifically reply to what you’re talking about, and keeps discussions clean. Use it whenever you can.
replyTo(7): Reply to post #7 on the thread. (Numbers are available on the email you received from the thread.)
Actions available to team members and admins
These actions are available to team members and admins.
join() (Takes nothing)
Makes you join the channel you’re sending this email to. It takes no arguments.
join() sent to
firstname.lastname@example.org: Makes you join my-channel channel on acme team.
Makes you leave the channel you’re sending this email to. It takes no arguments.
Note: If you’re a channel member, you cannot use
leave(), If you’d like to leave any particular channel or all channels, you can do so by clicking the unsubscribe link at the bottom of every message you receive.
leave() sent to
email@example.com: Makes you leave my-channel channel on acme team.
Actions available to admins
These actions are only available only to admins. They are intended to make team management easier.
Note: A guest is a channel member by another name. They’re the same.
Adds an email as a channel member to one of your channels. Channel members cannot sign into the app. They can only get messages and respond via email.
addGuest("firstname.lastname@example.org") sent to
email@example.com: Makes firstname.lastname@example.org join my-channel on the acme team as a guest.
Join everyone to this channel
Makes all members of this team join the channel you’re emailing. This is useful when you add a new channel. Since updates on a channel are only sent out when someone subscribes to it, you might need to tell people to join the channel to start working in it.
This allows you to auto-add everyone to a channel so that they will start getting updates for threads in the channel.
If they have already joined, but had the channel on mute, this will also remove the mute.
joinEveryoneToThisChannel() sent to
email@example.com: Makes every member of the acme team join my-channel.
Join specific member to this channel
Makes one specific member of this team join the channel you’re emailing. This is useful when you add a new channel. Since updates on a channel are only sent out when someone subscribes to it, you might need to tell people to join the channel to start working in it.
This allows you to auto-add a specific member to a channel so that they will start getting updates for threads in the channel.
joinMemberToThisChannel("firstname.lastname@example.org") sent to
email@example.com: Makes firstname.lastname@example.org join my-channel on the acme team.