Integrating Inbound SMS Messaging with Slack

Prerequisites

  • An AWS account with Admin Privileges
  • An Atmosphere® SmartFlows account
  • A Slack account
  • cURL or PostMan to test the API Endpoint (Optional)

Create a Slack App

Slack apps provide the packing for any functionality you wish to implement through Slack.

  1. Create a Slack workspace.
  2. Click your workspace name and select Settings & Administration -> Manage apps from the drop-down menu.

  1. Select Build from the menu options on the top right side of the slack app directory.
  2. Under Your Apps, click Create an App.
  3. In the Create a Slack App pop-up, enter a name for your app and select your workspace from the Development Slack Workspace drop-down list.

  1. Click Create App, and you will be brought to your application’s Settings Basic Information section.
  2. Under the Add Features and Functionality section, click Incoming Webhooks (or select Incoming Webhooks from the menu on the left).

  1. Set Activate Incoming Webhooks to On via the slider.
  2. Scroll down to the bottom of the page and click Add New Webhook to Workspace.
  3. Select the Slack workspace where the messages should go (via the Search for a channel drop-down list) and click Allow to authorize the Slack app to post messages there.

  1. A new Webhook will be added to your bot. Back on the Incoming Webhooks page, note the Webhook URL near the bottom of the page. You will need it later to when configuring your SmartFlow.

  1. Navigate to the SmartFlow receiving your inbound message.
  2. Add a new External Web Call.

  1. Click on the action you just placed on the board and configure as follows:
    • METHOD: POST
    • URL OF SERVICE: Enter your Slack Webhook URL here
    • BODY: {“text”: “$ISMS_1.message”}
  2. SAVE and DEPLOY your updated flow.

Test Your Command

Once you have saved and deployed your flow, to test, simply send an SMS message to the number assigned to your SmartFlow.