API-ключи и отправка сообщений
Что делает. Вкладка «API» в верхнем меню выдаёт ключи доступа к публичному API виджета. С таким ключом ваша сторонняя система (например своя CRM) может отправлять сообщения в чаты Авито по контакту amoCRM — не заходя в Авито вручную.
Как настроить.
- Откройте виджет и в верхнем меню нажмите вкладку «API».
- Введите «Название ключа» (любое, чтобы потом узнать ключ в списке).
- Нажмите «Создать ключ».
- Ключ в формате
ak_…показывается один раз. Нажмите «Копировать» и сохраните его в надёжном месте — повторно его увидеть нельзя. - В таблице ниже видно: название, префикс ключа, когда создан, когда последний раз использован, и кнопку «Отозвать».
Как пользоваться (документация есть прямо в панели).
- В каждый запрос добавляйте заголовок авторизации:
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":"подпись"}
Ограничения и частые вопросы.
- Можно слать только текст и картинки — это ограничение самого Авито.
- Ключ нельзя восстановить. Потеряли — создайте новый и отзовите старый.
- Один ключ = один аккаунт amoCRM.
- Лимит частоты — около 5 запросов в секунду. При превышении придёт ошибка 429.
- Сообщение уходит прямо в Авито и автоматически зеркалится в историю чата amoCRM — отдельно дублировать не нужно.
- Если у аккаунта выключены сообщения или аккаунт неактивен — отправка не сработает.
- При неоплаченной подписке отправлять сообщения нельзя.