> For the complete documentation index, see [llms.txt](https://2sign-co-il.gitbook.io/2sign.co.il-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://2sign-co-il.gitbook.io/2sign.co.il-docs/getting-started/undefined.md).

# טיפים וחידודים - עברית

### משימה בודדת לעומת סבב חתימות

#### משימה בודדת

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

אפשר לשלוח אל:

* לקוח קיים באמצעות `ClientId`
* נמען חד-פעמי באמצעות `ClientPhones` או `ClientEmails`

ראו [Create a single Task](/2sign.co.il-docs/tasks/create-a-single-task.md).

#### סבב חתימות

השתמשו בסבב חתימות כאשר כמה נמענים חותמים על אותו מסמך.

המערכת תומכת בשני מצבים:

* `SignatureRoutineAsync: false` — חתימה טורית
* `SignatureRoutineAsync: true` — חתימה במקביל

אפשר ליצור סבב:

* עם קבוצה מוגדרת מראש וערכי `ClientId` של החותמים
* בלי קבוצה, על ידי שליחת ClientId של החותמים ישירות בבקשה

ראו [Create a Signature Routine](/2sign.co.il-docs/signature-routine-tasks/create-a-signature-routine.md) ו-[Create a Signature Routine Without a Group](/2sign.co.il-docs/signature-routine-tasks/create-a-signature-routine-without-a-group.md).

{% hint style="info" %}
השתמשו במצב טורי כשהסדר חשוב. השתמשו במצב מקבילי כשכל החותמים יכולים לקבל את המסמך באותו זמן.
{% endhint %}

***

### עבודה עם תבניות

השתמשו בתבנית כשהמבנה של המסמך נשאר קבוע בין משימות.

תבניות מתאימות כאשר:

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

כדי לעשות שימוש חוזר במיקומי שדות מתבנית:

1. קראו ל-endpoint מתאים מתוך [Single task tamplates](/2sign.co.il-docs/templates/get-tamplates-info.md)
2. העתיקו את מערך `SignaturePositions`
3. עדכנו את `PositionTextContent` לפי הצורך
4. שלחו את המערך בבקשת יצירת המשימה

{% hint style="info" %}
זו הדרך המהירה ביותר לקבל מיקומי שדות מדויקים. כך נמנעים מחישוב ידני של ערכי X/Y.
{% endhint %}

#### מילוי שדות מצד השולח

כדי להציג ערך על המסמך לפני שהחותם פותח אותו:

* הגדירו `SignaturePositionStageTypeId` ל-`1`
* הגדירו את ערך השדה בתוך `PositionTextContent`

למודל השדות המלא, ראו [Defining Signature Fields](/2sign.co.il-docs/tasks/defining-signature-fields.md).

***

### מיקום שדות באמצעות תווים נסתרים

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

#### תו יחיד לשדות חתימה

`SearchWordForMarkingSignature` מוסיף שדה חתימה בכל מקום שבו התו מופיע.

```json
{
  "SearchWordForMarkingSignature": "§"
}
```

השיטה הזו תומכת בשדות חתימה בלבד.

#### כמה תווים לכמה סוגי שדות

`SearchWordForMarkingFieldsJson` ממפה כל תו לסוג שדה אחר.

```json
{
  "SearchWordForMarkingFieldsJson": "[{ \"fieldSignaturePositionType\": \"1\", \"fieldSearchChar\": \"&\" }, { \"fieldSignaturePositionType\": \"6\", \"fieldSearchChar\": \"$\" }]"
}
```

בדוגמה הזו:

* `&` יוצר שדה חתימה
* `$` יוצר שדה שם מלא

| שדה                          | תיאור            |
| ---------------------------- | ---------------- |
| `fieldSignaturePositionType` | מזהה סוג השדה    |
| `fieldSearchChar`            | התו שמוטמע במסמך |

{% hint style="warning" %}
השתמשו בתווים נדירים כמו `§`, `¤` או `¬`. הימנעו מתווים נפוצים כמו `@`, `!` ו-`%`.
{% endhint %}

לאפשרויות נוספות למיקום שדות, ראו [Defining Signature Fields](/2sign.co.il-docs/tasks/defining-signature-fields.md).

***

### התראות וקישור חתימה

השתמשו בפרמטרים הבאים כדי לשלוט בערוץ השליחה:

* `IsSendOnCreation`
* `IsSendEmailOnCreation`
* `IsSendSmsOnCreation`
* `IsSendWhatsappOnCreation`

השתמשו ב-`EmailText` כדי להתאים אישית את גוף המייל.

SMS נשלח לערך `ClientPhones` של הנמען או למספר הנייד השמור שלו.

אפשר גם לבנות קישור חתימה ישיר מתוך ה-`taskGuid` שמוחזר בתשובה:

```
https://app.2sign.co.il/he/Clients/DocSignature?guid=<taskGuid>
```

אפשר לשלוח את הקישור הזה במייל, ב-WhatsApp או בכל ערוץ אחר.

***

### Callbacks

הגדירו כתובת callback קבועה כדי לקבל עדכוני סטטוס על משימות.

הגדירו אותה ב-**Subscription → Settings → Account Settings → Advanced Settings → Additional API Settings**.

הזינו כתובת מלאה עם `https://` ושמרו.

המערכת שולחת בקשת `POST` בכל פעם שסטטוס המשימה משתנה.

***

### קבלת קישור לחתימה על המסמך

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

לאחר יצירת מסמך באמצעות ה-API, יוחזר בשדה `TaskGuid` מזהה ייחודי של המשימה.

כדי ליצור קישור לחתימה על המסמך, יש לשרשר את ערך ה-`TaskGuid` לכתובת הבאה:

```
https://app.2sign.co.il/he/Clients/DocSignature?guid={TaskGuid}
```

**דוגמה:**

```
https://app.2sign.co.il/he/Clients/DocSignature?guid=c788c46d-7f64-48d9-94a0-7d0c3ee56301
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://2sign-co-il.gitbook.io/2sign.co.il-docs/getting-started/undefined.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.