Интеграция ManyChat и Metabot для создания квиза-калькулятора

1. Введение

В этой статье мы рассмотрим, как интегрировать ManyChat, отличный инструмент для построения воронок, с платформой Metabot в качестве Low-code инструмента для бэкенд-разработки. ManyChat обладает удобным интерфейсом для работы с пользователями, но не поддерживает написание кода. Metabot идеально дополняет ManyChat, предлагая возможности быстрой разработки и легкой интеграции с чат-ботами.

В этом уроке мы разработаем интерактивный квиз для путешественников. На протяжении квиза участники будут отвечать на вопросы, касающиеся характера их путешествия, а также характера затрат. Эта информация поможет нам оценить, сколько денег им стоит взять с собой в поездку.

В конце квиза, основываясь на предоставленных данных, наша система предоставит участникам приблизительную оценку требуемого бюджета для их путешествия. Это будет сделано с помощью специально разработанного алгоритма, который учитывает различные факторы, такие как длительность пребывания, количество путешественников, их предпочтения в расходах, сезонность и цель поездки.

Ниже представлен пример кода, который мы будем использовать для расчета бюджета. Этот код можно адаптировать под ваши задачи, будь то создание собственных калькуляторов расходов или оценка бюджета для различных мероприятий. Воспользуйтесь этим примером как отправной точкой для разработки собственных инструментов.

2. Обзор интеграции

1. Создание бота в Metabot: Сначала нужно создать бота в системе Metabot.
2. Создание пользователя API и токена в Metabot: Для авторизации запросов необходимо создать пользователя с типом API и сгенерировать токен.

   • 

3. Настройка внутреннего endpoint в Metabot: В боте нужно создать endpoint, который будет обрабатывать запросы от ManyChat.

   • 

4. Написание кода для обработки запросов: Пример кода показывает, как обработать запросы и вернуть результат в формате, подходящем для ManyChat.

3. Пример кода эндпоинта

snippet('Business.Helpers.Response');// Check if the necessary fields are present in the requestif (!request.json ||     !request.json.destinationCoefficient ||    !request.json.nights ||    !request.json.travelers ||    !request.json.averageSpendingScore ||    !request.json.seasonCoefficient ||    !request.json.tripPurposeCoefficient ||    !request.json.familyTravelCoefficient ||    !request.json.format) {  return getErrorResponse("Required fields are missing");}// Ensure that format is either 'raw' or 'manychat'if (request.json.format !== 'raw' && request.json.format !== 'manychat') {  return getErrorResponse("Invalid format specified");}// Extract values from the requestconst destinationCoefficient = request.json.destinationCoefficient;const seasonCoefficient = request.json.seasonCoefficient;const tripPurposeCoefficient = request.json.tripPurposeCoefficient;const familyTravelCoefficient = request.json.familyTravelCoefficient;// Base daily cost based on average spending score (example values)let baseDailyCost;if (request.json.averageSpendingScore <= 1.75) {  baseDailyCost = 50; // Low spender} else if (request.json.averageSpendingScore <= 2.5) {  baseDailyCost = 100; // Moderate spender} else if (request.json.averageSpendingScore <= 3.25) {  baseDailyCost = 150; // High spender} else {  baseDailyCost = 200; // Ultra spender}// Calculating the total recommended amountconst totalAmount = (baseDailyCost * request.json.destinationCoefficient * request.json.nights * request.json.travelers) *                     seasonCoefficient *                     tripPurposeCoefficient *                     familyTravelCoefficient;// Determine the response formatif (request.json.format === 'raw') {  // Returning the calculated budget in raw format  return getSuccessResponseWithJson({    calculatedBudget: totalAmount  });} else {  // Returning the calculated budget in ManyChat format  return {    "version": "v2",    "content": {  /*    "messages": [        {          "type": "text",          "text": `Ok! I got it`        }        // Additional messages can be added here      ],*/      "actions": [        {          "action": "set_field_value",          "field_name": "budget_estimate_amount", // Custom field name in ManyChat          "value": totalAmount.toString()  // Setting the calculated budget as the value        }      ],      "quick_replies": []    }  };}

4. Код плагина Business.Helpers.Response

5. Интеграция с ManyChat

1. Настройка API в ManyChat: В ManyChat реализуйте команду для динамического формирования контента, указав URL endpoint MetaBot.
   • Подробнее про эту команду: https://support.manychat.com/support/solutions/articles/36000143342-dev-tools-dynamic-block 

   • 

2. Настройка Headers и Body запроса: В Header запроса укажите токен авторизации, а в Body - параметры из воронки ManyChat.
   • Подробнее про формат обмена REST API: https://manychat.github.io/dynamic_block_docs/ 
   • Настройте заголовок запроса:
   • Настройте тело запроса:

Пример тела запроса

{
  "script_request_params": {
    "destinationCoefficient": 1,
    "nights": 5,
    "travelers": 1,
    "averageSpendingScore": 2.25,
    "seasonCoefficient": 1.0,
    "tripPurposeCoefficient": 1.0,
    "familyTravelCoefficient": 1.0,
    "format": "manychat"
  }
}

Всегда оборачивайте все запросы к эндпоинтам вашего бота на платформы Metabot в "script_request_params"!

Заключение

Интеграция ManyChat и Metabot открывает новые возможности для создания продвинутых чат-ботов. Благодаря Low-Code подходу Metabot и удобному интерфейсу ManyChat, можно быстро разрабатывать и интегрировать сложные функциональности, улучшая взаимодействие с пользователями.