> This page is for version Scripted.
> For other versions, use one of these documentation indexes:
> - Generative (default): https://developers.ada.cx/generative/llms.txt
> - Scripted: https://developers.ada.cx/scripted/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.ada.cx/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.ada.cx/_mcp/server.

# Let chatters track shipments using the Shopify block

## Overview\[#UUID-8d41c687-5ec1-9a4c-aedc-1488afb3c74f_id_1500010742881_id_h_01F5KPWW8CV68DZ7YECJ8T4CYN]

The Shopify block helps you to create powerful interactions between Ada
and Shopify. With the Shopify block, you can:

* Look up Shopify shipment details using an order number.

* Get last order and Shopify customer info using the customer's email
  address.

> **Note**
>
> This feature may not be included with your organization's subscription
> package. For more information, see Ada's
> [Pricing](https://www.ada.cx/pricing) page, or contact your Ada team.

## Prepare your bot\[#UUID-8d41c687-5ec1-9a4c-aedc-1488afb3c74f_section-idm43346947243098]

Before using the Shopify block in your bot, you should do two things:

1. Set up a [Capture block](/scripted/docs/build-and-maintain-your-bot/work-with-blocks-and-apps/save-chatter-information-using-the-capture-block)
   to capture the order number from your chatters before they reach the
   Shopify block. Then, you can easily reference that variable in the
   Shopify block.

2. Think about how you want to verify chatters to ensure that the wrong
   people don't access sensitive information or perform sensitive
   actions. For your chatters' security, it's a good idea to verify
   and/or authenticate chatters. For more information, see [Protect chatter data using verification and authentication](/scripted/docs/build-and-maintain-your-bot/personalize-conversations/protect-chatter-data-using-verification-and-authentication).

## Create a custom app for your Shopify store\[#UUID-8d41c687-5ec1-9a4c-aedc-1488afb3c74f_id_1500010742881_id_h_01F5KPX5D6YE0VZZ7Y4G02TXC3]

Configuring the Shopify block requires you to create what Shopify calls
a *custom app*. For more information about custom apps, refer to
[Shopify's custom app documentation](https://help.shopify.com/en/manual/apps/app-types/custom-apps).

> **Note**
>
> Before you can create a custom app for your Shopify store, you need to
> enable custom app development. You need to be the store owner or a staff
> member with the **Enable app** development permission to enable custom
> app development.

When creating your app, under the **Admin API** section, ensure that the
following permissions are all set to **read access**:

* Customers

* Fulfillment services

* Orders

* Shipping

## Configure the Shopify block\[#UUID-8d41c687-5ec1-9a4c-aedc-1488afb3c74f_id_1500010742881_id_h_01F5KPXCCF9ZZ1GSQYYYPFR9E6]

To configure the Shopify block in Ada:

1. On the Ada dashboard, go to **Settings** > **Integrations**. Next
   to **Shopify**, click **Configure**.

2. In the dialogue window that appears, enter the API Key, API
   password, and your Shopify shop name that you copied from your
   Shopify dashboard.

3. **Click Save**. This would successfully connect your Shopify account
   with your Ada bot.

4. Refresh your webpage.

![](/_fern-files/_img/8915a28628322707b8f1ca00bc576fadf63bf3af205a41df8142730f6bec5a0b.webp)

## Use the Shopify block\[#UUID-8d41c687-5ec1-9a4c-aedc-1488afb3c74f_id_1500010742881_id_h_01F5KPXKCCN3MW2PGZNC8T4SM6]

To use the Shopify block, drag it from the block drawer, into the
appropriate Answer, and select an action.

With the Shopify block, you can perform two actions:

* Look up shipment details by order number

* Get last order and customer info using email address

### Look up shipment details by order number

Select this action if your Answer flow involves chatters sharing their
Order Number and using it to track orders.

![](/_fern-files/_img/48426e3b7b1ca5433e21204339552cdaa13fb3c68de9e761b5a01a8810cf5910.webp)

To configure the Look up Shipment Details by Order Number action, fill
in the following fields accordingly:

In the **Select Variables for Inputs** field, select the variable that
returns the *Order Number*, inputted by the chatter. (Order Number is
the order's position in the shop's count of orders.
Order numbers are sequential, starting at 1001.)

In the **Save Responses as Variable** field, select the output that you
require from the list of optional responses:

* Carrier/Tracking Company: The name of the tracking company

* Fulfilment Status:

  * fulfilled: Every line item in the order has been fulfilled

  * null: None of the line items in the order have been fulfilled

  * partial: At least one line item in the order has been fulfilled

  * restocked: Every line item in the order has been restocked and the
    order canceled

* Order status URL: The URL pointing to the order status web page, if
  applicable

* Purchaser's Email: The email ID of the customer used while making the
  purchase

* Purchaser's First Name: The first name of the customer used while
  placing the order

* Purchaser's Last Name: The last name of the customer used while
  placing the order

* Shipment Status:

  * label_printed: A label for the shipment was purchased and printed

  * label_purchased: A label for the shipment was purchased, but not
    printed

  * attempted_delivery: Delivery of the shipment was attempted, but
    unable to be completed

  * ready_for_pickup: The shipment is ready for pickup at a shipping
    depot

  * confirmed: The carrier is aware of the shipment, but hasn't received
    it yet

  * in_transit: The shipment is being transported between shipping
    facilities on the way to its destination

  * out_for_delivery: The shipment is being delivered to its final
    destination

  * delivered: The shipment was successfully delivered

  * failure: Something went wrong when pulling tracking information for
    the shipment, such as the tracking number was invalid or the
    shipment was canceled

* Shipping Address:

  * The mailing address to where the order will be shipped. This address
    is optional and will not be available on orders that do not require
    shipping

* Tracking Number:

  * A list of tracking numbers, provided by the shipping company

* Tracking URL:

  * The URLs of tracking pages for the fulfillment

* Updated at:

  * The date and time when the order was last modified

Click **Save**.

### Get last order and customer info using email address

Select this action if your Answer flow involves chatters who don't know
their order number, and thus use their email address to track their
orders. In case that the chatter doesn't have an Order ID, the other way
to enable a chatter to find their last order number is using their email
ID.

![](/_fern-files/_img/92c2a2812729d37fcfb0b1c1768e377772c18182f458f1f4aacfa29b18fe6157.webp)

In the **Select Variables for Inputs** field, select the variable that
returns the Customer Email ID, inputted by the chatter.

In the **Save Responses as Variable** field, select the output that you
require from the list of optional responses:

* City

* Country

* Customer's First Name

* Customer's Last Name

* Mailing Address

* Phone Number

* Province

* Zip Code

Click **Save**.

## Answer flow design\[#UUID-8d41c687-5ec1-9a4c-aedc-1488afb3c74f_id_1500010742881_id_h_01F5NZXH9HS6Z5Q1BCFFHC3EYD]

1. [Capture block](/scripted/docs/build-and-maintain-your-bot/work-with-blocks-and-apps/save-chatter-information-using-the-capture-block):
   Ask for email address

2. Insert the Shopify block and select an action

   * Get order details by order number

   * Get last order number or customer info by email address

3. [Conditional block](/scripted/docs/build-and-maintain-your-bot/work-with-blocks-and-apps/target-content-to-chatters-using-the-conditional-block):
   Set up conditions for order status values

---

Have any questions? Contact your Ada team, or email us at [](<mailto:help@ada.support%20%E2%80%9CHelp Docs inquiry%E2%80%9D>).