# Keap integration with Sociocs

# Introduction

Add ability to send text/SMS (using your Twilio account) or WhatsApp messages (using your Twilio or Gupshup account) from your Keap automation.

When the recipient replies to the message, it shows up in your Sociocs Inbox, from where you can reply, and continue the conversation.

# Supported channels

  • SMS (with Twilio)
  • WhatsApp (with Twilio)
  • WhatsApp (with Gupshup)

# Setup on Sociocs

  1. Sign up or log in on app.sociocs.com.

  2. Connect "SMS (with Twilio)", "WhatsApp (with Gupshup)", or "WhatsApp (with Twilio)" channel on the "Connect a new channel" page. If you're an existing user, after logging in, click on "Channels" menu on the top, click on "+" button to go to the "Connect a new channel" page.

  3. Go to "Profile & settings -> API". settings

    api

  4. Find "API key", "provider", and "channel_key". You'll need this information later. (If you're using Sociocs API for the first time, you need to enable it by clicking on "Enable API" button.) key

# Setup on Keap

  1. Open the automation sequence where you want to add the SMS message. sequence

  2. Drag an HTTP Post object onto the canvas. post

  3. Double click the added HTTP Post action to edit it.

  4. Under "POST URL", enter Sociocs API URL with your API key in below format. https://api.sociocs.com/message?apikey=your-api-key

    For example, if you API key is abcd1234, the API URL value should be entered as https://api.sociocs.com/message?apikey=abcd1234

  5. Under "Name / Value Pairs", enter below name and value pairs.

    Name Value Remarks
    provider provider value from "Profile & settings -> API" page (e.g., twlo) If you've multiple phone numbers in Sociocs, make sure to select the applicable channel on the API page.
    channel_key channel_key value from "Profile & settings -> API" page (e.g., twlo_16317471111) If you've multiple phone numbers in Sociocs, make sure to select the applicable channel on the API page.
    to ~Contact.Phone1~ Recipient's phone number. You can also enter a phone number directly or use any other variable available in Keap.
    name ~Contact.FirstName~ Recipient's name. You can also enter a name directly or use any other variable available in Keap.
    text Hello world! SMS / text message content you would like to send.

    Example: pairs

  6. Once you've got it all set up, you can quickly test it on your user record (assuming you've your mobile phone as the Phone 1 in your user record.)

    test

That's it, you are all set to send messages to your target recipients!