Проекты

REST API CRM

Прокрутите вниз
На главную

REST API CRM

API позволяет подключить к CRM TELCOM дополнительные функции CRM или базу данных через сторонние приложения

ТЕЛКОМ разработчик
РАЗРАБОТЧИКАМ И ПРОГРАММИСТАМ

Интеграция
REST API TelcomCRM

REST API определяет набор функций, с помощью которых разработчики могут выполнять запросы и получать ответы по протоколу HTTP, например GET и POST.
 – API TelcomCRM работает через HTTPS и использует JSON в качестве формата данных. API представляет собой RESTful API и использует методы HTTP и коды состояния HTTP для указания запросов и ответов.
Мы предоставляем полную документацию . Если вы не уверены в своих навыках программирования или не понимаете, что такое API, возможно, вам придется подумать о найме эксперта.
 – Обратите внимание: из-за ограничений CI вам может потребоваться включить /index.php/ в ваши конечные точки.
Скачать PDF
01.

Команды через API

Ниже вы найдете все доступные команды, которые можно использовать с Rest API RISE, а также их методы.

  • Лиды

    → Добавить новый лид;
    → Удалить лид;
    → Вся информацию о лиде;
    → Поиск информации о лиде;
    → Обновить лид;
    01.
  • Контрагент

    → Новый контрагента;
    → Удалить контрагента;
    → Информация о контрагенте;
    → Поиск контрагента;
    → Обновить контрагента;
    02.
  • Проекты

    → Добавить новый проект;
    → Удалить проект;
    → Информация о проекте;
    → Поиск проекта;
    → Обновить проект;
    03.
  • Счета

    → Добавить новый счет;
    → Удалить счет;
    → Вся информацию о счете;
    → Поиск информации о счете;
    → Обновить счет;
    03.
  • Заявки

    → Новая заявка;
    → Удалить заявку;
    → Информация о заявке;
    → Поиск заявки;
    → Обновить заявку;
    05.
  • Прочее

    → Группы контрагентов;
    → Контакты по ClientID:
    → Вид счетов, налоги;
    → Участники проекта;
    → Вид и тип заявок;
    06.
02.

Полноценный API-сервис для установок TelcomCRM, с помощью которого вы можете реализовать свои подключения к сторонним сервисам.

Создайте свой токен API TelcomCRM

Войдите в серверную часть TelcomCRM как администратор, перейдите в API → Управление API и создайте новый токен. Обязательно скопируйте токен и заполните всю необходимую информацию.

Использование API TelcomCRM

Доступные команды API описаны ниже вместе с ответами на них. В этом примере мы будем использовать фиктивный токен и случайную команду.
Допустим, ваш новый токен J4fRtwkfj6E8heV6ytl8AoF5l7F88M9qeU4Q7j6AsoH2hOXAS5z8t9XjEh2e4Vy6twlAoFlr7oFw8MqUQ7eRt5 что вам необходимо перечислить всех доступных клиентов установки TelcomCRM, используя API, через запрос cURL.

Запрос команды

Curl – H ” токен авторизации: https://mysite.com/api/customers ” j4fRtwkfj6E8heV6ytl8AoF5l7F88M9qeU4Q7j6AsoH2hOXAS5z8t9XjEh2e4Vy6twlAoFlr7oFw8MqUQ7eRt5

Ответ на запрос команды

Header
Имя Описание Тип
Authorization Basic Access Authentication token. string
Параметр
Имя Описание Тип
company_name Mandatory Lead Name. string
owner_id Mandatory Lead owner id. string
lead_status_id Mandatory Lead status id. string
lead_source_id Mandatory Lead source id. string
address Optional Lead address. string
city Optional Lead city. string
state Optional Lead state. string
zip Optional Lead zip. string
country Optional Lead country. string
phone Optional Lead phone. string
website Optional Lead website. string
vat_number Optional Lead vat number. string
Success 200
Имя Описание Тип
status Request status. Boolean
message Lead add successful. string
Error 4xx
Имя Описание Тип
status Request status. Boolean
message Lead add fail. string
Request-Example:

