Integration With Zendesk

Last Updated: November 21, 2024

ReturnGO integrates with Zendesk to help you manage customer support queries regarding returns and exchanges. Zendesk is a customer service platform that helps you provide responsive and efficient customer support.

Capabilities 

The ReturnGO-Zendesk integration supports: 

  • Automatic ticket creation and updates.
  • RMA information will appear and update your store’s support team in Zendesk. 
  • A widget that enables your support team to process RMAs directly from Zendesk.

Requirements 

To link your Zendesk account to ReturnGO, you will need: 

    Zendesk Base API URL

    • Log in to your Zendesk account.
    • Copy your account URL, e.g. https://your-name.zendesk.com.

    Username

    • The email address associated with your Zendesk account.

    Password (API Key)

    Linking your Zendesk Account to ReturnGO 

    To link your Zendesk account to ReturnGO: 

    1. Go to Integrations > Products & Services
    2. Click on +ADD PRODUCT OR SERVICE.
      zendesk 1
    3. Choose Zendesk from the drop-down list. 
      zendesk 2
    4. Click the check mark.
      zendesk 3
    5. Enter your credentials. 
    6. Click CONNECT. 

    zendesk 4

    Integration Settings

    Once the integration has been completed, you can configure and define:

    1. When a ticket will be created.

    zendesk 5

    2. When a ticket will be updated.zendesk 6

    3. Whether the store name should be added to the ticket.

    zendesk 7

    ReturnGO-Zendesk Widget

    This feature is currently in beta and not yet available to all merchants. Apply to join the beta.

    The ReturnGO-Zendesk widget enables your support team to manage RMAs directly from Zendesk. This feature provides a streamlined way to handle returns, with key RMA details and one-click operations available within Zendesk.

    Zendesk widget

    Capabilities of the Widget

    • The widget is available on all new or updated Zendesk tickets associated with ReturnGO.
    • It displays critical RMA details such as items, SKU, return method, resolution, return policy, return reasons, and item prices.
    • Includes action buttons for quick return processing.

    To trigger a refund or exchange directly from Zendesk, you can configure automation rules in ReturnGO and trigger them from Zendesk based on actions like receiving or validating items.

    For example, you can set up an automation rule for auto-refund triggered by item validation. When you mark an item as Validated via the Zendesk widget button, it will automatically trigger the auto-refund.

    Note: The widget will only appear on new or updated RMA tickets; older tickets will not display the widget.

    How to Enable the Zendesk Widget

    To enable the ReturnGO-Zendesk widget, you'll need to connect the latest version of the Zendesk integration.

    1. Go to Settings > Integrations > Products & Services.

    2. Click ADD PRODUCT OR SERVICE.

    3. Select Zendesk OAuth.

    4. Click on the green checkmark.

    Zendesk oauth

    5. Enter your Zendesk subdomain.

    6. Click CONNECT.

    Zendesk oauth1

    7. Log in to your Zendesk account in the popup.

    8. Click ALLOW.

    Note: You need to already be logged in to Zendesk in another tab of the same browser window in order for this to work.

    To enable the ReturnGO-Zendesk widget, you'll need to add your ReturnGO API key to the Zendesk private app in your Zendesk admin dashboard.

    1. Go to Settings > Integrations > API and generate a ReturnGO API key.

    API Key-12. Go to the Zendesk dashboard and open the Apps and Integrations section.

    3. Click on ZENDESK SUPPORT APPS.
    4. Click on PRIVATE APPS.

    5. Install the ReturnGO app.

    6. Paste the ReturnGO API key.

    Updated Zendesk widget2

    7. Click INSTALL ANOTHER.

    Updated Zendesk widget3

    Once setup is complete, the widget will automatically appear on new tickets or updates to existing ones in your Zendesk dashboard.

    How Zendesk Widget Works

    To access the widget:

    1. Open a Zendesk ticket related to a return request.
    2. Click on the Apps icon on the right-hand side.
    3. Select the ReturnGO widget to open the widget in the sidebar.

    Zendesk-widget 2

    Tip: You can also pin the ReturnGO widget to the right-hand side for quick access.

    pin Zendesk widget

    Widget Details

    The Zendesk widget is comprised of several sections designed for viewing or processing RMAs efficiently.

    RMA Summary

    The RMA Summary section includes:

    • RMA ID

    • Order ID

    • Return Status

    • Action buttons depending on the RMA status:

      • Pending: Approve, Reject, Cancel

      • Approved: Received, Reject, Cancel

      • Received: Validate All, Reject, Cancel, Done

      • Validated: Done

    Zendesk widget RMA summary-1

    Returned Items

    The Returned Items section displays details on items involved in the return, including:

    • SKU
    • Return method
    • Resolution
    • Return policy
    • Return reasons
    • Prices

    Zendesk widget returned items

    Shipments

    The Shipments section shows:

    • Carrier name
    • Shipping info
      • This includes the shipping label, if available.
    • Tracking number
    • Return shipment status
    • Customer address
    • Return address

    Zendesk widget shipments

    Events

    The Events section logs all actions related to the RMA. These include system-generated updates and manual actions, such as when a request is approved, a shipment is received, or an item is validated.

    Zendesk widget events

    Comments

    The Comments section displays information from the timeline of the RMA page in the ReturnGO dashboard. This includes all activity related to the RMA, such as automated actions, manual updates, and any notes added to the timeline.

    Zendesk widget comments

    Troubleshooting the Integration 

    Many of the issues encountered related to integration can be identified during setup. 

    Here are a few things you can check to try and fix such issues: 

    Setup Issues 

    Make sure your API credentials are accurate. 

    • There should be no extra spaces before or after each API entry. 
    • Make sure you are using live or production API credentials, and not dev or test APIs. 
    • Try to re-generate a new API key and reconnect. 

    Widget Issues

    Zendesk-Related Issues 

    For Zendesk-related issues, please contact Zendesk:

    1. Sign in to your Zendesk account.
    2. Click your profile avatar in the upper right-hand corner.
    3. Click GET HELP.

    For any other issues, feel free to contact ReturnGO support through chat or email.