Webhook Setup for Order Tracking

Automatic Order Updates - Webhook Setup

Keep WooCommerce and Shaloz perfectly synced with webhooks!

__________________________________________________

Why Set Up Webhooks?

Without Webhooks:

• Delivery completes → WooCommerce still shows "Processing"
• You manually mark orders complete
• Customers don't get automatic updates
• More work for you!

With Webhooks:

• Delivery completes → WooCommerce automatically updates to "Completed"
• Order notes added for each status change
• Customers get automatic tracking updates
• Everything syncs automatically!

Highly Recommended!

__________________________________________________

What You'll Do

Simple Copy/Paste Setup:

1. Copy secret code from Shaloz Portal
2. Paste in WooCommerce
3. Copy link from WooCommerce
4. Paste in Shaloz Portal
5. Test it works
6. Done!

Time: 5 minutes

__________________________________________________

Step 1: Get Webhook Secret from Shaloz

In Shaloz Portal:

1. Log into portal.shaloz.com
2. Click "Settings"
3. Scroll to "Webhook Configuration"
4. Find "Webhook Secret"
5. Click copy icon
6. Keep this handy - you'll paste in WooCommerce

__________________________________________________

Step 2: Enter Secret in WooCommerce

In WordPress:

1. WooCommerce → Settings → Shipping
2. Click your zone → Click "Shaloz Shipping"
3. Scroll to "Webhook Secret" field
4. Paste the secret you copied
5. Don't save yet - continue to next step

__________________________________________________

Step 3: Copy WooCommerce Webhook URL

Still in WooCommerce Settings:

1. Find "Your Webhook URL" (shown below where you pasted secret)
2. Should look like: https://yoursite.com/wp-json/shaloz/v1/webhook
3. Click copy icon or select all and copy
4. Keep this - you'll paste in Shaloz Portal

__________________________________________________

Step 4: Test Webhook in WooCommerce

Before Saving:

1. Click "Test Webhook" button
2. Plugin tests connection
3. Should show: "Webhook test successful"
4. If error, double-check you pasted entire secret

Now Save:

• Click "Save changes" at bottom
• Settings saved!

__________________________________________________

Step 5: Add Webhook URL to Shaloz Portal

Back in Shaloz Portal:

1. Still in Settings → Webhook Configuration
2. Find "Your WooCommerce Webhook URL" field
3. Paste the URL you copied from WooCommerce
4. Click "Save"
5. Portal validates URL
6. Success message appears

Done! Webhooks are configured.

__________________________________________________

Testing Webhooks

Place a Test Order:

1. Create test order in WooCommerce
2. Fulfill it in Shaloz Portal
3. Watch for order notes in WooCommerce

Expected Order Notes:

Shaloz: Order sent for delivery
Shaloz: Driver John Smith assigned
Shaloz: Package picked up
Shaloz: Delivery completed
Order status changed to Completed

All These Auto-Added by Webhooks!

__________________________________________________

What Webhooks Sync

Shaloz → WooCommerce Updates:

Driver Assignment:

• "Driver [Name] assigned to delivery"
• Shows driver name and vehicle

Pickup:

• "Package picked up from [Location]"
• Confirms driver has package

Delivery Status:

• "Delivery completed"
• "Delivery cancelled"
• Includes timestamp

Order Status Changes:

• Processing → Completed (when delivered)
• Processing → Cancelled (if delivery cancelled)

Tracking Info:

• Adds tracking URL to order
• Customer can click to track

__________________________________________________

Troubleshooting Webhooks

Problem: No Order Notes Appearing

Check:

1. Webhook secret matches in both systems
2. Webhook URL correct in Shaloz Portal
3. URL starts with https:// (not http://)
4. Your website isn't blocking incoming requests
5. Test webhook button shows success

Problem: "Invalid Webhook Signature"

Fix:

• Webhook secret doesn't match
• Re-copy secret from Portal
• Paste in WooCommerce again
• Save and test

Problem: Webhooks Sometimes Work, Sometimes Don't

Possible Causes:

• Server busy/timing out
• Network issues
• Firewall intermittently blocking

Fixes:

• Shaloz retries automatically
• Check with web host about webhook reliability
• May need to whitelist Shaloz IPs

Problem: Order Status Not Changing to Completed

Check:

• Delivery actually completed in Shaloz
• Webhook configured correctly
• WooCommerce order still exists (not deleted)
• Try manual refresh: Open order → "Refresh Status" button

__________________________________________________

Advanced: Webhook Logs

View Webhook Activity:

1. Enable debug mode in plugin settings
2. WooCommerce → Status → Logs
3. Look for webhook-related logs
4. See all incoming webhook requests
5. Identify errors

Use Logs For:

• Debugging webhook issues
• Verifying webhooks received
• Checking what's being sent

__________________________________________________

Disabling Webhooks

If You Need To:

1. Clear webhook secret from WooCommerce
2. Or clear webhook URL from Shaloz Portal
3. Save changes
4. Webhooks disabled

Why Disable:

• Troubleshooting issues
• Testing without auto-updates
• Temporary fix for problems

Re-Enable: Follow setup steps again

__________________________________________________

Need Help?

Webhooks Not Working?

• Verify all 5 setup steps completed
• Test connection in WooCommerce
• Check logs for errors
• Contact help.shaloz.com

Technical Questions?

• Ask your web host about webhook support
• help.shaloz.com for Shaloz-specific issues