Webhook Configuration

Connecting Shaloz with Your WooCommerce Store

Webhooks automatically keep your WooCommerce store and Shaloz in sync. When a delivery status changes, both systems update automatically - no manual work needed!

__________________________________________________

Why This Matters

Without This Setup:

• You manually check Shaloz to see delivery status
• Your WooCommerce orders don't update automatically
• Customers don't see tracking updates
• More work for you!

With This Setup:

• Delivery completes → WooCommerce order automatically marks "Completed"
• Driver assigned → Customer sees update in their order
• Everything syncs automatically
• You save time!

__________________________________________________

What You Need to Do

Simple 4-Step Setup:

1. Copy a code from Shaloz Portal
2. Paste it in WooCommerce
3. Copy a link from WooCommerce
4. Paste it in Shaloz Portal

Time Required: 2-5 minutes

__________________________________________________

Step 1: Get Your Webhook Secret from Shaloz

The webhook secret is gotten from the Portal in Settings. Use this if you want Shaloz to send events to your store like order canceled, package arrived, or order sent out for delivery.

How to Find It:

1. Log into portal.shaloz.com
2. Click "Settings" in the sidebar
3. Scroll down to find "Webhook Secret"
4. Click the copy button next to the long code
5. Keep this handy - you'll paste it in WooCommerce next

It looks like: whsec_abc123xyz... (a long random string)

__________________________________________________

Step 2: Put the Secret Code in WooCommerce

Where to Put It:

1. In WordPress, go to WooCommerce → Settings
2. Click "Shipping" tab
3. Select your shipping zone (like "United States")
4. Click "Shaloz Shipping"
5. Scroll to "Webhook Secret" field
6. Paste the code you copied from Shaloz
7. Click "Save changes"

Test It:

• Click the "Test Webhook" button
• Should say " Connection successful!"
• If you see an error, double-check you pasted the whole code

__________________________________________________

Step 3: Copy Your Store's Webhook Link

Still in the same WooCommerce settings page:

Find the Link:

• Look for "Your Webhook URL"
• It looks like: https://yourstore.com/wp-json/shaloz/v1/webhook
• Click copy or select it all and copy

This is the address where Shaloz will send updates about your deliveries.

__________________________________________________

Step 4: Give Shaloz Your Store's Link

Back in Shaloz Portal:

1. Go to Settings page
2. Find "Your WooCommerce Webhook URL"
3. Paste the link you copied from WooCommerce
4. Click "Save"

Done! Now Shaloz and WooCommerce can talk to each other.

__________________________________________________

How to Test It's Working

Quick Test:

1. Create a test order in your WooCommerce store (use Sandbox mode!)
2. Fulfill the order in Shaloz Portal
3. Go back to WooCommerce and open the order
4. Look for notes that say things like:
5. "Shaloz: Driver John assigned to delivery"
6. "Shaloz: Package picked up"
7. "Shaloz: Delivery completed"

If you see these notes, it's working perfectly!

__________________________________________________

What Updates You'll See

In WooCommerce Orders:

When things happen in Shaloz, you'll automatically see:

• "Driver assigned" - Shows driver name
• "Package picked up" - Driver collected from your store
• "Delivery completed" - Package delivered to customer
• Order status changes to "Completed" automatically
• Tracking link for customer

Your Customers See:

• Tracking link in their order confirmation
• Status updates as delivery progresses
• Delivery completion notification

__________________________________________________

Common Problems & Easy Fixes

Problem: "Test Webhook" Button Shows Error

Most Common Cause: Secret code doesn't match

Fix:

1. Go back to Shaloz Portal Settings
2. Copy the webhook secret again (make sure you copy ALL of it)
3. Paste it in WooCommerce again
4. Save and test again

Problem: Delivery Completed but WooCommerce Order Still Says "Processing"

Possible Causes:

• Webhook not set up yet
• Link you pasted in Shaloz was incorrect
• Your web hosting is blocking the updates

Fix:

1. Check the link in Shaloz Portal matches exactly what WooCommerce shows
2. Make sure it starts with https:// (secure connection required)
3. Contact your web host and ask: "Can you make sure webhooks from Shaloz aren't blocked?"
4. Need help? Contact us at help.shaloz.com

Problem: Some Orders Update, Some Don't

Fix:

• This is usually temporary
• Shaloz automatically retries if an update fails
• Check your internet connection
• If it keeps happening, contact help.shaloz.com

__________________________________________________

Important Notes

Keep Your Secret Code Safe:

• Don't share it publicly
• It's like a password between Shaloz and your store
• If you think it's been exposed, contact help.shaloz.com to get a new one

HTTPS Required:

• Your store must have SSL (the padlock in browser)
• Most modern stores already have this
• If you see "http://" instead of "https://", contact your web host

You Only Set This Up Once:

• Once configured, it works automatically forever
• No need to do anything else
• Unless you change your website URL or reinstall WooCommerce

__________________________________________________

Need Help?

Setup Not Working?

• Double-check you copied the entire secret code
• Make sure the link starts with https://
• Try copying and pasting again (sometimes spaces sneak in)
• Contact help.shaloz.com with your Business ID

Questions?

• Visit help.shaloz.com
• Email: help@shaloz.com
• We're here to help!