ایجاد فعالیت

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

POST {{baseURL}}/api/activity/save?apikey={{API_KEY}}

پارامترهای Query

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

Content-Type: application/json

بدنه درخواست

object

required

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

Show property

string

required

مشخص می‌کند این فعالیت از چه نوعی است؛ مثلا تماس، جلسه یا پیگیری.

Show وابستگی‌ها

این فیلد باید Id یکی از نوع‌های فعالیت موجود در دیدار را بگیرد.

Activity Type — Id نوع فعالیت موردنظر را بردارید

string

required

عنوان کوتاه فعالیت که به کاربر نمایش داده می‌شود.

string

شناسه User مسئول انجام و پیگیری فعالیت است. فعالیت در لیست فعالیت های همین کاربر نمایش داده می‌شود.

Show وابستگی‌ها

این فیلد نام کاربر را نمی‌پذیرد؛ باید UserId یک User موجود در دیدار را بفرستید.

User List — مقدار UserId کاربر موردنظر را بردارید

string

توضیحات لازم پیش از انجام فعالیت است؛ مثلا موضوع تماس یا نکاتی که مسئول باید هنگام پیگیری بداند.

boolean

مشخص می‌کند فعالیت انجام شده است یا هنوز باز است؛ true برای انجام‌شده و false برای انجام‌نشده.

Show مقادیر مجاز

true — فعالیت انجام‌شده است
false — فعالیت هنوز باز است

string

متنی است که نتیجه نهایی فعالیت یا محتوای یادداشت در آن ذخیره می‌شود؛ مثلا «مشتری درخواست پیش‌فاکتور داد».

Show شرایط ارسال

برای Activity معمولا زمانی ارسال می‌شود که فعالیت انجام شده و می‌خواهید نتیجه آن را ثبت کنید.

boolean

مشخص می‌کند فعالیت در وضعیت حذف‌شده قرار دارد یا فعال است.

Show مقادیر مجاز

true — فعالیت یا یادداشت حذف‌شده در نظر گرفته می‌شود
false — رکورد حذف‌شده نیست

boolean

مشخص می‌کند فعالیت برای دسترسی سریع در رکورد مرتبط (کارت یا فعالیت) سنجاق شود.

Show مقادیر مجاز

true — رکورد سنجاق می‌شود
false — رکورد سنجاق نمی‌شود

string

تاریخ و زمان برنامه‌ریزی‌شده برای انجام فعالیت است.

number

مدت زمان فعالیت برحسب دقیقه است و بازه زمانی آن را در تقویم مشخص می‌کند.

string

تاریخ و زمانی است که فعالیت واقعا انجام شده است.

Show شرایط ارسال

زمانی ارسالش کنید که فعالیت انجام شده و Activity.IsDone برابر true است.

string

شناسه معامله‌ای است که فعالیت باید به آن وصل شود. بعد از اتصال، فعالیت در سابقه همان معامله دیده می‌شود.

Show وابستگی‌ها

مقدار این فیلد باید Id یک معامله موجود در دیدار باشد.

Create Deal — اگر معامله هنوز ساخته نشده است
Search Deal — برای جست‌وجوی معامله

string

شناسه کارتی است که فعالیت یا یادداشت باید به آن وصل شود. بعد از اتصال، رکورد در سابقه همان کارت دیده می‌شود.

Show وابستگی‌ها

مقدار این فیلد باید Id یک کارت موجود در دیدار باشد.

Create Case — اگر کارت هنوز ساخته نشده است
Search Case — برای جست‌وجوی کارت

array

فهرست Id اشخاص یا شرکت‌هایی است که این فعالیت یا یادداشت به آن‌ها مربوط می‌شود. رکورد در سابقه مخاطبان انتخاب‌شده هم دیده خواهد شد.

Show وابستگی‌ها

هر مقدار باید Id یک شخص یا شرکت موجود در دیدار باشد.

Create Person — ساخت شخص جدید
Get Person By Mobile — پیداکردن شخص با موبایل
Search Person — جست‌وجوی شخص
Create Company — ساخت شرکت جدید
Search Company — جست‌وجوی شرکت

Show property

string

Show وابستگی‌ها

هر مقدار باید Id یک شخص یا شرکت موجود در دیدار باشد.

Create Person — ساخت شخص جدید
Get Person By Mobile — پیداکردن شخص با موبایل
Search Person — جست‌وجوی شخص
Create Company — ساخت شرکت جدید
Search Company — جست‌وجوی شرکت

string

شناسه Userی است که به‌عنوان ایجادکننده فعالیت ثبت می‌شود.

Show وابستگی‌ها

این فیلد نام کاربر را نمی‌پذیرد؛ باید UserId یک User موجود در دیدار را بفرستید.

User List — مقدار UserId کاربر موردنظر را بردارید

Show شرایط ارسال

اگر این فیلد ارسال نشود، ایجادکننده فعالیت مالک بیزدامنه در نظر گرفته می‌شود.

string

الگوی تکرار فعالیت را مشخص می‌کند؛ مثلا یک‌باره، روزانه یا هفتگی.

Show مقادیر مجاز

DontCare — فعالیت بدون الگوی تکرار
OneTime — فعالیت فقط یک‌بار انجام می‌شود
Hourly — تکرار ساعتی
Daily — تکرار روزانه
Weekly — تکرار هفتگی
Monthly — تکرار ماهانه
Yearly — تکرار سالانه

number

فاصله تکرار را همراه RecurrenceType مشخص می‌کند؛ مثلا RecurrenceType=Daily و مقدار 10 یعنی تکرار هر ۱۰ روز.

Show شرایط ارسال

وقتی RecurrenceType یک الگوی تکرارشونده مثل Daily یا Weekly است، این مقدار فاصله تکرار را مشخص می‌کند.

array

فهرست تگ‌هایی است که برای دسته‌بندی و پیداکردن سریع‌تر فعالیت یا یادداشت به آن وصل می‌شوند.

Show وابستگی‌ها

این فیلد باید Id تگ موجود در دیدار را بگیرد.

Tags — Id تگ موردنظر را بردارید

Show property

string

شناسه تگی است که باید به فعالیت یا یادداشت وصل شود.

Show وابستگی‌ها

این فیلد باید Id تگ موجود در دیدار را بگیرد.

Tags — Id تگ موردنظر را بردارید

string

آخرین تاریخی است که تکرار فعالیت تا آن ادامه دارد.

Show شرایط ارسال

فقط برای فعالیت تکرارشونده ارسالش کنید؛ برای فعالیت یک‌باره نیازی به آن نیست.

{
  "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"
            }
        ],
  }
}

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"
            }
        ],
  }
}'

{
  "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
  }
}

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

{
  "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"
            }
        ],
  }
}

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"
            }
        ],
  }
}'

{
  "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
  }
}

Create Activity

ایجاد فعالیت

پارامترهای Query

Header درخواست

بدنه درخواست

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

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

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

​Header درخواست

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

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

ایجاد فعالیت

پارامترهای Query

Header درخواست

بدنه درخواست

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