SMSTunnel for Shopify

• A store on the Grow, Advanced or Plus plan. Flow itself is free on every plan from Basic up, but its Send HTTP request action, which these workflows use, isn't available on Basic.
• The Shopify Flow app (in your admin: Apps → Flow; if it isn't there, add it for free from the Shopify App Store).
• The staff permission Manage connections and secrets, to save your key in Flow and to turn on workflows that use it.
• An Android phone with the SMSTunnel app from Google Play, signed in to your SMSTunnel account.

1. 1. Install the SMSTunnel app from Google Play on your Android phone and sign in.
2. 2. In your dashboard, open Apps → Add an app, pick Shopify Flow, name it (for example "Shopify") and click Create the key.
3. 3. Copy the key right away: it's shown only once. You can stop or delete the app there anytime, and Shopify can't send texts anymore.

Get the steps with your key in them

It opens Add an app with Shopify Flow picked. Once the key is made, the dashboard shows every step and command with the key already filled in, ready to copy.

The key can send texts and look up whether they went out; it can't read the texts your phone receives.

1. 1. In Apps → Flow, click Create workflow, then Select a trigger and choose Order created.
2. 2. Click + under the trigger, choose Action, then Send HTTP request, and fill it in as in step 3 with this Body. Change +14155550123 to your own number, written with + and the country code:
   Body: new order, to you

   {%- capture cents -%}{{ order.totalPriceSet.shopMoney.amount | times: 100 | round }}{%- endcapture -%}
   {%- capture total -%}{{ cents | divided_by: 100 | floor }}.{{ cents | modulo: 100 | plus: 100 | slice: 1, 2 }} {{ order.totalPriceSet.shopMoney.currencyCode }}{%- endcapture -%}
   {%- capture message -%}
   New order {{ order.name }}{% if order.customer.displayName %} from {{ order.customer.displayName }}{% endif %}: {{ total }}, {{ order.subtotalLineItemsQuantity }} {% if order.subtotalLineItemsQuantity == 1 %}item{% else %}items{% endif %}.
   {%- endcapture -%}
   {
     "to": "+14155550123",
     "message": {{ message | strip | json }},
     "defaultCountryCode": "1"
   }

3. 3. More numbers: each number is its own action. Click + after the action, add another Send HTTP request with the same settings and the same Body, and type the other number. Put the most important number first: if an action fails, the ones after it don't run.
4. 4. Click New Workflow at the top, name it (for example "SMSTunnel: text me new orders") and click Turn on workflow.

The first two lines only turn the total into two decimals (86.5 becomes 86.50); the words of the text are inside capture message. To skip sales made in person with Shopify POS, add a Condition before the action: order.sourceName Not equal to pos.

1. 1. Create workflow → Select a trigger → Fulfillment created. It runs once per shipment, so a split order gets one text per package, each with its own tracking.
2. 2. Click +, choose Condition: pick fulfillment → trackingInfo → number, choose At least one of, then Not empty and exists. This skips fulfillments without tracking, such as digital items.
3. 3. On the True path, add another Condition, choose If any criteria are met, and add three criteria, each Not empty and exists:
   • fulfillment.order.shippingAddress.phone
   • fulfillment.order.phone (the phone given at checkout)
   • fulfillment.order.customer.defaultPhoneNumber.phoneNumber
4. 4. On its True path, add the Send HTTP request action (step 3) with this Body. It takes the first number it finds, in the order above:
   Body: on its way, to the customer

   {%- capture to -%}{{ fulfillment.order.shippingAddress.phone }}{%- endcapture -%}
   {%- if to == "" -%}{%- capture to -%}{{ fulfillment.order.phone }}{%- endcapture -%}{%- endif -%}
   {%- if to == "" -%}{%- capture to -%}{{ fulfillment.order.customer.defaultPhoneNumber.phoneNumber }}{%- endcapture -%}{%- endif -%}
   {%- capture tracking -%}
   {%- for info in fulfillment.trackingInfo limit: 1 -%}
   {%- if info.url -%}{{ info.url }}{%- else -%}{{ info.number }}{%- endif -%}
   {%- endfor -%}
   {%- endcapture -%}
   {%- capture message -%}
   {{ shop.name }}: your order {{ fulfillment.order.name }} is on its way.{% if tracking != "" %} Tracking: {{ tracking }}{% else %} Details: {{ fulfillment.order.statusPageUrl }}{% endif %}
   {%- endcapture -%}
   {
     "to": {{ to | strip | json }},
     "message": {{ message | strip | json }},
     "defaultCountryCode": "1"
   }

5. 5. Name it and click Turn on workflow.

If you ship without tracking numbers, leave out the condition of step 2: the text then links the customer's order status page instead. Tracking added to a shipment later doesn't start the workflow again.

Both start the same way: the trigger, then the "has a phone" Condition from Workflow 2, step 3, with the same three fields under order (order.shippingAddress.phone, order.phone, order.customer.defaultPhoneNumber.phoneNumber), then the action on its True path.

1. 3a. Trigger Order canceled, with this Body:
   Body: canceled, to the customer

   {%- capture to -%}{{ order.shippingAddress.phone }}{%- endcapture -%}
   {%- if to == "" -%}{%- capture to -%}{{ order.phone }}{%- endcapture -%}{%- endif -%}
   {%- if to == "" -%}{%- capture to -%}{{ order.customer.defaultPhoneNumber.phoneNumber }}{%- endcapture -%}{%- endif -%}
   {%- capture message -%}
   {{ shop.name }}: your order {{ order.name }} has been canceled.
   {%- endcapture -%}
   {
     "to": {{ to | strip | json }},
     "message": {{ message | strip | json }},
     "defaultCountryCode": "1"
   }

2. 3b. Trigger Refund created, with this Body (the amount is what was refunded on the order so far, in the customer's currency):
   Body: refunded, to the customer

   {%- capture to -%}{{ order.shippingAddress.phone }}{%- endcapture -%}
   {%- if to == "" -%}{%- capture to -%}{{ order.phone }}{%- endcapture -%}{%- endif -%}
   {%- if to == "" -%}{%- capture to -%}{{ order.customer.defaultPhoneNumber.phoneNumber }}{%- endcapture -%}{%- endif -%}
   {%- capture cents -%}{{ order.totalRefundedSet.presentmentMoney.amount | times: 100 | round }}{%- endcapture -%}
   {%- capture refunded -%}{{ cents | divided_by: 100 | floor }}.{{ cents | modulo: 100 | plus: 100 | slice: 1, 2 }} {{ order.totalRefundedSet.presentmentMoney.currencyCode }}{%- endcapture -%}
   {%- capture message -%}
   {{ shop.name }}: we have refunded your order {{ order.name }}. Total refunded: {{ refunded }}.
   {%- endcapture -%}
   {
     "to": {{ to | strip | json }},
     "message": {{ message | strip | json }},
     "defaultCountryCode": "1"
   }

Canceling an order with a refund starts both workflows, so the customer gets both texts. Turn on only one of them if that is too much.

• See the text before sending anything: in the workflow, click Test your workflow at the trigger, then + Add event → Create event and pick an existing order. Click the Send HTTP request action and open Preview: you see the Body with the real values. A test never sends the request.
• Send a real one: turn the workflow on and place a test order on your store (or fulfill one). The text leaves from your phone within seconds, and the run shows under the workflow's Recent runs.

Does it work on the Basic plan?

Not with Flow: its Send HTTP request action needs Grow, Advanced or Plus.

Do I install anything in Shopify?

Only Flow, Shopify's own free app, if it isn't there yet. You paste the values into it.

Can I import a ready-made workflow?

Shopify creates .flow files itself and doesn't support files made outside Flow, so this page gives the values to copy. Once a workflow works in your store, you can export it and import it in your other stores.

What does it cost?

Your carrier's usual price for each text, plus your SMSTunnel plan.