Все про шаблони для Телеграм.

Вступ

Ми постаралися зробити створення шаблонів максимально універсальним та багатофункціональним.

Зарезервовані змінні

• user_id

  - id чата телеграм, який отримає повідомлення. Не обов’язкове

• user.id

  - id чата в телеграм. На відміну від user_id - в даному випадку id користувача підставить в шаблон як значення (Власник сайту);

• user.first_name

  - first_name користувача в телеграм. Власника сайту. Буде підставлено в шаблон як значення;

• user.last_name

  - last_name користувача в телеграм. Власника сайту. Буде підставлено в шаблон як значення;

• user.username

  - username користувача в телеграм. Власника сайту. Буде підставлено в шаблон як значення;

• user_reciver.id

  - id чата телеграм, який отримає повідомлення. Буде підставлено в шаблоні як значення;

• user_reciver.first_name

  - first_name чата телеграм, який отримає повідомлення. Буде підставлено в шаблоні як значення;

• user_reciver.last_name

  - last_name чата телеграм, який отримає повідомлення. Буде підставлено в шаблоні як значення;

• user_reciver.username

  - username чата телеграм, який отримає повідомлення. Буде підставлено в шаблоні як значення;

Доступні HTML теги, які можна використовувати для відправки в телеграм

• <br>, або <br/>, або <br /> : новий рядок
• <b>текст</b>, або <strong>текст</strong> : жирний текст
• <i>текст</i>, або <em>текст</em> : курсивний текст
• <u>текст</u> : підкреслений текст
• <s>текст</s> : закреслений текст
• <code>текст</code> : текст, відформатований як код або моноширинний шрифт
• <pre>текст</pre> :

  форматує текст так само, як <code>, але зберігає оригінальне форматування прогалин та переносів рядків

• <a href="URL">текст</a> : гіперпосилання на вказаний URL
• <a href="tg://user?id=USER_ID">текст</a> : спеціальне гіперпосилання на користувача Telegram за його ідентифікатором USER_ID
• <a href="tel:PHONE_NUMBER">текст</a> : гіперпосилання для набору телефонного номера
• <a href="mailto:EMAIL_ADDRESS">текст</a> : гіперпосилання для відправки електронного листа на EMAIL_ADDRESS
• <a href="tg://join?invite=INVITE_LINK">текст</a> : спеціальне гіперпосилання для приєднання до групи або каналу за посиланням INVITE_LINK

Доступні директиви, які можна використовувати в шаблоні

• {% for item in data.items %} {% endfor %}
• {%if data.quantity > 10 %} {% endif %}
• {%if data.quantity > 10 %} {% else %} {% endif %}
• {%if data.quantity > 10 %} {% elseif data.quantity == 10 %} {% else %} {% endif %}

Приклади шаблонів

Примітка: всі змінні повинні бути обгорнуті в "{ {" та "} }"

1. Простий шаблон без змінних. Звичайни текст

   • Вітаємо. Сайт досяг відмітки 1000 користувачів.

     ТУТ ПРИКЛАД НА PHP

     ТУТ КНОПКА НА ТЕСТ.. ПЕРЕД ЦИМ ТРЕБА ПРИЄДНАТИСЯ ДО БОТА (саме живого бота) ..

     Тіло запиту в json: {}

   В даному прикладі запит на відправку шаблону буде без параметрів.

2. Простий шаблон з кількома змінними

   • На сайті зареєструвався новий користувач:
     ID: { {data.id} }
     Ім’я: { {data.name} }
     Телефон: { {data.phone} }
     email: { {data.email} }
     

   Тіло запиту в json: {id:"52",name:"Віталій",phone:"+38055 333 33 33",email:"api@notify.shop"}

   Тоді шаблон прийде в такому вигляді:
   • На сайті зареєструвався новий користувач:
     ID: 52
     Ім’я: Віталій
     Телефон: +38055 333 33 33
     email: api@notify.shop
     
   • ТУТ ПРИКЛАД НА PHP
   • ТУТ КНОПКА НА ТЕСТ.. ПЕРЕД ЦИМ ТРЕБА ПРИЄДНАТИСЯ ДО БОТА (саме живого бота) ..

3. Приклад оформлення замовлення зі списком товарних позицій

   • Привіт, { {data.user_name} } { {data.first_name} } зробив замовлення на сайті
     --------------------------
     Данні, які він вказав в замовленні:
     Імя:{ {data.user_name} }
     Телефон: { {data.phone} }
     E-mail: { {data.email} }
     --------------------------
     Корзина:
     {% for item in data.items %}{ {item.name} }-{ {item.quantity} } шт {% endfor %}
     --------------------------
     Загальна сума: { { data.amount } } грн
     

   Тіло запиту в json: {user_name:"Віталій",first_name:"Покупець",phone:"+38055 333 33 33",email:"api@notify.shop",amount:"10 250",items:[{name:"Товар 1",quantity:"3"},{name:"Товар 2",quantity:"2"},{name:"Товар 3",quantity:"1"}]}

4. Відправка повідомлення відділу менеджерів з використанням змінних отримувача та відправника

   • Шановний менеджер { { user_reciver.first_name } } { { user_reciver.last_name } }. Ваш керівник { { user.first_name } } { { user.last_name } } вислав вам запрошення на конференціюю.

   В цьому випадку ваш запит може бути пустим, без параметрів. І, допустим, ім’я керівника - Олег Хом’яков, а імя одного з отримувачів - Оксана Гідна. Тоді повідомлення для Оксани буде виглядати наступним чином: "Шановний менеджер Оксана Гідна. Ваш керівник Олег Хом’яков вислав вам запрошення на конференціюю."

Готові шаблони (замовлення, новий товар, новина, - для відсилки в бот або в канал) - з наперед готовими зміннами (ключами)