> ## Documentation Index
> Fetch the complete documentation index at: https://didar-crm.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Activity

# ایجاد فعالیت

فعالیت کاری است که باید در زمان مشخصی انجام شود؛ مثل تماس با مشتری، جلسه یا پیگیری یک معامله.‎ با این Endpoint می‌توانید فعالیت جدیدی بسازید، مسئول و زمان آن را مشخص کنید و فعالیت را به شخص، شرکت، معامله یا کارت مرتبط کنید.‎

```http theme={null}
POST {{baseURL}}/api/activity/save?apikey={{API_KEY}}
```

## پارامترهای Query

| پارامتر  | نوع      | وضعیت  | توضیح           |
| -------- | -------- | ------ | --------------- |
| `apikey` | `string` | الزامی | کلید API دیدار. |

## Header درخواست

```text theme={null}
Content-Type: application/json
```

## بدنه درخواست

<ParamField path="Activity" type="object" required>
  اطلاعات فعالیت جدید داخل این آبجکت ارسال می‌شود؛ عنوان، نوع، زمان، مسئول و رکوردهای مرتبط مشخص می‌کنند چه کاری برای چه زمانی و توسط چه کسی انجام شود.

  <Expandable title="property">
    <ParamField path="Activity.ActivityTypeId" type="string" required>
      مشخص می‌کند این فعالیت از چه نوعی است؛ مثلا تماس، جلسه یا پیگیری.

      <Expandable title="وابستگی‌ها">
        این فیلد باید `Id` یکی از نوع‌های فعالیت موجود در دیدار را بگیرد.

        * [Activity Type](/untitled-page-4) — `Id` نوع فعالیت موردنظر را بردارید
      </Expandable>
    </ParamField>

    <ParamField path="Activity.Title" type="string" required>
      عنوان کوتاه فعالیت که به کاربر نمایش داده می‌شود.
    </ParamField>

    <ParamField path="Activity.OwnerId" type="string">
      شناسه User مسئول انجام و پیگیری فعالیت است. فعالیت در لیست فعالیت های همین کاربر نمایش داده می‌شود.

      <Expandable title="وابستگی‌ها">
        این فیلد نام کاربر را نمی‌پذیرد؛ باید `UserId` یک User موجود در دیدار را بفرستید.

        * [User List](/User-List) — مقدار `UserId` کاربر موردنظر را بردارید
      </Expandable>
    </ParamField>

    <ParamField path="Activity.Note" type="string">
      توضیحات لازم پیش از انجام فعالیت است؛ مثلا موضوع تماس یا نکاتی که مسئول باید هنگام پیگیری بداند.
    </ParamField>

    <ParamField path="Activity.IsDone" type="boolean">
      مشخص می‌کند فعالیت انجام شده است یا هنوز باز است؛ `true` برای انجام‌شده و `false` برای انجام‌نشده.

      <Expandable title="مقادیر مجاز">
        * `true` — فعالیت انجام‌شده است
        * `false` — فعالیت هنوز باز است
      </Expandable>
    </ParamField>

    <ParamField path="Activity.ResultNote" type="string">
      متنی است که نتیجه نهایی فعالیت یا محتوای یادداشت در آن ذخیره می‌شود؛ مثلا «مشتری درخواست پیش‌فاکتور داد».

      <Expandable title="شرایط ارسال">
        برای Activity معمولا زمانی ارسال می‌شود که فعالیت انجام شده و می‌خواهید نتیجه آن را ثبت کنید.
      </Expandable>
    </ParamField>

    <ParamField path="Activity.IsDeleted" type="boolean">
      مشخص می‌کند فعالیت در وضعیت حذف‌شده قرار دارد یا فعال است.

      <Expandable title="مقادیر مجاز">
        * `true` — فعالیت یا یادداشت حذف‌شده در نظر گرفته می‌شود
        * `false` — رکورد حذف‌شده نیست
      </Expandable>
    </ParamField>

    <ParamField path="Activity.IsPinned" type="boolean">
      مشخص می‌کند فعالیت برای دسترسی سریع در رکورد مرتبط (کارت یا فعالیت) سنجاق شود.

      <Expandable title="مقادیر مجاز">
        * `true` — رکورد سنجاق می‌شود
        * `false` — رکورد سنجاق نمی‌شود
      </Expandable>
    </ParamField>

    <ParamField path="Activity.DueDate" type="string">
      تاریخ و زمان برنامه‌ریزی‌شده برای انجام فعالیت است.
    </ParamField>

    <ParamField path="Activity.Duration" type="number">
      مدت زمان فعالیت برحسب دقیقه است و بازه زمانی آن را در تقویم مشخص می‌کند.
    </ParamField>

    <ParamField path="Activity.DoneDate" type="string">
      تاریخ و زمانی است که فعالیت واقعا انجام شده است.

      <Expandable title="شرایط ارسال">
        زمانی ارسالش کنید که فعالیت انجام شده و `Activity.IsDone` برابر `true` است.
      </Expandable>
    </ParamField>

    <ParamField path="Activity.DealId" type="string">
      شناسه معامله‌ای است که فعالیت باید به آن وصل شود. بعد از اتصال، فعالیت در سابقه همان معامله دیده می‌شود.

      <Expandable title="وابستگی‌ها">
        مقدار این فیلد باید `Id` یک معامله موجود در دیدار باشد.

        * [Create Deal](/Create-Deal) — اگر معامله هنوز ساخته نشده است

        * [Search Deal](/Search-Deal) — برای جست‌وجوی معامله
      </Expandable>
    </ParamField>

    <ParamField path="Activity.CaseId" type="string">
      شناسه کارتی است که فعالیت یا یادداشت باید به آن وصل شود. بعد از اتصال، رکورد در سابقه همان کارت دیده می‌شود.

      <Expandable title="وابستگی‌ها">
        مقدار این فیلد باید `Id` یک کارت موجود در دیدار باشد.

        * [Create Case](/Create-Case) — اگر کارت هنوز ساخته نشده است
        * [Search Case](/Search-Case) — برای جست‌وجوی کارت
      </Expandable>
    </ParamField>

    <ParamField path="Activity.ContactIds[]" type="array">
      فهرست `Id` اشخاص یا شرکت‌هایی است که این فعالیت یا یادداشت به آن‌ها مربوط می‌شود. رکورد در سابقه مخاطبان انتخاب‌شده هم دیده خواهد شد.

      <Expandable title="وابستگی‌ها">
        هر مقدار باید `Id` یک شخص یا شرکت موجود در دیدار باشد.

        * [Create Person](/Create-Person) — ساخت شخص جدید
        * [Get Person By Mobile](/Get-Person-By-Mobile) — پیداکردن شخص با موبایل
        * [Search Person](/Search-Person) — جست‌وجوی شخص
        * [Create Company](/Create-Company) — ساخت شرکت جدید
        * [Search Company](/Search-Company) — جست‌وجوی شرکت
      </Expandable>

      <Expandable title="property">
        <ParamField path="Activity.ContactIds[]" type="string">
          فهرست `Id` اشخاص یا شرکت‌هایی است که این فعالیت یا یادداشت به آن‌ها مربوط می‌شود. رکورد در سابقه مخاطبان انتخاب‌شده هم دیده خواهد شد.

          <Expandable title="وابستگی‌ها">
            هر مقدار باید `Id` یک شخص یا شرکت موجود در دیدار باشد.

            * [Create Person](/Create-Person) — ساخت شخص جدید
            * [Get Person By Mobile](/Get-Person-By-Mobile) — پیداکردن شخص با موبایل
            * [Search Person](/Search-Person) — جست‌وجوی شخص
            * [Create Company](/Create-Company) — ساخت شرکت جدید
            * [Search Company](/Search-Company) — جست‌وجوی شرکت
          </Expandable>
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField path="Activity.CreatorId" type="string">
      شناسه Userی است که به‌عنوان ایجادکننده فعالیت ثبت می‌شود.

      <Expandable title="وابستگی‌ها">
        این فیلد نام کاربر را نمی‌پذیرد؛ باید `UserId` یک User موجود در دیدار را بفرستید.

        * [User List](/User-List) — مقدار `UserId` کاربر موردنظر را بردارید
      </Expandable>

      <Expandable title="شرایط ارسال">
        اگر این فیلد ارسال نشود، ایجادکننده فعالیت مالک بیزدامنه در نظر گرفته می‌شود.
      </Expandable>
    </ParamField>

    <ParamField path="Activity.RecurrenceType" type="string">
      الگوی تکرار فعالیت را مشخص می‌کند؛ مثلا یک‌باره، روزانه یا هفتگی.

      <Expandable title="مقادیر مجاز">
        * `DontCare` — فعالیت بدون الگوی تکرار
        * `OneTime` — فعالیت فقط یک‌بار انجام می‌شود
        * `Hourly` — تکرار ساعتی
        * `Daily` — تکرار روزانه
        * `Weekly` — تکرار هفتگی
        * `Monthly` — تکرار ماهانه
        * `Yearly` — تکرار سالانه
      </Expandable>
    </ParamField>

    <ParamField path="Activity.RecurrenceData" type="number">
      فاصله تکرار را همراه `RecurrenceType` مشخص می‌کند؛ مثلا `RecurrenceType=Daily` و مقدار `10` یعنی تکرار هر ۱۰ روز.

      <Expandable title="شرایط ارسال">
        وقتی `RecurrenceType` یک الگوی تکرارشونده مثل `Daily` یا `Weekly` است، این مقدار فاصله تکرار را مشخص می‌کند.
      </Expandable>
    </ParamField>

    <ParamField path="Activity.Tags[]" type="array">
      فهرست تگ‌هایی است که برای دسته‌بندی و پیداکردن سریع‌تر فعالیت یا یادداشت به آن وصل می‌شوند.

      <Expandable title="وابستگی‌ها">
        این فیلد باید `Id` تگ موجود در دیدار را بگیرد.

        * [Tags](/Tags) — `Id` تگ موردنظر را بردارید
      </Expandable>

      <Expandable title="property">
        <ParamField path="Activity.Tags[].TagId" type="string">
          شناسه تگی است که باید به فعالیت یا یادداشت وصل شود.

          <Expandable title="وابستگی‌ها">
            این فیلد باید `Id` تگ موجود در دیدار را بگیرد.

            * [Tags](/Tags) — `Id` تگ موردنظر را بردارید
          </Expandable>
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField path="Activity.RecurrenceEndDate" type="string">
      آخرین تاریخی است که تکرار فعالیت تا آن ادامه دارد.

      <Expandable title="شرایط ارسال">
        فقط برای فعالیت تکرارشونده ارسالش کنید؛ برای فعالیت یک‌باره نیازی به آن نیست.
      </Expandable>
    </ParamField>
  </Expandable>
