API Обращения
Информация по работе с объектом Обращения (cases).
Справочники
GET /types — Получение списка типов обращений.
GET /sources — Получение списка источников обращений.
GET /reasons — Получение списка причин обращений.
GET /custom_fields — Получение списка произвольных полей обращений.
Операции
GET / — Получение списка обращений.
GET /$id — Получение карточки обращения.
POST / — Добавление обращения.
PUT /$id — Обновление обращения.
DELETE /$id — Удаление обращения.
Поля
name — Название (Текст).
description — Описание (Текст).
d_case — Дата обращения (Дата).
account — Организация (Идентификатор организации).
contact — Контакт (Идентификатор контакта).
type — Тип (Идентификатор типа).
source — Источник (Идентификатор источника).
reason — Причина (Идентификатор причины).
status — Статус (Идентификатор статуса).
priority — Приоритет (Текст low, normal, high).
user — Ответственный (Идентификатор пользователя).
Фильтры
id - Идентификатор или массив идентификаторов.
name — Название.
user — Ответственный.
d_reg1 - Дата добавления (От).
d_reg2 - Дата добавления (До).
d_mod1 - Дата изменения (От).
d_mod2 - Дата изменения (До).
Справочники
GET /types — Получение списка типов обращений.
GET /sources — Получение списка источников обращений.
GET /reasons — Получение списка причин обращений.
GET /custom_fields — Получение списка произвольных полей обращений.
Операции
GET / — Получение списка обращений.
GET /$id — Получение карточки обращения.
POST / — Добавление обращения.
PUT /$id — Обновление обращения.
DELETE /$id — Удаление обращения.
Поля
name — Название (Текст).
description — Описание (Текст).
d_case — Дата обращения (Дата).
account — Организация (Идентификатор организации).
contact — Контакт (Идентификатор контакта).
type — Тип (Идентификатор типа).
source — Источник (Идентификатор источника).
reason — Причина (Идентификатор причины).
status — Статус (Идентификатор статуса).
priority — Приоритет (Текст low, normal, high).
user — Ответственный (Идентификатор пользователя).
Фильтры
id - Идентификатор или массив идентификаторов.
name — Название.
user — Ответственный.
d_reg1 - Дата добавления (От).
d_reg2 - Дата добавления (До).
d_mod1 - Дата изменения (От).
d_mod2 - Дата изменения (До).
//Пример добавления обращения с заполнением значения произвольного поля на PHP
$apikey = "Ваш API-ключ";
//Получаем список произвольных полей в обращениях
$url = "https://wirecrm.com/api/v1/cases/custom_fields";
$headers = array("X-API-KEY:".$apikey
);
$handle = curl_init();
curl_setopt($handle, CURLOPT_URL, $url);
curl_setopt($handle, CURLOPT_USERAGENT, "WireCRM Rest API");
curl_setopt($handle, CURLOPT_HTTPHEADER, $headers);
curl_setopt($handle, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($handle, CURLOPT_RETURNTRANSFER, true);
$data = curl_exec($handle);
curl_close($handle);
//Добавляем обращение
$url = "https://wirecrm.com/api/v1/cases";
$headers = array("X-API-KEY:".$apikey);
$data = '{"name":"Обращение клиента","description":"Обратился клиент с проблемой через сайт","custom_fields":{"4":"Значение"}}';
$handle = curl_init();
curl_setopt($handle, CURLOPT_URL, $url);
curl_setopt($handle, CURLOPT_USERAGENT, "WireCRM Rest API");
curl_setopt($handle, CURLOPT_HTTPHEADER, $headers);
curl_setopt($handle, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($handle, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($handle, CURLOPT_POSTFIELDS, $data);
curl_setopt($handle, CURLOPT_RETURNTRANSFER, true);
$data = curl_exec($handle);
curl_close($handle);
//Пример добавления обращения с указанием типа, источника и статуса на PHP
$apikey = "Ваш API-ключ";
//Список типов обращений
//Можно получить GET запросом https://wirecrm.com/api/v1/cases/types
$case_type_id = "ID типа";
//Список источников обращений
//Можно получить GET запросом https://wirecrm.com/api/v1/cases/sources
$case_source_id = "ID источника";
//Список статусов обращений (open, close)
$case_status = "open";
//Список приоритетов обращений (low, normal, high)
$case_priority = "normal";
//Добавляем обращение
$url = "https://wirecrm.com/api/v1/cases";
$headers = array("X-API-KEY:".$apikey);
$data = '{"name":"Обращение клиента","description":"Обратился клиент с проблемой через сайт","status":"'.$case_status.'","priority":"'.$case_priority.'","type":"'.$case_type_id.'","source":"'.$case_source_id.'"}';
$handle = curl_init();
curl_setopt($handle, CURLOPT_URL, $url);
curl_setopt($handle, CURLOPT_USERAGENT, "WireCRM Rest API");
curl_setopt($handle, CURLOPT_HTTPHEADER, $headers);
curl_setopt($handle, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($handle, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($handle, CURLOPT_POSTFIELDS, $data);
curl_setopt($handle, CURLOPT_RETURNTRANSFER, true);
$data = curl_exec($handle);
curl_close($handle);
В WireCRM легко вести учет клиентов и продаж, работать с финансами и складом, создавать документы по шаблону. Первые 14 дней бесплатны для всех новых пользователей. Изучите возможности сервиса, ведите учет клиентов и пользуйтесь поддержкой наших специалистов!
Создать аккаунт
Создать аккаунт