SimpleTexting & Subscriptions V2 Integration

SimpleTexting provides SMS, MMS, and text marketing services. With this integration, you can link your SimpleTexting account to Bold Subscriptions V2 using webhooks and set up triggers for event based text message campaigns such as new subscriber offers, win-back campaigns, and more.

With SimpleTexting you can:

  • Get a number for your business for toll-free texting and short codes
  • Enable 2-way messaging to improve customer satisfaction
  • Send and schedule mass text messages
  • Collect phone numbers or message existing ones
  • Enable texting for teams

And much more! For detailed information on all the features SimpleTexting provides, please visit SimpleTexting Features.

 Alert

Please note, this is a technical integration. It is recommended to have your own developer as it requires knowledge in the use of APIs and webhooks.

 


 

Simple texting has different levels of price plans available depending on the amount of messages you wish to send per month. There is a 14 day free trial available for new members.

For more information on the price plans available, please visit SimpleTexting Pricing.

SimpleTexting_Price_Plans.png

In order to set up this integration you will need to have both Bold Subscriptions V2 and an account on Bold Account Center. This will allow you to create an API key and access Subscriptions V2 webhooks. For more information on creating your account, please visit Create & Connect a Bold Account

You will also need to create an account with SimpleTexting. Please notify the support team at SimpleTexting by emailing edith@simpletexting.net to let them know you would like to have them enable recipes for Bold Subscriptions.

  1. Log in, or create an account in Bold Account Center.

    Note: For more information on creating your account, please visit Create & Connect a Bold Account.

  2. Select API access tokens.
  3. Select Create API access token.
  4. Enter a name for your API key.
  5. Ensure the scopes appear as they do in the screenshot below.

    Scopes 1

    Scopes 2

  6. Select Create.

    Note: You will now be provided with the Shared Secret and API access token. This API access token will disappear once the dialogue box closes. Save this information in a secure location.

    API_shared_secret_and_access_token.png

  7. Get your shop identifier and Bold shop ID by following the Bold Commerce Developer Documentation.

    Note: The bearer token is your API secret as saved above.

  8. Review Bold's webhooks and decide which you'd like to subscribe to here: Webhook topics.

    Note: Webhook topic numbers can be found in the response sample. Some helpful ones are:
    New Subscription - offer subscriber texts and offers: webhook_topic_id = 1
    New Subscription order created - send out confirmation order texts: webhook_topic_id = 3
    Upcoming Subscription Reminders: webhook_topic_id = 9
    Transaction failed: webhook_topic_id = 6
    Cancelled subscription- create customer buy-back subscription texts: webhook_topic_id = 12

  9. Login to your SimpleTexting account.
  10. From your SimpleTexting dashboard, navigate to the Integrations > Custom Integration > View Recipes.
  11. Create a project or use Home Assets.

    Create a project

  12. Select Start guided setup on the right. Once you create an event name, it will provide you with a webhook URL.
  13. Subscribe to the Bold webhook of your choice. You can do this on Postman or REQBIN.
 Example

Webhook_example.png

 

The payload to POST to is in raw JSON format:

  • shop_id is the id from your first request to get your shop information.
  • Callback_url is the provided URL from SimpleTexting
  • The shared_secret was provided on your initial creation within the Bold Account Center in step 6 above.
  • webhook_topic_id is the webhook topic you want to subscribe to. The list of options here were provided in step 8 above.

 

For specific flows, the topics correlate with the number below:

  • New subscriber texts and offers: webhook_topic_id = 1
  • New order texts: webhook_topic_id = 3
  • Upcoming Subscription Reminders: webhook_topic_id = 9
  • Order failed texts: webhook_topic_id = 6
  • Customer buy-back subscription texts: webhook_topic_id = 12

 

Once your integration and webhooks are ready, you can test it out by triggering a webhook. For example, if you are using webhook_topic_id: 1 (subscription created), you can create a new subscription for yourself to see if it will be triggered in the SimpleTexting setup.

Helpful Links:

 


 

Example Recipes

This example will show you how to set up a recipe to send a text message to your customer once they purchase a subscription.

To complete these steps, you will need:

  • Your API Access Token and Shared Secret as shown in the Setup above.
  • Access to Postman.

 


 

 

