Skip to content
P2Lab Mirakl

Order messages

Every Mirakl order has its own conversation thread between you (the seller), the buyer and the marketplace operator. P2Lab Mirakl pulls those conversations into the Shopware order detail page and lets you reply without leaving the admin.

Where to find it

Section titled “Where to find it”

Open any Shopware order that was imported from Mirakl. The plugin adds a Mirakl tab to the standard order detail page; inside that tab there are three sub-tabs: Overview, Messages and Documents.

The Messages sub-tab shows a card titled Messages with two toolbar buttons:

  • Sync — fetches the latest messages for this order from the operator right now.
  • New thread — opens the Send Message dialog.

You can reach the same order detail page from the standard Shopware Orders list, or from Mirakl → Orders (in the Dashboard’s Quick Start tiles): pick a row, then View Shopware Order.

Reading messages

Section titled “Reading messages”

Each thread is shown as a card you can expand. Inside, individual messages are displayed in chronological order with:

  • the sender label — Shop, Customer or Operator,
  • the message body,
  • a timestamp,
  • any attached files.

Unread messages from the buyer or operator are flagged with a small new badge so you can spot them at a glance.

Each message has three actions:

  • Reply — opens an inline reply box at the bottom of the thread.
  • Copy text — copies the message body to the clipboard.
  • Show error details — appears only on a message you tried to send that the operator rejected. Opens a dialog with the operator’s exact error.
  • Retry — appears only on a failed outbound message. Re-queues the send.

Sending a new thread

Section titled “Sending a new thread”
  1. In the Messages card toolbar click New thread.
  2. In Recipient(s) pick Operator, Customer, or Customer and Operator.
  3. In Topic pick one of the operator’s predefined topics. One of them is Other reason, which reveals a free-text field where you can type your own subject.
  4. Type your message into the Message field.
  5. Optionally click Choose files to attach one or more files.
  6. Click Send.

The message is created with status pending and is sent in the background. Once it reaches the operator the status moves to sent / synced. If something goes wrong the row turns red and Show error details appears, carrying the operator’s response.

Replying

Section titled “Replying”

On any message click Reply. An inline reply box opens at the bottom of the thread. Type your reply, optionally attach files, and click Send.

Attachments

Section titled “Attachments”

Files you attach to an outbound message are uploaded together with the message body. Files attached to messages you received are listed inline and downloaded when you click them. If a download fails the plugin shows a notification.

Background sync

Section titled “Background sync”

The plugin polls the operator for new messages automatically. The default polling interval is 30 minutes, and only orders that closed more than 7 days ago are excluded from the poll — this saves operator quota since closed orders rarely receive new messages.

For an on-the-spot refresh of a single order, use the Sync button on the Messages card.

Initial import

Section titled “Initial import”

The first time you turn on order import for a connection (during the setup wizard), the plugin also backfills the full message history for every order in the initial window. If the run is interrupted it resumes from where it stopped, not from the start.

Configuration

Section titled “Configuration”

Open Mirakl → Settings → Sync tab → Sync Settings card:

  • Enable Message Sync — default off. Turn it on once per Shopware environment.
  • Message Sync Interval — how often to fetch new messages. Presets from 2 to 60 minutes. Default 30 minutes.
  • Sync messages for closed orders (days) — how many days after an order is closed to keep checking it for new messages. Presets 1 / 3 / 5 / 7 / 14 / 30 days. Default 7.

Tips & gotchas

Section titled “Tips & gotchas”
Section titled “Related”