Setup the Slack Premium Integration

  • Updated

With Showcase IDX, you can use a Premium integration to send leads and their search activity to Slack.

A couple key things to note before we walk through Slack and how to set up the integration

If you don't see the Integrations tab, that means you are not an Admin on the account. Only Admins can add integrations. Contact your account Admin to help with your integration setup

The Slack integration is a Premium feature. If your green button doesn't say "Add", it will say "Upgrade" instead. You would need to upgrade your account in order to use the Slack integration.

What is Slack?

Slack is a messaging program designed specifically for the workplace. Developed by American software company Slack Technologies and now owned by Salesforce, Slack offers many IRC-style features, including persistent chat rooms organized by topic, private groups, and direct messaging.

Set Up the Slack Integration

Setting up the integration is super easy and only takes a few steps. 

  1. In your IDX Control Panel, navigate to the Integration tab. Scroll the page until you find the line that says Slack and click the green "Add" button.

    Screen_Shot_2022-05-06_at_5.36.02_PM.png

     

  2. The next part takes place within Slack. It's a good idea to have a specific channel in mind before proceeding. Visit the Slack Help Centerto learn how to create a channel. For these instructions, we're using a private channel called #slack-integration, as shown below.

    Screen_Shot_2022-05-06_at_10.59.07_AM.png

  3. In your Slack account, click on your workspace name, then "Administration" and then choose "Manage Apps".

    Screen_Shot_2022-05-06_at_5.30.24_PM.png

  4. On the page in your browser that pulls up, enter "Incoming WebHooks" into the search bar. Select the option that matches. 

    Screen_Shot_2022-05-06_at_10.56.00_AM.png

  5. Click "Add to Slack" on the application page.

    Screen_Shot_2022-05-06_at_5.31.33_PM.png

  6. Now we'll choose the channel to post our events to. Use the dropdown to find your preferred channel or type in the channel name to find it quickly, then click the green "Add Incoming WebHooks integration" button.

    Screen_Shot_2022-05-06_at_11.08.30_AM.png

  7. This will post an update to your slack channel that an integration has been added. This is good!

  8. Copy the WebHook URL from the page but don't close the page yet.

    Screen_Shot_2022-05-06_at_5.34.53_PM.png

  9. Hop over to your IDX Control Panel and paste the URL in the input box labeled "Web Hook".

    Next, name your integration. It doesn't really matter what you name it.

    Select an integration level. There are three options to choose from:

    1. Account Level: all events for leads from all websites and users
    2. Website Level: all events for leads for a specific website on the account
    3. User Level: all events for leads for a specific user on the account

    Lastly, select the types of events you would like notifications for in the channel. Then click the blue "Save" button.

    webhook.gif

  10. Clicking "Save" will send a test ping to your slack channel. This confirms that your integration is working.

    Screen_Shot_2022-05-06_at_11.25.56_AM.png

  11. If you go back to the page where you copied the WebHook URL from, you can further customize the settings of the integration. There are options to include message attachments, customize the bot appearance, etc. You'll want to consult the Slack Help Center for support with these items. 

    Screen_Shot_2022-05-06_at_5.39.24_PM.png

And that's it! If your IDX is installed on your website, you can run some tests to see how the integration works!

Slack Events

There are several types of events that can post to Slack. Each event shares information that helps you know more about the leads that register on your website.

  • This event triggers every time a lead registers on your website. The name of the lead will be a hyperlink to their lead profile page in your IDX Control Panel.

    Screen_Shot_2022-05-06_at_11.46.02_AM.png

  • This event triggers every time a lead sends a message on your website (like through a contact form, market value form, ask a question form or schedule a tour form on a listing page). There are three hyperlinks for a message event: Lead name (lead profile page), message text (links to the message in the IDX Control Panel) and the address (links to your website).

    Screen_Shot_2022-05-06_at_2.39.16_PM.png

     

  • This event triggers every time a lead views a listing. The name of the lead is a hyperlink to the lead profile page, and the address of the property is a hyperlink that links to your website.

    Screen_Shot_2022-05-06_at_2.36.56_PM.png

     

  • This event triggers every time a lead saves a listing. The name of the lead is a hyperlink to the lead profile page, and the address of the property is a hyperlink that links to your website.

    Screen_Shot_2022-05-06_at_2.42.16_PM.png

     

  • This event triggers every time a lead hides a listing. The name of the lead is a hyperlink to the lead profile page, and the address of the property is a hyperlink that links to your website.

    Screen_Shot_2022-05-06_at_2.43.04_PM.png

     

  • This event triggers every time a lead subscribes to a search. The name of the lead is a hyperlink to the lead profile page, and the name of the search is a hyperlink that links to that search on your website.

    Screen_Shot_2022-05-06_at_2.43.50_PM.png

     

  • This event triggers every time a lead reacts to a listing. The name of the lead is a hyperlink to the lead profile page, and the name of the search is a hyperlink that links to that search on your website. We also post the emoji that accompanies the reaction. This example shows that the lead loved the listing.
    Screen_Shot_2022-05-06_at_2.44.56_PM.png

  • There are two types of comment events: Private comment and Agent Visible comment. In both cases, the lead's name is hyperlinked to their lead profile page and the address that they left a comment on is hyperlinked to the website.

    Private comments are comments that leads can make that can be shared with members of their search party (See Friends & Family) The lead doesn't want the agent to know what the comment on the listing is, but the agent can still know that they left a comment.

    Screen_Shot_2022-05-06_at_5.01.40_PM.png

    Agent Visible comments are comments that send a notification to the assigned agent. The lead wants the agent to know what the comment is and the agent could reply back.

    Screen_Shot_2022-05-06_at_5.04.06_PM.png

Video Tutorial