# 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.

If you're already using Twilio API under "Send HTTP Post" in Keap for sending SMS, you can replace it with the Sociocs app to enable a two-way conversation with the recipients.

You need a FREE TRIAL or PAID account on Sociocs to use the necessary API for this integration.

# Supported channels

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

# Setup on Sociocs

Sign up or log in on app.sociocs.com.
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.
Go to "Profile & settings -> API".
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.)

# Setup on Keap

Open the automation sequence where you want to add the SMS message.
Drag an HTTP Post object onto the canvas.
Double click the added HTTP Post action to edit it.
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

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

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.)

Whenever you're using a WhatsApp channel to initiate a message, please make sure the message text is approved as a template by WhatsApp, and enter it exactly as the approved template's text.

You can submit the template for approval on the website of the provider you used (e.g., Twilio) for creating your WhatsApp account.

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