Webhook הוא הדרך של Jgive "לדבר" עם המערכות האחרות שלכם.
דמיינו את זה כ"התראה חכמה": בכל פעם שמתרחשת פעולה באתר (כמו תרומה חדשה), המערכת שלנו שולחת באופן אוטומטי את המידע למערכת שלכם בזמן אמת, בלי שתצטרכו לבדוק את הנתונים ידנית.
לפני שמתחילים
כדי להפעיל את ה-Webhook, אתם צריכים כתובת URL ייעודית שאליה יישלח המידע.
יש לכם כתובת? מעולה, המשיכו לשלבים הבאים.
אין לכם כתובת? מומלץ לפנות למתכנת/ת או לאיש האוטומציה שלכם כדי שיפיקו עבורכם את הקישור המתאים.
צעדים להגדרת ה-Webhook
היכנסו לאזור האישי של העמותה.
בתפריט הצד, לחצו על "הגדרות חשבון".
בחלק העליון של המסך, עברו ללשונית "אינטגרציות".
אתרו את השדה שנקרא Webhook URL.
הדביקו בשדה זה את הכתובת שיצרתם (או שקיבלתם מהמתכנת).
לחצו על "שמור".
🧾 תיעוד שדות אירוע Webhook של תרומה
🔹 transfer – פרטי העברת התשלום
שדה | תיאור |
id | מזהה ייחודי של ההעברה |
completed_at | תאריך ושעה שההעברה הושלמה |
refunded_at | תאריך ושעה שההעברה בוטלה (אם רלוונטי) |
israeli_id | תעודת זהות של התורם בשלב ההעברה |
israeli_id_source | מקור קבלת תעודת הזהות |
amount | סכום ההעברה |
currency | מטבע ההעברה |
🔹 donation – פרטי התרומה
שדה | תיאור |
donation_id | מזהה ייחודי של התרומה |
created_at | תאריך יצירת התרומה |
comment | הערה שנוספה על ידי התורם |
share_donor_details_with_charities | האם לשתף את פרטי התורם עם העמותות |
receive_updates_from_charities | האם לקבל עדכונים מהעמותות |
purpose_he | מטרת התרומה (עברית) |
purpose_en | מטרת התרומה (אנגלית) |
checkout_locale | שפת המסך בעת התרומה |
recurring | האם זו תרומה חוזרת |
recurring_months | מספר חודשים לתרומה החוזרת |
upcoming_transfer_count | מספר העברות שנותרו בתרומה חוזרת |
next_transfer_at | תאריך ההעברה הבאה (אם רלוונטי) |
recurring_end_date | תאריך סיום התרומה החוזרת |
recurring_payment_number | מספר תשלום נוכחי מתוך סדרת תשלומים חוזרים |
amount | סכום התרומה |
norm_amount | סכום מנורמל של התרומה |
amount_currency | מטבע התרומה |
🔹 payment_method – אמצעי תשלום
שדה | תיאור |
provider | ספק התשלום (לדוג' PayMe) |
name | סוג אמצעי התשלום (כרטיס אשראי, ביט וכו') |
card_last4 | 4 הספרות האחרונות של כרטיס האשראי |
redirected | האם המשתמש הועבר לעמוד תשלום חיצוני |
🔹 invoice – פרטי חשבונית
שדה | תיאור |
id | מזהה החשבונית |
number | מספר חשבונית |
download_url | קישור להורדת חשבונית מקור |
download_copy_url | קישור להורדת העתק חשבונית |
tax_authority_confirmation_number | מספר אישור מרשויות המס (אם קיים) |
🔹 donor – פרטי התורם
שדה | תיאור |
כתובת האימייל של התורם | |
phone_number | מספר הטלפון של התורם |
israeli_id | תעודת זהות של התורם |
first_name | שם פרטי |
last_name | שם משפחה |
full_name | שם מלא |
🔹 invoice_information – פרטי נמען החשבונית
שדה | תיאור |
recipient_name | שם המופיע על החשבונית |
company_id | ח.פ./ע.מ (אם רלוונטי) |
address_1 | שורת כתובת ראשונה |
address_2 | שורת כתובת שנייה (אם קיימת) |
🔹 donation_target – יעד התרומה (משתתף, עמותה, אירוע)
שדה | תיאור |
id | מזהה יעד התרומה |
name_he | שם היעד בעברית |
name_en | שם היעד באנגלית |
to_charity_page | האם התרומה לעמותה |
to_main_event | האם התרומה לאירוע ראשי |
to_team | האם התרומה לקבוצה |
team_id | מזהה הקבוצה (אם רלוונטי) |
main_event_id | מזהה האירוע הראשי |
🔹 participant – פרטי שגריר
שדה | תיאור |
id | מזהה המשתתף |
name_he | שם בעברית |
name_en | שם באנגלית |
אימייל המשתתף | |
phone_number | טלפון של המשתתף |
send_email_notification | שליחת הודעת אימייל |
send_whatsapp_notification | שליחת הודעת וואטסאפ |
team_id | מזהה קבוצה (אם יש) |
main_event_id | מזהה האירוע הראשי |