Мақсаты
Telegram пайдаланушыларына немесе топтарына ағын нәтижелері, мақұлдаулар және басқа оқиғалар туралы хабарлайды. Мәтін мен алушы тұрақты немесе кесте өрістерінен жасалуы мүмкін.
Кірістер және шығыстар
in және success/failure бар қабылдаушы; бапталған бот жазу кезінде жеткізуді орындайды.
Параметрлер
| Параметр | Баптаулар және мәндер | Нұсқалар және шектер |
|---|---|---|
role | Блок рөлі: дереккөз деректерді оқиды; қабылдаушы нәтижені жазады. | Әдепкі: target |
connection_id | Блок жүйеге қатынайтын сақталған қосылым. | Әдепкі: empty64 таңбаға дейін |
recipient_type | Алушы түрі: private, group немесе үйлесімді автоматты анықтау үшін auto. | Нұсқалар: auto, private, groupӘдепкі: auto |
chats | Чат идентификаторлары немесе алушыны деректерден анықтайтын үлгі. | Әдепкі: empty4000 таңбаға дейін |
text | Хабар мәтіні; конфигурацияда 4096 таңбаға дейін. | Әдепкі: empty4096 таңбаға дейін |
parse_mode | Қарапайым мәтінге none, қолдау көрсетілетін пішімдеуге html. | Нұсқалар: none, htmlӘдепкі: none |
silent | Дыбыстық хабарлаусыз жіберу. | Әдепкі: disabled |
attachments | Файл менеджерінен, қалтадан немесе іске қосу параметрлерінің «Тіркелген файл» өрісінен тіркемелер. | Саны: 0–10 |
time_zone | Жүйелік күн мен уақыт қоюға арналған уақыт белдеуі. | Әдепкі: Europe/Kyiv64 таңбаға дейін |
Үлгілер және хабар саны
Мына алмастыру: {{Назва поля}} ағымдағы жол мәнін қолданады. Жүйелік тегтер: {{$date}}, {{$time}}, {{$datetime}}, {{$flow}}, {{$rows}}, {{$row}}, {{$table}}.
- Алушы, тақырып немесе дене үлгісінде жол өрісі не {{$row}} болса, әр жолға жеке хабар жасалады. Әйтпесе бүкіл кіріске бір хабар жасалады.
- {{$table}} тек хабар денесінде қолжетімді. Ол 1000 жолға дейін және қалғаны туралы белгі қосады.
- Тегтердегі барлық өріс кірісте болуы керек; TEMPLATE_FIELD_MISSING дайындау кезінде анықталады.
- Күндер мен уақыттар көрсетілген time_zone қолданады. Пішімделген хабарларда дерек мәндері қауіпсіз экрандаудан өтеді.
Қадамдық баптау
- Бот қосылымын жасап, қажетті алушыға қатынауды тексеріңіз.
- Қолжетімді интерфейсте алушы түрі мен чатты таңдаңыз немесе қолдау көрсетілетін идентификаторды беріңіз.
- Хабарды жазып, тегтер қойыңыз. Қанша хабар жасалатынын тексеріңіз.
- Қажет болса тіркемелер мен silent қосып, уақыт белдеуін орнатыңыз.
- Пішімдеу мен дайындауды тексеріп, жеткізуді бастаңыз.
Ережелер және диагностика
- Бот алушыға қолжетімді болып, қажетті топ құқықтарына ие болуы керек; блок бұл құқықтарды өзі бермейді.
- 10 тіркеме көзіне дейін. Қайталанатын көздерге тыйым салынады.
- HTML Telegram рұқсат еткен жиынға сай болуы керек; жарамсыз/жабылмаған тегтер TELEGRAM_MARKUP қатесін береді. Редактор қолдау көрсетілетін пішімдеуді жасауға көмектеседі.
- Үлкен кесте көптеген хабар бөлігін жасауы мүмкін; көлемді деректерге тіркелген файл немесе қысқа қорытынды ыңғайлырақ.
- Ішінара жіберуден кейін қайталанымдарды болдырмау үшін қайталаудан бұрын журналды тексеріңіз.
- Белсенді бос кіріс хабар жасамайды: EMPTY_STAGE. Бір іске қосуда бір блокқа 10000 хабарға дейін рұқсат; көбірек болса, жиынды сүзіңіз немесе бөліңіз.
- Сыртқы жіберу кезінде жауаптың жоғалуы анықталмаған нәтиже болып есептеледі: жүйе сол хабарды автоматты қайта жібермейді.
- Алмастырулардан кейін мәтін жарамды HTML сақтала отырып, 4096 таңбаға дейінгі бөліктерге автоматты бөлінеді. Жеке файл 50 MB-пен шектеледі; қалта тіркемесі 20 файлға дейін қосады.
Баптау мысалы
Бір хабарлама үшін тұрақты топ чатын және «{{$flow}} ағыны аяқталды. {{$rows}} жол өңделді, {{$datetime}}» мәтінін орнатыңыз. Мұнда жол өрістері жоқ, сондықтан бір қорытынды жасалады.