# Overview

Juble.io is a leading provider of integration solutions that empower businesses to connect, automate, and streamline their operations. With our innovative suite of applications, we enable seamless integration between popular marketplaces and Zendesk Support, allowing businesses to enhance their customer support capabilities and deliver exceptional service.

Our mission is to simplify complex integrations and provide efficient solutions that enable businesses to focus on what matters most – delivering outstanding customer experiences.

**Key Features:**

* Streamline your customer support processes
* Connect and automate multiple marketplaces
* Enhance your customer support capabilities
* Deliver exceptional service

Discover the power of Juble.io and unlock the full potential of your customer support operations. Let us be your trusted partner in integration.

For more information, visit our [website](https://www.juble.io/?utm_source=gitbook\&utm_medium=description\&utm_campaign=website).


# Account

## Create a juble.io account

1. **Visit the Juble.io Website:** Open your web browser and navigate to <https://channels.juble.io/>.
2. **Click "Sign Up":** On the Juble.io homepage, locate and click the "Sign Up" button. This will take you to the account registration page.
3. **Enter Your Information:** You'll be asked to provide the following information:
   * Your full name
   * Your email address
   * A secure password for your account
4. **Agree to Terms:** Carefully review Juble.io's Terms of Service and Privacy Policy. If you agree, check the box to accept the terms.
5. **Click "Sign Up":** Once all required information is entered, click the "Sign Up" button.
6. **Verify Your Email:** You will receive a verification email at the address you provided. Open your email inbox and click the verification link in the email. If you don't see it, check your spam or junk folder.

That's it! You've successfully created your Juble.io account. You can now log in and explore the features and functionalities of Juble.io to enhance your customer support and communication.

## **Resetting Your Juble.io Password**

If you've forgotten your password or need to reset it for any reason, follow these simple steps to regain access to your Juble.io account:

1. **Go to the Login Page**: Start by navigating to the Juble.io login page. You can do this by entering the Juble.io website address: <https://channels.juble.io/> .
2. **Click "Forgot Password"**: On the login page, you'll find a "Forgot Password" link. Click on it.
3. **Enter Your Email**: You'll be prompted to enter the email address associated with your Juble.io account. Make sure you use the email you used to sign up.
4. **Verification Email**: After entering your email, click "Submit." Juble.io will send you a verification email to that address.
5. **Check Your Email**: Open your email inbox and look for an email from Juble.io. It may take a few minutes to arrive. If you don't see it, check your spam or junk folder.
6. **Click the Reset Link**: Inside the email, you'll find a link to reset your password. Click on it.
7. **Create a New Password**: You'll be directed to a page where you can create a new password. Make sure it's secure and not easily guessable.
8. **Confirm Your Password**: Enter the new password again to confirm it.
9. **Save Changes**: Click the "Reset Password" or "Save Changes" button to confirm your new password.
10. **Login**: You can now return to the login page, enter your email, and your new password. You should be able to access your Juble.io account without any issues.


# Map Custom Fields

## Prerequisites

You need an active Juble.io account:

{% content-ref url="/pages/kytfM4GinqzMznZbAfZc" %}
[Account](/juble.io/account)
{% endcontent-ref %}

Ensure that you have successfully linked your helpdesk account with your Juble.io profile. If you haven't done this, you can follow the steps provided in our documentation to link your helpdesk account.

## Map Custom Fields

To map custom fields for your application, follow these steps:

1. **Navigate to Helpdesk Menu:** Start by logging into your [Juble.io account](/juble.io/account). Once logged in, navigate to the "Helpdesk" menu.
2. **Access Custom Fields:** In the Helpdesk menu, you'll find a section for "Custom Fields." Click on it to access the custom field mapping options.

<figure><img src="/files/YxgEcG0QS0GAiEEyHQy5" alt=""><figcaption></figcaption></figure>

3. **Mapping Mappable Data:** In this section, you'll find a list of mappable data fields that you can link to your custom fields in your helpdesk. The currently mappable data includes:

* **Order Id:** This field represents the unique identifier for the order in your Mirakl marketplace. By mapping it, you can easily track and reference specific orders within your helpdesk.
* **Order SKU:** The Order SKU, or Stock Keeping Unit, is a unique code or identifier for each product in the order. Mapping it ensures you can easily identify and manage specific products.
* **Order Item Title:** This field holds the title or name of the items in the order. Mapping it helps you access product information for support interactions.
* **Order Status:** The order status provides information about the current state of an order, such as "In Progress" or "Shipped." Mapping this field ensures that you can address order status-related inquiries accurately.
* **Order Total:** The order total is the sum of costs associated with an order, including items, taxes, and shipping fees. Mapping this field helps you access this financial data within your your helpdesk support interactions.
* **Customer Full name:** This field contains the full name of the customer who placed the order. Mapping it allows you to address customers by their full names in your support responses.
* **Customer First name:** This is the first name of the customer. Mapping it enables a more personalized approach when interacting with customers in your support tickets.
* **Customer Last name:** The customer's last name is an essential part of their identity. By mapping it, you can address customers by their last names in your support interactions.
* **Customer Email:** The customer's email address is crucial for communication. Mapping this field allows you to reply to customers and send updates to their provided email addresses.
* **Customer Phone:** This field contains the customer's phone number. By mapping it, you can access contact information for customer support inquiries or order updates.
* **Shipping Address:** This field contains the complete shipping address for the order, including name, street, city, state, postal code, and country. Mapping it enables precise shipping information in your support interactions.
* **Shipping Address:** This field contains the complete shipping address for the order, including name, street, city, state, postal code, and country. Mapping it enables precise shipping information in your support interactions.
* **Shipping Address Name:** The name associated with the shipping address. Mapping it ensures that you have the recipient's name for shipping-related support.
* **Shipping Address Line 1:** The first line of the shipping address. By mapping it, you can access the primary address details for orders.
* **Shipping Address Line 2:** The second line of the shipping address. Mapping it allows for more detailed shipping address information.
* **Shipping Address City:** The city in the shipping address. By mapping it, you can provide accurate city information for shipping-related inquiries.
* **Shipping Address State:** The state in the shipping address. Mapping it enables accurate state information for shipping-related inquiries.
* **Shipping Address Postal Code:** The postal code in the shipping address. By mapping it, you can provide precise postal code details for shipping inquiries.
* **Shipping Address Country:** The country in the shipping address. Mapping it ensures you have the correct country information for shipping support.
* **Shipping Carrier:** This field identifies the shipping carrier or method used for the order's delivery. Mapping it helps you provide accurate information regarding shipping.
* &#x20;**Tracking Number:** The tracking number is a unique identifier for tracking the shipment. Mapping it allows you to assist customers with tracking their orders effectively.

1. **Map Custom Fields:** To map these data fields to your custom fields in your helpdesk, select the corresponding helpdesk custom field from the dropdown options provided for each data field. Make sure that the custom fields you're mapping to are of type "Text."
2. **Create Helpdesk Custom Fields:** Ensure that you have already created the necessary custom fields in your helpdesk account before coming to this mapping UI. The available custom fields are retrieved directly from your helpdesk account.
3. **Save Your Mapping:** After mapping the data fields to your custom fields and ensuring that you're satisfied with the configuration, click the "Save" button to save your mapping settings.

If you require additional mappable fields or have specific mapping needs, don't hesitate to reach out to our support team at \[<support@juble.io>]. We'll be happy to assist you in extending the mappable options to suit your requirements.

By following these steps, you can efficiently map the incoming data from Mirakl to your custom fields in your helpdesk, ensuring that your support operations are precisely aligned with your needs.


# Zendesk

This guide empowers you to leverage the Zendesk Marketplace Connector by Juble.io and transform your multi-marketplace customer support. By establishing a seamless connection between your Zendesk instance and various online marketplaces, you'll gain a centralized hub for managing customer inquiries and order details. This translates to enhanced operational efficiency, improved agent productivity, and ultimately, exceptional customer service across all your sales channels.

## Prerequisites

* A Zendesk account with administrative privileges.
* A Juble.io account (See [Creating a Juble.io Account](/juble.io/account) for signup instructions)

## Get Started

1. **Create a Juble.io Account:**

If you haven't already, sign up for a free Juble.io account. This account grants you access to Juble's suite of integration tools and ongoing support.

{% content-ref url="/pages/kytfM4GinqzMznZbAfZc" %}
[Account](/juble.io/account)
{% endcontent-ref %}

2. Connect Your Zendesk Instance:

Juble.io seamlessly integrates with your existing Zendesk environment. Refer to the dedicated guide on Connecting Your Zendesk Account for step-by-step instructions on establishing this vital connection.

{% content-ref url="/pages/GJdDm18OvgpciApl0FpZ" %}
[Broken mention](broken://pages/GJdDm18OvgpciApl0FpZ)
{% endcontent-ref %}

## Link Your Marketplaces

This Zendesk Marketplace Connector empowers you to connect a vast array of online marketplaces. Explore the detailed documentation on Linking Your Marketplaces to discover the specific instructions for each platform.

### **Amazon Seller Central Integration with Zendesk**

Streamline Your Amazon Customer Support

{% content-ref url="/pages/M4c6WXMULs4f5E1o5WdV" %}
[Amazon Seller Central](/channels/sellercentral)
{% endcontent-ref %}

### Mirakl Marketplace Integration with Zendesk:

Connect Your Mirakl Store to Zendesk for Efficient Support

{% content-ref url="/pages/5G84vs0X19hYdVy10OEc" %}
[Mirakl](/channels/mirakl)
{% endcontent-ref %}

### Miravia Marketplace Integration with Zendesk:

Connect Your Miravia Store to Zendesk for Efficient Support

{% content-ref url="/pages/wS5h0zhTZEYHUTWtXrJm" %}
[Miravia](/channels/miravia)
{% endcontent-ref %}

### **Newegg Marketplace Integration with Zendesk**

Simplify Newegg Customer Support

{% content-ref url="/pages/wuixrV8g3g0VRiHQzNua" %}
[Newegg](/channels/newegg)
{% endcontent-ref %}

### **Cdiscount Integration with Zendesk**

Connect Your Cdiscount Store to Zendesk for Efficient Support

{% content-ref url="/pages/QtBEZsQ9GWCAZ64HYTQt" %}
[Octopia](/channels/octopia)
{% endcontent-ref %}

### Walmart Marketplace Integration with Zendesk

Centralize Your Walmart Customer Support

{% content-ref url="/pages/3wgbjfUNYIeOfBjCwyIL" %}
[Walmart](/channels/walmart)
{% endcontent-ref %}


# Link Zendesk Account

To integrate your Juble.io account with Zendesk, follow these simple steps:

1. **Log in to Your Juble.io Account:** Start by logging in to your Juble.io account using your credentials.
2. **Navigate to Helpdesk:** Once you're logged in, navigate to the "Helpdesk" option in the menu.
3. **Click on "Connect":** In the Helpdesk menu, click on the "Connect" button.

<figure><img src="/files/9Yxkqq1SNCVnq4dwI8jK" alt=""><figcaption></figcaption></figure>

4. **Select Zendesk:** You will be presented with integration options. Choose "Zendesk" to proceed with connecting your Zendesk account.

<figure><img src="/files/J71WaY4s8YhWljX4aGul" alt=""><figcaption></figcaption></figure>

5. **Input Zendesk Subdomain:** Enter your Zendesk subdomain. This is the unique part of your Zendesk URL, usually in the format "yourcompany.zendesk.com".

<figure><img src="/files/TeBfdKaHz1gnN1DnAWIn" alt=""><figcaption></figcaption></figure>

6. **Authorize the Connection:** Clicking "Continue" will redirect you to your Zendesk instance, where you'll be asked to authorize the connection between Juble.io and Zendesk.
7. **Approve Access:** In your Zendesk instance, approve the access request from Juble.io. This authorization allows Juble.io to connect with your Zendesk account securely.

<figure><img src="/files/q18XYTpcGm993H9CdPo1" alt=""><figcaption></figcaption></figure>

8. **Redirect Back to Juble.io:** Once approved, you will be automatically redirected back to your Juble.io account.

Congratulations! Your Juble.io account is now successfully linked with your Zendesk instance. You're all set to enjoy the benefits of this integration for efficient communication and support operations.

If you encounter any issues during the linking process or need further assistance, please reach out to our support team at \[<support@juble.io>]. We're here to help you make the most of your Juble.io integration.


# Auto Responder

Setting Up Auto-Responders for Juble.io with Zendesk

This guide explains how to configure auto-responders for Juble.io within your Zendesk platform. These auto-responders can streamline your workflow by automatically sending personalized messages to customers upon receiving specific tickets.

## **Requirements**

A Juble.io account with Zendesk integration enabled.

{% content-ref url="/pages/kytfM4GinqzMznZbAfZc" %}
[Account](/juble.io/account)
{% endcontent-ref %}

{% content-ref url="/pages/tiPD0RKHlIpUI4dO5exa" %}
[Link Zendesk Account](/helpdesks/zendesk/link-zendesk-account)
{% endcontent-ref %}

## **Steps**

1. **Log in to Juble.io:** Navigate to <https://channels.juble.io/> and sign in with your Juble.io credentials.
2. **Access Helpdesk Details:** Locate the section dedicated to your helpdesk.
3. **Auto-Responder Section:** Within your Zendesk helpdesk details, find the section labeled "Auto-Responder". This is where you will configure your auto-responses.
4. **Craft Your Message:** In the designated text box, type the message you want your auto-responder to send.
5. **Personalize Your Message (Optional):** Juble.io allows you to integrate dynamic placeholders that automatically populate based on your tickets. See the full list of placeholders [here](https://support.zendesk.com/hc/en-us/articles/4408886858138-Zendesk-Support-placeholders-reference). For example, you can use `{{ticket.requester.name}}` to insert the requester's name dynamically.
6. **Specify Trigger Tags:** Here, you can define a space-separated list of tags that will trigger the auto-responder. This allows you to target specific types of tickets. For instance, if you create a tag named "New\_Order," you can add it here to trigger the auto-responder only for tickets with that tag.

<figure><img src="/files/ZcJtfQVRTFUxgrjmSbhe" alt=""><figcaption></figcaption></figure>


# Zendesk token

The Zendesk Token is a crucial component of your Juble.io integration. It allows for the seamless exchange of information between Zendesk and your Juble.io account, ensuring efficient communication and support operations.

## Prerequisites

You need an active Juble.io account:

{% content-ref url="/pages/kytfM4GinqzMznZbAfZc" %}
[Account](/juble.io/account)
{% endcontent-ref %}

Ensure that you have successfully linked your Zendesk account with your Juble.io profile. If you haven't done this, you can follow the steps provided in our documentation to link your Zendesk account.

{% content-ref url="/pages/GJdDm18OvgpciApl0FpZ" %}
[Broken mention](broken://pages/GJdDm18OvgpciApl0FpZ)
{% endcontent-ref %}

## Access the Zendesk Token

1. Log in to your Juble.io account.
2. Navigate to the "Helpdesk" menu.
3. From the dropdown, click on the "Settings" section.
4. In the Settings, you will find the Zendesk Token. This token is a secure key that facilitates communication between Zendesk and your Juble.io account.

## Add the token in Zendesk

To add the token in Zendesk, follow the steps below:

1. Sign in to your Zendesk Support account
2. Go to your Zendesk Admin Center and click on the Zendesk Support apps menu.

<figure><img src="/files/mhtzE5x4qEymaCYT58RP" alt=""><figcaption></figcaption></figure>

3. Select the Marketplaces application from the available options. Click on 'Change settings' to configure the integration.

<figure><img src="/files/tHeLUQ4Fh6DCrM7EoIr3" alt=""><figcaption></figcaption></figure>

3. Locate the 'Juble.io Token' field. Insert the token you obtained in the previous step (Prerequisites).

<figure><img src="/files/TEqAR5vDXQEScmRxNL8G" alt=""><figcaption></figcaption></figure>

5. After inserting the token, click 'Save' to confirm your settings.


# Settings

### Setting Up Reply Text Removal (Zendesk) <a href="#setting-up-reply-text-removal-zendesk" id="setting-up-reply-text-removal-zendesk"></a>

When responding to customers via Zendesk, your messages may sometimes include internal signatures, system-generated footers, or specific boilerplate text that you don't want the end-customer to see in the final reply.

The **Reply Text Removal** feature allows you to automatically "clean" your outbound messages by stripping out specific phrases before they are sent.

**How it Works**

You can define a list of phrases or snippets of text. Every time a reply is sent from your Zendesk to a connected channel, our system scans the message and removes every exact match found in your list. This applies to both the plain text and the HTML versions of your message.

**Configuration Steps**

<figure><img src="/files/Sf7FluLnvr6PmL6FYD9I" alt=""><figcaption></figcaption></figure>

1. Navigate to your **Helpdesk Settings** and select your **Zendesk** integration.
2. Locate the section labeled **"Text to remove from replies"**.
3. Add the phrases you wish to remove. Common examples include:
   * `Sent from my Zendesk`
   * `-- \n Your Signature Name`
   * `[Internal Note]`
4. **Save** your settings.

**Best Practices & Tips**

* **Exact Matches:** The system removes text based on an exact character match. Ensure your spacing and punctuation are identical to what appears in your Zendesk editor.
* **Case Sensitivity:** Matches are case-sensitive. If you want to remove both "CONFIDENTIAL" and "confidential", add both as separate entries.
* **Signatures:** If your agents have individual signatures, you can add each unique signature line to the list to ensure the final customer response stays clean and professional.
* **Multiple Items:** You can add as many items as needed. They will all be processed sequentially.

**Example**

**Before Removal:**

> "Hi there! We are looking into your order right now.
>
> Best, Support Team
>
> Sent from my Zendesk"

**Configured Removal List:**

* `Sent from my Zendesk`

**Final Message Delivered to Customer:**

> "Hi there! We are looking into your order right now.
>
> Best, Support Team"


# Intercom


# Link Intercom Account

To integrate your Juble.io account with Intercom, follow these simple steps:

1. **Log in to Your Juble.io Account:** Start by logging in to your Juble.io account using your credentials.
2. **Navigate to Helpdesk:** Once you're logged in, navigate to the "Helpdesk" option in the menu.
3. **Click on "Connect":** In the Helpdesk menu, click on the "Connect" button.

<figure><img src="/files/9Yxkqq1SNCVnq4dwI8jK" alt=""><figcaption></figcaption></figure>

4. **Select Intercom:** You will be presented with integration options. Choose "Intercom" to proceed with connecting your Intercom account.

<figure><img src="/files/Aggch6ZRoXTPgdyyMEKk" alt=""><figcaption></figcaption></figure>

5. **Authorize the Connection:** Clicking "Connect" will redirect you to your Intercom instance, where you'll be asked to authorize the connection between Juble.io and Intercom.
6. **Approve Access:** In your Intercom instance, approve the access request from Juble.io. This authorization allows Juble.io to connect with your Intercom account securely.

<figure><img src="/files/XQDEgIrmIKnwN3H7sLmA" alt=""><figcaption></figcaption></figure>

5. **Redirect Back to Juble.io:** Once approved, you will be automatically redirected back to your Juble.io account.

Congratulations! Your Juble.io account is now successfully linked with your Intercom instance. You're all set to enjoy the benefits of this integration for efficient communication and support operations.

If you encounter any issues during the linking process or need further assistance, please reach out to our support team at \[<support@juble.io>]. We're here to help you make the most of your Juble.io integration.


# Marketplace Routing

By default, Juble sends all incoming customer messages from your connected marketplaces to your helpdesk's primary inbox. However, if you manage multiple brands or have specialized teams (e.g., a dedicated Returns team or a UK vs. US support team), you can route specific marketplaces to specific inboxes.

#### Why use Inbox Mapping?

* Team Specialization: Route Amazon technical queries to your "Product Experts" inbox and Shopify sales queries to your "Sales" inbox.
* Regional Organization: Keep your Amazon UK, eBay UK, and Etsy UK messages in a "UK Support" inbox.
* Reduced Noise: Ensure agents only see the tickets relevant to their specific marketplace or region.

***

#### How to Set Up Routing

1. Open Helpdesk Settings: Navigate to your Settings and select your connected Helpdesk <https://channels.juble.io/helpdesk>.
2. Locate the Routing Table: Look for the Marketplace Routing section.
3. Map Your Channels: You will see a list of all your connected marketplaces. For each marketplace, use the dropdown menu to select the specific destination inbox.
   * *Example:* Set Amazon US to route to "General Support" and Amazon UK to route to "International Support".
4. Save Changes: Click the Save Settings button at the bottom of the page.

***

#### Frequently Asked Questions

What happens if I don't map a marketplace? Any marketplace not specifically mapped in this table will continue to flow into your helpdesk's Default/Main Inbox.

Can I route one marketplace to multiple inboxes? Currently, Juble supports a 1-to-1 mapping. Each marketplace connection can be tied to exactly one destination inbox to ensure message consistency.


# Freshdesk


# Link Freshdesk Account

To integrate your Juble.io account with Freshdesk, follow these simple steps:

1. **Log in to Your Juble.io Account:** Start by logging in to your Juble.io account using your credentials.
2. **Navigate to Helpdesk:** Once you're logged in, navigate to the "Helpdesk" option in the menu.
3. **Click on "Connect":** In the Helpdesk menu, click on the "Connect" button.
4. **Select Freshdesk:** You will be presented with integration options. Choose "Freshdesk" to proceed with connecting your Freshdesk account.

<figure><img src="/files/YXrsVZKHOQI7NztGgw5l" alt=""><figcaption></figcaption></figure>

5. **Get your Freshdesk Domain:** Note down your Freshdesk domain without the ".freshdesk.com" part. For example, if your Freshdesk URL is "yourcompany.freshdesk.com," your domain is "yourcompany"
6. **Retrieve your Freshdesk API Key**: Follow [this guide](https://support.freshdesk.com/en/support/solutions/articles/215517-how-to-find-your-api-key) to find and copy your API Key.

<figure><img src="/files/alUr6K4fIC8eSsjN7lj8" alt=""><figcaption></figcaption></figure>

Congratulations! Your Juble.io account is now successfully linked with your Freshdesk instance. You're all set to enjoy the benefits of this integration for efficient communication and support operations.

If you encounter any issues during the linking process or need further assistance, please reach out to our support team at \[<support@juble.io>]. We're here to help you make the most of your Juble.io integration.


# Gorgias

Welcome to the Gorgias Integration Documentation! This guide will walk you through the process of integrating your Gorgias account with Juble.io to streamline your customer support workflow. Below are the key steps to get started:

#### Summary:

1. **Link Your Gorgias Account**: Follow the instructions provided to link your Gorgias account with Juble.io. This step is essential for accessing your Gorgias data within the Juble.io platform.

{% content-ref url="/pages/yoHOV9iko5BxzIGFNZuM" %}
[Link Gorgias Account](/helpdesks/gorgias/link-gorgias-account)
{% endcontent-ref %}

1. **Add Channels**: Once your Gorgias account is linked, you can add channels to import customer messages and inquiries into Juble.io. Refer to the documentation for detailed instructions on adding channels.

{% content-ref url="/pages/xcBEaOLP8rworjWgV5ge" %}
[Channels](/channels/sellercentral)
{% endcontent-ref %}


# Link Gorgias Account

To integrate your Juble.io account with Gorgias, follow these simple steps:

1. **Log in to Your Juble.io Account:** Start by logging in to your Juble.io account using your credentials.
2. **Navigate to Helpdesk:** Once you're logged in, navigate to the "Helpdesk" option in the menu.
3. **Click on "Connect":** In the Helpdesk menu, click on the "Connect" button.

<figure><img src="/files/9Yxkqq1SNCVnq4dwI8jK" alt=""><figcaption></figcaption></figure>

4. **Select Gorgias:** You will be presented with integration options. Choose "Gorgias" to proceed with connecting your Gorgias  account.

<figure><img src="/files/KV8EZE9Hvwn9beejUg5L" alt=""><figcaption></figcaption></figure>

5. **Get your Gorgias Domain:** Note down your Gorgias domain without the ".gorgias.com" part. For example, if your Gorgias URL is "yourcompany.gorgias.com," your domain is "yourcompany"

<figure><img src="/files/GfRjZ1NItixYhnsANaiG" alt=""><figcaption></figcaption></figure>

6. **Authorize the Connection:** Clicking "Connect" will redirect you to your Gorgias instance, where you'll be asked to authorize the connection between Juble.io and Gorgias.
7. **Approve Access:** In your Gorgias instance, approve the access request from Juble.io. This authorization allows Juble.io to connect with your Gorgias account securely.

<figure><img src="/files/0Gp0BJCEYgmSW0MiBYYh" alt=""><figcaption></figcaption></figure>

8. **Redirect Back to Juble.io:** Once approved, you will be automatically redirected back to your Juble.io account.

Congratulations! Your Juble.io account is now successfully linked with your Gorgias instance. You're all set to enjoy the benefits of this integration for efficient communication and support operations.

If you encounter any issues during the linking process or need further assistance, please reach out to our support team at \[<support@juble.io>]. We're here to help you make the most of your Juble.io integration.


# Kustomer

This guide empowers you to leverage the Kustomer Marketplace Connector by Juble.io and transform your multi-marketplace customer support. By establishing a seamless connection between your Kustomer instance and various online marketplaces, you'll gain a centralized hub for managing customer inquiries and order details. This translates to enhanced operational efficiency, improved agent productivity, and ultimately, exceptional customer service across all your sales channels.

## Prerequisites

* A Kustomer account with administrative privileges.
* A Juble.io account (See [Creating a Juble.io Account](/juble.io/account) for signup instructions)

## Get Started

### **Step 1: Create a Juble.io Account:**

If you haven't already, sign up for a free Juble.io account. This account grants you access to Juble's suite of integration tools and ongoing support.

{% content-ref url="/pages/kytfM4GinqzMznZbAfZc" %}
[Account](/juble.io/account)
{% endcontent-ref %}

### Step 2: Install the Juble.io Kustomer App:

Install the Juble.io application within your Kustomer instance to connect your marketplaces and streamline customer support.

{% content-ref url="/pages/crpvWSZUXGoTtyJfqPbH" %}
[Install the Juble.io Kustomer App](/helpdesks/kustomer/install-the-juble.io-kustomer-app)
{% endcontent-ref %}

### Step 3: Connect Your Kustomer Instance:

Juble.io seamlessly integrates with your existing Kustomer environment. Refer to the dedicated guide on Connecting Your Zendesk Account for step-by-step instructions on establishing this vital connection.

{% content-ref url="/pages/ZnODJQxKmenVIZAHgaxk" %}
[Link Kustomer Account](/helpdesks/kustomer/link-kustomer-account)
{% endcontent-ref %}

### Step 3: Add the Auth Token:

The Auth Token is a crucial component of your Juble.io integration. It allows for the seamless exchange of information between Kustomer and your Juble.io account, ensuring efficient communication and support operations.

{% content-ref url="/pages/udWNnhkLZZ6ODhWjZv5h" %}
[Add the Auth Token](/helpdesks/kustomer/add-the-auth-token)
{% endcontent-ref %}

## Link Your Marketplaces:

This Kustomer Marketplace Connector empowers you to connect a vast array of online marketplaces. Explore the detailed documentation on Linking Your Marketplaces to discover the specific instructions for each platform.

### **Amazon Seller Central Integration with Kustomer**

Streamline Your Amazon Customer Support

{% content-ref url="/pages/M4c6WXMULs4f5E1o5WdV" %}
[Amazon Seller Central](/channels/sellercentral)
{% endcontent-ref %}

### Mirakl Marketplace Integration with Kustomer

Connect Your Mirakl Store to Kustomer for Efficient Support

{% content-ref url="/pages/5G84vs0X19hYdVy10OEc" %}
[Mirakl](/channels/mirakl)
{% endcontent-ref %}

### Miravia Marketplace Integration with Kustomer

Connect Your Miravia Store to Kustomer for Efficient Support

{% content-ref url="/pages/wS5h0zhTZEYHUTWtXrJm" %}
[Miravia](/channels/miravia)
{% endcontent-ref %}

### **Newegg Marketplace Integration with Kustomer**

Simplify Newegg Customer Support

{% content-ref url="/pages/wuixrV8g3g0VRiHQzNua" %}
[Newegg](/channels/newegg)
{% endcontent-ref %}

### **Cdiscount Integration with Kustomer**

Connect Your Cdiscount Store to Kustomer for Efficient Support

{% content-ref url="/pages/QtBEZsQ9GWCAZ64HYTQt" %}
[Octopia](/channels/octopia)
{% endcontent-ref %}

### Walmart Marketplace Integration with Kustomer

Centralize Your Walmart Customer Support

{% content-ref url="/pages/3wgbjfUNYIeOfBjCwyIL" %}
[Walmart](/channels/walmart)
{% endcontent-ref %}


# Install the Juble.io Kustomer App

This guide walks you through installing the Juble.io application within your Kustomer instance to connect your marketplaces and streamline customer support.

## Search for the Application

In your Kustomer dashboard, navigate to the **Apps** section. Within the search bar, type "Juble.io" and click the corresponding application from the results.

<figure><img src="/files/E4LT44QKyJBak9ECWaab" alt="" width="563"><figcaption></figcaption></figure>

## Install Juble.io

Click the **Install** button to initiate the installation process for the Juble.io app.<br>

<figure><img src="/files/nLaMCLaUtJKa31xThFbx" alt="" width="563"><figcaption></figcaption></figure>

## Accept the Installation

A confirmation window will appear. Review the application details and click **Accept** to proceed.

<figure><img src="/files/PBbtFPpBRm480V2iuZK8" alt="" width="450"><figcaption></figcaption></figure>

Once installation is complete, continue to the next section of this documentation to link Juble.io and your Kustomer account.

{% content-ref url="/pages/ZnODJQxKmenVIZAHgaxk" %}
[Link Kustomer Account](/helpdesks/kustomer/link-kustomer-account)
{% endcontent-ref %}


# Link Kustomer Account

To integrate your Juble.io account with Kustomer, follow these simple steps:

1. **Log in to Your Juble.io Account:** Start by logging in to your [Juble.io account](https://channels.juble.io/) using your credentials.
2. **Navigate to Helpdesk:** Once you're logged in, navigate to the "Helpdesk" option in the menu.
3. **Click on "Connect":** In the Helpdesk menu, click on the "Connect" button.

<figure><img src="/files/9Yxkqq1SNCVnq4dwI8jK" alt=""><figcaption></figcaption></figure>

4. **Select Kustomer:** You will be presented with integration options. Choose "Kustomer" to proceed with connecting your Kustomer account.

<figure><img src="/files/fjbheUdDOCstFBIRAVZp" alt=""><figcaption></figcaption></figure>

5. **Authorize the Connection:** Clicking "Connect" will redirect you to your Kustomer instance, where you'll be asked to authorize the connection between Juble.io and Kustomer.
6. **Approve Access:** In your Gorgias instance, approve the access request from Juble.io. This authorization allows Juble.io to connect with your Gorgias account securely.

<figure><img src="/files/p2Q2zUmHYfX0hi1ozvD0" alt=""><figcaption></figcaption></figure>

8. **Redirect Back to Juble.io:** Once approved, you will be automatically redirected back to your Juble.io account.

Congratulations! Your Juble.io account is now successfully linked with your Kustomer instance. You're all set to enjoy the benefits of this integration for efficient communication and support operations.

If you encounter any issues during the linking process or need further assistance, please reach out to our support team at \[<support@juble.io>]. We're here to help you make the most of your Juble.io integration.


# Add the Auth Token

The Auth Token is a crucial component of your Juble.io integration. It allows for the seamless exchange of information between Kustomer and your Juble.io account, ensuring efficient communication and support operations.

## Prerequisites

You need an active Juble.io account:

{% content-ref url="/pages/kytfM4GinqzMznZbAfZc" %}
[Account](/juble.io/account)
{% endcontent-ref %}

The Juble.io application needs to be installed within your Kustomer.

{% content-ref url="/pages/crpvWSZUXGoTtyJfqPbH" %}
[Install the Juble.io Kustomer App](/helpdesks/kustomer/install-the-juble.io-kustomer-app)
{% endcontent-ref %}

Ensure that you have successfully linked your Kustomer account with your Juble.io profile. If you haven't done this, you can follow the steps provided in our documentation to link your Kustomer account.

{% content-ref url="/pages/ZnODJQxKmenVIZAHgaxk" %}
[Link Kustomer Account](/helpdesks/kustomer/link-kustomer-account)
{% endcontent-ref %}

## Step 1: Access the Auth Token

1. Log in to your Juble.io account.
2. Navigate to the "Helpdesk" menu.
3. In the Settings, you will find the Auth Token. This token is a secure key that facilitates communication between Kustomer and your Juble.io account.

<figure><img src="/files/HTK98s1lxi4R8K9sVmIe" alt=""><figcaption></figcaption></figure>

## Step 2: Update the Auth Token in the Kustomer application

Locate the field for the Kustomer auth token and securely enter the token you obtained in step 1.

<figure><img src="/files/O3cXNkGs49cIKb4bwoi9" alt=""><figcaption></figcaption></figure>


# Troubleshooting

### OAUTH ERROR: failed to retrieve client id

<figure><img src="/files/ZFlGfB6riYDuKjqtMfXe" alt="" width="512"><figcaption></figcaption></figure>

If you encounter an error while linking Juble.io and Kustomer, it's possible the Juble.io app hasn't been installed within your Kustomer instance yet.

Head back to Step 1 of this documentation and follow the instructions for installing the Juble.io app. Once installed, you can proceed with linking Juble.io and Kustomer.

{% content-ref url="/pages/crpvWSZUXGoTtyJfqPbH" %}
[Install the Juble.io Kustomer App](/helpdesks/kustomer/install-the-juble.io-kustomer-app)
{% endcontent-ref %}


# Amazon Seller Central


# Add account

{% hint style="info" %}
**Good to know:** You can add multiple accounts by repeating the steps below with all your Amazon accounts
{% endhint %}

## Authorize Juble.io Access to your Amazon Seller account

1. **Log in to Your Juble.io Account:** Start by logging in to your [Juble.io account](https://channels.juble.io/) using your credentials.
2. **Navigate to Channels:** Once you're logged in, navigate to the "Channels" option in the menu.
3. **Click on "Add Channel":**  In the "Channels" section, click on the "Add Channel" button to initiate the process of connecting a new integration.
4. **Select Amazon:** Among the available integration options, choose "Amazon" to proceed with linking your Amazon Seller account.

<figure><img src="/files/eD9PyNo9gbpzmKm5H17b" alt=""><figcaption></figcaption></figure>

5. **Select Your Marketplace**: You will be prompted to select the specific Amazon marketplace you wish to connect to. Choose the relevant marketplace from the dropdown list.
6. **Authorize Access:** After selecting the marketplace, click on the "Authorize" button. This will redirect you to Amazon Seller Central where you will be asked to confirm and authorize Juble.io’s access to your account.

<figure><img src="/files/9M1YONOyM1ACStNI2kkV" alt=""><figcaption></figcaption></figure>

7. **Confirmation:** Once authorization is complete, you'll be redirected back to Juble.io. Your Amazon Seller account will now be integrated with Juble.io, and you can start managing your channels effectively.

## Finalize Your Amazon Integration

<figure><img src="/files/vnXJTmSRjWywkytrgjhZ" alt=""><figcaption></figcaption></figure>

1. **Provide a Friendly Name:**  This name will help you easily identify the specific integration within your Juble.io account, especially if you have multiple channels connected.
2. **Copy Your Unique Email Address:** This email address is crucial for ensuring that communications from Amazon are correctly routed through Juble.io.
3. **Save and Confirm:** click on the "Create" button to finalize the integration process.

## Add Your Unique Email Address to Amazon

To ensure that communications from Amazon are correctly routed through Juble.io, you'll need to add the unique email address provided during the integration setup to your Amazon Seller Central account. Follow these steps to complete the process:

#### Step 1: Log in to Amazon Seller Central

* **Access Your Account**: Start by logging in to your [Amazon Seller Central](https://sellercentral.amazon.com) account using your credentials.

#### Step 2: Navigate to the Notification Preferences

* **Settings Menu**: Once logged in, navigate to the "Settings" menu located at the top right corner of your screen.
* **Notification Preferences**: In the drop-down menu, select "Notification Preferences." This will take you to a page where you can manage various notifications and the associated email addresses.

<figure><img src="/files/m2jtq43Y6AntsKS7wHGo" alt=""><figcaption></figcaption></figure>

#### Step 3: Update the Email Address

* **Messaging**: Scroll down to the section labeled "Messaging"
* **Email** : In the "Email" field, paste the unique email address that you copied from Juble.io during the integration setup.
  * **Important**: This email address should be the one provided by Juble.io, as it is specifically configured to route your Amazon communications through the Juble.io platform.

<figure><img src="/files/z8x1Jw7Ndmn1pZI0ahHW" alt=""><figcaption></figcaption></figure>

Step 4: Save Your Changes

* **Save**: After entering the unique email address, scroll down and click the "Save" button at the bottom of the page to confirm your changes.

#### Step 5: Confirm and Test

* **Confirmation**: You may receive a confirmation message from Amazon indicating that your notification preferences have been successfully updated.

{% hint style="success" %}
**Congratulations!** Your account is now setup and will receive new tickets soon!
{% endhint %}

{% hint style="info" %}
**Good to know:** New messages are pulled every 2 mins.
{% endhint %}


# Additional Amazon Notifications

This section guides you through configuring Amazon notification forwarding to your helpdesk system, streamlining communication and managing customer interactions.

## **Setting Up Order Notification Forwarding**

* In your Amazon Seller Central account, navigate to **Settings > Notification Preferences**.
* Under **Order Notifications**, click **Edit**.
* Select the specific order notification types you wish to forward by checking the corresponding boxes. Options include Order Received, Order Update, Shipment Confirmed, etc.
* Enter the specific email address provided by Juble.io during integration.
* Click **Save**.

<figure><img src="/files/g8WBSEDBgUoUipgEseGq" alt=""><figcaption></figcaption></figure>

**2. Forwarding Additional Amazon Notifications (Optional):**

Beyond order notifications, you can also forward other relevant communications to your helpdesk. These include:

* Return and Claim Notifications
* Listing Notifications
* Reports
* Make an Offer Notifications
* Amazon Selling Coach Notifications
* Account Notifications
* Messaging (including one-way notifications like Confirmation Notifications)  &#x20;

Utilize the same process outlined for order notifications to configure forwarding for each of these categories.

**By configuring Amazon notification forwarding, you can streamline your support operations and optimize customer service delivery.**


# Settings

The Amazon Seller Central integration provides advanced settings for customizing your message handling preferences.

## **Notifications**

* **Amazon Answers:** Enable or disable notifications for Amazon Answers (enable to receive notifications for customer questions posted on product detail pages).
* **Service Messages:** Enable or disable notifications for Service Messages (enable to receive notifications for important messages from Amazon, such as order updates or policy changes).

<figure><img src="/files/NnbLdXB8YplvUN0Mkl9s" alt=""><figcaption></figcaption></figure>

## **Custom Tags**

* Custom tags: Add custom tags to your tickets for easy categorization and filtering. (space separated tags)

<figure><img src="/files/aU17ry8UzY6MnJgITCIM" alt=""><figcaption></figcaption></figure>

## **Custom Signature**

* **Custom Signature:** Add a custom signature to be appended to every message sent from your helpdesk account to Amazon. Use this to include your name, contact information, or any other relevant details.

<figure><img src="/files/p20wmBaQRuMXAv3tCWW9" alt=""><figcaption></figcaption></figure>


# eBay


# Add account

{% hint style="info" %}
**Good to know:** You can add multiple accounts by repeating the steps below with all your eBay accounts
{% endhint %}

## Authorize Juble.io Access to your eBay account

1. **Log in to Your Juble.io Account:** Start by logging in to your [Juble.io account](https://channels.juble.io/) using your credentials.
2. **Navigate to Channels:** Once you're logged in, navigate to the "Channels" option in the menu.
3. **Click on "Add Channel":**  In the "Channels" section, click on the "Add Channel" button to initiate the process of connecting a new integration.
4. **Select eBay:** Among the available integration options, choose "eBay" to proceed with linking your eBay Seller account.

<figure><img src="/files/9tyQiR3zDCfhTa3sP66w" alt=""><figcaption></figcaption></figure>

1. **Select Your Marketplace**: You will be prompted to select the specific eBay marketplace you wish to connect to. Choose the relevant marketplace from the dropdown list.
2. **Authorize Access:** After selecting the marketplace, click on the "Agree and Continue" button. This will redirect you to eBay where you will be asked to confirm and authorize Juble.io’s access to your account.

<figure><img src="/files/oIB0UjMhbidtbRTYpKfO" alt=""><figcaption></figcaption></figure>

7. **Confirmation:** Once authorization is complete, you'll be redirected back to Juble.io. Your eBay account will now be integrated with Juble.io, and you can start managing your channels effectively.
8. **Enable Connection:** Once you've reviewed and granted the necessary permissions, click the "Enable" button to finalize the integration process.

{% hint style="success" %}
**Congratulations!** Your account is now setup and will receive new tickets soon!
{% endhint %}

{% hint style="info" %}
**Good to know:** New messages are pulled every 2 mins.
{% endhint %}


# Settings

The eBay integration provides advanced settings for customizing your message handling preferences.

## **Custom Tags**

* Custom tags: Add custom tags to your tickets for easy categorization and filtering. (space separated tags)

<figure><img src="/files/aU17ry8UzY6MnJgITCIM" alt=""><figcaption></figcaption></figure>


# Bol.com


# Add account

{% hint style="info" %}
G**ood to know:** You can add multiple accounts by repeating the steps below with all your Bol accounts
{% endhint %}

## Generate a Bol.com Client Id and Client Secret

To integrate bol.com, you'll need your **Client ID** and **Client Secret**.

👉 Follow **Step 1 only** from this official guide:\
[How to acquire bol.com API credentials](https://api.bol.com/retailer/public/Retailer-API/authentication.html#_step_1_acquiring_api_credentials)

## Create a new Bol.com account

To create a new Bol account, follow the steps below:

1. Sign in to your Juble.io account using your credentials.
2. In the main menu, go to the "Channels" section.

<figure><img src="/files/JljqW2GvJuNajIA7KcyL" alt=""><figcaption></figcaption></figure>

3. Within the "Channels" section, click on the "Add Channel" button to initiate the process of connecting a new marketplace integration.
4. From the available marketplace options, choose "Bol.com" to proceed with linking your Bol.com account.

<figure><img src="/files/8st0vEjl7CtQHneOarN4" alt=""><figcaption></figcaption></figure>

5. **Provide a Friendly Name:** Assign a clear and descriptive name to this specific integration within your Juble.io account, especially if you manage multiple marketplaces.

<figure><img src="/files/m4GtHchYw4ycqXJXwZmm" alt=""><figcaption></figcaption></figure>

6. Enter the **Client ID** and the **Client Secret**

<figure><img src="/files/IZgGxVy9TyEdOtJtPVqc" alt=""><figcaption></figcaption></figure>

## Finalize Your Bol.com Integration

1. **Enable Connection:**

Once you've reviewed and granted the necessary permissions, click the "Enable" button to finalize the integration process.

<figure><img src="/files/c0disXJLQx0SwCN1uVx8" alt=""><figcaption></figcaption></figure>

## Add Your Unique Email Address to Bol.com

To ensure customer messages from bol.com are correctly routed to your helpdesk, you must add your **unique support email** to your seller account.

Follow the official bol.com instructions here:\
👉 [How to manage email addresses in your bol.com account](https://partnerplatform.bol.com/en/need-help/my-account/email-addresses/)

Once this is done, Bol.com will start forwarding messages to your helpdesk through the newly added email.

{% hint style="success" %}
**Congratulations!** Your account is now setup and will receive new tickets soon!
{% endhint %}

{% hint style="info" %}
**Good to know:** New messages are pulled every 2 mins.
{% endhint %}


# Settings

The Bol integration provides advanced settings for customizing your message handling preferences.

## **Custom Tags**

* Custom tags: Add custom tags to your tickets for easy categorization and filtering. (space separated tags)

<figure><img src="/files/aU17ry8UzY6MnJgITCIM" alt=""><figcaption></figcaption></figure>


# Fnac / Darty


# Add account

{% hint style="info" %}
**Good to know:** You can add multiple accounts if you happen to have a partnership with several Fnac / Darty shops
{% endhint %}

## Authorize Juble.io Access to your Fnac / Darty account

To enable the seamless integration of Fnac / Darty, it's crucial to grant authorization for Juble.io to access your Fnac / Darty account. Follow these steps to authorize access:

1. Contact Fnac support by emailing **<Marketplace.api@fnacdarty.com>**
2. In your message, kindly ask them to authorize **Juble.io** to access and interact with your store.

By completing these steps, you've successfully authorized Juble.io to access your Fnac / Darty account. This authorization is essential for Juble.io to retrieve customer messages and order details, providing you with a unified platform for managing customer support.

## Create a new Fnac / Darty account

To create a new Fnac / Darty  account, follow the steps below:

1. Sign in to your Juble.io account using your credentials.
2. In the main menu, go to the "Channels" section.

<figure><img src="/files/JljqW2GvJuNajIA7KcyL" alt=""><figcaption></figcaption></figure>

3\. Enter the desired information regarding, the name of the account, the Fnac / Darty Shop Id

<figure><img src="/files/hA6tOOyhrllYlxm2iCq7" alt=""><figcaption></figcaption></figure>

4\. Verify the connection and Save the information

{% hint style="success" %}
**Congratulations!** Your account is now setup and will receive new tickets soon!
{% endhint %}

{% hint style="info" %}
**Good to know:** New messages are pulled every 2 mins.
{% endhint %}


# Settings

The Fnac / Darty integration provides advanced settings for customizing your message handling preferences.

## **Custom Tags**

* Custom tags: Add custom tags to your tickets for easy categorization and filtering. (space separated tags)

<figure><img src="/files/aU17ry8UzY6MnJgITCIM" alt=""><figcaption></figcaption></figure>


# ManoMano


# Add account

{% hint style="info" %}
**Good to know:** You can add multiple accounts by repeating the steps below with all your ManoMano accounts
{% endhint %}

## Generate a ManoMano API Key and Seller contract ID

Your ManoMano API credentials are linked to the same account you use to access the [ManoMano seller back office](https://toolbox.manomano.com/).

If you don’t have an API key yet, follow these steps to generate one:

1. Log in to your ManoMano seller account.
2. Navigate to **Settings > API Keys**.
3. Locate and **copy your Seller Contract ID** — you’ll need it for API authentication.
4. Click **Create API Key**.
5. Enter a name for your API key (e.g., *Juble.io*).
6. Click **Generate API Key**.
7. **Copy and securely store** your new API key — you won’t be able to view it again.

## Create a new ManoMano account

To create a new ManoMano account, follow the steps below:

1. Sign in to your Juble.io account using your credentials.
2. In the main menu, go to the "Channels" section.

<figure><img src="/files/JljqW2GvJuNajIA7KcyL" alt=""><figcaption></figcaption></figure>

3. Within the "Channels" section, click on the "Add Channel" button to initiate the process of connecting a new marketplace integration.
4. From the available marketplace options, choose "ManoMano" to proceed with linking your ManoMano account.

<figure><img src="/files/rT2sCyjcKkoo1ULY8vjv" alt=""><figcaption></figcaption></figure>

5. **Provide a Friendly Name:** Assign a clear and descriptive name to this specific integration within your Juble.io account, especially if you manage multiple marketplaces.

<figure><img src="/files/pgCIvufjyTRXOk6GGtPD" alt=""><figcaption></figcaption></figure>

6. Enter the following information:
   * **Seller Contract ID**: Paste the ID you copied from the ManoMano back office.
   * **API Key**: Paste the API key you generated.

<figure><img src="/files/uvxL2copNshzaVqAxFHA" alt=""><figcaption></figcaption></figure>

## Finalize Your ManoMano Integration

1. **Enable Connection:**

Once you've reviewed and granted the necessary permissions, click the "Enable" button to finalize the integration process.

<figure><img src="/files/ssA9hTwnc1ElqCXvrQWe" alt=""><figcaption></figcaption></figure>

## Add Your Unique Email Address to ManoMano

To ensure that communications from ManoMano are correctly routed through Juble.io, you'll need to add the unique email address provided during the integration setup to your ManoMano account. Follow these steps to complete the process:

1. Log in to your **ManoMano seller account**.
2. Navigate to **Settings > Users** (or the relevant section where you manage users).
3. Click **Add New User**.
4. In the email field, enter your **unique support email**.
5. Before saving, **make sure the ManoMano integration is enabled** by clicking the **Enable** from the previous section.
6. Save the new user.
7. You will receive a **confirmation email** at your support email address. This confirms the user has been created successfully.

Once this is done, ManoMano will start forwarding messages to your helpdesk through the newly added email.

{% hint style="success" %}
**Congratulations!** Your account is now setup and will receive new tickets soon!
{% endhint %}

{% hint style="info" %}
**Good to know:** New messages are pulled every 2 mins.
{% endhint %}


# Settings

The ManoMano integration provides advanced settings for customizing your message handling preferences.

## **Custom Tags**

* Custom tags: Add custom tags to your tickets for easy categorization and filtering. (space separated tags)

<figure><img src="/files/aU17ry8UzY6MnJgITCIM" alt=""><figcaption></figcaption></figure>


# Miravia


# Add account

{% hint style="info" %}
**Good to know:** You can add multiple accounts by repeating the steps below with all your Miravia accounts
{% endhint %}

## Create a new Miravia account

To create a new Miravia account, follow the steps below:

1. Sign in to your Juble.io account using your credentials.
2. In the main menu, go to the "Channels" section.

<figure><img src="/files/JljqW2GvJuNajIA7KcyL" alt=""><figcaption></figcaption></figure>

3. Within the "Channels" section, click on the "Add Channel" button to initiate the process of connecting a new marketplace integration.
4. From the available marketplace options, choose "Miravia" to proceed with linking your Miravia account.

<figure><img src="/files/SXoRUqINh7rk3jiB3MIK" alt=""><figcaption></figcaption></figure>

5. **Provide a Friendly Name:** Assign a clear and descriptive name to this specific integration within your Juble.io account, especially if you manage multiple marketplaces.

<figure><img src="/files/F4Fk1TD8P1sfDdYKj5jB" alt=""><figcaption></figcaption></figure>

## Authorize Juble.io Access to your Miravia - Instant Messages

1. **Authorize Instant Messages Access:** Click on the "Authorize" button. This will redirect you to Miravia where you will be asked to confirm and authorize Juble.io’s access to your instant messages.

<figure><img src="/files/UEBOd3kWdhoIH0VRZDrA" alt=""><figcaption></figcaption></figure>

2. **Confirmation:** Once authorization is complete, you'll be redirected back to Juble.io. Your Miravia instant messages will now be integrated with Juble.io, and you can start managing your channels effectively.

## Authorize Juble.io Access to your Miravia - API

1. **Authorize API Access:** Click on the "Authorize" button. This will redirect you to Miravia where you will be asked to confirm and authorize Juble.io’s access to your order information.

<figure><img src="/files/FOOwb54xjgML44XmvmSV" alt=""><figcaption></figcaption></figure>

2. **Confirmation:** Once authorization is complete, you'll be redirected back to Juble.io. Your Miravia API will now be integrated with Juble.io, and you can start managing your channels effectively.

## Finalize Your Miravia Integration

1. **Enable Connection:**

Once you've reviewed and granted the necessary permissions, click the "Enable" button to finalize the integration process.

<figure><img src="/files/fHtHwajQkz9ZaWJrdxyw" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
**Congratulations!** Your account is now setup and will receive new tickets soon!
{% endhint %}

{% hint style="info" %}
**Good to know:** New messages are pulled every 2 mins.
{% endhint %}


# Settings

The Miravia integration provides advanced settings for customizing your message handling preferences.

## **Custom Tags**

* Custom tags: Add custom tags to your tickets for easy categorization and filtering. (space separated tags)

<figure><img src="/files/aU17ry8UzY6MnJgITCIM" alt=""><figcaption></figcaption></figure>


# Mirakl


# Add account

{% hint style="info" %}
**Good to know:** You can add multiple accounts if you happen to have a partnership with several Mirakl vendors
{% endhint %}

## Step 1 — Choose Your Authentication Method

You can now connect to Mirakl using **either an API Key** or **OAuth 2.0**.\
OAuth 2.0 is the recommended method for improved security and easier credential management.

### Option 1 — API Key Authentication

To generate the Mirakl API Key (See screenshot below):

1. Log into your desired Mirakl account: https\://\[ACCOUNT].mirakl.net/mmp/shop/user/api
2. Click on your email address on the top right corner
3. Select the tab 'API Key'
4. Copy your API Key

<figure><img src="/files/7rdyEu2AQAeNZK2BXIzH" alt=""><figcaption></figcaption></figure>

### **Option 2 — OAuth 2.0 Authentication (New)**

If your Mirakl instance supports OAuth 2.0, you can authenticate using your **Client ID** and **Client Secret** instead of an API key.

You’ll need to provide:

| Field                  | Description                                                                                    |
| ---------------------- | ---------------------------------------------------------------------------------------------- |
| **Client ID**          | The client identifier generated in your Mirakl developer portal.                               |
| **Client Secret**      | The secret associated with your Client ID.                                                     |
| **Target Environment** | The Mirakl environment you wish to connect to (e.g., development, pre-production, production). |

📘 **How to generate your Client ID and Secret:**\
Follow Mirakl’s official guide here:\
👉 [Generate Access Tokens and Client Credentials](https://help.mirakl.com/bundle/customers/page/topics/Mirakl/get_started/generate_access_tokens.html#clientid)

<figure><img src="/files/5tIdjcOO2tG8FwjB0x6u" alt=""><figcaption></figcaption></figure>

## Step 2 — Create a New Mirakl Account

To create a new Mirakl account, follow the steps below:

1. Sign in to your Juble.io account using your credentials.
2. In the main menu, go to the "Channels" section.

<figure><img src="/files/JljqW2GvJuNajIA7KcyL" alt=""><figcaption></figcaption></figure>

3\. Enter the desired information regarding, the name of the account, the Mirakl URL and the API Key

<figure><img src="/files/TXMvEC8GdVEBE8UsRujK" alt=""><figcaption></figcaption></figure>

4\. Verify the connection and Save the information

{% hint style="success" %}
**Congratulations!** Your account is now setup and will receive new tickets soon!
{% endhint %}

{% hint style="info" %}
**Good to know:** New messages are pulled every 2 mins.
{% endhint %}


# Advanced settings

The Mirakl app provides advanced settings for customizing your message handling preferences.

## Reply option

* **Default:**
  * When a customer sends a message to the shop, the reply is sent to the customer with the operator copied.
  * When the operator sends a message to the shop, the reply is sent to the operator only, without copying the customer.
  * If the operator sends a message to the shop with the customer copied, the reply is sent to both the operator and the customer.
* **Always Reply to Operator and Customer:** Messages are always replied to both operators and customers, ensuring both parties stay informed.
* **Always Reply to Customer Only:** Messages are exclusively replied to customers, limiting operator involvement.

<figure><img src="/files/mgfg3owPEGe0YAzxjWsT" alt=""><figcaption></figcaption></figure>

## Shop id

You can set your Shop ID here to ensure messages are directed correctly, especially when managing multiple shops within your Mirakl account. Leave this field empty if not applicable.

<figure><img src="/files/8YZJLeQY2otle19pDDKY" alt=""><figcaption></figcaption></figure>

To find you shop id, you can log into your Mirakl instance and it will be display on the dashboard page:

<figure><img src="/files/csRQfmXO8DrvwOF8Nh1E" alt=""><figcaption><p>Shop id is 2114 in this case</p></figcaption></figure>

## Channel Code

* Used to identify specific sales channels within your Mirakl account.
* Leave empty for single-shop accounts.
* Enter channel code for multiple shops (e.g., FR for France, ES for Spain).

<figure><img src="/files/sly4xtn9KTcduX75qKrI" alt="" width="563"><figcaption></figcaption></figure>

## Role

Specify your role as an Operator or Shop. This helps the app adapt its message handling to your specific needs. Messages are imported differently based on your chosen role.

<figure><img src="/files/9iZeGIUlbp9eNQHDGwnJ" alt=""><figcaption></figcaption></figure>

## **Custom Tags**

* Custom tags: Add custom tags to your tickets for easy categorization and filtering. (space separated tags)

<figure><img src="/files/10ZCIRFEYscsaJn1aGlF" alt=""><figcaption></figcaption></figure>

## **Notifications**

* **Incident without messages:** Enable or disable notifications for incidents without messages.

<figure><img src="/files/ULAsEp1k5Qo6S0UtLIKO" alt=""><figcaption></figcaption></figure>


# Message Creation

## Overview

The Message Creation feature enables users to initiate messages from Zendesk to Mirakl seamlessly. This integration streamlines communication between these two platforms, allowing for efficient and effective interactions. By creating messages directly from Zendesk to Mirakl, you can enhance your customer support and marketplace management processes, ultimately improving the overall user experience.

In the following sections, we will guide you through the steps to set up and utilize this feature, ensuring that you can harness its full potential to benefit your operations.

## Setup

### Prerequisites

Before you proceed with the integration, ensure that you have the necessary prerequisites in place:

#### Zendesk token

You will need an API token to complete the integration process. If you don't have a token yet, follow these steps to obtain it:

{% content-ref url="/pages/3RxAAKVvMKbu4kdJccRp" %}
[Zendesk token](/helpdesks/zendesk/zendesk-token)
{% endcontent-ref %}

Once you have your Zendesk API token, you can proceed to the next section to create message from Zendesk to Mirakl.

## Utilization

With the integration set up, you can now create messages from Zendesk to Mirakl effortlessly:

1. Click on 'New Ticket' in Zendesk to initiate a new support ticket.
2. Within the Mirakl application, click on 'Create Mirakl Message.' This action will load your data to prepare for sending the message.

<figure><img src="/files/kxpDOkJYzvL8l3ZCOqvO" alt=""><figcaption></figcaption></figure>

3. When creating a message, ensure that you include the following information as part of your ticket:

* Subject
* Comment
* Order ID

4. Click 'Send Message' to dispatch the message to Mirakl.

<figure><img src="/files/osDmOmeqUKi5oEiiZV8M" alt=""><figcaption></figcaption></figure>

By following these steps, you can fully utilize the Message Creation feature to streamline communication between Zendesk and Mirakl, providing a seamless experience for both your team and your customers.


# Troubleshooting

## Connection is not verifying with the API key

Ensure that your Mirakl user account has the "Seller Administration" role assigned. The API key requires this role for proper functionality. If your role is different, please request an update from your Mirakl administrator.

<figure><img src="/files/GPfUk6fuRCUZsZGYMxfM" alt=""><figcaption></figcaption></figure>

## Cleaning Up Mirakl URL

Sometimes, issues may arise due to variations in the Mirakl URL. To ensure a smooth connection, please make sure your Mirakl URL is in the correct format. Follow these steps to clean up the Mirakl URL:

1. **Original URL:** `https://1800flowers-prod.mirakl.net/marketplace-dashboard/`
2. **Cleaned Up URL:** `https://1800flowers-prod.mirakl.net`

By removing any unnecessary paths beyond the main domain, you can enhance the accuracy of the connection. Ensure that your Mirakl URL matches the cleaned-up format. If you continue to face issues, feel free to reach out to our support team for further assistance.


# Newegg


# Add account

{% hint style="info" %}
**Good to know:** You can add multiple accounts by repeating the steps below with all you Newegg accounts
{% endhint %}

## Retrieve Newegg Seller ID, API Key and Secret Key

To retrieve the Newegg Seller ID, API Key and Secret Key, follow these steps:

1. **Access Newegg Data Feed Settings:**
   * Open the [Newegg Data Feed Settings](https://sellerportal.newegg.com/v3/module/account/datafeed-settings) page in a new tab.
   * Sign in if prompted.
   * Navigate to the **"API Settings"** tab in the top menu.

<figure><img src="/files/9kRsBDn1y9Uwl63wMJak" alt=""><figcaption></figcaption></figure>

2. **Update Contact Information (if needed):**

* If you haven't already, fill in the **“Full Contact Name”** and **“Email Address”** fields.
* Click **“SAVE”** if you make any changes.

<figure><img src="/files/3JHGvyGiOHaiu0Wr061k" alt=""><figcaption></figcaption></figure>

3. **Enable API Access:**

* Ensure that the **“Enable/Disable API Access”** slider is enabled (should appear orange with the knob on the right).
* If the slider is grey, click on it to enable API access, then hit **“OK”** in the pop-up that appears.

<figure><img src="/files/SwXFrOligw3VTpz2LPb4" alt=""><figcaption></figcaption></figure>

4. Retrieve Your Seller ID, API Key and Secret Key

* If you require a unique Secret Key specifically for Juble.io, contact Newegg support at **<datafeeds@newegg.com>**. Request them to send your unique Juble.io API credentials.
* Once you receive the email, copy your unique Secret Key.
* Alternatively, you can use the **Default Secret Key** from Data Feed Settings if you prefer not to wait.

<figure><img src="/files/Sw6Sj7L48TyILUq0HtT7" alt=""><figcaption></figcaption></figure>

## Create a new Newegg account

To create a new Newegg account, follow the steps below:

1. Sign in to your Juble.io account using your credentials.
2. In the main menu, go to the "Channels" section.

<figure><img src="/files/JljqW2GvJuNajIA7KcyL" alt=""><figcaption></figcaption></figure>

3. Enter the required information, including the name of the account, Newegg Seller Id, Newegg API Key, Newegg Secret Key, and Newegg Market (Newegg, Newegg Business, Newegg Canada).

<figure><img src="/files/yiOKQJor4OayezkcnSSR" alt=""><figcaption></figcaption></figure>

4. Copy your Unique Email Address, as it will be needed in the next section.
5. Verify the connection and Save the information

## Add Your Unique Email Address to Newegg

To add your unique email address to Newegg, please follow these steps:

1. Navigate to the Newegg seller portal and log in to your account.&#x20;
2. Go to the [Account Settings](https://sellerportal.newegg.com/account/accountsettings) page.
3. Within the Account Settings, locate the **Notification Options** tab. Click the **"EDIT"** button found in the upper right corner of the Notification Options section.

<figure><img src="/files/mVJbWbQ5wJMRNP5L461t" alt=""><figcaption></figcaption></figure>

4. Scroll down to the **Message Notifications** section at the bottom of the page.
5. Paste your unique Juble.io email address into the **Email** field.

<figure><img src="/files/IlDSQySDXwnrPekb2NOO" alt=""><figcaption></figcaption></figure>

6. After entering your email address, click the **"SAVE"** button to apply the changes. A confirmation message will pop up. Click **"OK"** to proceed.
7. Please note that it may take up to 30 minutes for Newegg to process your changes and begin sending messages through Juble.io. During this period, continue to monitor your Newegg messages through the standard platform to ensure nothing is missed.

{% hint style="success" %}
**Congratulations!** Your account is now setup and will receive new tickets soon!
{% endhint %}

{% hint style="info" %}
**Good to know:** New messages are pulled every 2 mins.
{% endhint %}


# Settings

The Newegg integration provides advanced settings for customizing your message handling preferences.

**Notifications**

* **New Order:** Enable or disable notifications for new orders received from Newegg.
* **Cancel Order:** Enable or disable notifications for canceled orders from Newegg.
* **Return/Refund/Replacement:** Enable or disable notifications for return, refund, or replacement requests from Newegg.
* **New SBN Order:** Enable or disable notifications for new SBN (Ship By Newegg) orders from Newegg.

<figure><img src="/files/u9olZqvx6oJS8eBUncVb" alt=""><figcaption></figcaption></figure>

**Custom Signature**

* **Custom Signature:** Add a custom signature to be appended to every message sent from your helpdesk account to Newegg. Use this to include your name, contact information, or any other relevant details.

<figure><img src="/files/p20wmBaQRuMXAv3tCWW9" alt=""><figcaption></figcaption></figure>


# Octopia


# Add account

{% hint style="info" %}
**Good to know:** You can add multiple accounts if you happen to have a partnership with several Octopia vendors
{% endhint %}

## Authorize Juble.io Access to your Octopia account

To enable the seamless integration of Octopia, it's crucial to grant authorization for Juble.io to access your Octopia account. Follow these steps to authorize access:

1. **Grant Access via Octopia API Credentials:**
   * Visit the Octopia API Credentials page: <https://developer.octopia-io.net/api-credentials/#linkAgregClientToSeller>
   * Enter the client ID **"Juble.io"** in the designated field.
   * Click the button labeled **"Confirm my agregator clientId"**.

<figure><img src="/files/v051yH6FgEdDGwjotqHb" alt=""><figcaption></figcaption></figure>

1. Click the button labeled **"Proceed with seller authentication"**.

<figure><img src="/files/sfbGZmGEwkLRz0CEazzC" alt=""><figcaption></figcaption></figure>

1. **Octopia Seller Login:**
   * You will be redirected to a secure Octopia login page.
   * Enter your **Octopia username** and **password** in the respective fields.
2. **Confirm Connection:**
   * Once you've entered your login credentials, click the button to **confirm the connection** between Juble.io and your Octopia account.

By completing these steps, you've successfully authorized Juble.io to access your Octopia account. This authorization is essential for Juble.io to retrieve customer messages and order details, providing you with a unified platform for managing customer support.

## Create a new Octopia account

To create a new Octopia account, follow the steps below:

1. Sign in to your Juble.io account using your credentials.
2. In the main menu, go to the "Channels" section.

<figure><img src="/files/JljqW2GvJuNajIA7KcyL" alt=""><figcaption></figcaption></figure>

3\. Enter the desired information regarding, the name of the account, the Octopia Seller Id and the Sales Channel

<figure><img src="/files/NXsDnKbjO2K4kYrGnh1R" alt=""><figcaption></figcaption></figure>

4\. Verify the connection and Save the information

{% hint style="success" %}
**Congratulations!** Your account is now setup and will receive new tickets soon!
{% endhint %}

{% hint style="info" %}
**Good to know:** New messages are pulled every 2 mins.
{% endhint %}


# TikTok Shop


# Add account

{% hint style="info" %}
**Good to know:** You can add multiple accounts by repeating the steps below with all your TikTok accounts
{% endhint %}

## Create a new TikTok account

To create a new TikTok account, follow the steps below:

1. Sign in to your Juble.io account using your credentials.
2. In the main menu, go to the "Channels" section.

<figure><img src="/files/JljqW2GvJuNajIA7KcyL" alt=""><figcaption></figcaption></figure>

3. Within the "Channels" section, click on the "Add Channel" button to initiate the process of connecting a new marketplace integration.
4. From the available marketplace options, choose "TikTok Shop" to proceed with linking your TikTok account.

<figure><img src="/files/oSk2fV1FwVx7yyZbUIGf" alt="" width="464"><figcaption></figcaption></figure>

3. **Provide a Friendly Name:** Assign a clear and descriptive name to this specific integration within your Juble.io account, especially if you manage multiple marketplaces.

<figure><img src="/files/SCwUNGpizEF6qZE5btYk" alt="" width="563"><figcaption></figcaption></figure>

## Authorize Juble.io Access to your TikTok Shop

1. **Authorize API Access:** Click on the "Authorize" button. This will redirect you to TikTok where you will be asked to confirm and authorize Juble.io’s access to your order information and instant messages.

<figure><img src="/files/j9WogosClaVYFJyEfGNS" alt="" width="563"><figcaption></figcaption></figure>

2. **Confirmation:** Once authorization is complete, you'll be redirected back to Juble.io. Your TikTok API will now be integrated with Juble.io, and you can start managing your channels effectively.

## Finalize Your TikTok Shop Integration

1. **Enable Connection:**

Once you've reviewed and granted the necessary permissions, click the "Enable" button to finalize the integration process.

<figure><img src="/files/Dln0EhsJItcoYuNk1GvW" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="success" %}
**Congratulations!** Your account is now setup and will receive new tickets soon!
{% endhint %}

{% hint style="info" %}
**Good to know:** New messages are pulled every 2 mins.
{% endhint %}


# Settings

The Tiktok integration provides advanced settings for customizing your message handling preferences.

## **Custom Tags**

* Custom tags: Add custom tags to your tickets for easy categorization and filtering. (space separated tags)

<figure><img src="/files/aU17ry8UzY6MnJgITCIM" alt=""><figcaption></figcaption></figure>


# Walmart


# Add account

{% hint style="info" %}
**Good to know:** You can add multiple accounts by repeating the steps below with all your Walmart accounts
{% endhint %}

## Retrieve Walmart Client ID and Client Secret

To retrieve the Walmart Client Id and Client Secret, follow these steps:

1. Log into the [API Keys](https://developer.walmart.com/account/generateKey) section of Walmart using the desired account.
2. Click on "Production Keys".
3. Copy your Client Id.
4. Copy your Client Secret.

Refer to the screenshot below for a visual guide:

<figure><img src="/files/L0kEReBbUCTndEKCY0TQ" alt=""><figcaption></figcaption></figure>

## Create a new Walmart account

To create a new Walmart account, follow the steps below:

1. Sign in to your Juble.io account using your credentials.
2. In the main menu, go to the "Channels" section.

<figure><img src="/files/JljqW2GvJuNajIA7KcyL" alt=""><figcaption></figcaption></figure>

3. Enter the required information, including the name of the account, Walmart Client Id, Walmart Client Secret, and Walmart Market (US, CA, MX).

<figure><img src="/files/JZdqfs1dSYOMKHUW4vVi" alt=""><figcaption></figcaption></figure>

4. Copy your Unique Email Address, as it will be needed in the next section.
5. Verify the connection and Save the information

## Add Your Unique Email Address to Walmart

To add your unique email address to Walmart, please follow these steps:

1. Go to <https://seller.walmart.com/seller-profile/manage-contacts> and log in to your account.
2. Search for "Customer Service Contact" and click on "Add Contact".

<figure><img src="/files/2XIp2fRo5SS6BB5TKEBg" alt=""><figcaption></figcaption></figure>

3. Select the option "Individual Contact" as the contact type, check the box labeled "Make primary contact." and paste your Unique Email Address that was mentioned earlier.&#x20;
4. Fill out the remaining fields with the contact details for your primary customer service representative. This person will be your main liaison for Walmart, so it's crucial that they are designated as your primary point of contact. Please ensure to provide their most dependable phone number.

<figure><img src="/files/DwxDTLh14EhFZUxLhxPN" alt=""><figcaption></figcaption></figure>

5. Click on  "Save Contact" to confirm the changes.
6. After saving the contact, please note that you will receive a new ticket requesting confirmation of the email address. It's essential to check this ticket and validate the email to ensure proper configuration and functionality within the Walmart system.

{% hint style="success" %}
**Congratulations!** Your account is now setup and will receive new tickets soon!
{% endhint %}

{% hint style="info" %}
**Good to know:** New messages are pulled every 2 mins.
{% endhint %}


# Zendesk Legacy App


# Mirakl

## Mirakl App for Zendesk Integration

The Mirakl app by Juble.io enables seamless integration between Mirakl marketplaces and Zendesk Support. With this powerful integration, you can streamline your customer support operations and deliver exceptional service to your Mirakl customers.

### Key Features

* Retrieve customer messages and inquiries from multiple Mirakl marketplaces directly into Zendesk Support.
* View comprehensive order details, including order status, product information, and delivery details.
* Empower support agents with relevant order and customer information to make informed decisions.
* Enable click-through actions to navigate directly from Zendesk Support to the Mirakl platform.
* Manage an unlimited number of Mirakl marketplace accounts within Zendesk.

Get started today and enhance your customer support capabilities with the Mirakl app by Juble.io.

*Disclaimer: Mirakl is a registered trademark of Mirakl Inc. This application is developed by Juble.io and is not affiliated with or endorsed by Mirakl Inc.*


# Add account

{% hint style="info" %}
**Good to know:** You can add multiple accounts if you happen to have a partnership with several Mirakl vendors
{% endhint %}

## Generate a Mirakl API Key

To generate the Mirakl API Key (See screenshot below):

1. Log into your desired Mirakl account: https\://\[ACCOUNT].mirakl.net/mmp/shop/user/api
2. Click on your email address on the top right corner
3. Select the tab 'API Key'
4. Copy your API Key

<figure><img src="/files/7rdyEu2AQAeNZK2BXIzH" alt=""><figcaption></figcaption></figure>

## Create a new Mirakl account in Zendesk

To create a new Mirakl account, follow the steps below:

1. Sign in to your Zendesk Support account
2. Go to your Zendesk Admin Center and click on the Channel apps menu.

<figure><img src="/files/gSAQPHroMBHqKNUqMxmI" alt=""><figcaption></figcaption></figure>

3. Select your Mirakl integration installed.

<figure><img src="/files/eflR25aWnoAdNiSY3sOs" alt=""><figcaption></figcaption></figure>

4. Click on Add account

<figure><img src="/files/ws1haaTNGqgnMGorSQBj" alt=""><figcaption></figcaption></figure>

5\. Enter the desired information regarding, the name of the account, the Mirakl URL and the API Key

<figure><img src="/files/D1FHXrVbaJkbOhdn0wbI" alt=""><figcaption></figcaption></figure>

6\. Verify the connection and Save the information

{% hint style="success" %}
**Congratulations!** Your account is now setup and will receive new tickets soon!
{% endhint %}

{% hint style="info" %}
**Good to know:** New messages are pulled every 2 mins.
{% endhint %}


# Advanced settings

The Mirakl app provides advanced settings for customizing your message handling preferences.

## Reply option

* **Default:**
  * When a customer sends a message to the shop, the reply is sent to the customer with the operator copied.
  * When the operator sends a message to the shop, the reply is sent to the operator only, without copying the customer.
  * If the operator sends a message to the shop with the customer copied, the reply is sent to both the operator and the customer.
* **Always Reply to Operator and Customer:** Messages are always replied to both operators and customers, ensuring both parties stay informed.
* **Always Reply to Customer Only:** Messages are exclusively replied to customers, limiting operator involvement.

<figure><img src="/files/mgfg3owPEGe0YAzxjWsT" alt=""><figcaption></figcaption></figure>

## Shop id

You can set your Shop ID here to ensure messages are directed correctly, especially when managing multiple shops within your Mirakl account. Leave this field empty if not applicable.

<figure><img src="/files/8YZJLeQY2otle19pDDKY" alt=""><figcaption></figcaption></figure>

## Role

Specify your role as an Operator or Shop. This helps the app adapt its message handling to your specific needs. Messages are imported differently based on your chosen role.

<figure><img src="/files/9iZeGIUlbp9eNQHDGwnJ" alt=""><figcaption></figcaption></figure>

## **Notifications**

* **Incident without messages:** Enable or disable notifications for incidents without messages.

<figure><img src="/files/dYJAOTQE8B2Xmfrdo4au" alt=""><figcaption></figcaption></figure>


# Troubleshooting

## Connection is not verifying with the API key

Ensure that your Mirakl user account has the "Seller Administration" role assigned. The API key requires this role for proper functionality. If your role is different, please request an update from your Mirakl administrator.

<figure><img src="/files/GPfUk6fuRCUZsZGYMxfM" alt=""><figcaption></figcaption></figure>

## Cleaning Up Mirakl URL

Sometimes, issues may arise due to variations in the Mirakl URL. To ensure a smooth connection, please make sure your Mirakl URL is in the correct format. Follow these steps to clean up the Mirakl URL:

1. **Original URL:** `https://1800flowers-prod.mirakl.net/marketplace-dashboard/`
2. **Cleaned Up URL:** `https://1800flowers-prod.mirakl.net`

By removing any unnecessary paths beyond the main domain, you can enhance the accuracy of the connection. Ensure that your Mirakl URL matches the cleaned-up format. If you continue to face issues, feel free to reach out to our support team for further assistance.


# Walmart

## Application Summary

Manage your Walmart customer messages and orders seamlessly within Zendesk. Our application integrates Walmart's messaging system with Zendesk, allowing you to retrieve and respond to customer messages directly in your Zendesk platform.

### Key Features

* Retrieve and respond to Walmart customer messages within Zendesk
* Effortlessly handle an unlimited number of Walmart accounts
* Streamline order management with easy refund and cancellation options

### Benefits

* Simplify your Walmart customer interactions
* Centralize all customer support activities in Zendesk
* Enhance efficiency and productivity
* Provide seamless customer experiences

Experience the power of our Walmart integration and revolutionize your customer support workflow.

Get started with [Walmart ](https://www.zendesk.com/marketplace/apps/support/933555/walmart/)by Juble.io today!

*Disclaimer: Walmart is a registered trademark owned by their respective company. This app is not affiliated with or endorsed by Walmart.*


# Add account

{% hint style="info" %}
**Good to know:** You can add multiple accounts by repeating the steps below with all you Walmart accounts
{% endhint %}

## Retrieve Walmart Client ID and Client Secret

To retrieve the Walmart Client Id and Client Secret, follow these steps:

1. Log into the [API Keys](https://developer.walmart.com/account/generateKey) section of Walmart using the desired account.
2. Click on "Production Keys".
3. Copy your Client Id.
4. Copy your Client Secret.

Refer to the screenshot below for a visual guide:

<figure><img src="/files/L0kEReBbUCTndEKCY0TQ" alt=""><figcaption></figcaption></figure>

## Create a New Walmart Account in Zendesk

To create a new Walmart account in Zendesk, follow these steps:

1. Sign in to your Zendesk Support account.
2. Go to your Zendesk Admin Center and click on the Channel apps menu.

<figure><img src="/files/gSAQPHroMBHqKNUqMxmI" alt=""><figcaption></figcaption></figure>

3. Select your installed Walmart integration.

<figure><img src="/files/1Am1vdcqVI0X25B8HvGM" alt=""><figcaption></figcaption></figure>

4. Click on "Add account".

<figure><img src="/files/WYCtCvcPmvCWBbC2dSJg" alt=""><figcaption></figcaption></figure>

5. Enter the required information, including the name of the account, Walmart Client Id, Walmart Client Secret, and Walmart Market (US, CA, MX).

<figure><img src="/files/Wgiuv0yuHevcfEaPxQwz" alt=""><figcaption></figcaption></figure>

6. Copy your Unique Email Address, as it will be needed in the next section.
7. Verify the connection and save the information.

## Add Your Unique Email Address to Walmart

To add your unique email address to Walmart, please follow these steps:

1. Go to <https://seller.walmart.com/seller-profile/manage-contacts> and log in to your account.
2. Search for "Customer Service Contact" and click on "Add Contact".

<figure><img src="/files/2XIp2fRo5SS6BB5TKEBg" alt=""><figcaption></figcaption></figure>

3. Select the option "Individual Contact" as the contact type, check the box labeled "Make primary contact." and paste your Unique Email Address that was mentioned earlier.&#x20;
4. Fill out the remaining fields with the contact details for your primary customer service representative. This person will be your main liaison for Walmart, so it's crucial that they are designated as your primary point of contact. Please ensure to provide their most dependable phone number.

<figure><img src="/files/DwxDTLh14EhFZUxLhxPN" alt=""><figcaption></figcaption></figure>

5. Click on  "Save Contact" to confirm the changes.
6. After saving the contact, please note that you will receive a new ticket requesting confirmation of the email address. It's essential to check this ticket and validate the email to ensure proper configuration and functionality within the Walmart system.

{% hint style="success" %}
**Congratulations!** Your account is now setup and will receive new tickets soon!
{% endhint %}

{% hint style="info" %}
**Good to know:** New messages are pulled every 2 mins.
{% endhint %}


# Octopia


# Add account

{% hint style="info" %}
**Good to know:** You can add multiple accounts if you happen to have a partnership with several Octopia vendors
{% endhint %}

## Authorize Juble.io Access to your Octopia account

To enable the seamless integration of Octopia, it's crucial to grant authorization for Juble.io to access your Octopia account. Follow these steps to authorize access:

1. **Grant Access via Octopia API Credentials:**
   * Visit the Octopia API Credentials page: <https://developer.octopia-io.net/api-credentials/#linkAgregClientToSeller>
   * Enter the client ID **"Juble.io"** in the designated field.
   * Click the button labeled **"Confirm my agregator clientId"**.

<figure><img src="/files/v051yH6FgEdDGwjotqHb" alt=""><figcaption></figcaption></figure>

1. Click the button labeled **"Proceed with seller authentication"**.

<figure><img src="/files/sfbGZmGEwkLRz0CEazzC" alt=""><figcaption></figcaption></figure>

1. **Octopia Seller Login:**
   * You will be redirected to a secure Octopia login page.
   * Enter your **Octopia username** and **password** in the respective fields.
2. **Confirm Connection:**
   * Once you've entered your login credentials, click the button to **confirm the connection** between Juble.io and your Octopia account.

By completing these steps, you've successfully authorized Juble.io to access your Octopia account. This authorization is essential for Juble.io to retrieve customer messages and order details, providing you with a unified platform for managing customer support.

## Create a new Octopia account in Zendesk

To create a new Octopia account, follow the steps below:

1. Sign in to your Zendesk Support account
2. Go to your Zendesk Admin Center and click on the Channel apps menu.

<figure><img src="/files/gSAQPHroMBHqKNUqMxmI" alt=""><figcaption></figcaption></figure>

3. Select your Octopia integration installed.

<figure><img src="/files/tzhLExwQ8oCvYbQqOPpg" alt=""><figcaption></figcaption></figure>

4. Click on Add account

<figure><img src="/files/n3u3XLJaVqSxzuEoW6J0" alt=""><figcaption></figcaption></figure>

5\. Enter the desired information regarding, the name of the account, the Octopia Seller Id and the Sales Channel

<figure><img src="/files/1VHTp5geHxM57Ih9gmwg" alt=""><figcaption></figcaption></figure>

6\. Verify the connection and Save the information

{% hint style="success" %}
**Congratulations!** Your account is now setup and will receive new tickets soon!
{% endhint %}

{% hint style="info" %}
**Good to know:** New messages are pulled every 2 mins.
{% endhint %}