</ParamField>

<RequestExample>
  ```json Request Body (JSON) theme={null}
  {
    "Activity": {
      "ActivityTypeId": "634b654c-b65a-4702-921e-6c3bc241aec1",
      "Title": "32131321",
      "OwnerId": "f1599895-3d58-44a8-a830-e77b42d8e4c6",
      "Note": "توضیحات فاکتور و پیش فاکتور در این جا است ",
      "IsDone": false,
      "ResultNote": "متن یاداشت را وارد کنید",
      "IsDeleted": false,
      "IsPinned": true,
      "DueDate": "2024-05-14T07:30:00.000Z",
      "Duration": 0,
      "DoneDate": "2025-05-14T07:30:00.000Z",
      "DealId": "b96eeffe-9baa-4fac-99d2-772415957ff0",
      "CaseId": "348d182c-8311-4abf-aa92-a1f2248f1192",
      "ContactIds": [
        "56620317-b415-4673-a2a5-6d20a7d12b00",
        "44cb2f3f-9a52-4f16-a6e3-e0d725349647"
      ],
      "CreatorId": "",
      "RecurrenceType": "OneTime",
      "RecurrenceData": 1,
      "RecurrenceEndDate": "2023-03-14T07:30:00.000Z",
      "Tags": [
              {
                  "TagId": "f76826cd-4917-4866-a235-2ab66d17faea"
              },
              {
                  "TagId": "3e0efd9c-fc6f-404b-872e-36af87182db0"
              }
          ],
    }
  }
  ```

  ```shellscript Request Body (cURL) theme={null}
  curl --location '{{baseURL}}/api/activity/save?apikey={{API_KEY}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "Activity": {
      "ActivityTypeId": "634b654c-b65a-4702-921e-6c3bc241aec1",
      "Title": "32131321",
      "OwnerId": "f1599895-3d58-44a8-a830-e77b42d8e4c6",
      "Note": "توضیحات فاکتور و پیش فاکتور در این جا است ",
      "IsDone": false,
      "ResultNote": "متن یاداشت را وارد کنید",
      "IsDeleted": false,
      "IsPinned": true,
      "DueDate": "2024-05-14T07:30:00.000Z",
      "Duration": 0,
      "DoneDate": "2025-05-14T07:30:00.000Z",
      "DealId": "b96eeffe-9baa-4fac-99d2-772415957ff0",
      "CaseId": "348d182c-8311-4abf-aa92-a1f2248f1192",
      "ContactIds": [
        "56620317-b415-4673-a2a5-6d20a7d12b00",
        "44cb2f3f-9a52-4f16-a6e3-e0d725349647"
      ],
      "CreatorId": "",
      "RecurrenceType": "OneTime",
      "RecurrenceData": 1,
      "RecurrenceEndDate": "2023-03-14T07:30:00.000Z",
      "Tags": [
              {
                  "TagId": "f76826cd-4917-4866-a235-2ab66d17faea"
              },
              {
                  "TagId": "3e0efd9c-fc6f-404b-872e-36af87182db0"
              }
          ],
    }
  }'
  ```
</RequestExample>

<ResponseExample>
  ```json Request Response (JSON) theme={null}
  {
    "Response": {
      "Id": "8c7b6390-6ae4-455b-a1d9-0a9ebd072854",
      "Title": "گوگل1",
      "Note": "",
      "ResultNote": "متن یاداشت را وارد کنید",
      "ActivityTypeId": "b9876107-44ea-4dbf-bbfb-2ee9fbcc597c",
      "IsPrivate": false,
      "IsDone": false,
      "IsPinned": false,
      "IsDeleted": false,
      "IsKeepInTouch": false,
      "DueDateType": "NoTime",
      "DueDate": "2023-03-14T07:30:00Z",
      "FinishDate": "2023-03-15T00:00:00Z",
      "OriginalDueDate": "2023-03-14T07:57:35.6222528Z",
      "DoneDate": "2023-03-14T07:30:00Z",
      "RegisterDate": "2023-03-14T07:57:35.6222528Z",
      "LastUpdateTime": "2023-03-14T07:57:35.6222528Z",
      "LastPokeDate": "2023-03-14T07:57:35.6222528Z",
      "Duration": 0,
      "DealId": "d6afde96-36f7-4d85-a5f4-00006e62adde",
      "CaseId": "00000000-0000-0000-0000-000000000000",
      "TicketId": "00000000-0000-0000-0000-000000000000",
      "CreatorId": "f677929c-0f9a-4570-8234-c5b6ac20b892",
      "OwnerId": "f677929c-0f9a-4570-8234-c5b6ac20b892",
      "UpdaterId": "f677929c-0f9a-4570-8234-c5b6ac20b892",
      "ActivityGroupId": "00000000-0000-0000-0000-000000000000",
      "RecurrenceType": "OneTime",
      "RecurrenceData": 1,
      "RecurrenceEndDate": "2023-03-14T07:30:00Z",
      "FeedbackType": "Neutral",
      "NextOccurrence": "0001-01-01T00:00:00Z",
      "CanPoke": false,
      "IsAttended": false,
      "Deal": null,
      "Case": null,
      "Contacts": [
        {
          "ContactId": "bdfaf004-2ad3-47cb-89b9-0002fe5e5678",
          "ActivityId": "5abb6a62-6f41-4f5a-ac01-7123dce4a5de",
          "Status": "Accepted",
          "Message": null,
          "Contact": null
        }
      ],
      "Creator": {
        "UserId": "f677929c-0f9a-4570-8234-c5b6ac20b892",
        "DisplayName": "نگین عابدیان",
        "PictureUrl": "/PortalData/Subsystems/Profile/UserPics/e326b384-94d1-41fa-a5cb-8845181be7d8.jpg",
        "Email": "abediannegin@gmail.com"
      },
      "Owner": {
        "UserId": "f677929c-0f9a-4570-8234-c5b6ac20b892",
        "DisplayName": "نگین عابدیان",
        "PictureUrl": "/PortalData/Subsystems/Profile/UserPics/e326b384-94d1-41fa-a5cb-8845181be7d8.jpg",
        "Email": "abediannegin@gmail.com"
      },
      "Users": [],
      "Notifies": [],
      "Comments": [],
      "Attachments": [],
      "Tags": [
              {
                  "ActivityId": "00000000-0000-0000-0000-000000000000",
                  "TagId": "f76826cd-4917-4866-a235-2ab66d17faea"
              },
              {
                  "ActivityId": "00000000-0000-0000-0000-000000000000",
                  "TagId": "3e0efd9c-fc6f-404b-872e-36af87182db0"
              }
  		],
      "CanEdit": true,
      "CanDelete": true,
      "CanDone": true,
      "ActivityTicketStatus": "NotAnswered",
      "IsTicket": false
    }
  }
  ```
</ResponseExample>

## لینک های مرتبط

* [Activity Type](/Activity-Type)
* [Search Deal](/Search-Deal)
* [Search Case](/Search-Case)
* [Tags ](/Tags)
* [Attach Files To Activity](/Attach-Files-To-Activity)
* [User List](/User-List)
* [Get Person By Mobile](/Get-Person-By-Mobile)
* [Search Person](/Search-Person)
* [Create Person](/Create-Person)
* [Create Company](/Create-Company)
* [Search Company](/Search-Company)