array (size=13)
company_name‘ => string ‘Lead Name‘ (length=9)
‘owner_id‘ => string ‘1‘ (length=1)
address‘ => string ‘test address‘ (length=12)
city‘ => string ‘test city‘ (length=9)
state‘ => string ‘test state‘ (length=10)
zip‘ => string ‘123456‘ (length=6)
country‘ => string ‘test country‘ (length=12)
phone‘ => string ‘9856231470‘ (length=10)
website‘ => string ‘www.test.com‘ (length=12)
vat_number‘ => string ‘123465789‘ (length=9)
start_date‘ => string ‘25/07/2019‘ (length=10)
lead_source_id‘ => string ‘0‘ (length=10)
lead_status_id‘ => string ‘1‘ (length=1) *

Success-Response:

HTTP/1.1 200 OK
{
status“: true,
message“: “Lead add successful.
}

Error-Response:

HTTP/1.1 404 Not Found
{
status“: false,
message“: “Lead add fail.
}

Пожалуйста, реализуйте принимающую и ответную часть для этих команд.

Команда history (POST)

– Входящий звонок клиента и ссылка на запись разговора записывается в CRM – Всегда подключено!
– Исходящий звонок клиента и ссылка на запись разговора записывается в CRM – Всегда подключено!

После успешного звонка в CRM отправляется запрос с данными о звонке и ссылкой на запись разговора.
Команда может быть использована для сохранения в данных ваших клиентов истории и записей входящих и исходящих звонков.
Команда доступна сразу после включения API.

Входные параметры:

 

Имя Описание Тип/формат данных Обязательный параметр
cmd тип операции, в данном случае history string да
type тип звонка in/out (входящий/исходящий) string да
user идентификатор пользователя облачной АТС TELCOM (необходим для сопоставления на стороне CRM) string да
ext внутренний номер пользователя облачной АТС TELCOM, если есть string нет
groupRealName название отдела, если входящий звонок прошел через отдел string нет
telnum прямой телефонный номер пользователя облачной АТС TELCOM, если есть string нет
phone номер телефона клиента, с которого или на который произошел звонок string / E164 да
diversion ваш номер телефона, через который пришел входящий вызов string / E164
start время начала звонка в формате YYYYmmddTHHMMSSZ timestamp да
duration общая длительность звонка в секундах number да
callid уникальный id звонка string да
link ссылка на запись звонка, если она включена в Облачной АТС TELCOM string
crm_token ключ (token) от CRM, установленный в веб-кабинете string да
status статус входящего звонка:
– Success – успешный входящий звонок
– missed – пропущенный входящий звонок
статус исходящего звонка:
– Success – успешный исходящий звонок
– Busy – мы получили ответ Занято
– NotAvailable – мы получили ответ Абонент недоступен
– NotAllowed – мы получили ответ Звонки на это направление запрещены
– call A error – вызов менеджера при выполнении команды makecall завершился ошибкой
string да

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

POST https://crm.ru/crm_integration.php
cmd=history
type=out
status=Success
phone=79101234567
user=user
start=20170703T121110Z
duration=124
link=https://link/file.mp3
crm_token=76fsd7tfs-fhjdgfdjsfsk-hfgsdguuuwoeiwey1111
callid=B10D0EB124F4E64AF4EA-1511

Выходные данные:

 

Код Содержание Описание
200 Ok
400 { error: “Invalid parameters” } Переданы некорректные параметры
401 { error: “Invalid token” } Передан неверный ключ (token)

Команда event (POST)

При входящем звонке всплывает карточка клиента с его именем – Всегда подключено!
Облачная АТС TELCOM отправляет в вашу CRM уведомления о событиях входящих звонков пользователям: появлении, принятии или завершении звонка. Команда может быть использована для отображения всплывающей карточки клиента в интерфейсе CRM. Команда доступна сразу после включения API.

