В данном разделе описывается работа с методом добавления звонков

Общая информация

При использовании метода добавления звонков, система автоматически находит контакт или компанию с указанным номером телефона, а также все связанные сделки и покупатели и добавляет звонок в одну из них по следующему алгоритму:

• если у контакта/компании есть одна активная сделка и нет связанных покупателей, то звонок будет добавлен в сделку
• если у контакта/компании есть один покупатель и нет активных сделок, то звонок будет добавлен в покупателя
• в случае если у контакта/компании более одной активной сделки/покупателя или связанные сущности отсутствуют, то звонок будет добавлен в карточку контакта/компании
• поиск производится по последним 10 цифрам номера

Добавление звонка

Метод

POST /api/v4/calls

Описание

Данный метод позволяет пакетно добавлять звонки в карточки сущностей.
При добавлении звонков будет использоваться алгоритм описанный выше.
При наличии в аккаунте карточки подходящей под условия алгоритма, звонок будет добавлен мгновенно.
Если сущности с таким номером нет в базе, то звонок добавлен не будет.

Ограничения

Метод доступен в соответствии с правами пользователя.

Заголовок запроса

Content-Type: application/json

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

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

[
  {
    "duration": 10,
    "source": "example_integration",
    "phone": "123123",
    "link": "https://example.com/audio.mp3",
    "direction": "inbound",
    "call_result": "Успешный разговор",
    "call_status": 4,
    "call_responsible": 504141
  }
]

Заголовок типа данных при успешном результате

Content-Type: application/hal+json

Заголовок типа данных при ошибке

Content-Type: application/problem+json

HTTP коды ответа

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

Метод возвращает коллекцию добавленных звонков, рассмотрим ниже свойства свойства звонка.

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

{
    "_total_items": 1,
    "errors": [],
    "_embedded": {
        "calls": [
            {
                "id": 37512063,
                "entity_id": 11070881,
                "entity_type": "contact",
                "account_id": 28805383,
                "request_id": "0",
                "_embedded": {
                    "entity": {
                        "id": 11070881,
                        "_links": {
                            "self": {
                                "href": "https://example.amocrm.ru/api/v4/contacts/11070881"
                            }
                        }
                    }
                }
            }
        ]
    }
}