API-ключи и отправка сообщений
Что делает. Вкладка «API» в верхнем меню выдаёт ключи доступа к публичному API виджета. С ключом ваша система, например своя CRM или AI-агент, отправляет сообщения в чаты Авито по контакту amoCRM, а на тарифе «Профессиональный» ещё и читает историю переписки и управляет подписками на webhook'и. Что именно разрешено ключу, задают его права.
Как настроить.
- Откройте виджет и в верхнем меню нажмите вкладку «API».
- Введите «Название ключа» — любое, чтобы потом узнать ключ в списке.
- В блоке «Права ключа» отметьте, что ключу можно делать (подробно ниже). По умолчанию отмечены «Чтение чатов» и «Отправка сообщений».
- Нажмите «Создать ключ». Если отмечено право «Управление webhook-подписками», виджет попросит подтвердить: «Выдать право».
- Ключ в формате
ak_…показывается один раз. Нажмите «Копировать», сохраните ключ в надёжном месте и нажмите «Я сохранил, скрыть». - В таблице ниже видно: название, префикс ключа, права, когда создан и когда последний раз использован. Справа кнопки «Изменить права» и «Отозвать».
Права ключа.
| Право | Что разрешает | Тариф |
|---|---|---|
| Чтение чатов | Найти чаты Авито по контакту amoCRM. На «Профессиональном» ещё список всех чатов и чаты сделки | любой |
| Отправка сообщений | Отправлять текст и картинки в чат Авито | любой |
| Чтение истории сообщений | Читать историю переписки чата | «Профессиональный» |
| Управление webhook-подписками | Создавать, менять и удалять подписки на события о сообщениях | «Профессиональный» |
Что выдать под задачу:
- отправка из своей CRM — «Чтение чатов» и «Отправка сообщений»;
- выгрузка переписки и отчёты — «Чтение чатов» и «Чтение истории сообщений»;
- AI-агент, который отвечает покупателям — «Чтение чатов», «Чтение истории сообщений» и «Отправка сообщений».
Право «Управление webhook-подписками» по умолчанию выключено. С ним ключ может перенаправить всю переписку на любой адрес, поэтому выдавайте его только системе, которой полностью доверяете. Надёжнее завести подписку самому в блоке «Webhooks».
Как изменить права существующего ключа.
- В таблице ключей нажмите «Изменить права» у нужного ключа.
- В окне «Права ключа «…»» отметьте нужные права.
- Нажмите «Сохранить». Права действуют сразу, сам ключ не меняется, перевыпускать его не нужно.
У ключей, выпущенных до появления прав, включены «Чтение чатов» и «Отправка сообщений». Для истории и webhook'ов добавьте права этой кнопкой.
Как пользоваться (краткая справка есть прямо в панели).
- В каждый запрос добавляйте заголовок авторизации:
Authorization: Bearer ak_… - Получить чаты контакта (право «Чтение чатов»):
GET /api/v1/contacts/{contact_id}/chats - Отправить сообщение (право «Отправка сообщений»):
POST /api/v1/chats/{chat_id}/messagesТело для текста:{"type":"text","text":"…"}Тело для картинки:{"type":"image","image_url":"https://…","text":"подпись"}
Полное описание API с готовым кодом лежит там же, на вкладке «API», в карточке «Инструкция для AI-агента». Файл подходит и разработчику, и нейросети. Подробнее — в статье Подключение AI-агента.
Ограничения и частые вопросы.
- Можно слать только текст и картинки — это ограничение самого Авито.
- Ключ нельзя восстановить. Потеряли — создайте новый и отзовите старый.
- Не вставляйте ключ в чат с нейросетью и не пересылайте его в открытых переписках. Если ключ мог утечь, отзовите его.
- Один ключ = один аккаунт amoCRM.
- Лимит частоты — около 5 запросов в секунду на аккаунт, все ключи аккаунта делят его между собой. История переписки отдаётся медленнее, 1 запрос в секунду. При превышении придёт ошибка 429.
- Ключ без нужного права получит ошибку 403. Добавьте право кнопкой «Изменить права».
- Сообщение уходит прямо в Авито и автоматически зеркалится в историю чата amoCRM — отдельно дублировать не нужно.
- Если у аккаунта выключены сообщения или аккаунт неактивен — отправка не сработает.
- При неоплаченной подписке отправлять сообщения нельзя.