Step 1: Start Guided Setup

  1. Log into your SimpleTexting account.
  2. Select Integrations > Custom Integrations.

    Integration page

  3. Select View recipes.

    View recipes

  4. Select Create project.

    Create project

  5. Enter a Name and a Description.

    Name and Description

  6. Select Create recipe.

    Create recipe

  7. Enter a Name and select a project Location for your recipe.

    Note: This is the project location that was just created.

  8. Select Trigger from a webhook.

    Trigger from a webhook

  9. Select Start building.
  10. Select Start guided setup.

    Start guided setup

  11. Enter your Event name.

    Event Name

 


 

Step 2: Register the Webhook

  1. Open Postman.
  2. From within your Workspace, go to APIs.
  3. Select the + sign above My Workspace to create a new request.

    Plus sign

  4. Select the Authorization tab.

    Authorization tab

  5. In the dropdown menu next to Type, select Bearer Token.

    Bearer Token

  6. Enter your API access token in the Token field.

    API access token

  7. Next to GET, in the Enter request URL field, enter: https://api.boldcommerce.com/shops/v1/info

    Note: This can be found in our developer documentation here.

    Request URL

  8. Select Send.

    Note: Save your shop_identifier number from the text that appears below, as it will be needed again.

    Shop identifier

  9. Paste the following link in the field next to GET: https://api.boldcommerce.com/subscriptions/v1/shops/{shop_identifier}/webhooks/topics

    Note: This can be found in our developer documentation here.

  10. Replace the text: {shop_identifier} in the above link with your shop identifier number.

    Replaced shop_identifier

  11. Select Send.
  12. Paste the following endpoint: https://api.boldcommerce.com/subscriptions/v1/shops/{shopIdentifier}/webhooks/subscriptions next to GET, but replace the text {shop_identifier} with your shop_identifier number.

    Note: This can be found in our developer documentation here.

    Replaced shop_identifier

  13. Switch your workspace to Body, select raw, and in the Text dropdown select, JSON.

    Change to JSON

  14. Using the dropdown menu, change GET to POST.

    POST

  15. Paste the following code in the window below:
    {
             "webhook_subscription": {
                 "callback_url": "https://webhooks.example.com",
                 "webhook_topic_id": 4,
                 "shared_secret": "exMh194qw8JD@A50dA^P"
             }
         }

    Note: This can be found in our developer documentation here.

    Paste code

  16. Return to SimpleTexting and copy the Workato webhook address.

    Workato webhook address

  17. Navigate back to Postman and place the Workato webhook address inside the quotes of the callback_url, change the webhook_topic_id to number 1, and paste in your own shared secret.

    callback_url and webhoot_topic_id pasted

  18. Select Send.

    Note: The registration is successful if the message 200 Success appears.

  19. Navigate back to your page in SimpleTexting, select Next.

    Next

  20. Navigate to your store and place a test order.
  21. Navigate back to SimpleTexting to confirm your event has been received.

    Event recieved

  22. Select Setup Webhook.

 


 

Step 3: Build Your Recipe

  1. Select the plus sign.

    plus sign

  2. Select Action in an app.

    Action in app

  3. From the right side of the page, select SimpleTexting.

    Select SimpleTexting

  4. Under Choose an action, scroll to the bottom and select Send SMS.

    Select Send SMS

  5. Select SimpleTexting connection.

    SimpleTexting connection

  6. Place your cursor in the Phone field. The Recipe data menu will pop up on the left.

    Access Recipe data

  7. Within the Recipe data menu, scroll down to Shipping address and expand the menu by selecting the arrow. Select Phone.

    Select Phone

  8. In the Message field, enter the message you would like to send to your new subscriber.

    Message

  9. Select the plus sign in the left window.

    Plus sign

  10. Select Stop job.

    Stop job

  11. Select Save.

    Save

  12. Select Exit.
  13. Select Start recipe.

    Start recipe

 


 

Step 4: Test

Go to your store and create a new test subscription using your own phone number in the shipping address to confirm the recipe works.

Based on the example setup, you can see the message that was received when our test subscription order was created.

 Example

Text message recieved

This example will show you how set up a flow to send a text message to a customer once they pause a subscription and offer them an option to reactivate.

This example requires two recipes. The first will send the message once the subscription is paused, the second will listen to the input from the customer and if received, send an API call to Bold Subscriptions to reactivate the subscription.

To complete these steps, you will need:

  • Your API Access Token and Shared Secret as shown in the Setup above.
  • Access to Postman.
  • An active test subscription on your store with your phone number in the shipping address, phone number field.

 


 

