---
title: Slack Integrations
slug: slack-integrations
docTags: 
createdAt: 2024-10-16T17:33:29.762Z
---

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](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**.

::Image[]{src="https://lh7-rt.googleusercontent.com/slidesz/AGV_vUc_mPN8Vo_EXnBGieACyGMB6ghuvATe5Gb_imXRvQhvXq0Jyf3-4WJcCm7bMHALaYC42dTPg9rEkJMRfFgrEPS515R24R3UL4v27LCxIEh7841gnK0_m_dqK-4v40UzIrx0b3VrDupw7YGDNDjjTa-fA8C-A1lu_ms-TGHvGNFdWw=s2048?key=gTE3RoyXeWORrZ8y-q8JxQ" size="72" width="1396" height="554" position="center" caption="Create an App Button" alt="Create an App Button" showCaption="true"}

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

::Image[]{src="https://lh7-rt.googleusercontent.com/slidesz/AGV_vUeHByL-GaRcvCBiumTJa4R75z6NtebKl0V4sjkcXrTjctMfYgy1jK1rP7wRpVImFQYpauoe77st-kcVYO01RbtI5RnIqZ2VLVNpemn7vdcTqV7VPee9OXlw788OhFdzAx-KNyV0bAbCzu-ZDfF3vEdJaIrHRSTs9vkZJBKK60NvdQ=s2048?key=gTE3RoyXeWORrZ8y-q8JxQ" size="78" width="1330" height="684" position="center" showCaption="false"}

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

::Image[]{src="https://lh7-rt.googleusercontent.com/slidesz/AGV_vUfX2rApuNp6cMbQ9FR23Li5lHrwbr4XqobIxRzRaT_gdo6ooMZ9i1V9zTYKEOLDUJr_Vu7uk91STw-sVXiOIMkLh82paobRIcOP6yEiOaIK0Kw8dNVv6SIBMSRDzZXnBNjAjXeUBn1Bir0UziqrlWlh8nBqe4vOY9OPrESiTzefAQ=s2048?key=gTE3RoyXeWORrZ8y-q8JxQ" size="72" width="1344" height="860" position="center" caption="Scopes" alt="Scopes" showCaption="true"}

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](https://lh7-rt.googleusercontent.com/slidesz/AGV_vUc4Bsdhk-srlb-wWvQTXdWkgbXKF8_h1nVOlm-T1wonPvLAmjsO7t5jVmYrtZyC9Cd4AMY277-jSNB2mZFA9kyO25PgM4U3AzlbNOJp3AJ9F0umrjvmyJwylhoJuBTA3pjJiY-cB6YckYdSj7RreIgDK0B02cEEDlPc2rEbkCKWlw=s2048?key=gTE3RoyXeWORrZ8y-q8JxQ "Manage Groups")

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

::Image[]{src="https://lh7-rt.googleusercontent.com/slidesz/AGV_vUdWx-LlV69mqx-cIxcqWtX-wlbY1GQeFayUSRu-ZVGJ01Uqmkb23LiK-XLCwq4PpkVkCWlZ3x8quf3AbBYWTQ36M3fBxszOES56uLdn1_c27uV4y94v-M4hASZ48kq0d_PeSfadTmO3A_uSbZ9BhOxLY0axYNtfoJpLiby8bGwgyA=s2048?key=gTE3RoyXeWORrZ8y-q8JxQ" size="86" width="2035" height="481" position="center" caption="Integrations Page" alt="Integrations Page" showCaption="true"}

This is the page where you will create the integration for the group. Follow these steps&#x20;

- 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.&#x20;
- Click Save

![Add New Integration Page](https://lh7-rt.googleusercontent.com/slidesz/AGV_vUeD58m6s21cIJY8o5lEaLGSeMwqLscYjQxwF53jljtum2u9qpvjhgDcAb6McqL47dfejkM0vlsGBajA2rrBi10wEyUd7R7BvWIQPYOltjmXm3ci8qGrv-xjpRbnXznhCU9iKaijH5x4dWuX4-6bEYZ9HA--GWKych3xHc3vQlnLJg=s2048?key=gTE3RoyXeWORrZ8y-q8JxQ "Add New Integration Page")

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

![Activate Integration](https://lh7-rt.googleusercontent.com/slidesz/AGV_vUdLeDviNYeHHurM0b2xAaqkrucKsmGUrcwOnEgFs2utxLRoPKfgwdVq_Bdf8AOWyGRrYNGARBtbo0s495vrNfp8vH-9XCnwIVURqyCdUvDbAO8dMpB3TYevdxDR6Jik1TSbPDz6wLqIv9xvoW1jZslTLIF6VNncVTwwIh2Mmf4TLA=s2048?key=gTE3RoyXeWORrZ8y-q8JxQ "Activate Integration")

![Slack Integration Data Flow](https://lh7-rt.googleusercontent.com/slidesz/AGV_vUdRXmtptUbo0yqxlkF_u6ru2ihRLA7Ty4SGmWNDavw4FfmD68Lzu4_yg2rKu1egT2k1TDLlEZ_4oK3Z1G7hx-a8qr6h13nSdn00nQ9izCbFmMAWz-hgYiraH2bAZulPv4UfnyoMwU1Obl7DsPhdh1eOZEO7L8xdi6YMX3djEmSN=s2048?key=gTE3RoyXeWORrZ8y-q8JxQ "Slack Integration Data Flow")