projects/ak_notification.md

6.6 KiB
Raw Blame History

endpoint:

URL: https://api.botboom.ru/shop/message/send

пример на curl:

curl -X POST "https://api.botboom.ru/shop/message/send" \
  -H "Authorization: {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
        {
            "caption": "test",
            "imgUrl": "https://api.botboom.ru/www/uploads/meatcultrubot/wzitrc9r9qzjzivfarulzba2.gif",
            "shop": ["987"],
            "qr": "qrtext"
        }
    }'
  • Версия 1

передаётя json:

{
    {
        "caption": "test", // текст сообщения
        "imgUrl": "https://api.botboom.ru/www/uploads/meatcultrubot/wzitrc9r9qzjzivfarulzba2.gif", // картинка к тексту
        "shop": ["987"], // массив номеров магазинов для оповещения. для пуд - с приставкой PUD. устанавливается в чате командой /setshop 987
        "qr": "qrtext" // преобразуется в qr код заказа и отдаётся ссылкой
    }
}
  • Версия 2

передаётя json:

{
    orderNumber: "H19481743502", // номер заказа
    source: "СберМаркет", // источник заказа - СберМаркет, Агрокомплекс, ПУД, Яндекс Еда
    shop: ["267"], // массив номеров магазинов для оповещения. для пуд - с приставкой PUD. устанавливается в чате командой /setshop 987
    status: "new", // статус заказа. новый, не согласован, согласован, оплачен, отменён, передан в доставку, доставлен, закрыт, переписка
    orderDate: "25.05.2026, 09:32:34"
    client: {
        name: "Иванов Иван",
        phone: "79204421996" // поле - уникальный идентификатор для информирования в боте. Ставится в чате/боте /set_my_tag 79204421996
    },
    delivery: {
        addr: "Сочи, Ленина 1",
        date: "26.05.2026", // дата доставки. Текущая дата если не задано.
        timeslot: "10:12-", // таймслот через дефис, в этом примере, Доставка с 10:12
        storePickup: "" // если есть - то самовывоз, если не пусто - то адрес самовывоза
    },
    order: {
        weight: "1.7кг",
        items: "5", // число позиций или массив товаров в заказе. На будущее
        total: 1234.00 // общая сумма заказа в р.
    },
    comment: "Позвонить. Если не удалось дозвониться, заменить на аналогичный товар.",
    qr: "7cc8e74a-5803-11f1-ac94-00155d0a9b17", // преобразуется в qr код заказа и отдаётся ссылкой
    caption: "", // если задан, будет передан простым текстом в конце сообщения
    imgUrl: "https://api.botboom.ru/www/uploads/meatcultrubot/wzitrc9r9qzjzivfarulzba2.gif" // будет сообщение с картинкой
}

Статусы заказов:

НеСогласован, Согласован, Оплачен, Отменен, КОтгрузке, ПереданВДоставку, Выполнено, переписка

["notconfirmed", "confirmed", "paid", "cancelled", "readyforshipment", "indelivery", "closed", "conversation"]

Статус НеСогласован означает Новый заказ!

Никуда не отправляется. Начальный статус Согласован.

Отправка сообщений:

В служебные чаты: Согласован, Оплачен, Отменен, КОтгрузке, Выполнено

Покупателю: Согласован, КОтгрузке, ПереданВДоставку, Выполнено

Примеры сообщений:

Новый в служ чат:

Заказ Агрокомплекс 59049
Доставка с 10:00, вес 3.7кг, 5 поз.
Комментарий: На въезде шлагбаум, если что , звоните 
 Связаться со мной и предложить замену
https://api.botboom.ru/max/akrsloyalty/text-qr/a92b305e-58c8-11f1-ac94-00155d0a9b17

Оплачен в служ чат

Оплачен СберМаркет H09672992936

Сообщения конечному покупателю:

  • Не согласован. Мы получили ваш заказ и обработаем его в рабочее время с 9 до 20.
  • Согласован. Ваш заказ принят и ожидает сборки. Подбираем самое вкусное и свежее. Если при сборке возникнут вопросы, комплектовщик с вами свяжется. Если у вас есть вопрос по заказу, можете связаться с нами по номеру 8-800-250-8925
  • К отгрузке. Ваш заказ собран и ожидает оплаты с учётом итоговой стоимости
  • Оплачен. Ваш заказ собран и оплачен, ожидает курьера.
  • Не оплачен. Не прошла оплата по заказу. Возможно у вас ограничены платежи в интернете или не хватило денежных средств. Просьба проверить в своём банке.
  • Передан в доставку. Передали ваш заказ курьеру, он скоро будет у вас.
  • Отменён. Ваш заказ отменён. Если у вас возникла проблема, расскажите нам ссылка.
  • Выполнен. Ваш заказ выполнен. Вы можете оценить нашу работу или оставить комментарий по ссылке.

Работа с ботом

Ссылки на ботов для установки тэга:

https://t.me/Agrokomplexshop_bot?start=tg79204421996

https://max.ru/id2328000083_1_bot?start=tg79204421996

установить метку магазина: /setshop 987

установить себе метку покупателя: /set_my_tag 79204421997

снять метку покупателя: /unset_my_tag 79204421997

посмотреть метки: /get_my_tags