Входные параметры:

Имя Описание Тип/формат данных Обязательный параметр
cmd тип операции, в данном случае event string да
type type – это тип события, связанного со звонком
 – INCOMING – пришел входящий звонок (в это время у
менеджера должен начать звонить телефон).
 – ACCEPTED – звонок успешно принят (менеджер снял трубку). В этот момент можно убрать всплывающую карточку контакта в CRM.
 – COMPLETED – звонок успешно завершен (менеджер или клиент положили трубку после разговора).
 – CANCELLED – звонок сброшен (клиент не дождался
пока менеджер снимет трубку. Либо, если это был
звонок сразу на группу менеджеров, на звонок мог
ответить кто-то еще).
 – OUTGOING – менеджер совершает исходящий звонок (в это время облачная АТС TELCOM пытается дозвониться до клиента).
string да
phone номер телефона клиента string / E.164 да
diversion ваш номер телефона, через который пришел входящий вызов string / E.164
user идентификатор пользователя облачной АТС TELCOM (необходим для сопоставления на стороне CRM) string да
groupRealName название отдела, если входящий звонок прошел через отдел string нет
ext внутренний номер пользователя облачной АТС TELCOM, если есть string нет
telnum прямой телефонный номер пользователя облачной АТС TELCOM, если есть string нет
calid уникальный id звонка, совпадает для всех связанных звонков timestamp да
duration общая длительность звонка в секундах number да
callid уникальный id звонка string да
crm_token ключ (token) от CRM, установленный в веб-кабинете string да

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

POST https://crm.ru/crm_integration.php
cmd=event
type=INCOMING / COMPLETED / ACCEPTED / CANCELLED
phone=79101234567
user=andy
crm_token=76fsd7tfs-fhjdgfdjsfsk-hfgsdguuuwoeiwey1111
callid=B10D0EB124F4E64AF4EA-1511

Выходные данные:

Код Содержание Описание
200 Ok
400 { error: “Invalid parameters” } Переданы некорректные параметры
401 { error: “Invalid token” } Передан неверный ключ (token)

Команда contact (POST)

Команда для получения информации о названии клиента и ответственном за него сотруднике по номеру его телефона. Команда вызывается при поступлении нового входящего звонка.
При входящем звонке имя клиента отображается на экране IP-телефона или коммуникатора – Всегда подключено!
Команда используется для отображения на экране IP-телефона или в коммуникаторе на ПК сотрудника названия клиента.
Этот функционал доступен сразу после включения API.
Звонки от клиентов будут перенаправляться ответственному менеджеру, указанному в CRM – Настроить!
Также в Облачной АТС TELCOM можно включить функцию автоматического перевода каждого звонка от клиента сразу на ответственного за него менеджера, указанного в CRM. Данная функция активируется вручную в веб-кабинете Облачной АТС TELCOM. При включении вам будет необходимо выбрать номер(а) телефона, на котором будет работать данная функция, а также определить на кого будет переведен звонок, если ответственный сотрудник не отвечает или занят.

Входные параметры:

Имя Описание Тип/формат данных Обязательный параметр
cmd тип операции, в данном случае contact string да
phone номер телефона клиента string / E.164 да
crm_token ключ (token) от CRM, установленный в веб-кабинете string да
callid уникальный id звонка, совпадает для всех связанных звоков string да

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

POST https://crm.ru/crm_integration.php
cmd=contact
phone=79101234567
crm_token=76fsd7tfs-fhjdgfdjsfsk-hfgsdguuuwoeiwey1111
callid=B10D0EB124F4E64AF4EA-1511

Выходные данные:

Код Содержание Описание
200 {
contact_name: “Менеджер ЗАО Рога и копыта”, // имя
контакта
responsible:andy // id ответственного пользователя.
Нужно для автоматической маршрутизации звонка
}
Ok
400 { error: “Invalid parameters” } Переданы некорректные параметры
401 { error: “Invalid token” } Передан неверный ключ (token)

