דלג לתוכן
ראשי › אינטגרציות › חיבור דרך Webhook

חיבור כל מערכת דרך Webhook ואוטומציה

כל מערכת שיודעת לשלוח Webhook יכולה להפעיל אצלכם אוטומציה במיקרופיי. מצביעים על כתובת אחת, שולחים אילו נתונים שתרצו, והאוטומציה עושה את השאר: סמס, וואטסאפ, הודעה קולית, מייל, שורה בגוגל שיטס ותהליך שלם. חיבור אחד, בלי קוד.

פתיחת חשבון חינםדברו איתנו
זה מה שהופך את מיקרופיי לא רק למערכת שליחה, אלא למנוע אוטומציה שיושב בין המערכות שלכם. מערכת חיצונית שולחת Webhook עם הנתונים שלה, מיקרופיי מזהה את האוטומציה שבחרתם, וממפה את הנתונים למשתנים, והאוטומציה שבניתם רצה ומבצעת את כל הפעולות.
הכנה חד-פעמית

ארבעה שלבים במיקרופיי

  1. יוצרים טוקן API עם הרשאת "אוטומציה"

    בניהול הטוקנים, יוצרים טוקן חדש ומסמנים את הרשאת אוטומציה. אפשר גם להגביל את הטוקן לכתובות IP מסוימות.

  2. בונים אוטומציה עם טריגר "Webhook נכנס"

    בבונה האוטומציות בוחרים טריגר Webhook (נכנס), ומצהירים על שמות השדות שהמערכת החיצונית תשלח. רק שדות שהצהרתם עליהם ייכנסו לאוטומציה.

  3. מפעילים את האוטומציה

    מעבירים אותה לסטטוס פעילה. אוטומציה בטיוטה או מושהית לא תגיב ל-Webhook.

  4. מזינים את הכתובת, הטוקן ומזהה האוטומציה במערכת החיצונית

    מעתיקים מהאוטומציה את מזהה ה-autoid ואת הטוקן, ומזינים אותם בכתובת ה-Webhook.

הכתובת והפרמטרים

הכתובת שאליה מצביעים

https://www.micropay.co.il/extApi/autoWebhook.php?token=YOUR_TOKEN&autoid=AUTOMATION_ID

אפשר לשלוח בשלוש דרכים, בזיהוי אוטומטי: GET (כל הפרמטרים ב-URL), POST (בגוף הטופס), או JSON (עם Content-Type: application/json, וכל הנתונים כולל token ו-autoid בתוך גוף ה-JSON).

פרמטרחובהתיאור
tokenכןהטוקן שלכם, עם הרשאת אוטומציה
autoidכןמזהה האוטומציה (מרשימת האוטומציות)
כל שדה נוסףלאהנתונים שלכם (שם, טלפון, מספר הזמנה...), יהפכו למשתנים באוטומציה
טלפונים: מספרים ישראליים אפשר לשלוח בכל פורמט מקומי, עם או בלי אפס בהתחלה. מספרים מחו״ל יש לשלוח עם קידומת המדינה (למשל 44 לבריטניה). הנרמול חל אוטומטית על שדות ששמם מכיל phone, ומספר שלא זוהה נשמר כפי שנשלח.
דוגמאות

ככה שולחים

GET 
https://www.micropay.co.il/extApi/autoWebhook.php?token=YOUR_TOKEN&autoid=42&fullName=דנה&phone=0501234567&source=טופס-אתר
JSON (הכל בתוך הגוף) 
POST https://www.micropay.co.il/extApi/autoWebhook.php
Content-Type: application/json

{ "token": "YOUR_TOKEN", "autoid": 42, "fullName": "דנה", "phone": "0501234567", "orderId": 1001 }
cURL 
curl -X POST https://www.micropay.co.il/extApi/autoWebhook.php \
  -H "Content-Type: application/json" \
  -d '{"token":"YOUR_TOKEN","autoid":42,"fullName":"דנה","phone":"0501234567","orderId":1001}'

תשובת השרת

פורמט התשובה נקבע לפי אופן הפנייה: בשליחת GET/POST מוחזר טקסט פשוט, ובשליחת JSON מוחזר מבנה {status, message, data} אחיד, כמו בשאר הממשקים.

טקסט (GET / POST) 
# הצלחה: OK ואחריו מזהה הריצה (runId)
OK 78412

