> For the complete documentation index, see [llms.txt](https://docs.responso.com/responso-doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.responso.com/responso-doc/en/integrations/other-integrations/mirakl.md).

# Mirakl

Mirakl is a platform for building and running marketplaces. Many popular marketplaces run on it, including Empik, Leroy Merlin, and Dr. Max.

{% hint style="info" %}
This guide lets you integrate any Mirakl-based marketplace with Responso. These include: Alltricks, ANBW, Autodoc, Bauhaus, Big Bang, Black Red White, Brico Dépôt, But, B\&Q, Castorama, Carrefour, Conforama, Conrad, Decathlon, Debenhams, Dr. Max, E.Leclerc, Empik, ePrice, Home24, Home\&You, Hornbach, Kabum, Leroy Merlin, Maisons du Monde, Maxeda, Media Expert, MediaMarkt, Modivo, OBI, Rue du Commerce, Tesco, Ubaldi, Vente Unique, Worten, XXXLutz.
{% endhint %}

### Integration guide

To connect your Mirakl marketplace account to Responso, follow the steps below.

{% hint style="warning" %}
Note: If you have several stores on the same Mirakl marketplace assigned to the same e-mail address, add a separate integration for each store ID whose messages you want to handle in Responso.
{% endhint %}

{% stepper %}
{% step %}

### Log in to your Mirakl marketplace account.

From the menu, select *Settings -> Users* and **make sure your account has the&#x20;*****Store administration*****&#x20;role**.

<figure><img src="https://3955834893-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRzugs74q0ZJpBQlgWsYT%2Fuploads%2FBWLgfsNjMe05FKLuXiP8%2FEN%20Mirakle%201.png?alt=media&amp;token=3fa71058-916e-4bf8-b54d-a73d61942005" alt=""><figcaption></figcaption></figure>

Click the person icon in the top right corner of the screen, select *Profile*, and go to the *API Key* tab.

Click *Generate new key*. Then copy the generated key.

<figure><img src="https://3955834893-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRzugs74q0ZJpBQlgWsYT%2Fuploads%2FS0m4f2lL6uDucjY9fgJ9%2FEN%20Mirakle%202.png?alt=media&amp;token=114f211d-8a52-40df-81cd-96b306543504" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### **Log in to Responso.**

Select *Add channel* and click the name of the marketplace you want to integrate.

In the window that opens, paste the API key you copied earlier. Also enter a name for the integration and add the ID of the store you’re connecting to Responso (the store ID is required, even if you only have one store on that Mirakl marketplace). Once you’ve entered the details, click *Create*.

<figure><img src="https://3955834893-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRzugs74q0ZJpBQlgWsYT%2Fuploads%2FFVktwhYm8PimMFqMxi7F%2FEN%20Mirakl%203.png?alt=media&amp;token=2309a433-67a7-43a8-9e5a-bada6f587736" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
You can find your store ID by clicking the store name in the top left corner of your Mirakl marketplace dashboard:
{% endhint %}

<figure><img src="https://3955834893-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRzugs74q0ZJpBQlgWsYT%2Fuploads%2Fa70rxPrLoUbyz9grvhjN%2FEN%20Mirakl%204.png?alt=media&amp;token=cd5359a6-6ac1-462b-8d9c-f287f0baad37" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### FAQ

#### **How long does the first message import take?**

Once your account is added successfully, Responso starts importing your messages. The first import can take more or less time depending on how many messages you have, but it shouldn’t take longer than an hour. After that, new messages are imported every 5–10 minutes on average.

#### **How many messages will be imported?**

All messages from the connected account will be imported.

#### **Where can I find messages from this account in Responso?**

Messages appear in the main view (inbox), in the list of all messages, marked with the corresponding logo.

### Common issues

<details>

<summary><strong>Messages aren’t being imported</strong></summary>

First, check whether an icon indicating an account problem has appeared. You’ll find it in the top right corner: ![](https://3955834893-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRzugs74q0ZJpBQlgWsYT%2Fuploads%2Ff9HAqR4ZlYOy5DJ0OoVX%2Fimage.png?alt=media\&token=c96db210-1ddd-434c-9856-787db82a2a1a)

If there’s a notice about a problem with the account, try adding it again. If that doesn’t help, send us a message at <bok@responso.com> and we’ll look into it ☺️

</details>
