Retail Zipline

SYNQ supports Retail Zipline as a communication platform provider. This means that all staff-facing notifications generated by SYNQ will be delivered to configurable Zipline teams as Tasks.

To configure SYNQ to use Retail Zipline for your store location you need to:

1. Install the Retail Zipline app on your devices.
2. Determine the Retail Zipline teams that represent groups of workers that should receive notifications.
3. Configure SYNQ to be aware of your Retail Zipline instance and teams.
4. Configure SYNQ apps and devices to send their notifications to your Retail Zipline teams.

Once configured, SYNQ Frontline Hero delivers customer requests from call buttons and QRs to your staff as Tasks in Retail Zipline.

Supported Modules

Retail Zipline is supported for the following SYNQ modules:

• Call for Help

Requirements

The following information is required to integrate Retail Zipline with SYNQ Frontline Hero:

• Retail Zipline API client credentials.
• Retail Zipline webhooks that deliver task updates back to SYNQ Frontline Hero.
• Retail Zipline Team IDs that represent the Retail Zipline user groups that should receive notifications.

Configuration

To provide Frontline Hero with the Retail Zipline API client credentials:

1. Sign into MyStore as a Location Administrator.
2. Select Configure Store.
3. Scroll down to Bot configuration + Channels.
4. Set Notification Method to Zipline Bot.
5. Provide the following:
   • Zipline Client ID
   • Zipline Client Secret
   • Zipline Subdomain
   • Zipline Username
   • Zipline Password
6. Copy the Webhook URL from the information box.
7. Configure Webhooks in Retail Zipline:
   1. Sign in to the Retail Zipline portal.
   2. Click on your user avatar and select Settings.
   3. Click Webhooks.
   4. Click Add Webhook.
   5. Provide a Name. For example, SYNQ Frontline Hero.
   6. Paste the copied Webhook URL.
   7. Click Add Webhook.
   8. Copy the Secret.
   9. To add an event subscription:
      1. Click Add Event Subscription.
      2. Select the desired event.
      3. Click Add Event.
   10. Add event subscriptions for the following events:
   • Task assigned
   • Task unassigned
   • Team task assigned
   • Team task cancelled
   • Team task completed
   • Team task created
   • Team task deleted
   • Team task uncompleted
8. Click Enable Webhook.
9. Return to MyStore.
10. Paste the copied secret into Zipline Webhook Secret.
11. Click Update Location Settings.

To define a target Retail Zipline group that should receive Frontline Hero notifications:

1. Click the Add Bot Instance button.
2. Provide the following:
   • Name: A display name for this group of users. This is how the group will appear elsewhere in MyStore when you are selecting which group will receive notifications.
   • ID: The ID of the Retail Zipline team that will receive notifications.
3. Click Save.
4. Repeat to add other groups.