Справочник ошибок и ответов 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” |
List of API error and API responses
When an incorrect request to the system is executed, our API can return an error code, in the case of the correct query, the API will return a response. You, of course, have already processed the server’s response while debugging your widgets or writing scripts interacting with our system. For your convenience, we decided to systematize all possible answers and errors, given by our system and place them on a separate page. We hope this will facilitate and accelerate the integration of your projects with Kommo.
Responses during authorization
Read more about authorization here
Error code | HTTP code | Description |
---|---|---|
110 | 401 Unauthorized | General authorization error. Incorrect login or password. |
111 | 401 Unauthorized | Occurs after several unsuccessful authorization attempts. In this case, you need to log in to your account through the browser by entering the captcha code. |
112 | 401 Unauthorized | Occurs when the user is turned off in the “Users and Rights” account settings or is not in the account. |
113 | 403 Forbidden | Access to this account is prohibited from your IP address. Occurs when the filtering of access to the API by the “whitelist of IP addresses” is enabled in the account security settings. |
101 | 401 Unauthorized | Occurs in the case of a request to a non-existent account (subdomain). |
401 | 401 Unauthorized | Not Authorized. There is no account information on the server. You need to make a request to another server on the transmitted IP. |
Responses while working with your account
For more information about working with your account, click here
Code | Description |
---|---|
101 | No account found |
102 | POST parameters must be sent in JSON format |
103 | Parameters not passed |
104 | The requested API method was not found |
Responses when working with contacts
For more information about working with contacts, click here.
Code | Description |
---|---|
201 | Adding Contacts: An Empty Array |
202 | Adding contacts: no rights |
203 | Adding contacts: system error when working with additional fields |
204 | Adding contacts: additional field not found |
205 | Adding contacts: no contact created |
206 | Add / Update contacts: empty query |
207 | Adding / Updating contacts: invalid method requested |
208 | Updating contacts: an empty array |
209 | Updating contacts: “id” and “updated_at” parameters are required |
210 | Updating contacts: system error when working with additional fields |
211 | Updating contacts: additional field not found |
212 | Updating contacts: contact not updated |
219 | Contact list: Search error, retry the request later |
Response when dealing with lead
More information about dealing with lead read here
Code | Description |
---|---|
213 | Adding Leads: An Empty Array |
214 | Adding / Updating deals: empty request |
215 | Adding / Updating leads: invalid method requested |
216 | Updating leads: empty array |
217 | Updating leads: the parameters “id”, “updated_at”, “status_id”, “name” ‘are required |
240 | Adding / Updating leads: invalid parameter “id” of an additional field |
Responses when working with events
Read more about working with events here
Code | Description |
---|---|
218 | Adding events: empty array |
221 | Event list: type required |
226 | Adding events: an event element of this entity could not be found |
244 | Adding events: insufficient rights to add an event |
222 | Adding / Updating Events: Empty request |
223 | Add / Update events: invalid method requested (GET instead of POST) |
224 | Event update: empty array |
225 | Event updates: no events found |
Responses when working with tasks
Read more about working with tasks here
Code | Description |
---|---|
227 | Adding Tasks: An Empty Array |
228 | Add / Update tasks: empty query |
229 | Adding / Updating Tasks: Invalid Method Requested |
230 | Updating tasks: an empty array |
231 | Update tasks: No tasks found |
232 | Adding events: The item ID or item type is empty or not valid |
233 | Adding events: some contacts have not been found for this item ID |
234 | Adding events: some transactions have not been found for this item ID |
235 | Adding Tasks: no element type specified |
236 | Adding Tasks: No contacts found for this Item ID |
237 | Adding Tasks: Some transactions were not found for this Item ID |
238 | Adding contacts: Missing value for additional field |
244 | Adding transactions: no rights. |
Responses when working with directories
Read more about working with directories here.
Code | Description |
---|---|
405 | Request Transfer Method Invalid |
222 | Adding / Updating / Deleting directories: an empty query |
244 | Adding / Updating / Deleting directories: No permissions. |
281 | Directory not deleted: internal error |
282 | The directory was not found in the account. |
283 | Invalid request, data not sent. |
284 | Invalid request, no array sent. |
285 | Required field not passed. |
Responses when working with directory elements
For more information about working with directory elements, see here
Code | Description |
---|---|
405 | Request Transfer Method is Invalid |
203 | Adding / Updating Directory Items: System Error with Custom Fields |
204 | Adding / Updating Directory Items: An additional field was not found |
222 | Adding / Updating / Deleting directory items: an empty request |
244 | Adding / Updating / Deleting directory items: insufficient rights |
280 | Adding directory items: element created. |
282 | Item not found in account. |
283 | Invalid request, data not sent. |
284 | Invalid request, no array passed. |
285 | Required field not submitted. |
Responses when working with customers
For more information about working with customers, see here
Code | Description |
---|---|
288 | Insufficient rights. Access is denied. |
402 | It is necessary to pay for the functional. |
425 | Functionality is not available. |
426 | Functionality is disabled. |
Other Responses
Errors and responses that do not relate to any particular section
Code | Description | Note |
---|---|---|
400 | Wrong structure of the array of transmitted data, or invalid identifiers of custom fields | |
402 | Subscription has ended | With this reply, you receive a HTTP code #402 “Payment Required” |
403 | The account is blocked, for repeatedly exceeding the number of requests per second. | Together with this response, HTTP code #403 |
429 | The number of requests per second exceeded | With the response, the HTTP code #429 is sent |
2002 | There are no results for your search | At the same time HTTP code #204 “No Content” is given with this response. |
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.
Already on GitHub?
Sign in
to your account
Closed
makeroi opened this issue
Jan 16, 2021
· 7 comments
Closed
Повторная отправка хука
#226
makeroi opened this issue
Jan 16, 2021
· 7 comments
Comments
Не совсем понимаю, куда писать — поддержка упорно молчит, может быть через вас возможно
Проблема в том, бывают ситуации, когда хук не словлен. Не очень часто, тем не менее.
Возможен ли функционал с отправкой повторных вебхуков через минут, две, десять… если хук не был обработан?
Если на хук не был отдан ответ с http кодом 200-299, то мы попробуем отправить его еще раз через некоторое время
Copy link
Contributor
Author
Этого нигде в документации не описано. Попробовал воспроизвести — в течение часа повторного не получил (отвечал 500 кодом). Через какое время приходит повторный?
Параметры повторной отправки описаны в документации. Самый низ страницы.
Но похоже есть ситуации когда хуки просто не оправляются. Мы сейчас расследуем в своём проекте ситуацию, когда хуки «пропадают». Есть отдельные хуки на изменение сделки и статуса сделки. Так вот хуки изменения статуса сделки не всегда приходят, а судя по логам хука на изменение сделки были срабатывания на изменения статуса. Непонятно обязуется ли AmoCRM присылать хуки по всем изменениями (даже если они были внутри секунды) или хуки только по снепшотам губо говоря за минуту-две
На прошлой неделе отгружали переработку части сервиса хуков. Количество «потерянных» хуков приблизилось к нулю. Теперь могут теряться только при падении сервиса, но такое возможно только при глобальной аварии.
Хуки уходят от нас по всем изменениям, могут быть какие-то кейсы, можно прям с ними в тп, тп проверит на тестовых аккаунтах и если воспроизводится зафиксирует ошибку
По повторным отправкам ситуация хуже, часто задержки составляют сильно больше заявленных в документации. Задача на оптимизацию этого момента есть, но пока не в работе
Copy link
Contributor
Author
@bessudnov Можно ли в хуке передавать номер попытки? (Для отслеживания частоты не переданных хуков)
Возможно даже как то отображать в интерфейсе црм лог отправленных хуков (в т.ч из диджитал пайплайн)?
Лога точно не планируется в ближайшее время
А вот по номеру попытки записал в бэклог, хорошая идея
Issue закрываю, так как тут всё-таки не поддержка amoCRM, а скорее вопросы и обсуждения именно по библиотеке
Текст ошибки |
Описание |
---|---|
403 Forbidden |
Доступ к аккаунту {{XXXX}} запрещён с Вашего IP адреса. Возникает, когда в настройках безопасности аккаунта включена фильтрация доступа к API по «белому списку IP адресов». Если вы не используете «белый список IP адресов», то обратитесь в службу поддержки AmoCRM. |
Admin access only. Please perform the integration under Administrator account to get full api access to account {{XXXX}}. |
Недостаточно прав для аккаунта {{XXXX}}. Подключите интеграцию под аккаунтом Администратора |
Subscription has ended. It is necessary to pay for the functional |
Означает, что закончилась подписка на сервис. Необходимо оплатить подписку на amoCRM |
«title»:»Bad Request»,»type»:»https://httpstatus.es/400″,»status»:400,»detail»:»Код ошибки 205. В случае повторного возникновения ошибки, обращайтесь в нашу техническую поддержку — [email protected]» |
Означает, что были превышены лимиты по контактам и компаниям. Необходимо удалить лишние контакты |
Содержание
- Server error occurred amocrm
- Ошибки импорта
- Ошибки при отправке и подключении почты
- Server error occurred amocrm
- Ошибки при валидации данных
- Пример ошибки валидации данных
- Ответы при авторизации
- Ответы при работе с контактами
- Ответы при работе со сделками
- Ответы при работе с событиями
- Ответы при работе с задачами
- Ответы при работе со списками
- Ответы при работе с элементами каталога
- Ответы при работе с покупателями
- Другие ответы
- Зачем нужно интегрировать электронную почту и amoCRM
- Интеграция почтового ящика штатными средствами Amo
- Подключение почтового ящика к amoCRM
- Переписка по e-mail в amoCRM
- Различия корпоративной и персональной почты при подключении к amoCRM
- Как создать шаблон письма в amoCRM
- Автообработка писем в amoCRM
- Типичные ошибки подключения почты к amoCRM
- Почему за внедрением и настройкой amoCRM “под ключ” лучше обращаться к профессионалам
Server error occurred amocrm
Блог AlarmCRM → Что делать если amoCRM не работает?
Что делать если amoCRM не работает?
Вы пытаетесь выполнить привычный вход в систему или воспользоваться функционалом какого-то виджета, но ничего не происходит или возникает ошибка. Проблема может быть только у вас или у ваших коллег одновременно. CRM-система время от времени может не работать и это нормально. К этому стоит быть готовым. Причины, по которым это может произойти бывают разные:
- Глобальные: обновления amoCRM или проблемы у магистрального провайдера;
- Локальные: компьютер пользователя, ошибка виджета.
Давайте рассмотрим пути решения данных проблем.
Если вы не можете войти в CRM-систему, а проблем с интернет-соединением нет, то в первую очередь нужно проверить вход в систему через зеркала сайта.
Например, войти в amoCRM можно при помощи двух зеркал сайта:
— https://вашсубдомен.z1.amocrm.ru
— https://вашсубдомен.z2.amocrm.ru
Браузер может ругаться на не валидный SSL сертификат — это норма, т.к. эти адреса используются в крайних случаях. Для работы достаточно подтвердить переход на сайт.
Источник
Ошибки импорта
Вам нужно проверить, правильно ли были сопоставлены столбцы, содержащие номера телефонов в вашем файле и поля в аккаунте при импорте. Если вы указали все верно, напишите, пожалуйста, нам в чат технической поддержки – слева сверху картинка (аватарка) – снизу будет синяя кнопка «Обратиться за поддержкой» и пришлите часть файла для тестирования.
Ошибка: “не задано название сделки/имя контакта/название компании”
Это связано с тем, что вы загружаете в аккаунт данные по контакту, компании или сделке, но не указываете имя. Например, при сопоставлении столбцов во время импорта, вы указываете бюджет сделки, но название этой сделки не указано. В этом случае появится данная ошибка.
Ошибка: «загружаемый файл имеет недопустимый формат»
Это связано с тем, что вы загружаете пустой или поврежденный файл.
Ошибка при повторной загрузке файла: «файл уже был добавлен в очередь»
Ошибка появляется, если вы загружаете файл, который уже загружается в ваш аккаунт.
Ошибка при пустых строках в файле
Система после импорта отобразит ошибку и не проимпортирует эту строчку или же просто проигнорирует ее. Например, в нашем файле 2 контакта. Однако, в 4 и в 6 строчке указан текст, который ни к чему не относится, а 5 строка полностью пустая. Система импортировала 2 контакта, а из-за строк 4,5 и 6 выдала ошибку, потому что они либо пустые, либо в них не указаны имена контактов.
Для решения этой ошибки нужно направить запрос в чат технической поддержки из аккаунта: нажать сверху слева на картинку (аватарку), снизу будет синяя кнопка «Обратиться за поддержкой». В запросе указать:
Домен(id) вашего аккаунта; Время возникновения ошибки; Скриншот ошибки; Размер файла. Мы проверим причину возникновения данной ошибки.
Сообщение «Импорт поставлен в очередь»
Такое сообщение система может отобразить, если в данный момент большая нагрузка на сервер. В этом случае в течение нескольких минут файл будет импортирован.
Импорт завершен некорректно. Не загрузились примечания к контактам.
Вам нужно проверить, созданы ли столбцы примечаний в вашем файле, было ли сопоставление столбца файла и поля аккаунта при импорте.
Если вы указали все верно, напишите нам в чат технической поддержки – слева сверху картинка (аватарка) – снизу будет синяя кнопка «Обратиться за поддержкой» и пришлите часть файла для тестирования.
Ошибка:Server error occurred
Вероятно, произошла ошибка в загрузке файла. Попробуйте разделить файл на несколько частей.
Источник
Ошибки при отправке и подключении почты
Ошибка: Подозрение на спам
Данная ошибка означает, что при попытке отправки письма. Отправка была отклонена почтовым сервером, с ошибкой «Подозрение на спам». Для выяснения причины такой ошибки, необходимо обратиться в поддержку сервиса почты, более подробной информации нам не поступает. У нас появляется только сама причина отказа отправки письма.
При отправки письма напрямую из почты происходит без ошибок.
Это происходит из-за того, что вы отправляете напрямую, через почтовый сервис. В случае отправки из amoCRM мы выступаем интеграцией, так как мы отправляем письма на ваш сервер, и дальше идет отправка уже с него.
Не отправлено: Ошибка авторизации. Повторить.
Возможно вы изменяли пароль. Для повторного подключения почты, вам необходимо:
- Зайти в раздел «Почта»;
- Справа вверху нажать на «Еще»;
- Выбрать нужный ящик;
- Нажать отключить почту (письма не удалять).
После вам нужно обратно подключить ящик:
- Авторизация проходила по логину и пароль, тогда вам нужно нажать «Включить» и ввести пароль повторно.
- Авторизация проходила по OAuth, тогда вам нужно нажать «Включить» вас перенесет на страницу разрешения доступа, нажать «Разрешить». (вы должны быть авторизованы на сайте под своим логином и паролем).
Ошибка «Недостаточно прав» при отправке письма.
Этот статус свидетельствует о том что по правилам SMTP сервера клиента от этого имени (подключенного ящика в amoCRM) отправлять нельзя и для выяснения причин, необходимо обратиться к администратору сервера почты.
- Незаконченная регистрация в почтовике (для работы необходимо предварительно ответить на некоторые регистрационные вопросы и принять лицензионное соглашение в почтовом сервере);
- На сервере проверяется IP адреса и авторизационная информация. В таком случае вам нужно внести наши IP адреса в список разрешенных. Так как все адреса являются динамическими, мы не имеем возможности предоставить данную информацию, однако ваши системные администраторы смогут вычислять актуальные IP-адреса и добавлять их в белый список.
Письмо не отправлено: некорректный адрес получателя.
- Проверьте, пожалуйста, корректность введенного адреса (возможно одна из букв в имени ящика получателя указана на кириллице). Перепишите электронный адрес получателя вручную. ;
- Попробуйте зайдите, в почтовый ящик (не из amoCRM и не из почтового клиента) с сайта (сервера) почты и отправьте несколько тестовых писем.
Время ожидания сервера при получении списка папок истекло. Ошибка соединения.
Возможно неверно указан пароль или необходимы дополнительные данные авторизации. Их вы можете запросить у вашего системного администратора.
Возникли проблемы с подключением ящика, проверьте настройки почты.
Эта ошибка может появиться по нескольким причинам:
- Возможно у вас настроена двухфакторная аутентификация;
- Не найдена папка “Отправленные/Исходящие” на сервере;
- Указаны неверные данные сервера почты.
Не найдена папка “Исходящие”. Папка “Отправленные” отсутствует.
Такая ошибка после подключения ящика, может появляться:
- На вашем хостинге не создана папка «Отправленные», вам нужно ее создать и попробовать переподключить ящик;
- Нужно войти в почту (напрямую с хостинга, не через почтовую программу) и отправить пару писем.
Нет кнопки прикрепить к сделке/создать сделку.
- возможно у вас закончилось действие аккаунта;
- проверить настройки прав у пользователя, возможно у него нет прав на «Создание».
Если возникнут сложности, напишите в чат технической поддержки (картинка слева сверху – синяя кнопка «Обратиться за поддержкой»).
Кнопка «Отправить» не активна.
Для того, чтобы была возможность отправить письмо:
- Должен быть выбран ящик отправителя (который интегрирован в amoCRM);
- Должна быть заполнена тема письма;
- Должен быть заполнен текст письма;
- Правильно ли введена почта получателя в карточке (перепечатайте ее вручную).
Неверные данные сервера
После нажатия на кнопку «Сохранить», поля настроек отмечены красным цветом. Данная ошибка означает, что при подключении используются неверные настройки почтового сервера.
- Правильно ли вводится пароль, попробуйте перепроверить пароль заново (зайдите в другом браузереинкогнито — введите email и пароль вручную или напишите пароль в «Блокноте» и скопируйте его в поле (без пробелов);
- Если ящик находится на другом провайдере менее крупном, как к примеру Gmail, Outlook, Yandex, Mail и другие. Попробовать подключить данный почтовый ящик, через почтовый клиент (Outlook, Thunderbird и прочие). Нужно уточнить правильные параметры подключения у системного администратора или у самого провайдера/хостера.
Если возникнут сложности при подключении, напишите в чат технической поддержки (картинка слева сверху – синяя кнопка «Обратиться за поддержкой».
Источник
Server error occurred amocrm
При выполнении некорректного запроса к системе наше API может вернуть код ошибки, в случае же верного запроса, API вернёт ответ. Вы, конечно, уже обрабатывали ответ сервера в ходе отладки своих виджетов или написании скриптов, взаимодействующих с нашей системой. Для Вашего удобства, мы решили систематизировать все возможные ответы и ошибки, отдаваемые нашей системой и разместить их на отдельной странице. Надеемся это облегчит и ускорит интеграцию Ваших проектов с amoCRM.
Ошибки при валидации данных
Если переданные данные не совпадают с теми, что доступны для сущности, запрос вернет HTTP-код 400 Bad Request и массив с параметрами, которые не подошли под условия.
Пример ошибки валидации данных
Ответы при авторизации
Подробнее об авторизации читайте здесь
Код | 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 | Функционал выключен |
Другие ответы
Ошибки и ответы, не относящиеся к какому-либо конкретному разделу
Источник
Зачем нужно интегрировать электронную почту и amoCRM
Электронная почта изначально создавалась как средство коммуникации для американских военных, а широкое распространение получила только в середине девяностых. С тех пор технологии столь стремительно развивались, что теперь многим людям идея общаться через е-мейл кажется чем-то вроде обмена посланиями на почтовых голубях. И все-таки, когда речь идет о бизнесе, а не о личной переписке, свои договоренности лучше подтверждать письмами.
Даже если вам удобно общаться с клиентами через мессенджеры, самые важные этапы переговоров стоит закрепить в письмах:
- правки ТЗ;
- смета;
- финальный вариант договора;
- сроки оплаты, скидки и другие финансовые обязательства.
Переписка через почту позволяет легче разобраться в любых неоднозначных и спорных ситуациях. А еще отправленное на е-мейл нельзя стереть у собеседника, в отличие от сообщений в мессенджерах.
Если в вашей компании уже внедрена CRM или вы планируете заказать внедрение amoCRM и cейчас размышляете, с какими сервисами ее придется интегрировать, обязательно подключите корпоративную почту к Amo. Для корректной работы CRM необходимо, чтобы в систему попадали сообщения из всех каналов связи с клиентами — особенно из такого важного, как почта.
Интеграция почтового ящика штатными средствами Amo
Штатное подключение почтового ящика к amoCRM осуществляется в несколько кликов. Если Вы когда-либо настраивали переадресацию с одного е-мейла на другой, то легко сделаете такую интеграцию своими руками. В своем аккаунте Amo откройте раздел “Еще”, выберите “Подключить почтовый ящик”. Введите е-мейл, который собираетесь подключить и пароль от него. В самом почтовом ящике (туда система перенаправит Вас на следующем этапе) необходимо будет подтвердить, что интеграцию делает владелец аккаунта.
Подключение почтового ящика к amoCRM
На финальном этапе подключения почтового ящика к amoCRM необходимо выбрать, персональный или корпоративный е-мейл вы интегрируете. По умолчанию персональный почтовый ящик предполагает доступ только своего владельца, а корпоративный — всех сотрудников. Но вы можете изменить настройки и дать доступ к персональной переписке и администратору аккаунта, и коллегам, если в этом есть необходимость.
Не забудьте отметить галочкой “автоматическое создание контактов”. Это очень полезная функция — для новых е-мейлов, с которыми ведется рабочая переписка, в системе будут создаваться карточки “контакт” с данными этих клиентов. Если контакт с таким е-мейлом уже существует в базе, переписка будет подтягиваться к нему.
Переписка по e-mail в amoCRM
После подключения электронной почты к системе Amo вы сможете вести деловую переписку прямо из CRM. Правда, есть и некоторые ограничения и нюансы, о которых не стоит забывать:
- Синхронизация е-мейла и amoCRM происходит раз в 15-30 минут, новые письма поступают в Amo автоматически. Если вы срочно ждете важное письмо, имеет смысл обновлять систему вручную (для этого откройте раздел “Почта”, выберите нужный е-мейл и нажмите кнопочку “обновить” в правом верхнем углу);
- В amoCRM обрабатываются только письма из папок “Входящие” и “Отправленные”, другие папки подключить нельзя.
- В amoCRM невозможно пересылать письма или отправлять письма нескольким адресатам (в том числе отправлять копии);
- Также недоступна такая привычная функция, как поиск по переписке.
При необходимости поиска определенного письма, отправки копий или писем нескольким адресатам придется вручную открыть свой почтовый сервис и совершить эти действия там, а не через Amo.
Различия корпоративной и персональной почты при подключении к amoCRM
Современные компании обычно используют общую корпоративную почту, а также создают персональные е-мейлы сотрудникам на корпоративном домене. При этом рабочую почту персональной можно назвать с определенной долей условности, ведь с нее ведется рабочая, а не личная переписка.
Обычно заявки от новых клиентов приходят на корпоративную почту. В аккаунте Amo администратор может выбрать, каким именно сотрудникам дать доступ к письмам, поступающим на общую, корпоративную почту. Для этого необходимо открыть вкладку “Пользователи” в разделе “Настройки” и отметить галочкой пункт “Почта” у тех сотрудников, которым вы хотите дать к доступ к корпоративному е-мейлу.
По умолчанию любое письмо, приходящее на корпоративную почту (если она подключена к amoCRM) — это новая сделка на этапе “Неразобранное” в главной воронке. В карточку сделки подтянется имя и е-мейл отправителя, а также само письмо.
По желанию можно поменять настройки — например, чтобы сделки, открытые заявкой с е-мейла отправлялись не в главную, а в другую воронку или на определенный ее этап (для настройки надо открыть вкладку “Настройки” в разделе “Сделки” и выбрать “Добавить источник”). Также возможно создавать сделки не сразу на каждое входящее письмо от нового адресата, а только на этапе ответа потенциальному клиенту (для этого поставьте галочку в поле “Автоматически создавать сделки при ответе клиенту”).
Свой личный е-мейл к amoCRM может добавить любой пользователь этой платформы. Только этот человек сможет отправлять письма со своего персонального е-мейла через Amo, а вот доступ на просмотр своей рабочей переписки он может предоставить администратору (для этого необходимо нажать соответствующую галочку в настройках, “Доступно администратору”) и другим коллегам. Чтобы дать доступ к определенному письму из своей переписки другим сотрудникам компании, нужно поменять настройки в разделе “Сделки”, нажав кнопку “Открыть доступ”. Тогда письмо будет доступно всем пользователям, которым доступна эта карточка.
Как создать шаблон письма в amoCRM
Для того, чтобы создавать новые шаблоны писем в amoCRM, нужно обладать правами администратора аккаунта. Нажмите кнопку “Еще” в разделе “Почта” и выбирайте “Добавить шаблон”.Откроется окно, в котором необходимо ввести название шаблона (например: “Коммерческое предложение” или “Презентация”), тему письма (в отличие от названия шаблона, которая предназначена для внутреннего пользования, тему увидят адресаты письма), шаблонный текст сообщения, по желанию — прикрепить файлы. Учтите, что на все вложения действует ограничение — 20 Мб.
Используя специальные маркеры, в шаблоне можно оставить несколько полей, которые будут изменяться в зависимости от личности адресата и отправителя — имя получателя письма, имя отправителя, номер телефона отправителя.
Автообработка писем в amoCRM
Автообработка писем — важнейшая функция amoCRM, она позволяет распознавать определенные части текста из письма, и подтягивать их на соответствующие этапы подходящей воронки продаж.
Для настройки парсинга (автообработки писем) необходимо зайти в “Цифровую воронку” (воронка Digital). Обратите внимание, что работа с цифровой воронкой доступна только для тарифных планов “Расширенный” и “Профессиональный” (и не доступна в “Базовом” тарифном плане, а также для пользователей пакета “Старт-Ап” и “Микро-Бизнес”). Если тарифный план позволяет, откройте в цифровой воронке “Настройки” раздела “Сделки” и выберите среди инструментов “Автообработку писем”. Дальнейшие настройки осуществляются в четыре этапа:
- Исходя из выбранной почтовой службы (mail.ru, yandex и тд) вы получаете соответствующую инструкцию настройки.
- Осуществив настройку по инструкции, нажимаете “Далее” и получаете письмо со ссылкой на указанный ранее е-мейл.
- Выбираете типовое письмо и шаблон, по которому такие письма должны обрабатываться.
- Выделяете в письме значения, которые должны подтягиваться в карточку сделки, компании или контакта. На этом этапе также можно настроить нужные тэги, статус письма и менеджера, ответственного за новую сделку.
При всех очевидных плюсах автообработки писем в CRM, не стоит умалчивать о большом минусе — во время парсинга может возникнуть много дублей. Дублирующие заявки засоряют систему, мешают не только эффективной работе менеджеров, но и качественной аналитике. Чтобы этого не произошло, обращайтесь к профессионалам по внедрению CRM, таким, как “Деломатика”. Мы можем прописать для Вас специальный скрипт, выявляющий и склеивающий дубли при автообработке писем.
Типичные ошибки подключения почты к amoCRM
При самостоятельной интеграции почты и amoCRM часто возникают такие типичные ошибки:
Причиной ошибки авторизации может стать банальная смена пароля. Если Вы или другой сотрудники меняли пароль от рабочей почты, придется подключать ее к Amo повторно! Для этого сначала в разделе “Почта” надо отключить этот е-мейл (только не удаляйте при этом письма!), а затем заново включить этот е-мейл, но уже с новым паролем.
Причины, по которым письма не отправляются, могут быть самыми разнообразными. Одна из самых распространенных — у сотрудника нет соответствующих прав. Возможно, Вы не завершили регистрацию в почтовике, или ваш сервер сверяет отправителя по IP, а они не совпали.
Перед отправкой письма убедитесь, что “тема” и “тело” письма заполнены — amoCRM не позволяет отправлять письма с пустой темой и пустым полем текста.
Поскольку amoCRM не работает с адресами, написанными кириллицей, проверьте корректность введенного е-мейла адресата, не копируя его из заявки, а набрав вручную.
- Проблемы с подключением ящика
Чаще всего проблемы с подключением е-мейла к Амо возникают, когда на почте установлена двухфакторная идентификация. Но возможен и человеческий фактор: убедитесь, что корректно ввели все данные, включая адрес своей почты, при настройке.
Почему за внедрением и настройкой amoCRM “под ключ” лучше обращаться к профессионалам
90% негативных отзывов о CRM связаны с тем, что на установке сэкономили — искали варианты, как интегрировать систему дешево, а в идеале вообще бесплатно, силами собственных сотрудников. Лучше так не рисковать, ведь грамотно внедренная amoCRM повысит продажи, а система, внедренная с ошибками, принесет убытки, недовольство менеджеров и клиентов. Поэтому обращайтесь за внедрением и настройкой amoCRM “под ключ” к профессионалам!
Мы в “Деломатике” более 3 лет занимаемся внедрением, настройкой и интеграцией CRM-систем. За это время наши программисты и маркетологи реализовали сотни успешных проектов, включая разработку собственных программных решений. Готовы помочь автоматизировать и ваш бизнес!
Источник
Доброй ночи)
Изучаю документацию на AmoCRM https://developers.amocrm.ru/rest_api/tasks_set.php. Проверил код для авторизации и добавления сделки, подставив свои данные все заработало. С добавлением задачи проблема, код их выдает ошибку 0.
Проверил запрос в консоли https://developers.amocrm.ru/console.php через нее добавляет. В код разве что в паре мест фигурные скобки добавил (пропущены были в условиях), тоже в дугих примерах делал. Спасибо за ответы)
<?php
$tasks['request']['tasks']['add']=array(
#Привязываем к сделке
array(
'element_id'=>215413, #ID сделки
'element_type'=>2, #Показываем, что это - сделка, а не контакт
'task_type'=>1, #Звонок
'text'=>'My First Task',
'responsible_user_id'=>1529245,
'complete_till'=>1375285346
)
);
//Теперь подготовим данные, необходимые для запроса к серверу
$subdomain='gvandri21@gmail.com'; #Наш аккаунт - поддомен
#Формируем ссылку для запроса
$link='https://'.$subdomain.'.amocrm.ru/private/api/v2/json/tasks/set';
//Нам необходимо инициировать запрос к серверу. Воспользуемся библиотекой cURL (поставляется в составе PHP). Подробнее о работе с этой библиотекой Вы можете прочитать в мануале.
$curl=curl_init(); #Сохраняем дескриптор сеанса cURL
#Устанавливаем необходимые опции для сеанса cURL
curl_setopt($curl,CURLOPT_RETURNTRANSFER,true);
curl_setopt($curl,CURLOPT_USERAGENT,'amoCRM-API-client/1.0');
curl_setopt($curl,CURLOPT_URL,$link);
curl_setopt($curl,CURLOPT_CUSTOMREQUEST,'POST');
curl_setopt($curl,CURLOPT_POSTFIELDS,json_encode($tasks));
curl_setopt($curl,CURLOPT_HTTPHEADER,array('Content-Type: application/json'));
curl_setopt($curl,CURLOPT_HEADER,false);
curl_setopt($curl,CURLOPT_COOKIEFILE,dirname(__FILE__).'/cookie.txt'); #PHP>5.3.6 dirname(__FILE__) -> __DIR__
curl_setopt($curl,CURLOPT_COOKIEJAR,dirname(__FILE__).'/cookie.txt'); #PHP>5.3.6 dirname(__FILE__) -> __DIR__
curl_setopt($curl,CURLOPT_SSL_VERIFYPEER,0);
curl_setopt($curl,CURLOPT_SSL_VERIFYHOST,0);
$out=curl_exec($curl); #Инициируем запрос к API и сохраняем ответ в переменную
$code=curl_getinfo($curl,CURLINFO_HTTP_CODE);
//Теперь мы можем обработать ответ, полученный от сервера. Это пример. Вы можете обработать данные своим способом.
$code=(int)$code;
$errors=array(
301=>'Moved permanently',
400=>'Bad request',
401=>'Unauthorized',
403=>'Forbidden',
404=>'Not found',
500=>'Internal server error',
502=>'Bad gateway',
503=>'Service unavailable'
);
try
{
#Если код ответа не равен 200 или 204 - возвращаем сообщение об ошибке
if($code!=200 && $code!=204){
throw new Exception(isset($errors[$code]) ? $errors[$code] : 'Undescribed error',$code);
}
}
catch(Exception $E)
{
die('Ошибка: '.$E->getMessage().PHP_EOL.'Код ошибки: '.$E->getCode());
}
/**
* Данные получаем в формате JSON, поэтому, для получения читаемых данных,
* нам придётся перевести ответ в формат, понятный PHP
*/
$Response=json_decode($out,true);
$Response=$Response['response']['tasks']['add'];
$output='ID добавленных задач:'.PHP_EOL;
foreach($Response as $v){
if(is_array($v)){
$output.=$v['id'].PHP_EOL;
}
}
return $output;
Необходимо проверить белый список ip адресов и работоспособность api amoCRM.
1. Убедится что администратор, чьи данные используются для работы виджета, активен.
В случае если белый список включен, необходимо добавить в него ip адреса нашего виджета: 81.88.82.192/26; 81.88.81.0/26; 81.88.82.96/29.
2. В случае если белый список неактивен или адреса уже добавлены, необходимо проверить работоспособность методов API amoCRM используя данные из настроек виджета.
Например выполнив метод получения списка установленных виджетов: https://onemoretest43.amocrm.ru/api/v2/widgets?USER_LOGIN=techsupport@mangotele.com&USER_HASH=d4206942069420694206942069420694206942069
В методе необходимо использовать свои данные то есть:
- https://onemoretest43.amocrm.ru это ваш домен в amoCRM
- USER_LOGIN= techsupport@mangotele.com это Email администратора amoCRM из настроек виджета.
- USER_HASH=d4206942069420694206942069420694206942069 это API ключ amoCRM из настроек виджета.
В случае получения ошибки вида:
Необходимо обратится в техподдержку amoCRM.
Вы нашли ответы на все свои вопросы в данной статье?
Нет
Как можно улучшить эту статью?
Отправить ответ на email?
Предоставляя информацию, вы соглашаетесь с Политикой обработки персональных данных и на получение рекламной информации о продуктах, услугах посредством звонков и рассылок по предоставленным каналам связи
Задайте свой вопрос инженеру в режиме онлайн через мессенджеры или социальную сеть: