API v 2.0
UA | US | RU
|
---|
- 1 Шаблоны сообщений
- 1.2 Сообщения
- 1.3 Каналы коммуникации
- 1.4 LGT
- 1.5 Заказы
- 1.6 Люди
- 1.7 Теги
- 1.7.1 Получить список тегов
- 1.7.2 Удалить тег у человека
- 1.7.3 Добавить тег человеку
- 1.8 Туннели
- 1.9 Пользователи
- 1.10 Получение списка каналов связи
- 1.11 Подписка на туннель и блок туннеля:
Во всех запросах дату необходимо указывать с учетом нулевого часового пояса UTC-0
все запросы должны отправляться в JSON формате
Шаблоны сообщений
Получить список категорий шаблонов сообщений
GET https://api.leeloo.ai/api/v2/categories/templates
IMPORTANT: Pass your auth token in 'X-Leeloo-AuthToken
' header.
Response
"data": {
"categories": [
{
"id": "5e3bf3fdb70492000f72cd6c",
"name": "Category 1"
},
{
"id": "5e18a2a3ed0b7a000d6c948f",
"name": "Category 2"
}
]
},
"status": 1
}
Получить список шаблонов сообщений внутри категории
GET https://api.leeloo.ai/api/v2/categories/templates/{category_id}
Path Paramscategory_id
(example: 5b3f543bb2737000133d25b0) - id категории шаблонов сообщений
IMPORTANT: Pass your auth token in 'X-Leeloo-AuthToken
' header.
Response
{
"data": {
"templates": [
{
"id": "5e42be758d4fff000cafe6ef",
"message_name": "test template 2"
},
{
"id": "5e42be688d4fff000cafe5cc",
"message_name": "test template 1"
}
]
},
"status": 1
}
Отправка шаблона сообщения
POST https://api.leeloo.ai/api/v2/messages/send-template
IMPORTANT: Pass your auth token in 'X-Leeloo-AuthToken
' header.
Request Body(json)account_id
(example: 513f543gb2737020133d25b0) - id канала связиtemplate_id
(example: 6b3f543bb2737003133d25b4) - id шаблона сообщения на платформе
{
"account_id": "5e42be688d4fff000cafe5cc",
“template_id”: “5e42be758d4fff000cafe6ef”
"variables": {
"key1": "value1",
"key2": "value2"
}
}
Response
Сообщения
Получить список сообщений из чата по каналу коммуникации
Запрос
GET https://api.leeloo.ai/api/v2/communication-channels/{person_id}/chat-messages?limit=2&offset=0
Path Paramsperson_id
(example: 5b3f543bb2737000133d25b0) - id канала коммуникации.
IMPORTANT: Pass your auth token in 'X-Leeloo-AuthToken
' header.
Query Paramslimit
- ограничение количества результатов (не рекомендуется выгружать большое количество данных сразу, так как это может замедлить выгрузку данных)offset
- сколько результатов пропустить (по умолчанию 0)
Response
ВАЖНО! Пример ответа на запрос показан для установленого параметра лимита равного двум. При изменении значения параметра лимита будет изменяться и кол-во сообщений в ответе на запрос.
Отправка сообщений
POST https://api.leeloo.ai/api/v2/messages/send-message
IMPORTANT: Pass your auth token in 'X-Leeloo-AuthToken
' header.
Request Body(json)account_id
(example: 5b3f543bb2737000133d25b0) - id канала связиtext
- текст сообщения
Response
Каналы коммуникации
Получить список каналов коммуникации (С внешними UTM-метками)
IMPORTANT: Pass your auth token in 'X-Leeloo-AuthToken
' header.
Query Paramslimit
- ограничение количества результатов (не рекомендуется выгружать большое количество данных сразу, так как это может замедлить выгрузку данных)offset
- сколько результатов пропустить (по умолчанию 0)filter[last_message][from]
- фильтр по последнему сообщению от указанного числа
filter[last_message][to]
- фильтр по последнему сообщению до указанного числа
Response
Получение информации о человеке по каналу коммуникации (получить person id зная параметр account id)
GET https://api.leeloo.ai/api/v2/communication-channels/{account_id}/person
Path Paramsaccount_id
(example: 5b3f543bb2737000133d25b0) - id канала коммуникации
IMPORTANT: Pass your auth token in 'X-Leeloo-AuthToken
' header.
Response
LGT
Создать трафик соурс в ЛГТ
POST https://api.leeloo.ai/api/v2/leadgentools/{leadgentool_id}/create-traffic-source
Path Paramsleadgentool_id
(example: 5b3f543bb2737000133d25b0) - id инструмента лидогенерации
IMPORTANT: Pass your auth token in 'X-Leeloo-AuthToken
' header.
Request Body(json)name
- имя трафик соурсаdescription
- описание трафик соурса
Response
Заказы
Создать ручной ордер
POST https://api.leeloo.ai/api/v2/orders
IMPORTANT: Pass your auth token in 'X-Leeloo-AuthToken
' header.
Request Body(json)paymentCreditsId
(example: 5b3f543bb2737000133d25b2) - id платежной системы. Можно узнать в настройках платформы, раздел с платежными системами.email
- Емаил адрес человекаphone
- телефон человекаtransactionDate
- желаемая дата проведения транзакции (для отображения на платформе) указывается в формате 2020-02-04T11:46:48.803ZofferId
(example: 5b3f543bb2737000133d25b0) - id оффераisNotifyAccount
- сообщать человеку о создании заказа или нет (может быть значение true или false)personId
(example: 5b3f543bb2737000133d25b1) - id человекаmanagerId
(example: 5b3f543bb2737000133d25b0) - id юзера платформи за кем будет закреплен заказ. Опционально. Если не указать конкретного юзера - продажа будет System
Response
Получить список ордеров
GET https://api.leeloo.ai/api/v2/orders?limit=20&offset=0
Query Paramslimit
- ограничение количества результатов (не рекомендуется выгружать большое количество данных сразу, так как это может замедлить выгрузку данных)offset
- скольок результатов пропустить (по умолчанию 0)
IMPORTANT: Pass your auth token in 'X-Leeloo-AuthToken
' header.
Response
Получить информацию по отдельному ордеру
GET https://api.leeloo.ai/api/v2/orders/{order_id}
Path Paramsorder_id
(example: 5b3f543bb2737000133d25b0) - айди конкретного ордера
IMPORTANT: Pass your auth token in 'X-Leeloo-AuthToken
' header.
Response
Обновить информацию в МАНУАЛ (ручном) ордере
Ордер НЕ МОЖЕТ БЫТЬ с частичными оплатами
POST https://api.leeloo.ai/api/v2/orders/{order_id}
Path Paramsorder_id
(example: 5b3f543bb2737000133d25b0) - айди ручного ордера без частичных оплат.
IMPORTANT: Pass your auth token in 'X-Leeloo-AuthToken
' header.
Request Body(form-data)status
example: 'RESOLVED', (one_of: RESOLVED REJECTED)paymentDate
example: '2018-06-27 07:32',currency
example: 'RUB',price
example: '100' (actual price that you receive from account),userComments
example: 'actual date dont match'
Response
Люди
Получить список людей
IMPORTANT: Pass your auth token in 'X-Leeloo-AuthToken
' header.
Query Paramslimit
- ограничение количества результатов (не рекомендуется выгружать большое количество данных сразу, так как это может замедлить выгрузку данных)offset
- скольок результатов пропустить (по умолчанию 0)filter[tags]
- если необходима фильтрация по тегам. Опциональноfilter[last_message]
{ from: 'js_date', to: 'js_date' } - фильтр по дате последнего сообщния. Обязателен.filter[phone]
- фильтр по номеру телефону. Опциональноfilter[email]
- фильтр по емейлу. Опционально
Response
Получить информацию по конкретному человеку
GET https://api.leeloo.ai/api/v2/people/{person_id}?include=contactedUsers,orders
Path Paramsperson_id
(example: 5b3f543bb2737000133d25b0) - id человека на платформе
IMPORTANT: Pass your auth token in 'X-Leeloo-AuthToken
' header.
Response
Обновить информацию в карточке клиента
PUT https://api.leeloo.ai/api/v2/people/{person_id}
Path Paramsperson_id
(example: 5b3f543bb2737000133d25b0) - айди человека.
IMPORTANT: Pass your auth token in 'X-Leeloo-AuthToken
' header.
Request Body(json)
Добавить человека на платформе
POST https://api.leeloo.ai/api/v2/people
IMPORTANT: Pass your auth token in 'X-Leeloo-AuthToken
' header.
Request Body(json)
NOTE: connected_users_ids - is not required
Response
Добавить СМС конекшн к человеку
POST https://api.leeloo.ai/api/v2/people/sms
IMPORTANT: Pass your auth token in 'X-Leeloo-AuthToken
' header.
Request Body(json)
Response
Добавить комментарий к человеку
PUT https://api.leeloo.ai/api/v2/people/{person_id}/add-comment
Path Paramsperson_id
(example: 5b3f543bb2737000133d25b0) - id человека
IMPORTANT: Pass your auth token in 'X-Leeloo-AuthToken
' header.
Request Body(json)
Response
Добавить звонок в акаунт
POST https://api.leeloo.ai/api/v2/calls
IMPORTANT: Pass your auth token in 'X-Leeloo-AuthToken
' header.
Request Body(form-data, all required)user_id
example: ‘5b0d313b307879002915b3cc’from
example: ‘606'to
example: ‘607'date
example: ‘2024-03-22T15:30:17.339Z'account_id
example: '6b0d313b307879002915b3c1’record_link
example: 'https://file-examples.com/storage/2017/11/file_example_MP3_5MG.mp3’ or 'NOT_DEFINED’status
example: 'SUCCESS' (one of: 'TALKING', 'SUCCESS', 'NO_ANSWER', 'CLOSED_BY_SYSTEM')duration
example: '100' (seconds)type
example: INBOUND or OUTBOUND
Response
Теги
Получить список тегов
GEThttps://api.leeloo.ai/api/v2/tags
IMPORTANT: Pass your auth token in 'X-Leeloo-AuthToken
' header.
Response
Удалить тег у человека
PUT https://api.leeloo.ai/api/v2/people/{person_id}/remove-tag
Path Paramsperson_id
(example: 5b3f543bb2737000133d25b0) - айди человека
IMPORTANT: Pass your auth token in 'X-Leeloo-AuthToken
' header.
Request Body(form-data)tag_id
(example: 5b3f543bb2737000133d25b0) - id тега
Response
Добавить тег человеку
PUT https://api.leeloo.ai/api/v2/people/{person_id}/add-tag
Path Paramsperson_id
(example: 5b3f543bb2737000133d25b0) - айди человека
IMPORTANT: Pass your auth token in 'X-Leeloo-AuthToken
' header.
Request Body(form-data)tag_id
(example: 5b3f543bb2737000133d25b0) - id тега
Response
Туннели
Получить список туннелей
GET https://api.leeloo.ai/api/v2/tunnels?limit=20&offset=0
IMPORTANT: Pass your auth token in 'X-Leeloo-AuthToken
' header.
Query Paramslimit
- ограничение количества результатов (не рекомендуется выгружать большое количество данных сразу, так как это может замедлить выгрузку данных)offset
- сколько результатов пропустить (по умолчанию 0)
Response
Получить информацию про туннель
GEThttps://api.leeloo.ai/api/v2/tunnels/{tunnel_id}?include=leadgentools
Path Paramstunnel_id
(example: 5b3f543bb2737000133d25b0) - id тунеля
IMPORTANT: Pass your auth token in 'X-Leeloo-AuthToken
' header.
Response
Получить статистику по всем туннелям
GEThttps://api.leeloo.ai/api/v2/tunnels/stats
IMPORTANT: Pass your auth token in 'X-Leeloo-AuthToken
' header.
Response
Получить статистику по одному туннелю
Запрос
GEThttps://api.leeloo.ai/api/v2/tunnels/{tunnel_id}/stats
Path Paramstunnel_id
(example: 5b3f543bb2737000133d25b0) - id тунеля
IMPORTANT: Pass your auth token in 'X-Leeloo-AuthToken
' header.
Response
Пользователи
Получить список пользователей платформы
GEThttps://api.leeloo.ai/api/v2/users?limit=20&offset=0
IMPORTANT: Pass your auth token in 'X-Leeloo-AuthToken
' header.
Query Paramslimit
- ограничение количества результатовoffset
- сколько результатов пропустить(по умолчанию 0)
Ответ
Получить информацию по конкретному пользователю платформы
GEThttps://api.leeloo.ai/api/v2/users/{user_id}
Path Paramsuser_id
- id пользователя платформы
IMPORTANT: Pass your auth token in 'X-Leeloo-AuthToken
' header.
Response
Получение списка каналов связи
GET https://api.leeloo.ai/api/v2/connections
IMPORTANT: Pass your auth token in 'X-Leeloo-AuthToken
' header.
Response
Подписка на туннель и блок туннеля:
POST https://api.leeloo.ai/api/v2/communication-channels/{account_id}/manual-subscribe
Path Paramsaccount_id
- id канала комуникации которого нужно подписать
IMPORTANT: Pass your auth token in 'X-Leeloo-AuthToken
' header.
Request Body(form-data)tunnel_id
(example: 5b3f543bb2737000133d25b0) - id тунеляtunnel_block_id
(example: 5b3f543bb2737000133d25b0) - id блока в тунеле
Response