# שגיאה: ERROR ואחריו תיאור
ERROR --> Description: Automation not found
JSON 
// הצלחה
{"status":1,"message":"OK","data":{"taskId":"78412","remoteIP":"203.0.113.10"}}

// שגיאה
{"status":0,"message":"ERROR","data":{"description":"Automation not found","remoteIP":"203.0.113.10"}}
לתיעוד הטכני המלא של הממשק, כולל כל השגיאות והפרמטרים: תיעוד ה-Webhook למפתחים.
מה אפשר לעשות

אחרי שה-Webhook מפעיל את האוטומציה

כל שדה שהגיע זמין בשלבים כמשתנה, למשל {{trigger.fullName}}.

סמס

שליחת סמס ללקוח או לצוות, עם הנתונים שהגיעו ב-Webhook.

וואטסאפ

שליחת הודעת וואטסאפ בתבנית מאושרת.

הודעה קולית

חיוג אוטומטי והשמעת הודעה או תפריט.

גוגל שיטס

רישום שורה בגיליון, לתיעוד לידים והזמנות.

תנאים ולוגיקה

החלטות אם/אז לפי הנתונים שהגיעו.

המתנה ותהליך

השהיות ותהליכים רב-שלביים לאורך זמן.

חיבור מערכות נפוצות

מערכתאיך מחברים
WooCommerceפעולת Webhook על אירוע הזמנה, אל הכתובת של מיקרופיי, עם מיפוי שדות ההזמנה
טפסים (Elementor / WPForms / Fluent)פעולת Webhook אחרי שליחת טופס, עם מיפוי שדות הטופס
Zapier / Makeשלב Webhooks / HTTP, בשיטת POST לכתובת, עם השדות ב-body
CRM (Fireberry, Salesforce, Zoho, HubSpot)פעולת Webhook/HTTP באוטומציה של ה-CRM, עם מיפוי שדות
למערכות ששולחות אימייל בלבד (כמו התראות ERP) יש מסלול נפרד: אימייל לסמס בפריוריטי.
אבטחה ופתרון תקלות

הטוקן חייב הרשאת אוטומציה, אפשר להגביל אותו לרשימת כתובות IP, ואפשר להגדיר הגבלת קצב לכל אוטומציה.

הודעההמשמעות
Invalid tokenטוקן חסר או שגוי
Automation permission deniedלטוקן אין הרשאת אוטומציה
Automation not foundה-autoid שגוי, או שהאוטומציה לא פעילה / לא שייכת לטוקן
Rate limit exceededחריגה ממגבלת הקצב שהגדרתם
שאלות נפוצות

צריך ידע טכני כדי לחבר Webhook?

צריך לדעת איפה במערכת החיצונית מגדירים "Webhook" או "קריאת HTTP" בעת אירוע (רוב מערכות הטפסים, החנויות וה-CRM תומכות בזה מובנה). את הכתובת והפרמטרים פשוט מדביקים. בניית האוטומציה עצמה נעשית בבונה הוויזואלי של מיקרופיי, בלי קוד.

מה ההבדל מול שליחת סמס רגילה ב-API?

קריאה ל-API של שליחת סמס שולחת סמס אחד. חיבור לאוטומציה מפעיל תהליך שלם: הוא יכול לשלוח סמס, וואטסאפ, הודעה קולית ומייל, לרשום שורה בגוגל שיטס, לבדוק תנאים ולהמתין, הכל מאותו Webhook אחד.

באיזה פורמט צריך לשלוח את מספר הטלפון?

מספרים ישראליים בכל פורמט מקומי, עם או בלי 0 בהתחלה. מספרים מחו״ל עם קידומת המדינה (למשל 44 לבריטניה). מספר שלא זוהה נשמר כפי שנשלח.

האם החיבור מאובטח?

כן. הגישה מחייבת טוקן עם הרשאת אוטומציה, אפשר להגביל את הטוקן לרשימת כתובות IP מותרות, ואפשר להגדיר הגבלת קצב לכל אוטומציה.

לכל השאלות הנפוצות

ממשיכים לקרוא

תיעוד ה-Webhook למפתחיםאוטומציות ובוטיםממשקים למפתחיםכל האינטגרציות

מוכנים לחבר את המערכות שלכם?

פתחו חשבון חינם, בנו אוטומציה, וחברו אליה כל מערכת ששולחת Webhook, תוך דקות.

פתיחת חשבון חינםדברו איתנו