How to integrate Affinity with Slack

Integrate Affinity with Slack by reaching out to support@affinity.co or your Affinity CSM and asking them to unlock this integration for your account. As always, you must be on the Premium or Enterprise Tiers and be an account admin (see Affinity Native Integrations).

1. Once you've done the above, click Settings on the left-side of your screen.
   
   
   
2. Click on the Integrations tab, then click on Slack.
   
   
   
3. Jump to the relevant Slack integration to learn more:
   1. Affinity Field Updates to a Slack Channel
   2. Affinity Notes from a List to a Slack Channel
   3. Affinity Organization Notes to a Slack Channel
   4. All Affinity Notes into a Slack Channel

Affinity Field Updates to a Slack Channel

For updates that you/your team members make to certain fields, they will be pushed to a specific Slack channel. This integration may require some additional guidance for steps 5 and 7, so please reach out to support@affinity.co as needed.

1. Within the Affinity Field Updates to a Slack Channel integration, click Select.
   
   
   
2. Click Configure new solution.
   
   
   
3. Authenticate your Slack account by creating a new authentication, or select one from the dropdown.
   
   
   
4. Select the Slack Channel on the following screen, then click Next.
   
   
   
5. Select which Affinity Field and Field Value will be considered as the trigger. For Field, the dropdown options will be in the following format: [List Name] Field Name. For Field Value, type out the field value(s) depending on what is available in the Field. Once you're done, click Next.
   
   
   
6. Add additional filter conditions for increased specificity (optional). This requires you to know the field IDs (Column ID) of the Affinity fields that you're setting up the filter conditions for. 
   1. You can use Affinity's API to receive the relevant field IDs.
   2. If you don't need additional filter conditions, you can skip this step.
      
      
      
7. Select which Slack channel you'd like to push the notes into. Create a new Slack channel dedicated to these notes if you'd like.
   1. Note: Only public channels, private channels, and DMs are supported at this time. Group DMs are not supported at this time.
8. Now, embed fields and field values as a custom message (required). This requires you to know the field IDs of the Affinity fields that you're planning to include in your custom message.
   1. You can use Affinity's API to receive the relevant field IDs.
      

Affinity Notes from a List to a Slack Channel

For any private/shared notes that you (the person setting up the integration) add or have access to (whether it's yours or those of your team members) for the list entries within a specific list, they will be pushed into the designated Slack channel of your choice.

Note: For this integration, threaded replies within notes will not be sent as notifications to the designated Slack channel. 

1. Within the Affinity Notes from a List to a Slack Channel integration, click Select.
   
   
   
2. Click Configure new solution.
   
   
   
3. Authenticate your Slack account.
4. Select which Affinity list you will sync from.
5. Select which Slack channel you'd like to push the notes into. Create a new Slack channel dedicated to these notes if you'd like.
   1. Note: Only public channels, private channels, and DMs are supported at this time. Group DMs are not supported at this time.
      
      
      
6. Click Finish and you're all set! Now, any notes added to the list entries in that specific list will also be pushed to the designated Slack channel.

Affinity Organization Notes to a Slack Channel

For any private/shared notes that you (the person setting up the integration) add or have access to (whether it's yours or those of your team members) for a specific organization, they will be pushed into the designated Slack channel of your choice.

Note: For this integration, threaded replies within notes will not be sent as notifications to the designated Slack channel. 

1. Within the Affinity Organization Notes to a Slack Channel integration, click Select.
   
   
   
2. Click Configure new solution.
   
   
   
3. Authenticate your Slack account, then click Finish.
   
   
   
4. Go to a specific organization's profile page (i.e. Gong). You will see that Affinity automatically created a custom global field titled Slack Channel under the General tab.
5. Fill out the name of the Slack channel (i.e. gong-notes) where the notes will be pushed to and you're all set!
   Note: If you'd like, you can have multiple organizations direct their notes to the same Slack channel.
   

All Affinity Notes into a Slack Channel

For all private/shared notes that you (the person setting up the integration) add or have access to (whether it's yours or those of your team members) in general, they will be pushed into the designated Slack channel of your choice.

Note: For this integration, threaded replies within a note will also be sent as notifications to the designated Slack channel.

1. Within the All Affinity Notes to a Slack Channel integration, click Select.
   
   
   
2. Click Configure new solution.
   
   
   
3. Authenticate your Slack account.
4. Select which Slack channel you'd like to push the notes into, or create a new Slack channel dedicated to these notes if you'd like.
   1. Note: Only public channels, private channels, and DMs are supported at this time. Group DMs are not supported at this time.
5. Once you select the channel, click Finish and you're all set!