Salla Integration

Bridge your Salla e-commerce store with SkyLight Chat to automate customer communication, recover abandoned carts, and provide real-time support via WhatsApp and web chat.

Purpose

The Salla integration syncs your store data into SkyLight Chat so you can:

• Sync products — store catalog lands in a product catalog knowledge base with prices, stock, images, and purchase_url for each item (also exposed on the Knowledge Base API).
• Sync orders — import order details, status, and customer info into SkyLight Chat.
• Push status changes to Salla — confirm, cancel, or advance fulfillment from SkyLight Chat (or the Orders API); changes are sent to Salla via API, then saved locally.
• Recover abandoned carts — send WhatsApp reminders with cart contents and checkout links.
• Embed a storefront widget — add live chat to your Salla store.
• Automate notifications — order confirmations, shipping updates, and delivery alerts.
• Enrich contacts — automatically create or update contacts from Salla customers.

Who can access

Prerequisites

1. Active Salla store — you must have a Salla merchant account.
2. SkyLight Chat app installed on Salla — install from the Salla App Store.
3. WhatsApp channel connected — required for cart recovery and order notifications.
4. WhatsApp connected — for abandoned cart recovery messages.

Full walkthrough

Generating the connection code

1. In SkyLight Chat, go to Integrations → Salla.
2. Click Generate Connection Code.
3. Copy the code (e.g., SC-A1B2C3D4).

Connecting in Salla

1. Log in to your Salla Dashboard.
2. Go to Settings → Apps & Integrations.
3. Find SkyLight Chat and click Install (or open if already installed).
4. Paste the connection code into the designated field.
5. Click Connect.
6. Return to SkyLight Chat; the status should now show Connected.

Configuring sync settings

1. Open the Sync Settings tab.
2. Toggle:
   • Orders Sync — imports new and updated orders.
   • Contacts Sync — creates contacts from Salla customers.
   • Abandoned Cart Recovery — enables cart reminders.
3. Select Sync Frequency:
   • Real-time (webhook-driven)
   • Every 5 minutes
   • Every 15 minutes
   • Hourly
4. Click Save.

Setting up abandoned cart recovery

1. Go to the Abandoned Cart tab.
2. Write the recovery message using cart variables (see glossary below).
3. Set the Delay — minutes to wait after a cart is abandoned before sending (e.g., 30, 60, 120).
4. Map variables using the available placeholders:

5. Preview the message to verify variable placement.
6. Click Save & Activate.

Enabling the storefront widget

1. Open the Widget tab.
2. Toggle Enable Widget to ON.
3. Customize:
   • Position — bottom-left or bottom-right.
   • Primary Color — match your brand (hex picker).
   • Welcome Message — greeting displayed when widget opens.
4. Copy the Embed Code snippet.
5. In your Salla theme, paste the snippet before the closing </body> tag.
6. Save and publish your theme.

The widget now appears on your storefront, letting visitors chat via WhatsApp or web chat.

Viewing synced orders

Synced orders appear under Orders in SkyLight Chat. Each order shows:

• Customer name and contact link
• Order number and status
• Line items with quantities and prices
• Shipping address
• Created and updated timestamps
• Source badge Salla (created_by = salla)

Confirming or cancelling Salla orders from SkyLight

Status changes for Salla-sourced orders are two-way:

1. Open the order in SkyLight Chat (or call PUT /api/v1/orders/{id} / POST /api/v1/orders/{id}/cancel).
2. Confirm, cancel, or move to the next allowed status.
3. SkyLight pushes the matching status to Salla (POST …/orders/{salla_id}/status), then updates the local order.
4. Later Salla webhooks / sync keep both sides aligned.

Requires an active Salla connection with orders.read_write. Item edits on Salla orders remain Salla-only (not pushed from SkyLight).

Manual sync

Click Sync Now in the Sync Settings tab to trigger an immediate pull of orders and contacts.

Disconnecting Salla

1. Go to Integrations → Salla.
2. Click Disconnect.
3. Confirm the dialog.

Disconnecting stops all syncs and disables the widget. Historical data remains in SkyLight Chat.

Field glossary

Statuses and badges

Order sync statuses

Nested screens

Abandoned Cart tab

Widget tab

Activity log

Connections to other areas

Limits and plan behavior

Order and contact sync counts against your plan's respective limits.

Troubleshooting

Related articles

• Orders — manage and fulfill orders
• WhatsApp Contacts — view synced Salla customers
• Web Chat — configure the storefront widget