Справочник ошибок и ответов API
При выполнении некорректного запроса к системе наше API может вернуть код ошибки, в случае же верного запроса, API вернёт ответ. Вы, конечно, уже обрабатывали ответ сервера в ходе отладки своих виджетов или написании скриптов, взаимодействующих с нашей системой. Для Вашего удобства, мы решили систематизировать все возможные ответы и ошибки, отдаваемые нашей системой и разместить их на отдельной странице. Надеемся это облегчит и ускорит интеграцию Ваших проектов с amoCRM.
Ошибки при валидации данных
Если переданные данные не совпадают с теми, что доступны для сущности, запрос вернет HTTP-код 400 Bad Request и массив с параметрами, которые не подошли под условия.
Пример ошибки валидации данных
{
"validation-errors": [
{
"request_id": "0",
"errors": [
{
"code": "NotSupportedChoice",
"path": "custom_fields_values.0.field_id",
"detail": "The value you selected is not a valid choice."
}
]
}
],
"title": "Bad Request",
"type": "https://httpstatus.es/400",
"status": 400,
"detail": "Request validation failed"
}
Ответы при авторизации
Подробнее об авторизации читайте здесь
Код | HTTP код | Описание |
---|---|---|
110 | 401 Unauthorized | Общая ошибка авторизации. Неправильный логин или пароль. |
111 | 401 Unauthorized | Возникает после нескольких неудачных попыток авторизации. В этом случае нужно авторизоваться в аккаунте через браузер, введя код капчи. |
112 | 401 Unauthorized | Возникает, когда пользователь выключен в настройках аккаунта “Пользователи и права” или не состоит в аккаунте. |
113 | 403 Forbidden | Доступ к данному аккаунту запрещён с Вашего IP адреса. Возникает, когда в настройках безопасности аккаунта включена фильтрация доступа к API по “белому списку IP адресов”. |
101 | 401 Unauthorized | Возникает в случае запроса к несуществующему аккаунту (субдомену). |
Ответы при работе с контактами
Подробнее о работе с контактами читайте здесь
Код | Описание |
---|---|
202 | Добавление контактов: нет прав |
203 | Добавление контактов: системная ошибка при работе с дополнительными полями |
205 | Добавление контактов: контакт не создан |
212 | Обновление контактов: контакт не обновлён |
219 | Список контактов: ошибка поиска, повторите запрос позднее |
330 | Добавление/Обновление контактов: количество привязанных сделок слишком большое |
Ответы при работе со сделками
Подробнее о работе со сделками читайте здесь
Код | Описание |
---|---|
330 | Добавление/Обновление сделок: количество привязанных контактов слишком большое |
Ответы при работе с событиями
Подробнее о работе с событиями читайте здесь
Код | Описание |
---|---|
244 | Добавление событий: недостаточно прав для добавления события |
225 | Обновление событий: события не найдены |
Ответы при работе с задачами
Подробнее о работе с задачами читайте здесь
Код | Описание |
---|---|
231 | Обновление задач: задачи не найдены |
233 | Добавление событий: по данному ID элемента не найдены некоторые контакты |
234 | Добавление событий: по данному ID элемента не найдены некоторые сделки |
235 | Добавление задач: не указан тип элемента |
236 | Добавление задач: по данному ID элемента не найдены некоторые контакты |
237 | Добавление задач: по данному ID элемента не найдены некоторые сделки |
244 | Добавление сделок: нет прав. |
Ответы при работе со списками
Подробнее о работе со списками читайте здесь
Код | Описание |
---|---|
244 | Добавление/Обновление/Удаление каталогов: нет прав. |
281 | Каталог не удален: внутренняя ошибка |
282 | Каталог не найден в аккаунте. |
Ответы при работе с элементами каталога
Подробнее о работе с элементами каталога читайте здесь
Код | Описание |
---|---|
203 | Добавление/Обновление элементов каталога: системная ошибка при работе с дополнительными полями |
204 | Добавление/Обновление элементов каталога: дополнительное поле не найдено |
244 | Добавление/Обновление/Удаление элементов каталога: нет прав. |
280 | Добавление элементов каталога: элемент создан. |
282 | Элемент не найден в аккаунте. |
Ответы при работе с покупателями
Подробнее о работе с покупателями читайте здесь
Код | Описание |
---|---|
288 | Недостаточно прав. Доступ запрещен. |
402 | Необходимо оплатить функционал |
425 | Функционал недоступен |
426 | Функционал выключен |
Другие ответы
Ошибки и ответы, не относящиеся к какому-либо конкретному разделу
Код | Описание | Примечание |
---|---|---|
400 | Неверная структура массива передаваемых данных, либо не верные идентификаторы кастомных полей | |
422 | Входящие данные не мог быть обработаны. | |
405 | Запрашиваемый HTTP-метод не поддерживается | |
402 | Подписка закончилась | Вместе с этим ответом отдаётся HTTP код №402 “Payment Required” |
403 | Аккаунт заблокирован, за неоднократное превышение количества запросов в секунду | Вместе с этим ответом отдаётся HTTP код №403 |
429 | Превышено допустимое количество запросов в секунду | Вместе с этим ответом отдаётся HTTP код №429 |
2002 | По вашему запросу ничего не найдено | Вместе с этим ответом отдаётся HTTP код №204 “No Content” |
array(10) { ["last_http_method"]=> string(4) "POST" ["last_method"]=> string(48) "https://sadfsafsdf.amocrm.ru/api/v4/leads" ["last_body"]=> array(1) { [0]=> array(3) { ["name"]=> string(9) "some lead" ["custom_fields_values"]=> array(1) { [0]=> array(3) { ["field_id"]=> int(123) ["field_code"]=> NULL ["values"]=> array(1) { [0]=> array(1) { ["value"]=> string(10) "Текст" } } } } ["request_id"]=> string(1) "0" } } ["last_query_params"]=> array(0) { } ["last_response"]=> string(288) "{"validation-errors":[{"request_id":"0","errors":[{"code":"NotSupportedChoice","path":"custom_fields_values.0.field_id","detail":"The value you selected is not a valid choice."}]}],"title":"Bad Request","type":"https://httpstatus.es/400","status":400,"detail":"Request validation failed"}" ["last_response_code"]=> int(400) ["last_request_id"]=> string(32) "b686fc6990a6aded0d4dec8a6b1f8eb7" ["jquery_call"]=> string(289) " $.ajax({ url: "https://sadfsafsdf.amocrm.ru/api/v4/leads", data: JSON.stringify([{"name":"some lead","custom_fields_values":[{"field_id":123,"field_code":null,"values":[{"value":"Текст"}]}],"request_id":"0"}]), type: "POST", contentType: "application/json" });" ["curl_call"]=> string(260) "curl "https://sadfsafsdf.amocrm.ru/api/v4/leads" -X "POST" -d"0%5Bname%5D=some+lead&0%5Bcustom_fields_values%5D%5B0%5D%5Bfield_id%5D=123&0%5Bcustom_fields_values%5D%5B0%5D%5Bvalues%5D%5B0%5D%5Bvalue%5D=%D0%A2%D0%B5%D0%BA%D1%81%D1%82&0%5Brequest_id%5D=0"" ["timestamp"]=> int(1591913949) }
В amoCRM мы выделяем три основные и одну дополнительную сущности. Основные — контакт, компания b сделка, дополнительная — задача.
Работа должна вестись от сделки, а не от контакта, как это происходит в большинстве компаний.
ᅠ
Привет, на связи WEB-Regata. В этой статье мы расскажем вам о 10 ошибках при самостоятельном внедрении amoCRM.
Главная проблема — отсутствие системы. И если мы говорим о внедрении CRM-системы, то всех сотрудников отдела продаж нам нужно объединить в образованную систему, в голове которой находится CRM, затем почта, сайт и иные коммуникации с потенциальным клиентом. Поэтому самое главное в автоматизации процесса продаж — наличие системы и методологии.
ᅠ
Проблема эффективности отдела продаж.
ᅠ
При работе в CRM-системе не терять коммуникации с клиентом позволяет работа с задачами.
Во время аудитов у наших клиентов мы часто видим сделки без задач — такие сделки мы потенциально считаем потерянными. Отсутствие «памяти» — напоминаний — приводит к тому, что задачи по сделке не выполнены, а сделка упущена.
ᅠ
Сделки с просроченными задачами — нарушение договоренности с клиентом. Следовательно, потеря лояльности клиента.
ᅠ
Один из самых сложных моментов в работе связан с интеграциями , зачастую во время аудита именно этот этап вызывает множество вопросов и проблем у клиента.
ᅠ
Ваша база данных зачастую превращается в помойку.
ᅠ
Самая большая ошибка, связанная с человеческим фактором — коммуникации не ведутся в CRM. Используются личные телефоны и почта, коммуникации не отображены в системе. Коммуникации, не отображенные в системе, приводят к тому, что сделка не ведется по воронке продаж. Также крайне важно оставлять примечания к задачам и в сделках — примечания позволяют понимать контекст сделки и не забывать о важных деталях коммуникации с клиентом.
ᅠ
Доступ к системе и сделкам — большая боль многих клиентов. Мы часто обращаем на это внимание, потому что доступы — это очень важный момент, и наша задача, чтобы система всегда была наполнена нужными и важными данными, а, например, увольняющийся менеджер, не имел возможности «забрать» наработанную базу клиентов.
ᅠ
Автоматизация — основа функционала CRM-системы. Это позволяет разгрузить голову менеджера и не беспокоиться о «рутинных» задачах.
ᅠ
Мы хотим напомнить, что CRM — это только инструмент. И если человек, менеджер или руководитель отдела, не захочет работать внутри этой системы — он найдет способ добиться этого. Однако мотивация сотрудников для работы в CRM — попросту разгрузить голову от мелких, часто забываемых задач, иметь возможность опереться на контекст сделки и сделать коммуникацию с клиентом проще.
ᅠ
В видео Антон Сабуров, руководитель WEB-Regata, подробнее рассказал о работе и ошибках при работе в amoCRM.
ᅠ
При выполнении некорректного запроса к системе наше API может вернуть код ошибки, в случае же верного запроса, API вернёт ответ.
Вы, конечно, уже обрабатывали ответ сервера в ходе отладки своих виджетов или написании скриптов, взаимодействующих с нашей системой.
Для Вашего удобства, мы решили систематизировать все возможные ответы и ошибки, отдаваемые нашей системой и разместить их на отдельной странице.
Надеемся это облегчит и ускорит интеграцию Ваших проектов с amoCRM.
Ответы при авторизации
Подробнее об авторизации читайте здесь
CODE | HTTP CODE | ERROR | DESCRIPTION |
---|---|---|---|
110 | 401 Unauthorized | Неправильный логин или пароль | Общая ошибка авторизации. |
111 | 401 Unauthorized | Неправильный код капчи |
Возникает после нескольких неудачных попыток авторизации. В этом случае нужно авторизоваться в аккаунте через браузер, введя код капчи. |
112 | 401 Unauthorized | Пользователь не состоит в данном аккаунте |
Возникает, когда пользователь выключен в настройках аккаунта «Пользователи и права» или не состоит в аккаунте. |
113 | 403 Forbidden | Доступ к данному аккаунту запрещён с Вашего IP адреса |
Возникает, когда в настройках безопасности аккаунта включена фильтрация доступа к API по «белому списку IP адресов». |
101 | 401 Unauthorized | Account not found | Возникает в случае запроса к несуществующему аккаунту (субдомену). |
401 | 401 Not Authorized | 401 Unauthorized | На сервере нет данных аккаунта. Нужно сделать запрос на другой сервер по переданному IP. |
Ответы при работе с аккаунтом
Подробнее о работе с аккаунтом читайте здесь
CODE | DESCRIPTION |
---|---|
101 | Аккаунт не найден |
102 | POST-параметры должны передаваться в формате JSON |
103 | Параметры не переданы |
104 | Запрашиваемый метод API не найден |
Ответы при работе с контактами
Подробнее о работе с контактами читайте здесь
CODE | DESCRIPTION |
---|---|
201 | Добавление контактов: пустой массив |
202 | Добавление контактов: нет прав |
203 | Добавление контактов: системная ошибка при работе с дополнительными полями |
204 | Добавление контактов: дополнительное поле не найдено |
205 | Добавление контактов: контакт не создан |
206 | Добавление/Обновление контактов: пустой запрос |
207 | Добавление/Обновление контактов: неверный запрашиваемый метод |
208 | Обновление контактов: пустой массив |
209 | Обновление контактов: требуются параметры «id» и «last_modified» |
210 | Обновление контактов: системная ошибка при работе с дополнительными полями |
211 | Обновление контактов: дополнительное поле не найдено |
212 | Обновление контактов: контакт не обновлён |
219 | Список контактов: ошибка поиска, повторите запрос позднее |
Ответы при работе со сделками
Подробнее о работе со сделками читайте здесь
CODE | DESCRIPTION |
---|---|
213 | Добавление сделок: пустой массив |
214 | Добавление/Обновление сделок: пустой запрос |
215 | Добавление/Обновление сделок: неверный запрашиваемый метод |
216 | Обновление сделок: пустой массив |
217 | Обновление сделок: требуются параметры «id», «last_modified», «status_id», «name» |
240 | Добавление/Обновление сделок: неверный параметр «id» дополнительного поля |
Ответы при работе с событиями
Подробнее о работе с событиями читайте здесь
CODE | DESCRIPTION |
---|---|
218 | Добавление событий: пустой массив |
221 | Список событий: требуется тип |
222 | Добавление/Обновление событий: пустой запрос |
223 | Добавление/Обновление событий: неверный запрашиваемый метод (GET вместо POST) |
224 | Обновление событий: пустой массив |
225 | Обновление событий: события не найдены |
Ответы при работе с задачами
Подробнее о работе с задачами читайте здесь
CODE | DESCRIPTION |
---|---|
227 | Добавление задач: пустой массив |
228 | Добавление/Обновление задач: пустой запрос |
229 | Добавление/Обновление задач: неверный запрашиваемый метод |
230 | Обновление задач: пустой массив |
231 | Обновление задач: задачи не найдены |
232 | Добавление событий: ID элемента или тип элемента пустые либо неккоректные |
233 | Добавление событий: по данному ID элемента не найдены некоторые контакты |
234 | Добавление событий: по данному ID элемента не найдены некоторые сделки |
235 | Добавление задач: не указан тип элемента |
236 | Добавление задач: по данному ID элемента не найдены некоторые контакты |
237 | Добавление задач: по данному ID элемента не найдены некоторые сделки |
238 | Добавление контактов: отсутствует значение для дополнительного поля |
244 | Добавление сделок: нет прав. |
Другие ответы
Ошибки и ответы, не относящиеся к какому-либо конкретному разделу
CODE | DESCRIPTION | NOTE |
---|---|---|
400 | Неверная структура массива передаваемых данных, либо не верные идентификаторы кастомных полей | |
403 | Аккаунт заблокирован, за неоднократное превышение количества запросов в секунду | Вместе с этим ответом отдаётся HTTP код №403 |
429 | Превышено допустимое количество запросов в секунду | Вместе с этим ответом отдаётся HTTP код №429 |
2002 | По вашему запросу ничего не найдено | Вместе с этим ответом отдаётся HTTP код №204 «No Content» |
Ошибка при подключении почтового ящика к amoCRM
Ошибка при подключении почты к системе может возникнуть по таким причинам:
- вы настроили двухфакторную аутентификацию;
- на сервере не получилось найти папку с отправленными/исходящими сообщениями;
- вы указали неправильную информацию о почтовом сервере.
Ошибки подключения Вконтакте к amoCRM
Чтобы корректно подключить интеграцию с ВК, удостоверьтесь, прописана ли в настройках аккаунта соцсети почта. Если нет, нужно написать правильный e-mail, подтвердить его посредством уведомления, которое придет на почту.
Ошибки подключения Viber к amoCRM
Чтобы подключить «Вайбер», требуется профиль, зарегистрированный по ссылке https://partners.viber.com/. Дальнейший порядок действий будет следующим:
- Кликните по клавише создания бот-аккаунта на левой панели.
- Вам будет предоставлен приватный токен от бот-аккаунта, который нужно копировать.
- Добавьте токен в амоСРМ.
Подключение Telegram к amoCRM
При повторном переподключении в «Телеграм» бота нужно выполнять генерацию нового API. Сделать это возможно в BotFather мессенджера – порядок действий будет таким:
- Выбор бота.
- Выбор команды «Revoke current token».
- Копирование нового токена.
- Подключение бота в амоСРМ.
Ошибки импорта в amoCRM
Выделяют следующие ошибки импорта:
- Лимит данных – файл может не добавиться, если вы достигли либо превысили ограничение по контактам, сделкам, фирмам. Если вы превысили лимит по определенной сущности, система не выполнит загрузку информации.
- Блокировка аккаунта – если в профиле истек срок оплаты либо вы превысили лимиты, ваш личный может быть блокирован. В таком случае загрузка данных не будет осуществлена.
- Размер файла – если файл содержит больше 10 000 загружаемых данных, он будет долго добавляться в систему. Если файл имеет вес больше 2 Мб, загрузка не будет выполнена.
- Нет прав – если вы не имеете права создавать контакты, фирмы, сделки, то импортирование не будет осуществлено.
- Неправильный формат файла – файл не получится загрузить, если он обладает недопустимым форматом. Допускается использовать XLS, XLSX, ODS, CSV.
- Ошибка «Не задано название сделки» – она обусловлена тем, что вы добавляете в профиль информацию по контакту, фирме, сделке, но не прописываете имя. Так, сопоставляя столбцы при импортировании, вы пишете бюджет сделки, однако не указываете ее наименование.
Экспорт закрытых сделок в amoCRM
В базовом функционале закрытые стадии «Успешно реализовано» и «Закрыто и не реализовано» скрыты – по умолчанию отображаются лишь открытые сделки. Для выбора всех стадий требуется:
- Перейти в «Поиск и фильтр».
- Отметить все стадии.
- Кликнуть по 3 точкам, выбрать «Еще».
- Кликнуть по кнопке экспорта.
- После этого у вас появится возможность экспорта любых сделок, которые присутствуют в профиле. Выгрузка осуществляется по 500 сделок за файл. Если у вас более 5 сотен сделок, нужно кликать по цифрам страниц.
Действия при нерабочем амоCRM
К глобальным причинам относят апдейты системы, неполадки у магистрального оператора. К локальным причинам относят ПК пользователя, нарушения работы виджета.
Способы разрешения подобных сложностей со входом:
- Если у вас не получается войти в СРМ-систему, а нарушений интернет-соединения нет – попробуйте перейти в систему посредством зеркал веб-ресурса.
- Если проблема с интернет-соединением – выполните перезагрузку роутера.
- Если по каким-то причинам не подгружается новая информация в CRM-систему, не работает виджет или несколько виджетов – выполните перезагрузку страницы с очисткой кэша. Также можно выключить все виджеты, вписав параметр «?widgets_off=Y» в браузерную строку адреса.
- Если проблема не решается, тогда следует обратиться к интегратору CRM-системы или напрямую в техническую поддержку amoCRM.
Почему за интеграцией Instagram amoCRM лучше обратиться к специалистам “Деломатики”
Поручая проведение технических процедур нам, вы гарантируете себе качественное их выполнение. У нас работают опытные специалисты, которые досконально разбираются во внедрении и настройке амоСРМ. Кроме того, мы оказываем свои услуги по демократичным расценкам, поэтому они максимально доступны.