Для AI-агентов: markdown этой страницы — /docs-content/bots/openlines/auto-message.md индекс документации — /llms.txt

Автосообщение линии

POST /v1/bots/:botId/openlines/session/auto-message

Метод Б24: imopenlines.bot.session.message.send. Нужны imbot и imopenlines, владеющий ботом ключ и разрешённая запись.

Terminal

curl -X POST "https://vibecode.bitrix24.tech/v1/bots/621/openlines/session/auto-message" \
  -H "X-Api-Key: $VIBE_API_KEY" -H "Content-Type: application/json" \
  -d '{"chatId": 2043, "type": "DEFAULT", "message": "VIBE-PROBE Hello"}'

type обязателен: WELCOME отправляет шаблон приветствия линии, DEFAULT — системное сообщение в коннектор клиента. Для DEFAULT нужен строковый message, кроме пустой строки и "0": эти значения Б24 молча пропускает. Это не обычное сообщение бота. Битрикс24 не сообщает, отправлено ли сообщение: нет активной сессии или внутренняя проверка не прошла — REST всё равно может вернуть true. accepted подтверждает только принятие вызова. CLIENT_ID этому методу не нужен.

JSON

{
  "success": true,
  "data": {
    "chatId": 2043,
    "accepted": true
  }
}

Идентификаторы: chatId / dialogId / CHAT_ID — общие правила.

Отказы

HTTP	Коды
400	INVALID_BOT_ID / INVALID_CHAT_ID / INVALID_PARAMS / MISSING_REQUIRED_FIELDS / MISSING_TRANSFER_TARGET / INVALID_TRANSFER_TARGET
401	MISSING_API_KEY / TOKEN_MISSING
403	SCOPE_DENIED / BOT_ACCESS_DENIED / WRITE_BLOCKED_READONLY_KEY / BITRIX_ACCESS_DENIED
404	BOT_NOT_FOUND / ENTITY_NOT_FOUND
410	BOT_DISABLED
422	BITRIX_ERROR; b24Code содержит отказ Б24, например WRONG_CHAT, BOT_ID_ERROR, OPERATOR_WRONG или WRONG_AUTH_TYPE
429	RATE_LIMITED или очередь портала
502	OPENLINE_BOT_SESSION_FAILED / BITRIX_UNAVAILABLE
503	BITRIX_TIMEOUT или заморозка удаления владельца ключа

Бизнес-текст Б24 сохраняется с удалением секретов. Чужие сессии при проверке не изменяйте.