> ## Documentation Index
> Fetch the complete documentation index at: https://sorank.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks

> Doc Sorank - Webhooks

אין אינטגרציה מובנית של Sorank ל-CMS שלך? מחבר ה-**Webhook** מאפשר לך לדחוף את המאמרים שנוצרו לכל **URL**, Zapier, Make, n8n או נקודת קצה מותאמת אישית באתר מקודד משלך, כדי שתוכל לפרסם את התוכן שלך בכל מקום שתצטרך.

## איך זה עובד

כשאתה מפרסם מאמר ב-Sorank, אנו שולחים בקשת **POST** עם מטען JSON מובנה ל-URL שהגדרת. נקודת הקצה או כלי האוטומציה שלך יכולים לעבד את המטען וליצור את הפוסט בבלוג שלך, באתר מותאם אישית או בכל כלי אחר שמקבל בקשות HTTP נכנסות.

## ⚠️ חשוב: ה-webhook רק שולח את הנתונים, אתה מפרסם אותם

זה הדבר הכי חשוב להבין על מחבר ה-Webhook. מהצד שלנו, Sorank אורזת **את כל מה שצריך בתוך ה-JSON** (כותרת, slug, גוף HTML מלא, מטא-תיאור, תמונות, שפה ועוד) ושולחת ל-URL שלך. ברגע שה-JSON נשלח בהצלחה, Sorank מסמנת את המסירה כ-**success**.

**סטטוס "success" זה מאשר רק דבר אחד: הנתונים יצאו מ-Sorank ונקודת הקצה שלך קיבלה אותם.** אין לנו דרך לדעת מה קורה אחר כך בצד שלך. איננו יכולים לזהות אם הקוד שלך אכן קרא את ה-JSON, מיפה את השדות נכון, או פרסם את המאמר באתר שלך.

במילים אחרות, ה-webhook הוא **רק מנגנון מסירה של הנתונים**. קבלתם, ניתוחם ופרסומם ל-CMS שלך היא כולה באחריותך. אם המאמר לא מופיע בבלוג שלך למרות ש-Sorank מציגה "success", הבעיה כמעט תמיד היא באופן שבו האינטגרציה שלך תופסת ומטפלת במטען, ולא במסירה עצמה.

## שלב 1: פתיחת אינטגרציית ה-Webhook

1. לחץ על **תמונת הפרופיל** בפינה הימנית העליונה ובחר **Settings**.
2. פתח את לשונית **Integrations**.
3. גלול לכרטיס **Webhook** ולחץ על **Connect your website**.

<img src="https://mintcdn.com/sorank/rRyGQ-GqyuxjdZ-r/images/documentation/ef2e4f5f7ee941d0a448.jpg?fit=max&auto=format&n=rRyGQ-GqyuxjdZ-r&q=85&s=9f1c097972b3eab25d3a2cf7d69f595b" alt="__wf_reserved_inherit" width="3840" height="1930" data-path="images/documentation/ef2e4f5f7ee941d0a448.jpg" />

## שלב 2: הגדרת נקודת הקצה שלך

1. הדבק את ה-URL של היעד לתוך שדה **Webhook URL** (למשל, catch hook של Zapier, webhook של Make, או נקודת קצה של שרת משלך).
2. לחלופין, הוסף **Secret token** אם נקודת הקצה שלך דורשת אימות. Sorank תכלול אותו כאסימון `Bearer` בכותרת `Authorization` כדי שהשרת שלך יוכל לוודא שהקריאה באה מ-Sorank.
3. לחץ על **Test** כדי לשלוח מטען לדוגמה (סוג האירוע `webhook.test`) ולוודא שנקודת הקצה שלך מגיבה נכון.
4. לחץ על **Save webhook** להפעלת האינטגרציה.

<img src="https://mintcdn.com/sorank/rRyGQ-GqyuxjdZ-r/images/documentation/3c5313286dc963296a81.jpg?fit=max&auto=format&n=rRyGQ-GqyuxjdZ-r&q=85&s=53e1c6b1ea16438db8034440f82e6681" alt="__wf_reserved_inherit" width="3840" height="1930" data-path="images/documentation/3c5313286dc963296a81.jpg" />

## פרטי בקשת HTTP

כל webhook ש-Sorank שולחת לנקודת הקצה שלך פועל לפי אותו חוזה HTTP. הנה מה שהשרת שלך יקבל:

* **Method:** `POST`
* **Content-Type:** `application/json`
* **User-Agent:** `SORANK-Webhook/1.0`
* **Authorization:** `Bearer {webhook_secret}` (אופציונלי, נשלח רק אם הגדרת סוד באינטגרציה).