В поле responsible может быть передан логин, внутренний номер или прямой телефонный номер пользователя Облачной АТС TELCOM.

Пожалуйста, реализуйте отправку и приемку ответов для этих команд.

Команда accounts (GET / POST)

CRM получает список сотрудников из Облачной АТС для сопоставления – Всегда подключено!
Запрос от CRM к Облачной АТС для получения сотрудников. Может использоваться для сопоставления пользователей в CRM и Облачной АТС TELCOM. Для этого
вам придётся реализовать функционал сопоставления. Вы можете так же настраивать сопоставление пользователей на вашей стороне вручную, без использования этой команды. Команда доступна сразу после включения API.

Входные параметры:

Имя Описание Тип/формат данных Обязательный параметр
cmd тип операции, в данном случае accounts string да
crm_token  ключ (token) от Облачной АТС TELCOM, полученный в веб-кабинете string да

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

POST https://domain/sys/crm_api.wcgp
cmd=accounts
token=5f317b9f-e86c-41f7-a6fc-c76eb0da0000

Выходные данные:

Код Содержание Описание
200 [
{“name”:”test”,”realName”:”Тестовый пользователь”, ext: 701},
{“name”:”daria”,”realName”:”Иванова Дария”, ext: 705},
{“name”:”andy”,”realName”:”Петров Андрей”, ext: 708, telnum
79261234567},
{“name”:”mike”,”realName”:”Семенов Михаил”, ext: 702},
{“name”:”serg”,”realName”:”Чижиков Сергей”, ext: 708}
]
Ok
400 { error: “Invalid parameters” } Переданы некорректные параметры
401 { error: “Invalid token” } Передан неверный ключ (token)

Команда groups (GET / POST)
CRM получает список всех отделов из Облачной АТС или список отделов, в которые входит указанный сотрудник – Всегда подключено!
Запрос от CRM к Облачной АТС для получения отделов. Команда доступна сразу после включения API.

Входные параметры:

Имя Описание Тип/формат данных Обязательный параметр
cmd тип операции, в данном случае groups string да
user сотрудник Облачной АТС TELCOM string нет
token ключ (token) Облачной АТС TELCOM, полученный в веб-кабинете string да

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

POST https://domain/sys/crm_api.wcgp
cmd=groups
user=u1
token=5f317b9f-e86c-41f7-a6fc-c76eb0da0000

Выходные данные:

Код Содержание Описание
200 [
{“id”:”sales”,”realName”:”Отдел продаж”, ext: 701},
{“id”:”gr001″,”realName”:”Бухгалтерия”, ext: 705},
]
Список отделов
400 { error: “Invalid parameters” } Переданы некорректные параметры
401 { error: “Invalid token” } Передан неверный ключ (token)

Входные параметры:

Имя Описание Тип/формат данных Обязательный параметр
cmd тип операции, в данном случае groups string да
user сотрудник Облачной АТС TELCOM string нет
token ключ (token) Облачной АТС TELCOM, полученный в веб-кабинете string да

Команда makeCall (POST)

Кликом по номеру клиента в CRM совершается исходящий звонок клиенту – Всегда подключено!
Команда необходимая для того, чтобы инициировать звонок от менеджера клиенту. В результате успешного выполнения команды, Облачная АТС TELCOM сделает сначала звонок на телефон менеджера, а потом соединит его с клиентом. Команда может использоваться, например, для звонка по клику на номер клиента в вашей CRM или базе данных. Команда доступна сразу после включения API.

Входные параметры:

Имя Описание Тип/формат данных Обязательный параметр
cmd тип операции, в данном случае makeCall string да
user пользователь Облачной АТС TELCOM, от которого последует звонок (может быть передан логин, внутренний номер или прямой телефонный номер пользователя) string да
token ключ (token) Облачной АТС TELCOM, полученный в веб-кабинете string да

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

