# Postscript x Smartrr Integration

Last updated: May 14, 2025

## Setup

{% hint style="warning" %}
**📲 Note:** Smartrr does not currently act as a service to gather SMS subscribers. For this integration, we are assuming that your customers are already subscribed via Postscript. For instructions on how to gather Postscript subscribers, [<mark style="color:blue;">**click here**</mark>](https://postscript.io/grow-your-list). \
\
You may also need to be on a Postscript plan that allows integrations. Please contact your Postscript representative directly should you have questions on upgrading your plan.&#x20;
{% endhint %}

To integrate Postscript and Smartrr, first create a security key pair from your Postscript dashboard under Settings > API.

![](https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FFVqwkTT3plMEHfe0TYGj%2FScreen%20Shot%202022-07-06%20at%2011.02.13%20AM.png?alt=media\&token=6da56b9e-104e-415b-874b-8203158e469f)

Once created, show and copy your **Private Key** to your clipboard. Paste this key in your Smartrr admin under **Integrations**.

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FzsznJOrxjsh0WbHjNfT8%2Fpostscript-connect.png?alt=media&#x26;token=903f2395-46c8-4580-8d2f-fe7469de3dc4" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FRG6QRgeA0IMuSj2kybsz%2Fadd-postscript-api-key.png?alt=media&#x26;token=996d76ad-491c-40fc-bcd1-86b20439a29b" alt=""><figcaption></figcaption></figure>

Click **Confirm**. Once saved, your integration setup is complete!

## Postscript Triggers

The Smartrr x Postscript integration works by sending **triggers** on a subscriber-level that can be used to create automations inside the Postscript admin based on the below events.&#x20;

<mark style="color:green;">In green</mark> we've outlined some example copy for SMS automations that your shop could create using these triggers.&#x20;

[<mark style="color:blue;">Jump to the section below</mark>](#postscript-automations) to learn how to set up **automations** in Postscript using Smartrr triggers.&#x20;

<table><thead><tr><th width="210">Trigger</th><th>Description</th><th>Potential SMS Example</th><th data-hidden></th><th data-hidden></th><th data-hidden></th></tr></thead><tbody><tr><td><strong>🆕 Subscription Created</strong></td><td>Sent whenever a new subscription is created</td><td><mark style="color:green;">Hi {first_name}, thanks for your subscription! Manage your subscription by creating an account here: {account_page_link}</mark></td><td></td><td></td><td></td></tr><tr><td><strong>🔁 Upcoming Order</strong></td><td>Sent 3 days before upcoming order, customer provided option to skip</td><td><mark style="color:green;">Heads up: your upcoming subscription will ship in 3 days. Not quite ready? Just reply SKIP</mark></td><td></td><td></td><td></td></tr><tr><td><strong>⏭ Skipped Order</strong></td><td>Sent when a customer skips after receiving the upcoming order notification</td><td><mark style="color:green;">Confirmed! Your upcoming subscription will be skipped. Your next order will be on {new_delivery_date}</mark></td><td></td><td></td><td></td></tr><tr><td><strong>💳 Payment Method Updated</strong></td><td>Sent whenever a customer successfully updates their payment method</td><td><mark style="color:green;">Hi {first_name}, your payment method has been successfully updated!</mark></td><td></td><td></td><td></td></tr><tr><td><strong>❗️Payment Method Failed</strong></td><td>Sent whenever a payment method for an upcoming order has failed</td><td><mark style="color:green;">Your recent payment wasn't completed. To update your payment method, click here: {account_page_link}</mark></td><td></td><td></td><td></td></tr><tr><td><strong>❌ Customer Deactivated</strong> </td><td>Sent when when a customer's last subscription has been canceled </td><td><mark style="color:green;">We're reaching out to confirm your subscription has been canceled. We're sorry to see you go.</mark></td><td></td><td></td><td></td></tr></tbody></table>

## Postscript Automations

To create an automation in Postscript navigate to **Automations** under **Messaging**.&#x20;

{% hint style="info" %}
&#x20;**Note:** For Smartrr's integration, please use **Legacy Automations**.&#x20;
{% endhint %}

![](https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2Ft48S53UyIOUtef0GnGcC%2FScreen%20Shot%202022-08-17%20at%203.37.55%20PM.png?alt=media\&token=2acdbb0b-40bc-47f0-a696-93033bd6cce7)

Click **Create Automation**. Be sure to choose the Legacy option.&#x20;

![](https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FhKujVEl3GBzQJUAHWjtQ%2FScreen%20Shot%202022-08-17%20at%203.39.08%20PM.png?alt=media\&token=734269f9-9664-45d0-9803-acea389ce4aa)

Select Custom Automation.

![](https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2F7pAoS5hqihbl7cwgFbvF%2FScreen%20Shot%202022-08-17%20at%203.41.10%20PM.png?alt=media\&token=a07a0dca-c0ca-4c0f-af72-d0d5551e5582)

Select any of the triggers that begin with **Smartrr:** to proceed.&#x20;

![](https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FyGi1azfhpDNaKn5cPpWj%2FScreen%20Shot%202022-08-17%20at%203.41.54%20PM.png?alt=media\&token=bab6d5f8-1117-4325-b112-e2af12763d78)

You're now ready to add your desired SMS copy and set a wait period. You can set a wait time as low as 1 minute.&#x20;

![](https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FJFvBkNsz3u9lQQL8lFYu%2FScreen%20Shot%202022-08-17%20at%203.44.14%20PM.png?alt=media\&token=a2607093-e7c5-425f-961c-603974a53548)

To add dynamic tags to your SMS automation, click **More** and **Add Tags**. The default tags scoped to Postscript include <mark style="color:purple;">`shop_name`</mark>, <mark style="color:purple;">`first_name`</mark>, <mark style="color:purple;">`last_name`</mark> and <mark style="color:purple;">`shop_link`</mark>. To add Smartrr-specific dynamic tags, reference the below table for tags associated with each trigger:

![](https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FRQ8Bi4dqCXHi640cSyaA%2FScreen%20Shot%202022-08-17%20at%203.47.27%20PM.png?alt=media\&token=fad7b511-612a-420a-990f-9df5ea41e361)

<table><thead><tr><th width="267">Trigger</th><th>Associated Tags</th><th data-hidden></th></tr></thead><tbody><tr><td><strong>🆕 Subscription Created</strong></td><td><pre><code>{account_page_link}
{delivery_frequency}
{delivery_frequency_unit}
</code></pre></td><td></td></tr><tr><td><strong>🔁 Upcoming Order</strong></td><td><pre><code>{account_page_link}
</code></pre></td><td></td></tr><tr><td><strong>⏭ Skipped Order</strong></td><td><pre><code>{account_page_link}
{new_delivery_date}
</code></pre></td><td></td></tr><tr><td><strong>💳 Payment Method Updated</strong></td><td><pre><code>{account_page_link}
</code></pre></td><td></td></tr><tr><td><strong>❗️Payment Method Failed</strong></td><td><pre><code>{account_page_link}
{retry_num} 
</code></pre></td><td></td></tr><tr><td><strong>❌ Customer Deactivated</strong> </td><td><pre><code>{account_page_link}
</code></pre></td><td></td></tr></tbody></table>

{% hint style="info" %}
**Tip:** Make sure you save your automation and that it's enabled by sure the **Active** toggle is flipped to green.&#x20;

**Reminder:** in the United States, automation "waking hours" are from 11AM to 9PM.&#x20;
{% endhint %}

![](https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2Fdw28C6QtM2YU0VbUWcZV%2FScreen%20Shot%202022-08-17%20at%203.59.52%20PM.png?alt=media\&token=31cdb53f-405e-4132-b730-cbc817de8ef7)

### Customer Keyword Responses

Your customers can use specific keywords to trigger certain actions on their subscription.

#### Skip

<table><thead><tr><th width="129.66666666666666">Response</th><th>Action</th></tr></thead><tbody><tr><td>SKIP</td><td>Skips customer's next scheduled subscription order.</td></tr></tbody></table>

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2Foj9lDWb5TBBlDaSNScyF%2FGitbook%20%E2%80%93%20Skip%20Subscriptions%20Postscript%20Example.png?alt=media&#x26;token=cbe95478-9c77-4581-a475-eb45f9df19dc" alt=""><figcaption><p>Example of "SKIP" response.</p></figcaption></figure>

To set up a prompt for the customer to SKIP, set up a legacy automation with the automation trigger: **Smartrr: Upcoming Order**.&#x9;

{% code overflow="wrap" %}

```
{shop_name}: Heads up: your upcoming subscription from {shop_name} will ship in 3 days. Not quite ready? Just reply SKIP. To manage your subscription go to {account_page_link}
```

{% endcode %}

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FJvh5pJdAyWnU1kCKyT4u%2FScreenshot%202023-05-10%20at%2009.14.51.png?alt=media&#x26;token=f64c6ae2-3d76-40a0-8ffa-4e922794a470" alt=""><figcaption></figcaption></figure>

To set up a response to SKIP, set up a second legacy automation in response to the trigger: **Smartrr: Order Skipped**.&#x20;

{% code overflow="wrap" %}

```
{shop_name}: Confirmed! Your upcoming subscription will be skipped. Your next order will be on {new_delivery_date}. To manage your subscription go to {account_page_link}
```

{% endcode %}

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FDs7ubTh0P8Uca19YGczd%2FScreenshot%202023-05-10%20at%2009.12.30.png?alt=media&#x26;token=c16516ac-4625-40d2-97d2-4a87f31eef23" alt=""><figcaption></figcaption></figure>

### FAQs

1. **Where can I track Smartrr messages in Postscript?** \
   You can view your message analytics in your Postscript dashboard under Analytics > Messages. You can also view direct customer responses to automated messages in Messaging > Responses.

![](https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FdY2PfSt8CqpTL3qPi8J9%2FScreen%20Shot%202022-08-17%20at%204.04.31%20PM.png?alt=media\&token=291d58cc-b2eb-4e54-a389-34b2587f8acf)

![](https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FynuTaQoKVmYZVCRwiXEk%2FScreen%20Shot%202022-08-17%20at%204.03.48%20PM.png?alt=media\&token=6e19cacc-4042-4b9a-b823-c021caeb7066)

### 🕒 Coming soon...

The below features will be coming soon to the Smartrr x Postscript integration:&#x20;

* Text DELAY to delay a subscription
* Ability to pull in dynamic Shopify customer data into SMS