השתמש בכותרת `User-Agent` לזיהוי תעבורת Sorank בלוגים שלך, וודא את כותרת `Authorization` בצד שלך כדי לוודא שהבקשה באה מ-Sorank ולא ממוקד לא ידוע.

## מבנה מטען ה-Webhook

Sorank משדרת שני סוגי אירועי webhook. שניהם חולקים את אותו מעטפת עליונה (`event`, `delivery_id`, `timestamp`, `article`) כך שהאינטגרציה שלך צריכה רק להסתעף על שדה `event` כדי לנתב את המטען.

### Event: article.published

מופעל בכל פעם שאתה מפרסם מאמר מ-Sorank. זהו האירוע שנקודת הקצה של הייצור שלך צריכה לעבד כדי ליצור את הפוסט ב-CMS או להפעיל את זרימת האוטומציה שלך.

### Event: webhook.test

מופעל כשאתה לוחץ על כפתור Test ב-Sorank כדי לוודא שנקודת הקצה שלך נגישה. המטען משתמש בערכי דמה (id כולו אפסים, featured\_image מושמט, images ריק) כך שהאינטגרציה שלך יכולה בבטחה להתעלם ממנו או להשתמש בו כדי לאשר קישוריות בלי ליצור פוסט אמיתי.

### הפניית שדות

* **event**, סוג האירוע. `article.published` או `webhook.test`. הסתעף על שדה זה כדי לנתב את המטען.
* **delivery\_id**, UUID ייחודי לכל ניסיון מסירה. שמור אותו בצד שלך למניעת כפילויות בעת ניסיונות חוזרים ולהגנה מפני פרסום כפול.
* **timestamp**, חותמת זמן ISO 8601 UTC של מתי האירוע שודר.
* **article.id**, מזהה ייחודי של המאמר ב-Sorank.
* **article.title**, ה-H1 / כותרת המאמר.
* **article.slug**, slug ידידותי ל-URL, אותיות קטנות עם מקפים.
* **article.meta\_description**, מטא-תיאור SEO, מוכן להכנסה בתגית `<meta name="description">` שלך.
* **article.focus\_keyphrase**, מילת המפתח המרכזית של המאמר.
* **article.content**, גוף המאמר המלא ב-HTML, כולל כותרות, פסקאות, רשימות ותגיות תמונה inline.
* **article.featured\_image**, אובייקט תמונת שער עם `url`, `alt` ו-`placement`. מוצג רק באירועי `article.published`.
* **article.images**, מערך של תמונות נוספות בגוף. לכל רשומה יש `url`, `alt` ו-`placement`. יכול להיות ריק.
* **article.word\_count**, סך המילים של גוף המאמר.
* **article.keyword**, זהה למילת המפתח המרכזית, נשמר כשדה נפרד לצורך תאימות לאחור.
* **article.language**, תג שפה לפי BCP 47 (למשל `en-US`, `fr-FR`).

## מקרי שימוש נפוצים

* **Zapier:** השתמש בטריגר "Catch Hook" כדי להעביר מאמרים לאלפי אפליקציות כמו WordPress, Notion, Airtable או Google Sheets.
* **Make:** השתמש במודול Webhooks כדי לבנות אוטומציות פרסום מותאמות בשלבים מרובים.
* **n8n:** חבר צומת Webhook לזרימה שיוצרת את הפוסט ב-CMS ללא ראש או במערכת ניהול פנימית.
* **Backend מותאם:** שלח מאמרים ישירות ל-API משלך לפרסום באתר מקודד ידנית, ב-CMS ללא ראש כמו Sanity או Strapi, או בכל כלי פנימי.

## טיפים

* תמיד לחץ על **Test** לפני השמירה כדי לוודא שנקודת הקצה שלך מקבלת את הבקשה ומחזירה תגובת 2xx.
* הסתעף על שדה `event` בצד השרת כדי שקריאות `webhook.test` לעולם לא ייצרו פוסטים אמיתיים.
* השתמש ב-`delivery_id` כמפתח אידמפוטנטיות כדי להימנע מפרסום אותו מאמר פעמיים בניסיונות חוזרים.
* שמור על **Secret token** פרטי, ודא את כותרת `Authorization` בכל בקשה, וסובב את הסוד באופן קבוע.
* השתמש בנקודת קצה HTTPS כדי לשמור על נתוני המאמר מאובטחים במעבר.
* ברגע שחוברת, כל מאמר שיפורסם ב-Sorank יישלח אוטומטית ל-URL של ה-webhook שלך.

