Webhooks - חיבור לשירותים חיצוניים

Webhooks מאפשרים לחבר את QuickShop לשירותים חיצוניים ולהפעיל אוטומציות כשאירועים קורים בחנות.

מה זה Webhook?

Webhook הוא "התראה" שנשלחת לכתובת URL כשאירוע מסוים קורה. למשל:

יצירת Webhook

- שם - לזיהוי (למשל "גוגל שיטס - הזמנות")

- URL - הכתובת לשליחת הנתונים

- אירועים - אילו אירועים לעקוב אחריהם

- סוד (Secret) - לאימות הבקשה (אופציונלי)

אירועים זמינים

| אירוע | מתי נשלח |

|-------|----------|

| order.created | הזמנה חדשה נוצרה |

| order.paid | הזמנה שולמה |

| order.fulfilled | הזמנה נשלחה |

| order.cancelled | הזמנה בוטלה |

| customer.created | לקוח חדש נרשם |

| customer.updated | פרטי לקוח עודכנו |

| product.low_stock | מוצר הגיע למלאי נמוך |

| product.out_of_stock | מוצר נגמר מהמלאי |

מבנה הנתונים

כל Webhook נשלח בפורמט JSON:

```json

{

"event": "order.created",

"timestamp": "2024-01-15T10:30:00Z",

"data": {

"order_id": "abc123",

"order_number": "1001",

"total": 299.00,

"customer": {

"email": "customer@example.com",

"name": "ישראל ישראלי"

},

"items": [...]

}

}

```

אימות (חתימה)

אם הגדרתם Secret, כל בקשה תכלול חתימת HMAC-SHA256 בהדר:

```

X-QuickShop-Signature: sha256=abc123...

```

השתמשו בזה לאימות שהבקשה באמת הגיעה מ-QuickShop.

לוג משלוחים

בדף ה-Webhook תראו:

שילובים נפוצים

| שירות | שימוש | דוגמה |

|--------|-------|--------|

| Google Sheets | רישום הזמנות | דרך Zapier או Make |

| Mailchimp | הוספה לרשימה | לקוחות חדשים |

| Slack | התראות | הזמנה חדשה לערוץ |

| Priority/SAP | ERP | סנכרון הזמנות |

| SMS Gateway | התראות SMS | משלוח נשלח |

שילוב עם Zapier

טיפים