טריגר אוטומציה דרך Webhook

Q: מאיפה משיגים את מזהה האוטומציה (autoid)?

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

Q: אילו שדות נכנסים לאוטומציה?

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

Q: אילו משתנים מיקרופיי מוסיפה אוטומטית לכל ריצת Webhook?

חמישה: webhookIp כתובת השולח, datetime תאריך ושעה, dayOfWeek יום בשבוע מ-1 לראשון עד 7 לשבת, dayOfMonth יום בחודש, ו-time שעה בפורמט HHMM רצוף. אין צורך להצהיר עליהם או לשלוח אותם. הם נכתבים אחרי השדות שלכם, ולכן שדה שהוגדר באותו שם יידרס.

עודכן לאחרונה: 4 באוקטובר 2026 · נתמך ב-HTTP GET, POST ו-JSON

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

כתובת הממשק

/extApi/autoWebhook.php

שיטות נתמכות

HTTP GET · POST · JSON

אימות

טוקן עם הרשאת אוטומציה

תשובה

OK <runId>

מה זה טריגר אוטומציה?

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

תהליך השימוש

הכנה חד-פעמית במערכת, ואז אפשר להפעיל את האוטומציה מכל מערכת:

1 יוצרים טוקן עם הרשאת אוטומציה (ניתן להגביל אותו לרשימת כתובות IP).

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

3 מפעילים את האוטומציה (אוטומציה בטיוטה או מושהית לא תגיב).

4 מזינים במערכת החיצונית את הכתובת, ה-token ואת מזהה האוטומציה autoid.

כתובת הממשק ושיטת השליחה

הכתובת לפנייה לממשק היא:

Endpoint

https://www.micropay.co.il/extApi/autoWebhook.php

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

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

אימות וטוקן

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

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

פרמטרים

פרמטר	חובה	תיאור
`token`	חובה	טוקן הזדהות שיצרת במערכת, עם הרשאת אוטומציה.
`autoid`	חובה	מזהה האוטומציה שברצונך להפעיל (מספר), כפי שמופיע ברשימת האוטומציות. האוטומציה חייבת להיות מסוג טריגר Webhook נכנס ובמצב פעיל.
השדות שלך	רשות	כל שדה נוסף שתשלח (למשל `fullName`, `phone`, `orderId`) יהפוך למשתנה זמין בשלבי האוטומציה בפורמט `{{trigger.fieldName}}`. רק שדות שהוגדרו בטריגר של האוטומציה נשמרים, השאר נזרקים. כל ערך מוגבל ל-500 תווים, ושדה ששמו מכיל `phone` מנורמל אוטומטית (מספר ישראלי בכל פורמט מקומי; מספר מחו״ל עם קידומת המדינה).

משתנים שנוספים אוטומטית

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

משתנה	תוכן	דוגמה
`{{trigger.webhookIp}}`	כתובת ה-IP שממנה נשלחה הבקשה	203.0.113.10
`{{trigger.datetime}}`	תאריך ושעה של קבלת הבקשה	04/10/2026 14:35:02
`{{trigger.dayOfWeek}}`	יום בשבוע, 1 עד 7, כאשר ראשון הוא 1 ושבת היא 7	1
`{{trigger.dayOfMonth}}`	יום בחודש, בלי אפס מוביל	4
`{{trigger.time}}`	שעה בפורמט HHMM רצוף, שימושי להשוואות תנאי שעה	1435

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

דוגמאות קוד

הדוגמאות מוצגות ב-cURL. שים לב שבשליחת JSON גם ה-token וה-autoid נמצאים בתוך גוף הבקשה.

HTTP GET

curl "https://www.micropay.co.il/extApi/autoWebhook.php?token=XXXXX&autoid=42&fullName=%D7%93%D7%A0%D7%94&phone=0501234567"

HTTP POST

curl -X POST https://www.micropay.co.il/extApi/autoWebhook.php \
  --data-urlencode "token=XXXXX" \
  --data-urlencode "autoid=42" \
  --data-urlencode "fullName=דנה" \
  --data-urlencode "phone=0501234567"