POST https://domain/sys/crm_api.wcgp
cmd=makeCall
phone=79101234567
user=andy
token=5f317b9f-e86c-41f7-a6fc-c76eb0da0000

Выходные данные:

Код Содержание Описание
200 CallID Уникальный идентификатор звонка
400 { error: “Invalid parameters” } Переданы некорректные параметры
401 { error: “Invalid token” } Передан неверный ключ (token)

Команда history (GET / POST)

CRM может запросить истории звонков из Облачной АТС TELCOM за нужный период времени. Команда доступна сразу после включения API.

Входные параметры:

Имя Описание Тип/формат данных Обязательный параметр
cmd тип операции, в данном случае history string да
token ключ (token) Облачной АТС TELCOM, полученный в веб-кабинете string да
start начало периода для выгрузки данных
end jокончание периода для выгрузки данных string нет
period период, за который надо выгрузить данные.
Возможные значения:
today – звонки за сегодня
yesterday – звонки за вчера
this_week – звонки за текущую неделю
last_week – звонки за прошедшую неделю
this_month – звонки за текущий месяц
last_month – звонки за прошедший месяц
Если в запросе установлено значение period, выгружаются данные за указанный период,
string нет
type тип звонка:
all – все звонки
in – только входящие
out – только исходящие
missed – только пропущенные
Если не задан, используется all
string нет
limit Результат должен содержать не более, чем limit записей string нет

Значения start и end указываются в UTC, в формате YYYYmmddTHHMMSSZ, где
YYYY – год
mm – месяц
dd – день
HH – часы
MM – минуты
SS – секунды
T – разделитель

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

POST https://domain/sys/crm_api.wcgp
cmd=history
period=today
token=5f317b9f-e86c-41f7-a6fc-c76eb0da0000

Выходные данные:

Код Содержание Описание
200 Значения истории, разделенные запятыми
UID,type,client,account,via,start,wait,duration,record
OK
400 { error: “Invalid parameters” } Переданы некорректные параметры
401 { error: “Invalid token” } Передан неверный ключ (token)

Поля в таблице:

Поле Содержание
UID уникальный идентификатор звонка
type тип вызова: in / out / missed
client номер клиента
account логин сотрудника, который разговаривал с клиентом или имя группы или код: ivr / fax, если звонок не дошел до сотрудника
via номер телефона, через который пришел входящий звонок или АОН для исходящего вызова
start время начала звонка в UTC
wait время ожидания на линии (секунд)
duration длительность разговора (секунд)
record ссылка на запись разговора

Команда subscribeOnCalls (POST)

CRM может включить или выключить прием звонков сотрудником во всех его отделах или конкретном отделе – Всегда подключено!
Запрос от CRM к Облачной АТС TELCOM для включение / выключения приема звонков сотрудником во всех его отделах или конкретном отделе. Может использоваться для того, чтобы временно выключить прием звонков сотрудником во всех его отделах или конкретном отделе. Команда доступна сразу после включения API.

Входные параметры:

Имя Описание Тип/формат данных Обязательный параметр
cmd тип операции, в данном случае subscribeoncalls string да
token ключ (token) Облачной АТС TELCOM, полученный в веб-кабинете string да
user идентификатор пользователя CRM или аккаунт ВАТС, если при авторизации был установлен self_map = true, для которого надо
выключить/включить прием звонков
string да
group_id идентификатор отдела ВАТС, в котором надо выключить/вклю-
чить прием звонков
string нет
status on – чтобы включить прием звонков, off – чтобы выключить прием звонков string да

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

POST https://domain/sys/crm_api.wcgp
cmd=subscribeoncalls
user=ivanov
group_id=sales
status=off
token=5f317b9f-e86c-41f7-a6fc-c76eb0da0000

Выходные данные:

Код Содержание Описание
200 OK
400 { error: “Invalid parameters” } Переданы некорректные параметры
401 { error: “Invalid token” } Передан неверный ключ (token)

Команда subscriptionStatus (GET / POST)

