101 lines
4.4 KiB
Markdown
101 lines
4.4 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" // поле - уникальный идентификатор для информирования в боте. Ставится в чате/боте /aksetid 79204421996
|
||
},
|
||
delivery: {
|
||
addr: "Сочи, Ленина 1",
|
||
date: "26.05.2026", // дата доставки. Текущая дата если не задано.
|
||
timeslot: "10:12-" // таймслот через дефис, в этом примере, Доставка с 10:12
|
||
},
|
||
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
|
||
```
|
||
|