JSON (הכל בתוך הגוף)

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

תשובת השרת

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

Plain text (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"}}

שגיאות נפוצות

הודעה	משמעות
Missing token parameter	לא נשלח פרמטר `token`.
Invalid token	הטוקן שגוי או לא קיים.
Automation permission denied	לטוקן אין הרשאת אוטומציה.
Automation service not active	שירות האוטומציות אינו פעיל בחשבון. זו הרשאה ברמת החשבון, נפרדת מהרשאת הטוקן: גם טוקן עם הרשאת אוטומציה יידחה אם השירות כבוי בחשבון. לפנות לתמיכה.
Sub user not active	הטוקן שייך לתת מנהל שהושבת. השבתת תת מנהל אינה מוחקת את הטוקן שלו, ולכן הבקשה נדחית כאן.
IP not allowed	כתובת ה-IP של השולח אינה ברשימת ההיתר של הטוקן.
Missing or invalid autoId parameter	לא נשלח `autoid` תקין (מספר).
Automation not found	ה-`autoid` לא נמצא, או שהאוטומציה אינה פעילה או אינה שייכת לטוקן. אצל תת מנהל מוחזרת אותה הודעה גם כשהאוטומציה קיימת אך לא הוקצתה לו.
Automation has no field definitions	לטריגר ה-Webhook של האוטומציה לא הוגדרו שמות שדות. יש לערוך את האוטומציה, להצהיר על השדות שיישלחו, ולשמור.
Rate limit exceeded	חריגה ממגבלת הקצב שהוגדרה לאוטומציה. המגבלה נספרת לפי כתובת ה-IP השולחת, לא לכל האוטומציה יחד.
No IP	לא הצלחנו לזהות את כתובת ה-IP של השולח. תקלה נדירה ברמת התעבורה, לא בבקשה עצמה.
system 1, please call the support	הריצה לא נוצרה בשל תקלה בצד מיקרופיי. הבקשה הייתה תקינה; יש לפנות לתמיכה.

שגיאת No IP מוחזרת תמיד כטקסט פשוט, גם בפנייה ב-JSON, כי זיהוי ה-IP קודם לזיהוי סוג הבקשה. בכל שאר השגיאות פורמט התשובה תואם לפורמט הפנייה.

אבטחה

שמרו על סודיות הטוקן: הממשק מיועד לקריאות שרת-לשרת. אין להטמיע את הטוקן בטופס HTML או בקוד בצד הלקוח, שם הוא חשוף לכל מבקר. שליחת טופס מאתר תתבצע דרך השרת שלכם (או תוסף הטפסים), שיקרא לממשק וישמור את הטוקן בסוד.
הטוקן חייב הרשאת אוטומציה, אחרת הבקשה נדחית.
ניתן להגביל את הטוקן לרשימת כתובות IP מותרות.
ניתן להגדיר הגבלת קצב (rate limit) לכל אוטומציה, לפי דקה, שעה או יום.

שאלות נפוצות

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

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

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

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

מאיפה משיגים את מזהה האוטומציה (autoid)?

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

אילו שדות נכנסים לאוטומציה?

רק שדות שהוגדרו בטריגר של האוטומציה. כל שדה מוגדר זמין בשלבים כמשתנה בפורמט {{trigger.fieldName}}. שדות שלא הוגדרו נזרקים, וכל ערך מוגבל ל-500 תווים.

אילו משתנים מיקרופיי מוסיפה אוטומטית לכל ריצה?

חמישה: webhookIp כתובת השולח, datetime תאריך ושעה, dayOfWeek יום בשבוע מ-1 לראשון עד 7 לשבת, dayOfMonth יום בחודש, ו-time שעה בפורמט HHMM רצוף. אין צורך להצהיר עליהם או לשלוח אותם. שימו לב שהם נכתבים אחרי השדות שלכם, ולכן שדה שהוגדר באותו שם יידרס.

ממשקים קשורים

רוצה לחבר את המערכות שלך למיקרופיי?

פתח חשבון, בנה אוטומציה, וחבר אליה כל מערכת ששולחת בקשת HTTP

פתח חשבון חינם