• Post category:Задачи
  • Запись изменена:03.11.2022

POST api/2.0/crm/task

Для этой функции требуется аутентификация.

Описание

Создает задачу с указанными в запросе параметрами (название, описание, срок выполнения и т.д.).

Параметры

Название Описание Тип Пример
title

sent in body
Название задачи строковый текст
description

sent in body
Описание задания

необязательно
строковый текст
deadline

sent in body
Срок выполнения задачи Date and Time Roundtrip format: 2008-04-10T06-30-00.000Z
responsibleId

sent in body
Идентификатор ответственного за выполнение задачи guid 9924256A-739C-462b-AF15-E652A3B1B6EB
categoryId

sent in body
Идентификатор категории задачи номер 1234
contactId

sent in body
Идентификатор контакта

необязательно
номер 1234
entityType

sent in body
Связанный тип сущности
Допустимые значения: opportunity or case
необязательно
строковый текст
entityId

sent in body
Идентификатор связанной сущности

необязательно
номер 1234
isNotify

sent in body
Уведомляет ответственного о задаче

необязательно
логический истина
alertValue

sent in body
Период времени в минутах для напоминания ответственному о задаче

необязательно
номер 1234
Пример
POST api/2.0/crm/task
Host: yourportal.r7-office.ru
Content-Type: application/json
Accept: application/json

{
  "title": "some text",
  "description": "some text",
  "deadline": "2008-04-10T06-30-00.000Z",
  "responsibleId": "9924256A-739C-462b-AF15-E652A3B1B6EB",
  "categoryId": 1234,
  "contactId": 1234,
  "entityType": "some text",
  "entityId": 1234,
  "isNotify": true,
  "alertValue": 1234
}

Возвращает
Задача

Пример ответа

application/json

{
  "status": 0,
  "response": {
    "createBy": {
      "id": "00000000-0000-0000-0000-000000000000",
      "displayName": "Mike Zanyatski",
      "title": "Manager",
      "avatarSmall": "url to small avatar",
      "profileUrl": ""
    },
    "created": "2022-10-09T20:03:09.6137431Z",
    "title": "Send a commercial offer",
    "deadLine": "2022-10-09T20:03:09.6137431Z",
    "responsible": {
      "id": "00000000-0000-0000-0000-000000000000",
      "displayName": "Mike Zanyatski",
      "title": "Manager",
      "avatarSmall": "url to small avatar",
      "profileUrl": ""
    },
    "category": {
      "imagePath": "path to image",
      "title": "Appointment",
      "description": "",
      "sortOrder": 2,
      "id": 30
    },
    "canEdit": true,
    "id": 0
  }
}

text/xml

<result>
  <status>0</status>
  <response>
    <createBy>
      <id>00000000-0000-0000-0000-000000000000</id>
      <displayName>Mike Zanyatski</displayName>
      <title>Manager</title>
      <avatarSmall>url to small avatar</avatarSmall>
      <profileUrl></profileUrl>
    </createBy>
    <created>2022-10-09T20:03:09.6137431Z</created>
    <title>Send a commercial offer</title>
    <deadLine>2022-10-09T20:03:09.6137431Z</deadLine>
    <responsible>
      <id>00000000-0000-0000-0000-000000000000</id>
      <displayName>Mike Zanyatski</displayName>
      <title>Manager</title>
      <avatarSmall>url to small avatar</avatarSmall>
      <profileUrl></profileUrl>
    </responsible>
    <category>
      <imagePath>path to image</imagePath>
      <title>Appointment</title>
      <description></description>
      <sortOrder>2</sortOrder>
      <id>30</id>
    </category>
    <canEdit>true</canEdit>
    <id>0</id>
  </response>
</result>