Step 1: Create a Custom Field

  1. Log into your SimpleTexting account.
  2. From the left menu, select Contacts > Custom fields.
  3. Select New Custom field.

    New Custom field

  4. Using the dropdown under Type, select Text.
  5. Enter Subscription ID in the Name field.
  6. Select Create.

    Select Create

 


 

Step 2: Create an HTTP Connection

  1. Log into your SimpleTexting account.
  2. From your SimpleTexting home page, select Integrations > Custom integrations > View recipes.
  3. Choose a Connection name and Location for your HTTP connection.
  4. Select Create connection.

    Create connection

  5. Search for and select HTTP.

    Search http

  6. In the Authentication type field, use the dropdown to select Header auth.
  7. In the Header authorization field, enter Authorization: Bearer and enter your API access token.

    Header Authorization

  8. Select Connect.

 


 

Step 3: Start Building Your First Recipe

  1. From your SimpleTexting home page, select Integrations > Custom Integrations.

    Integration page

  2. Select View recipes.

    View recipes

  3. Select the project Example Flows.

    Note: This is the project created in the last example. If you like, you can add it to a different project.

  4. Select Create recipe.

    Create recipe

  5. Enter a Name and select a project Location for your recipe.

    Note: This is the same project location that was created in the last example.

  6. Select Trigger from a webhook.

    Name and Location

  7. Select Start building.
  8. Select Start guided setup.

    Start guided setup

  9. Enter your Event name.

    Subscription paused

 


 

Step 4: Register the Webhook

  1. Open Postman.
  2. From within your Workspace, go to APIs.
  3. Select the + sign above My Workspace to create a new request.

    Plus sign

  4. Select the Authorization tab.

    Authorization tab

  5. In the dropdown menu next to Type, select Bearer Token.

    Bearer Token

  6. Enter your API access token in the Token field.

    API access token

  7. Next to GET, in the Enter request URL field, enter: https://api.boldcommerce.com/shops/v1/info

    Note: This can be found in our developer documentation here.

    Request URL

  8. Select Send.

    Note: Save your shop_identifier number from the text that appears below, as it will be needed again.

    Shop identifier

  9. Paste the following link in the field next to GET: https://api.boldcommerce.com/subscriptions/v1/shops/{shop_identifier}/webhooks/topics

    Note: This can be found in our developer documentation here.

  10. Replace the text: {shop_identifier} in the above link with your shop identifier number.

    Replaced shop_identifier

  11. Select Send.
  12. Paste the endpoint: https://api.boldcommerce.com/subscriptions/v1/shops/{shopIdentifier}/webhooks/subscriptions next to GET, but replace the text {shop_identifier} with your shop_identifier number.

    Note: This endpoint can be found in our developer documentation here.

    Replaced shop_identifier

  13. Switch your workspace to Body, select raw, and in the Text dropdown select, JSON.

    Change to JSON

  14. Using the dropdown menu, change GET to POST.

    POST

  15. Paste the following code in the window below:
    {
             "webhook_subscription": {
                 "callback_url": "https://webhooks.example.com",
                 "webhook_topic_id": 4,
                 "shared_secret": "exMh194qw8JD@A50dA^P"
             }
         }

    Note: This can be found in our developer documentation here.

    Paste code

  16. Return to SimpleTexting and copy the Workato webhook address.

    Copy Workato Address

  17. Navigate back to Postman and place the Workato webhook address inside the quotes of the callback_url, change the webhook_topic_id to number 13, and paste in your own shared secret.

    callback_url and webhoot_topic_id pasted

  18. Select Send.

    Note: The registration is successful if the message 200 Success appears.

  19. Navigate back to your page in SimpleTexting, select Next.

    Next

  20. Navigate to your store and pause your test subscription order.
  21. Navigate back to SimpleTexting to confirm your event has been received.

    Event recieved

  22. Select Setup Webhook.

 


 