## 🔄 מדוע המאמרים שלך עלולים לא להופיע (סיבות לכשל)

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

### סיבות בצד האינטגרציה שלך

* **מפתח ה-API של ה-CMS שלך הוא לקריאה בלבד ולא לקריאה וכתיבה**, זו אחת הבעיות הנפוצות ביותר. אם לאישורים שהקוד שלך משתמש בהם לכתיבה ל-CMS (Sanity, Strapi, Contentful, או כל backend ללא ראש) יש רק הרשאות *view / read*, נקודת הקצה שלך תקבל את ה-JSON אך תיכשל בשקט ביצירת הפוסט. צור מפתח עם הרשאות **write** ועדכן אותו באינטגרציה שלך.
* **הקוד שלך מקבל את ה-JSON אך לא דוחף אותו ל-CMS**, קבלת המטען היא רק חצי מהעבודה. ודא שנקודת הקצה שלך אכן ממפה את שדות Sorank ויוצרת את הפוסט ב-CMS או במסד הנתונים שלך. תעד את המטען הנכנס וודא שקריאת הפרסום שלך רצה ומצליחה.
* **מיפוי שדות שגוי**, אם הקוד שלך מצפה לשמות שדות שונים מאלה שבמטען, הפוסט עשוי להיווצר ריק או להידחות. בדוק שוב שאתה קורא `article.title`, `article.slug`, `article.content` וכו', בדיוק כפי שמתועד למעלה.
* **נקודת הקצה שלך מחזירה 2xx אך זורקת שגיאה אחר כך**, אם אתה מאשר את הבקשה לפני עיבודה באופן אסינכרוני, כשל מאוחר יותר בלוגיקת הפרסום שלך לא יהיה גלוי ל-Sorank. בדוק את לוגי השרת שלך כדי לתפוס את אלה.

### סיבות בצד המסירה

* **נקודת הקצה של ה-webhook שלך לא מגיבה יותר** (שרת לא מקוון), החזר את השרת שלך לפעולה וודא שה-URL מגיב כרגיל.
* **ה-URL של ה-webhook השתנה אך לא עודכן ב-Sorank**, עדכן את ה-URL בהגדרות האינטגרציה של Sorank.
* **יצרת מחדש את סוד ה-webhook בצד שלך**, עדכן את הסוד ב-Sorank כך שיתאים לזה שהשרת שלך מצפה לו כעת בכותרת `Authorization`.
* **נקודת הקצה שלך מחזירה שגיאה ש-Sorank לא יכולה לפרש**, בדוק את לוגי השרת שלך כדי לזהות את הבעיה, ואז תקן אותה בצד ה-webhook שלך.
* **חומת אש בשרת שלך חוסמת את הבקשות שלנו**, הכנס את כתובות ה-IP של Sorank לרשימת ההיתר בחומת האש שלך, או אפשר את ה-User-Agent `SORANK-Webhook/1.0`.
* **נקודת הקצה שלך לוקחת יותר מ-30 שניות להגיב**, בצע אופטימיזציה לנקודת הקצה כדי שתגיב מהר יותר, או אשר את הבקשה מיד ועבד אותה באופן אסינכרוני.

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

## 🚀 לא מפתח? אכסן את הבלוג שלך על Sorank במקום

ה-webhook דורש שתכתוב ותתחזק קוד שתופס את ה-JSON ומפרסם אותו לאתר שלך. אם בנית את האתר שלך עם כלי no-code או AI, כמו **Lovable**, **Base44**, **Cursor** או **Claude Code**, ואתה לא מסוגל לפתח ולארח נקודת קצה שתופסת את ה-webhook ומפרסמת את המאמר, יש דרך פשוטה בהרבה.

יצרנו פתרון שבו אתה יכול **לארח אוטומטית את הבלוג שלך על תת-דומיין משלך, ישירות על Sorank**. ללא קוד, ללא נקודת קצה לתחזוקה, ללא webhook לתפוס. למד איך זה עובד כאן: [Host your blog on Sorank](/documentation/host-your-blog-on-sorank).

## מחפש אינטגרציה מובנית במקום?

אם הפלטפורמה שלך נתמכת, מחבר ישיר קל יותר מה-webhook. עיין במדריכים שלנו עבור [Webflow](/documentation/connect-webflow), [Shopify](/documentation/connect-shopify), [WordPress.org](/documentation/connect-wordpress-org), [WordPress.com](/documentation/connect-wordpress-com), [Wix](/documentation/connect-wix) ו-[HubSpot](/documentation/use-hubspot-with-sorank).

### הבעיה נמשכת אחרי הבדיקה?

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

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