Сделка — сущность, которая объединяет один или более контактов. У нее есть ответственный пользователь. В CRM чаще всего эта сущность называется «заказом» или «сделкой».

Пример: один и тот же клиент написал по поводу покупки новых дверей и половых покрытий. Клиент пытается закрыть две разные задачи и нуждается в консультации двух разных менеджеров. Поэтому необходимо создать две разные сделки с одним и тем же контактом, но разными ответственными менеджерами.

Загрузка списка сделок

Чтобы загрузить список сделок из CRM в Wazzup, отправьте запрос:

 POST https://api.wazzup24.com/v3/deals

В теле запроса нужно отправить массив с данными о сделках. Сделки в Wazzup и из запроса сравниваем по id. Если сделки нет в Wazzup — добавляем ее, если есть — то обновляем данные о сделке. За один запрос можно загружать не больше 100 сделок.

Параметры запроса

Пример запроса

fetch("https://api.wazzup24.com/v3/deals", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {apiKey}",
  },
  body: [
    {
      id: "deal-id",
      responsibleUserId: "user-id",
      name: "Супервайзер",
      uri: "any valid uri"
      contacts: [
        "contact-id-123",
        ...
      ],
      closed: false
    }
  ]
});

Получение списка сделок

Для получения списка сделок отправьте:

 GET https://api.wazzup24.com/v3/deals?offset=

В одном запросе можно получить до 100 записей.

Пример запроса

 curl --location --request GET 'https://api.wazzup24.com/v3/deals' \
--header 'Authorization: Bearer c8cf90474023482f909520d45f368d27'

Ответ

Ответ придет в виде массива объектов со следующими параметрами:

Получение информации по отдельной сделке

Для получение информации по отдельной сделке необходимо вызвать:

 GET https://api.wazzup24.com/v3/deals/{id сделки}

Ответ

Данные придут в виде объекта со следующими параметрами:

Удаление сделки

Для удаление конкретной сделки нужно вызвать:

 DELETE https://api.wazzup24.com/v3/deals/{id сделки}

Пример запроса

 curl --location --request DELETE 'https://api.wazzup24.com/v3/deals/101' \
--header 'Authorization: Bearer c8cf97644023482f909520d454368d27'

Ошибки

• общие для всех роутов,
• 404 Not found если такой сделки нет.

Удаление нескольких сделок

Чтобы удалить список сделок, необходимо вызвать:

 PATCH https://api.wazzup24.com/v3/deals/bulk_delete

В теле запроса необходимо передать массив id сделок, которых необходимо удалить. При успешном удалении вернется 200 ОК и пустой массив. Если в запросе на удаление были указаны сделки, некоторые из которых отсутствуют в Wazzup, то их ID вернутся в ответе в виде массива.

Пример запроса

fetch("https://api.wazzup24.com/v3/deals/bulk_delete", {
  method: "PATCH",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {apiKey}",
  },
  body: [
    "deal-id-123",
    "deal-id-456",
  ]
});