Slack new user notifications
 {
for (var _len = arguments.length, macroArgs = new Array(_len), _key = 0; _key < _len; _key++) {
macroArgs[_key] = arguments[_key];
}
var argCount = numArgs(macroArgs);
var args;
var kwargs = getKeywordArgs(macroArgs);
if (argCount > argNames.length) {
args = macroArgs.slice(0, argNames.length); // Positional arguments that should be passed in as
// keyword arguments (essentially default values)
macroArgs.slice(args.length, argCount).forEach(function (val, i) {
if (i < kwargNames.length) {
kwargs[kwargNames[i]] = val;
}
});
args.push(kwargs);
} else if (argCount < argNames.length) {
args = macroArgs.slice(0, argCount);
for (var i = argCount; i < argNames.length; i++) {
var arg = argNames[i]; // Keyword arguments that should be passed as
// positional arguments, i.e. the caller explicitly
// used the name of a positional arg
args.push(kwargs[arg]);
delete kwargs[arg];
}
args.push(kwargs);
} else {
args = macroArgs;
}
return func.apply(_this, args);
}){kind=icon}
A Transposit port of the Slack blueprint to have new users accept a ToS
Updated July 2019: These are specific instructions for use in Transposit. For other methods, check the Slack API website. Interested in reading more? Check out the blog post we wrote about it!
Sample Slack app that presents a Terms of Service (or any other message) when a new user joins a team.
The user can accept the Terms of Service using message buttons. If a user has been presented with the Terms before and they haven't accepted, a background job can send them a reminder after a specific period of time. Eventually you can use the SCIM API to disable the user's account.
Setup#
Create a Slack app#
- Create an app
- Go to Bot Users and click "Add a Bot User" to create an app bot. Save the change.
- Enable Interactive components (See Enable Interactive Components below)
- Navigate to the OAuth & Permissions page and add the following scopes:
chat:write:bot
- Add
https://accounts.transposit.com/oauth/v2/handle-redirectas a Redirect URI. - Click Save Changes and install the app (You should get an OAuth access token after the installation)
- Enable the events (See Enable the Events API below. It doesn't let you the Request URL until you run the code!)
- In your Slack workspace, invite the bot to #general, where the new user will join.
Fork in Transposit#
Configure your Slack app's connection to Transposit:
- Find your Client ID and Secret in your Slack app under Basic Information > App Credentials.
- In your Transposit app, go to Data connections > Slack > Authentication and change the values to your Slack app's Client ID and Secret.
Add Slack's credential to production under Deploy > Production Keys and follow the instructions.
Enable the Events API#
- Go back to the app settings and click on Events Subscriptions
- Set the Request URL to the generated webhook url for
newuserin Transposit under Deploy - On the same page, subscribe to the
team_jointeam events
Enable Interactive Messages#
- In the app settings, click on Interactive Messages
- Set the Request URL to the generated webhook url for
acceptpushin Transposit underDeploy > Endpoints
Transposit Functions#
acceptpush: The function that is called when the accept button is pressed in Slack.
newuser: The function that is called when a new user joins a workspace.
post_tos: The Slack API call to post the welcome message.
reminder: A scheduled task to remind users who have not accepted the TOS to accept them.