Step 5: Build your flow

  1. In your recipe window, select the plus sign.

    plus sign

  2. Select Action in an app.

    Action in app

  3. Select SimpleTexting on the right side of the page.

    SimpleTexting

  4. Under Choose an action, scroll to the bottom and select Send SMS.

    Send SMS

  5. Select SimpleTexting connection.

    SimpleTexting connection

  6. Place your cursor in the Phone field. The Recipe data menu will pop up on the left.

    Recipe data

  7. Within the Recipe data menu, scroll down to Shipping address and expand the menu by selecting the arrow. Select Phone.

    Phone

  8. In the Message field, enter the message you would like to send to your subscriber.

    Paused Message field

  9. Select the plus sign.

    plus sign

  10. Select Action in an app.
  11. Select SimpleTexting on the right side of the page.
  12. Select Create/Update Contact.

    Create Update Contact

  13. Place your cursor in the Contact phone field and from the Recipe data menu, select New event via webhook.

    New event via webhook

  14. Scroll down to Shipping address and expand the menu by selecting the arrow. Select Phone.

    Select Phone

  15. In the comment field, enter true.

    true

  16. Select + 1 optional field.

    Optional field

  17. Select Subscription ID and then Apply changes.

    Subscription ID Apply Changes

  18. Under Custom fields, select Show.
  19. Place your cursor in the field under Subscription ID.
  20. In the Recipe data menu, scroll down to Payload and select ID.

    Payload ID

  21. Select the plus sign.

    plus sign

  22. Select Stop job.

    Stop job

  23. Select Save.
  24. Select Exit.
  25. Select Start recipe.

    Start recipe

 


 

Step 6: Start Building Your Second Recipe

  1. From the home page select Integrations > Custom Integrations > View recipes.
  2. Select the project Example Flows.

    Note: This project location was created in the last example.

  3. Select Create recipe.
  4. Enter a Name and select a project Location for your recipe.

    Note: The name Call Bold API was selected as this flow will be listening for the input from the customer and use Bold’s API to reactivate the subscription.

  5. Select Trigger from an app.

    My new recipe

  6. Select Start building.
  7. On the right, select SimpleTexting.

    SimpleTexing

  8. Select Get Messages.

    Get Messages

  9. Select SimpleTexting connection.

    SimpleTexting connection

  10. Select the dropdown under Trigger and select Incoming Message.

    Incoming Message

  11. Select OK.
  12. On the left side of your workspace, select the plus sign under Actions.

    Plus under Actions

  13. Select Action in an app.

    Action in an app

  14. On the right side of your workspace, select SimpleTexting.
  15. Scroll down and select Get a contact.

    Get a contact

  16. Place your cursor inside the Contact phone field. Within the Recipe data menu, under Message, select Contact phone.

    Contact phone

  17. On the left side of your workspace, select the plus sign.
  18. Select IF condition.

    IF condition

  19. On the right side of your workspace, place your cursor in the Data field.
  20. In the Recipe data menu select Get a Contact, then under Custom fields select Comment.

    Comment

  21. Select the dropdown under Condition, and select equals.
  22. In the Value field, enter true.

    IF true

  23. On the left side of your workspace, hover over Select app and action to do when condition is met until the ellipsis appears. Select Delete.

    Select Delete

  24. Hover your cursor underneath Yes, and select the plus sign.

    Hover plus

  25. Select IF condition.

    IF condition

  26. On the right side of your workspace place your cursor in the Data field.
  27. In the Recipe data menu select Get Messages, then select Text.

    Text

  28. Select the dropdown in the Condition field and select equals.
  29. Under Value, select Formula and enter "1".to_s

    Note: This changes the integer to a string in Ruby.

  30. On the left side of your workspace, select Select app and action to do when condition is met.

    Select app and action

  31. On the right side of your workspace, select HTTP.

    Note: If you do not see the HTTP option, you can use the search bar to find it.

    HTTP

  32. Select My HTTP account.

    My HTTP account

  33. Select setup manually.

    Setup Manually

  34. Under Request, change the Method from GET to POST.
  35. In the Request URL field enter the API endpoint: https://api.boldcommerce.com/subscriptions/v1/shops/{shop_identifier}/subscriptions/{subscription_id}/activate

    Note: This can be found our developer documents.

  36. Replace the {shop_identifier} with your own shop identifier number.
  37. Remove {subscription_id} but leave your cursor placed in the area.
  38. In the Recipe data menu, scroll down to Custom fields and select Subscription ID.

    Subscription ID Selected

  39. On the left side of your workspace, select the plus sign and then Stop job.

    Stop job

  40. Select the plus sign once more, and then select Stop job again.

    Stop job

  41. Select Save and Exit.
  42. Select Start recipe.

 


 

Step 7: Test

Go to your store and pause your test subscription to confirm the recipe works. Once you receive the text message, you will need to reply 1 to reactivate your subscription. Check your customer profile to confirm the subscription was reactivated.

Based on the example setup, you can see the message that was received when our test subscription was paused. This successfully reactivated our test subscription.

 Example

Paused Subsription SMS

Was this article helpful?
0 out of 0 found this helpful