Integrations

Slack Integrations

5min

Affinities Slack Integration allows Events, Announcements, and Newsletters created in Affinities ERG’s to be published on Slack Channels as notifications. Affinities can be integrated as a Bot Application. 

Create an Affinities Custom Integration

Sign into your slack account as admin and navigate to https://api.slack.com/apps

Click on the Create New App.

Choose From Scratch, and enter App Name, e.g. ‘Affinities’ and choose your company workspace.

Click on Create an App.

Create an App Button
Create an App Button


Next, click on the Add Features and Functionality page click on Incoming Webhooks and then Activate Incoming Webhooks by turning the switch ON.

Document image


Click on ‘Add New Webhook to Workspace’ and on the next screen select one of the slack channel where you would like to post messages, then click Authorize.

Add OAUTH & Permissions

For this step click on OAuth & Permissions from the menu on the left side of the screen.

Go to Scopes > Bot Token Scopes and add the following scopes:

  1. chat:write
  2. chat:write.public
Scopes
Scopes


Next, click on Reinstall to Workspace and select the channel you selected in step 5 on the previous page and click on Allow.

Copy the Bot User OAUTH Token and share it securely with your Teleskope contact person.

Thats all! Rest of the steps will be completed by Teleskope. Please provide ERG/Chapter <> Slack Channel Id mapping to your Teleskope Contact Person.

Integration

For this step, Login into the admin panel. Now navigate to the Groups > Manage Groups section.

Click on Integration icon (right facing arrow under action column) next to the group you want to add the integration link. For this document, i’ll click on the icon in the group “Asian affinities link”.

Manage Groups
Manage Groups


This is the page where you’ll see all integrations linked to the group. Click on the + icon to add integration.

Integrations Page
Integrations Page


This is the page where you will create the integration for the group. Follow these steps

  • Select “Slack” from the dropdown.
  • Add a name for integration.
  • Checkmark where you want the integrations to work.
  • Paste the slack Channel ID and the OAUTH TOKEN we got in previous steps.
  • Click Save
Add New Integration Page
Add New Integration Page


You’ll see the integration listed. Click on the unlock icon to activate this integration.

Activate Integration
Activate Integration

Slack Integration Data Flow
Slack Integration Data Flow