Как правильно заполнить Mustache-шаблон

Откуда брать поля для заполнения шаблона

При подключении интеграции по Webhook сервис будет отправлять в Пачку большой файл с различной информацией.

Для того, чтобы чат-бот присылал только выбранные данные, нужен Mustache-шаблон. В нем прописываются фразы значения, которые будет отправлять бот. Если шаблон пустой, то бот ничего отправлять не будет.

На картинке ниже изображен заполненный Mustache-шаблон для чат-бота и сообщение, которое бот отправляет с таким шаблоном.

Чтобы узнать, какие поля нужно прописывать, нужно посмотреть структуру Webhook, который отправляет внешний сервис в Пачку.

Для этого:

  1. Откройте https://webhook.site/
  2. Скопируйте адрес из поля “Your unique URL”
  3. Вставьте скопированный адрес в сервис, который хотите подключить к Пачке. Его нужно вставить на этапе настройке Webhook.
    Если вы уже настроили интеграцию с Пачкой, то просто замените Webhook URL Пачки на скопированный адрес
  4. Сделайте триггерное действие а сервисе, который вы подключаете. Вы его настраивали при создании Webhook.
  5. После этого на странице Webhook придет и отобразится на странице https://webhook.site/
  6. Выберите те поля, которые вам необходимы в сообщениях бота. Вставьте их в Mustache шаблон

Правила оформления полей в Mustache-шаблоне

  1. Каждое поле нужно заключать в двойные скобки.Например, {{UserName}}
    Если одна переменная вложена внутри другой то ее нужно выделить.
  2. Например, если из Webhook, который расположен ниже, боту нужно отправить поле “description”, то в Mustache-шаблоне надо прописать следующее выражение:
    {{#issue}} {{#fields}} {{description}} {{/fields}} {{/issue}}
"issue": {
    "id": "10000",
    "self": "https://setters333.atlassian.net/rest/api/2/10000",
    "key": "PAC-1",
    "fields": {
        "statuscategorychangedate": "2023-03-15T22:40:29.147+0300",
        "issuetype": {
            "self": "https://setters333.atlassian.net/rest/api/2/issuetype/10001",
            "id": "10001",
            "description": "Tasks track small, distinct pieces of work.",
            "iconUrl": "https://setters333.atlassian.net/rest/api/2/universal_avatar/view/type/issuetype/avatar/10318?size=medium",
            "name": "Task",
            "subtask": false,
            "avatarId": 10318,
            "entityId": "aa4c414a-e66a-4004-9777-f494c3eda853",
            "hierarchyLevel": 0
        }
    }
}
    

Больше методов работы с Mustache можно найти по ссылке

3. К полям можно применять форматирование, как к сообщениям в Пачке. Например, если мы напишем **{{description}}**, то бот отправит значение этого поля с форматированием “жирный текст”.
Ниже представлены основные типы форматирования в Пачке:

Обновлено 
11.5.2023