Skip to main content

Let chatters track shipments using the Shopify block

Overview

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.

Create a Custom App for your Shopify Store

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.

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.

Configure the Shopify Block

To configure the Shopify block in Ada:

  • Navigate to: Settings > Integrations. Next to Shopify, click Configure.

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

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

  • Refresh your webpage.

    Screen_Shot_2021-07-12_at_4.11.26_PM.png

Use the Shopify Block

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.

2021-05-14_12-27-33.jpg

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

In the Select Variablesfor 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 starting at 1001. Order numbers are sequential and start 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.

2021-05-14_13-06-07.jpg

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

  1. 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: Set up conditions for order status values.

Have any questions? Contact your Ada team—or email us at help@ada.support.