CRM может запросить информацию о том, принимает или не принимает звонки сотрудник в отделе – Всегда подключено!
Запрос от CRM к Облачной АТС TELCOM для проверки факта приема звонков сотрудником в конкретном отделе. Команда доступна сразу после включения API.

Входные параметры:

Имя Описание Тип/формат данных Обязательный параметр
cmd тип операции, в данном случае subscribtionstatus string да
token ключ (token) Облачной АТС TELCOM, полученный в веб-кабинете string да
user идентификатор пользователя CRM или аккаунт ВАТС, если при авторизации был установлен self_map = true, для которого надо
выполнить проверку
string да
group_id идентификатор отдела ВАТС, для которого надо выполнить проверку string да

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

POST https://domain/sys/crm_api.wcgp
cmd=subscribtionstatus
user=ivanov
group_id=sales
token=5f317b9f-e86c-41f7-a6fc-c76eb0da0000

Выходные данные:

Код Содержание Описание
200 { status: “on” | “off” } Состояние подписки
400 { error: “Invalid parameters” } Переданы некорректные параметры
401 { error: “Invalid token” } Передан неверный ключ (token)

Команда set_dnd (POST)

CRM может включить или выключить прием звонков сотрудником (режим do not disturb) – Всегда подключено!
Запрос от CRM к Облачной АТС TELCOM позволяет включить или выключить прием звонков сотрудником Облачной АТС. Команда доступна сразу после включения API.

Входные параметры:

Имя Описание Тип/формат данных Обязательный параметр
cmd тип операции, в данном случае set_dnd string да
token ключ (token) Облачной АТС TELCOM, полученный в веб-кабинете string да
user идентификатор сотрудника Облачной АТС TELCOM string да
state true | false string да

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

POST https://domain/sys/crm_api.wcgp
cmd=set_dnd
user=ivanov
state=true
token=5f317b9f-e86c-41f7-a6fc-c76eb0da0000

Выходные данные:

Код Содержание Описание
200 { } OK
400 { error: “Invalid parameters” } Переданы некорректные параметры
401 { error: “Invalid token” } Передан неверный ключ (token)

Команда get_dnd (POST)
CRM может проверить факт прием звонков сотрудником (включен или выключен режим do not disturb) – Всегда подключено!
Запрос от CRM к Облачной АТС TELCOM позволяет узнать включен или выключен прием звонков сотрудником Облачной АТС. Команда доступна сразу после включения API.

Входные параметры:

Имя Описание Тип/формат данных Обязательный параметр
cmd тип операции, в данном случае get_dnd string да
token ключ (token) Облачной АТС TELCOM, полученный в веб-кабинете string да
user идентификатор сотрудника Облачной АТС TELCOM string да

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

POST https://domain/sys/crm_api.wcgp
cmd=get_dnd
user=ivanov
token=5f317b9f-e86c-41f7-a6fc-c76eb0da0000

Выходные данные:

Код Содержание Описание
200 { state: true | false} Состояние DND
400 { error: “Invalid parameters” } Переданы некорректные параметры
401 { error: “Invalid token” } Передан неверный ключ (token)

На основе имеющихся команд вы можете реализовать в вашей CRM другие полезные функции, например:
– Автоматическое создание нового контакта или лида для каждого пропущенного звонка с неизвестного номера с назначением на старшего менеджера. Это полезно для контроля результатов по работе с пропущенными звонками. Если контакту не перезвонили, он так и останется на старшем менеджере. Старший менеджер всегда увидит такие контакты.
– Автоматическое создание нового контакта или лида для каждого исходящего звонка на неизвестный номер. Позволяет быстро и удобно актуализировать базу контактов в CRM.
– Сохранять историю и записи звонков сотрудников, которые есть в Облачной АТС TELCOM, но их нет в CRM, от лица пользователя CRM по умолчанию, например, от пользователя «все остальные» или «админ». Так вся история звонков и записи разговоров всегда будут в вашей CRM.