Documentation · Integrations

ShipHero Setup

Connect ShipHero so the chatbot can see where an order is at the warehouse, and so a cancellation or a new address reaches the warehouse before your shop.

Do I need this?

Only if some or all of your orders are picked and shipped from a warehouse that runs ShipHero, your own or a fulfilment company’s (a 3PL). If you ship from two warehouses, for example Europe from one and the US from a ShipHero warehouse, you can connect both: see Two warehouses below.

What this integration does

Answers from the warehouse

The chatbot can tell a customer where their order is at the warehouse (received, waiting for stock, on hold and why, being picked, shipped), give them the tracking number and link once it has left, tell them whether their return has arrived and how many items were received, and check stock per warehouse.

Cancellations reach ShipHero first

When a customer cancels an order, or your team cancels one from the Supportify inbox, Supportify asks ShipHero first. An order nobody at the warehouse has started on is cancelled in ShipHero before your shop. Once a picker has the order, an item is in a tote or a parcel has left, the cancellation is refused and a colleague follows up, so a refunded order is not shipped.

Supportify cancels the order in ShipHero only. Your shop is cancelled and refunded by Supportify afterwards, the same way as without a warehouse.

A new address reaches ShipHero first

A change of delivery address is written to ShipHero before your shop, and refused once the warehouse has started on the order. ShipHero’s own Shopify connection does not carry address changes unless you have switched that on, so without this the parcel would leave for the old address.

An order can be paused while your team looks

When a customer asks to cancel or change an order the chatbot cannot change itself, it can put the order on hold in ShipHero until your team has answered. The hold is taken off again when the case is settled, or when someone presses Release for picking in the inbox. An order a picker already has is not paused: ShipHero does not stop those.


Before you start: a Third-Party Developer user

Step 1: Create the user in ShipHero

  1. In ShipHero, open My Account → Users (app.shiphero.com/dashboard/users).
  2. Press Add Third-Party Developer and fill in the form.
  3. ShipHero shows two values: a Bearer Token and a Refresh Token. Copy the Refresh Token.

Supportify stores the refresh token and uses it to get a new access token every four weeks, so the connection does not expire.


Setup

Step 2: Connect ShipHero in Supportify

  1. Go to Settings → Integrations → ShipHero and click Connect.
  2. Paste the Refresh Token and click Test connection.
  3. Supportify shows which ShipHero account the token belongs to, and how many of your shop’s newest orders it found in ShipHero.
  4. Choose the settings below and save.

Settings

  • Shop locations ShipHero ships from: tick the Shopify locations that are this warehouse. Leave all unticked if every order ships from ShipHero.
  • Who runs the warehouse: a fulfilment company, or you. It decides which ShipHero hold is used to pause an order (the client hold for a fulfilment company’s customer, the operator hold for your own warehouse).
  • Read stock from: all warehouses, or one.
  • Cancel in ShipHero before the shop (on by default).
  • Send address changes to ShipHero, and stop item changes once ShipHero has the order (on by default).
  • Verify the customer’s email first (on by default): the customer confirms a code before the chatbot reads out anything about an order.

With the cancellation switch off, a cancellation made through Supportify does not reach ShipHero, so a cancelled order can still be shipped.


Two warehouses

How Supportify knows which warehouse has an order

Shopify assigns each order to a location. Tick the locations that are your ShipHero warehouse, and orders from them are asked of ShipHero. Every other order is asked of your other warehouse connection, which needs no change.

If you tick nothing while two warehouses are connected, each order is looked up in both. That works, but it is slower, and an order that neither warehouse has imported yet cannot be cancelled until one of them has it.

Stock

With two warehouses connected, stock is reported per warehouse and never added together: which warehouse ships an order depends on where the customer is.


What it does not do

Changing the items on an order

Supportify does not send item changes to ShipHero. ShipHero’s own shop connection can carry an order edit across, depending on a setting on ShipHero’s side, and sending the same change twice would add the items twice. So a change of items on an order ShipHero already holds is refused and handed to your team. Orders ShipHero has not imported yet can still be changed.

Registering returns

Returns are not created in ShipHero from the chat. If you use a return portal that registers returns in ShipHero, the chatbot can tell the customer when the parcel has arrived.

Orders under a status you made yourself

ShipHero lets an account add its own order statuses. Supportify cannot tell which of them the warehouse picks from, so an order under one is shown to the customer with that status, and a cancellation, pause or address change on it is refused and handed to your team.


FAQ

The connection test says ShipHero did not accept the token

The most common cause is pasting the Bearer Token. Paste the Refresh Token. If it was accepted before and no longer is, the Third-Party Developer user has been removed or replaced: create a new one and connect again.

Why was a cancellation refused for an order that has not shipped?

A picker has the order or an item is already in a tote. ShipHero does not stop an order at that point, so only the warehouse can. Contact the warehouse with the order number.

The chatbot says it can’t find an order that is in ShipHero

Check that the shop location the order ships from is ticked for ShipHero. If it is, open the integration, run Test connection again and look at how many of your newest orders were found. If that doesn’t settle it, contact Supportify support.