שליחת אירועי ⁦Zinn® Ads⁩ ל-Zapier, ל-Make ולמערכות שלכם

⁦Zinn® Ads⁩ יכול לשלוח את האירועים שלו לנקודות הקצה של ה-webhook שלכם, כדי ש-Zapier, Make או המערכת שלכם יוכלו לפעול לפיהם ברגע שהם מתרחשים. האירועים הם ads.finding.opened, ads.change.applied, ads.alert.started.

הגדרת התכונה

1. בלוח הבקרה פתחו את ערוצי התראות והוסיפו נקודת קצה של webhook. עליה להיות כתובת HTTPS. אנו יוצרים עבורה מפתח חתימה סודי ומציגים אותו בפניכם פעם אחת.
2. אמתו את נקודת הקצה: אנו שולחים אליה בקשת בדיקה אחת, ועליה להשיב עם סטטוס 2xx.
3. פתחו את ⁦Zinn® Ads⁩, אתרו את Webhooks עבור Zapier, Make והמערכות שלכם, סמנו את האירועים שנקודת קצה זו צריכה לקבל ובחרו ב-שמור אירועים. האפשרות שלח בדיקה שולחת דוגמה אחת.

מה מתקבל

כל מסירה היא מסוג JSON POST. כותרות ה-HTTP מסוג X-Zinn-Event (שם האירוע) ו-X-Zinn-Delivery (מזהה יחיד לכל מסירה: התעלמו ממסירה שכבר טיפלתם בה) מגיעות יחד איתה, וכך גם X-Zinn-Signature: sha256=<hex>, חתימת HMAC-SHA256 של <X-Zinn-Timestamp>.<raw body> שנוצרה באמצעות המפתח הסודי של נקודת הקצה שלכם. בדקו את החתימה, ודחו חותמת זמן ישנה, לפני שאתם נותנים אמון בגוף הבקשה. המבנה של כל אירוע מפורסם במפרט ה-OpenAPI שלנו תחת webhooks.

כאשר נקודת הקצה שלכם אינה זמינה

מסירה שנכשלה מנוסה שוב עוד 5 פעמים, לאחר 1, 5, 25, 125, 625 דקות, וכל ניסיון מופיע ביומן המסירות של נקודת הקצה. שום דבר אינו נשלח לנקודת קצה שאינה מאומתת, וקבוצת אירועים ריקה מכבה את ⁦Zinn® Ads⁩ עבור אותה נקודת קצה.

מדריך שלב אחר שלב

המדריך שליטה ב-⁦Zinn® Ads⁩ מ-MCP ומעוזרי AI באתר zinnads.com מלווה את התהליך עם צילומי מסך מהממשק האמיתי. לכל מדריכי ⁦Zinn® Ads⁩: zinnads.com/kb.