# Nodaro עם Make

> התחילו תהליך Nodaro מתרחיש Make עם אפליקציית HTTP, וקבלו את התמונה או הסרטון המוכנים בחזרה ב-Webhook מותאם אישית של Make. לא צריך מפתח API.

Source: https://nodaro.ai/he/docs/guides/make-integration

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

## איך השניים מתחברים
1. המודול **Make a request** (שליחת בקשה) של אפליקציית **HTTP** שולח גוף JSON, למשל פרומפט, לכתובת ה-Webhook של תהליך Nodaro.
2. תהליך Nodaro מתחיל ברכיב [טריגר Webhook](https://nodaro.ai/docs/nodes/automate/webhook-trigger), מריץ את הרכיבים שלו ומסתיים ברכיב [פלט Webhook](https://nodaro.ai/docs/nodes/publish/webhook-output).
3. רכיב פלט Webhook שולח את התוצאה ל-**Custom webhook** (Webhook מותאם אישית) של Make, שמתחיל תרחיש שני עם התוצאה.

Workflow: הצד של Nodaro: תרחיש Make מתחיל את רכיב טריגר Webhook, ורכיב פלט Webhook שולח את כתובת התמונה ל-Webhook מותאם אישית של Make.

- טריגר Webhook → יצירת תמונה (פרומפט)
- יצירת תמונה → פלט Webhook (image_url)

## שלב 1: קבלת התוצאה ב-Make
צרו קודם את הצד המקבל, כי תהליך Nodaro צריך את הכתובת שלו.

1. צרו תרחיש והוסיפו את המודול **Webhooks › Custom webhook** בתור הטריגר שלו.
2. לחצו על **Add** (הוספה) לצד **Webhook**, תנו לו שם, למשל "Nodaro result" (תוצאת Nodaro), ולחצו על **Save** (שמירה).
3. העתיקו את כתובת ה-URL ש-Make יוצר. Make מאזין עכשיו ומחכה לבקשה הראשונה.

כל Webhook של Make שייך לתרחיש אחד. הפעילו את התרחיש כשהוא מוכן, כדי שיעבד כל תוצאה ברגע שהיא מגיעה.

## שלב 2: בניית תהליך Nodaro
1. הוסיפו רכיב **טריגר Webhook**. תחת **פרמטרי פלט**, הוסיפו פרמטר בשם `prompt` מסוג **טקסט**.
2. חברו את הפלט `prompt` לקלט הפרומפט של רכיב [יצירת תמונה](https://nodaro.ai/docs/nodes/image/generate-image), או של כל רכיב אחר שמייצר תוצאה.
3. הוסיפו רכיב **פלט Webhook**. הדביקו את כתובת ה-Webhook של Make בשדה **כתובת Webhook**. תחת **פרמטרים של קלט**, הוסיפו פרמטר `image_url` מסוג **כתובת תמונה**, וחברו אליו את התמונה.
4. שמרו את התהליך. סמנו את רכיב טריגר Webhook והעתיקו את הכתובת שלו תחת **כתובת Webhook**.

הכתובת היא בצורה `https://app.nodaro.ai/v1/webhooks/<token>`. האסימון עובד כמו סיסמה: כל מי שיש לו את הכתובת יכול להתחיל את התהליך.

## שלב 3: התחלת ההרצה מ-Make
1. בתרחיש שאמור להתחיל את ההרצה, הוסיפו את המודול **Make a request** של אפליקציית **HTTP**.
2. הדביקו את הכתובת של Nodaro בשדה **URL** וקבעו את **Method** (שיטה) ל-**POST**.
3. קבעו את **Body content type** (סוג תוכן הגוף) ל-`application/JSON` ואת **Body input method** (שיטת הזנת הגוף) ל-**Data structure** (מבנה נתונים). הוסיפו שדה בשם `prompt`, ומפו את הערך ממודול מוקדם יותר.
4. קבעו את **Parse response** (פענוח התגובה) ל-**Yes**, כדי שהמודולים הבאים יוכלו למפות את `executionId`.

השיטה **Data structure** עושה escape לערכים שלכם. מחרוזת JSON גולמית עם ערכים ממופים יכולה להישבר כשערך מכיל מירכאות.

## מה חוזר
Nodaro עונה לבקשה מיד, לפני שמשהו נוצר. התגובה היא `202` עם המזהה של ההרצה:

```json
{ "executionId": "3f9e2b1a-7c6d-4e5f-8a9b-0c1d2e3f4a5b", "status": "pending" }
```

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

```json
{ "image_url": "https://cdn.nodaro.ai/images/2538b658-d2e1-42ee-890a-72ce06089feb.png" }
```

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

## תשאול במקום Webhook
אפשר גם לבדוק את הסטטוס של התוצאה מדי כמה שניות עם [אסימון API אישי](https://nodaro.ai/docs/developers/api/authentication), באותו תרחיש. תשאול עובד בתהליכים שבפרויקטים האישיים שלכם.

1. אחרי מודול הבקשה, הוסיפו את המודול **Tools › Sleep** (המתנה), למשל ל-30 שניות.
2. הוסיפו מודול **Make a request** נוסף עם **Method** **GET** והכתובת `https://app.nodaro.ai/v1/api/status/<executionId>`, כש-`executionId` ממופה מהבקשה הראשונה.
3. לאסימון, בחרו את סוג האימות **API key**: שימו `Bearer <your API token>` בשדה **Key**, מקמו אותו בכותרת, ותנו לפרמטר את השם `Authorization`.
4. כשהסטטוס הוא `completed`, קראו ל-`https://app.nodaro.ai/v1/api/result/<executionId>` באותה דרך. התגובה מפרטת את הפלטים של ההרצה עם הכתובות שלהם.

יצירת סרטון יכולה לקחת כמה דקות, ומודול Sleep אחד מחכה זמן מוגבל. להרצות ארוכות, שיטת ה-Webhook שלמעלה פשוטה יותר. בדף ה-API, הסעיף [הרצת תהליך עם ערכי קלט חדשים](https://nodaro.ai/docs/developers/api/workflows#run-a-workflow-with-new-input-values) מתאר את התגובות של הסטטוס והתוצאה.

## מגבלות שכדאי להביא בחשבון
| מגבלה | מה קורה | מה לעשות |
| --- | --- | --- |
| הרצה אחת בכל פעם לכל תהליך | בקשה בזמן הרצה נדחית עם `409`, עם ה-`executionId` של ההרצה הפעילה. | שלחו את הבקשה הבאה אחרי שהתוצאה הקודמת הגיעה, או שכפלו את התהליך. |
| 10 בקשות בדקה לכל כתובת | בקשות נוספות נדחות עם `429`. | פזרו את הבקשות לאורך זמן. |
| ניסיון מסירה אחד | רכיב פלט Webhook מחכה 30 שנ׳ לתגובה ולא מנסה שוב. מסירה שנכשלה מכשילה את הרכיב. | השאירו את התרחיש המקבל פעיל. |
| Webhook של Make שלא בשימוש נעצר | Make משבית Webhook ששום תרחיש לא משתמש בו במשך 5 ימים. | השאירו את ה-Webhook המותאם אישית בתרחיש פעיל. |

## כמה זה עולה
רכיב טריגר Webhook ורכיב פלט Webhook לא עולים כלום. משלמים את הקרדיטים של הרכיבים שביניהם, באותם מחירים כמו בעורך. בדוגמה שלמעלה, כל הרצה עולה כמו תמונה אחת של Nano Banana 2, 22 קרדיטים. קרדיטים שמשוריינים לרכיב שנכשל חוזרים אוטומטית.

אותו דפוס עובד ב-[n8n](https://nodaro.ai/docs/guides/n8n-integration) וב-[Zapier](https://nodaro.ai/docs/guides/zapier-integration). המדריך [אוטומציות](https://nodaro.ai/docs/guides/automations) מכסה תזמונים ואת שאר הדרכים להתחיל תהליך.

## שאלות נפוצות

### האם צריך מפתח API של Nodaro כדי להשתמש ב-Nodaro מ-Make?

לא. המודול Make a request של אפליקציית HTTP מתחיל את ההרצה דרך כתובת ה-Webhook של תהליך Nodaro, ורכיב פלט Webhook שולח את התוצאה ל-Webhook מותאם אישית של Make. מפתח API נדרש רק אם במקום זאת בודקים את הסטטוס מדי כמה שניות.

### למה אי אפשר למפות את השדות של תוצאת Nodaro ב-Make?

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

### למה Nodaro מחזיר 409?

לתהליך Nodaro כבר יש הרצה פעילה, ותהליך מריץ בקשה אחת בכל פעם. שלחו את הבקשה הבאה אחרי שהתוצאה הקודמת הגיעה, או צרו עותק של התהליך להרצות מקבילות.

### כמה זה עולה?

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