Scalev Integration

Connect your Scalev store to Konektor. Each Scalev order is saved in Konektor and linked to the lead with the same WhatsApp number.

After you connect, Konektor can:

• Create a new lead for a buyer who is not in your list yet.
• Change the lead status: Invoice Sent when the order is created, Purchase when the order is sold.
• Run order flows: confirmation messages, payment reminders, checkout recovery, and thank-you messages from your WhatsApp number.
• Send one Purchase event for each sold order to your ad platforms (optional, off by default).

Who this is for

Use this integration if you sell on Scalev and close sales on WhatsApp. You do not change your Scalev order pages.

Prerequisites

1. A Scalev account on the Basic plan or higher. Scalev webhooks do not work on a lower plan. Scalev shows a notice about the plan on its Webhooks page.
2. Owner access to the Konektor workspace.
3. For automatic messages: at least one WhatsApp number connected to the Konektor Inbox.

Connect Scalev

The setup has three steps. Open two tabs: Konektor and Scalev.

Step 1: Create the address in Konektor

1. Open Settings > Store & orders.
2. Click Connect a store, then choose Scalev.
3. Enter a Store name, then click Create address.
4. Click Copy to copy the webhook address. You can see it again with Show address on the store card.

Step 2: Add the address in Scalev

1. In Scalev, open Settings > Developers > Webhooks.
2. Click Add Endpoint, then paste the address from Konektor in Webhook Endpoint URL.
3. Tick the events that you want to send to Konektor:
   • Order Created, Order Updated, Order Status Changed, and Order Payment Status Changed.
   • Order E-Payment Created.
   • Payment Received and Payment Failed.
   • Checkout Intent Abandoned and Checkout Intent Completed (for checkout recovery).
4. Switch the endpoint to Active. A new endpoint is Inactive, and Scalev sends nothing until you switch it on.
5. Click Save Endpoint. When you save an active endpoint, Scalev sends one test message to the address.
6. Go back to Konektor, then click I pasted it. The page waits up to 5 minutes for the test message, then shows "The test from Scalev arrived."

Konektor does not use Shipment Status Updated, Subscription, and WhatsApp Message. Do not tick them. Shipped, completed, and returned status arrive through Order Status Changed.

Scalev allows up to 3 webhook endpoints for each business. Your other tools keep their endpoints. Add the Konektor address as a new endpoint.

Step 3: Paste the Signing Secret

1. In Scalev, copy the Signing Secret of your business. It shows on the same Webhooks page. One Signing Secret serves your whole business.
2. In Konektor, paste it in the Signing Secret field, then click Save.
3. Click Done. The store card shows Waiting for orders until the first order arrives. After that, it shows Active and the time of the last order.

Scalev API key (optional)

You can paste a Scalev API key in the store settings. Konektor uses it only to read one order again from Scalev, for example to get a missing payment link, total, or phone number.

• Create the key in Scalev, under Settings > Developers > API Keys. Use a secret key, or a restricted key that can read and list orders.
• Without an API key, a message with {{payment_link}} is skipped when the order has no payment link.
• Click Check to test the API key. The result is valid, not valid, or Scalev is not reachable.
• Konektor shows only the last 4 characters of a saved key.

The three store settings

Open the store card in Store & orders, then click Settings.

When an order counts as sold

• Non-COD order: at the first confirmed payment.
• COD order: when Scalev marks the order completed.

The Purchase value equals the total that the buyer pays. Konektor sends one Purchase for one order. A repeat order from the same buyer sends a new Purchase. A checkout record never sends a Purchase.

Konektor sends a Purchase only for an order with a known total. Some Scalev events hold no total. In that case, Konektor waits up to 1 hour for the next event of that order. If you saved a Scalev API key, Konektor reads the total from Scalev. If the total stays unknown, Konektor skips the Purchase.

The Purchase uses your event mapping for the Closed won status in Conversion Settings. The Leads page calls the same status Purchase. Konektor sends it to every active ad platform.

Check that it works

1. Create a test order in Scalev with your own WhatsApp number.
2. In Store & orders, click Recent events on the store card. The list shows the event type, the time, and the result. It shows no buyer data.
3. Open Leads and click the lead with that number. The order shows in the Store orders section. The flow results show under the order.

Store states that you can see:

Results that you can see in the event list:

Common problems

The data from Scalev was rejected

The store card shows Needs a check and the message "The data from Scalev was rejected. Copy the Signing Secret from Scalev again." The Signing Secret in Konektor is different from the one in Scalev. Copy the Signing Secret again from Scalev, paste it in the store settings, then click Save.

Scalev does not save the endpoint

Scalev sends a test when you save an active endpoint. If Konektor does not answer, Scalev reports that the test failed and does not save the endpoint.

1. Make sure the store in Konektor is not Paused. Click Resume if needed.
2. Make sure you pasted the newest address. An old address stops working after you click Create new address.
3. Save the endpoint again.

The test does not arrive

The page in Konektor shows "The test has not arrived" after 5 minutes.

1. Make sure your Scalev plan is Basic or higher.
2. Make sure the endpoint is Active and that you clicked Save Endpoint.
3. Compare the address in Scalev with the address in Konektor.
4. In Konektor, click Check again.

No orders arrive

1. Make sure the store is Active or Waiting for orders, not Paused. Click Resume if needed.
2. In Scalev, make sure the endpoint is Active, its address is the same as the Konektor address, and the order events are ticked.
3. If you created a new address, change the address of the endpoint in Scalev.
4. Make sure you saved the Signing Secret. Without it, Konektor accepts only the test message.
5. Konektor skips events that it does not use, such as WhatsApp messages and subscriptions. They do not show in Recent events.

Orders arrive, but there is no lead

• Check the Create leads from orders setting. If it is off, an order from a new number does not create a lead.
• The daily lead limit of the workspace can be full. Konektor still saves the order, but order flows do not run for an order without a lead.
• Konektor cannot match an order without a valid WhatsApp number to a lead.

Messages are not sent

See Order flows. An official number needs a template for messages outside 24 hours. The Store orders section of the lead shows why a step did not send.

Spam orders

Konektor ignores orders that Scalev marks as spam.

Pause and delete a store

• Pause: click Pause on the store card. Konektor stops accepting orders from Scalev for that store. Flows that run for that store stop too. Your settings and old data stay. Click Resume to continue.
• Delete: click Delete, then Delete store. Konektor stops accepting orders from that store, and flows that run for that store stop. Also remove the endpoint in Scalev.

One workspace can have up to 5 stores from all platforms.

Next steps

• Order flows: messages, reminders, and automatic stops
• Manage leads
• Conversion Settings
• Partner Integrations