129 lines
6.6 KiB
Markdown
129 lines
6.6 KiB
Markdown
## endpoint:
|
||
|
||
URL: https://api.botboom.ru/shop/message/send
|
||
|
||
пример на curl:
|
||
|
||
```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:
|
||
|
||
```json
|
||
{
|
||
{
|
||
"caption": "test", // текст сообщения
|
||
"imgUrl": "https://api.botboom.ru/www/uploads/meatcultrubot/wzitrc9r9qzjzivfarulzba2.gif", // картинка к тексту
|
||
"shop": ["987"], // массив номеров магазинов для оповещения. для пуд - с приставкой PUD. устанавливается в чате командой /setshop 987
|
||
"qr": "qrtext" // преобразуется в qr код заказа и отдаётся ссылкой
|
||
}
|
||
}
|
||
```
|
||
|
||
* Версия 2
|
||
|
||
передаётя json:
|
||
|
||
```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" // будет сообщение с картинкой
|
||
}
|
||
```
|
||
|
||
## Статусы заказов:
|
||
|
||
НеСогласован, Согласован, Оплачен, Отменен, КОтгрузке, ПереданВДоставку, Выполнено, переписка
|
||
```json
|
||
["notconfirmed", "confirmed", "paid", "cancelled", "readyforshipment", "indelivery", "closed", "conversation"]
|
||
```
|
||
|
||
> ***Статус НеСогласован означает Новый заказ!***
|
||
>
|
||
> Никуда не отправляется. Начальный статус Согласован.
|
||
|
||
**Отправка сообщений:**
|
||
|
||
**В служебные чаты:** Согласован, Оплачен, Отменен, КОтгрузке, Выполнено
|
||
|
||
**Покупателю:** Согласован, КОтгрузке, ПереданВДоставку, Выполнено
|
||
|
||
## Примеры сообщений:
|
||
|
||
### Новый в служ чат:
|
||
```text
|
||
Заказ Агрокомплекс 59049
|
||
Доставка с 10:00, вес 3.7кг, 5 поз.
|
||
Комментарий: На въезде шлагбаум, если что , звоните
|
||
Связаться со мной и предложить замену
|
||
https://api.botboom.ru/max/akrsloyalty/text-qr/a92b305e-58c8-11f1-ac94-00155d0a9b17
|
||
```
|
||
|
||
### Оплачен в служ чат
|
||
```text
|
||
Оплачен СберМаркет H09672992936
|
||
```
|
||
|
||
### Сообщения конечному покупателю:
|
||
|
||
* Не согласован. Мы получили ваш заказ и обработаем его в рабочее время с 9 до 20.
|
||
* Согласован. Ваш заказ принят и ожидает сборки. Подбираем самое вкусное и свежее. Если при сборке возникнут вопросы, комплектовщик с вами свяжется. Если у вас есть вопрос по заказу, можете связаться с нами по номеру 8-800-250-8925
|
||
* К отгрузке. Ваш заказ собран и ожидает оплаты с учётом итоговой стоимости <sum>
|
||
* Оплачен. Ваш заказ собран и оплачен, ожидает курьера.
|
||
* Не оплачен. Не прошла оплата по заказу. Возможно у вас ограничены платежи в интернете или не хватило денежных средств. Просьба проверить в своём банке.
|
||
* Передан в доставку. Передали ваш заказ курьеру, он скоро будет у вас.
|
||
* Отменён. Ваш заказ отменён. Если у вас возникла проблема, расскажите нам ссылка.
|
||
* Выполнен. Ваш заказ выполнен. Вы можете оценить нашу работу или оставить комментарий по ссылке.
|
||
|
||
|
||
## Работа с ботом
|
||
|
||
Ссылки на ботов для установки тэга:
|
||
|
||
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
|