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

טיפים