Управление Шаблонами

GET https://cloud.lovi.ai/functions/v1/notify/templates?access_key={YOUR_ACCESS_KEY}&phone_number={PHONE_NUMBER}

GET https://cloud.lovi.ai/functions/v1/notify/templates?access_key=your-api-key&phone_number=34666033135

[
  {
    "id": "696796403510039",
    "name": "welcome_message",
    "status": "APPROVED",
    "category": "MARKETING",
    "language": "en",
    "components": [
      {
        "text": "Welcome! This is a test message.",
        "type": "BODY"
      }
    ],
    "parameter_format": "POSITIONAL"
  }
]

{
  "name": "welcome_user",
  "language": "ru_RU",
  "content": "Привет {{name}}! Добро пожаловать в {{company}}. Как мы можем вам помочь?",
  "variables": ["name", "company"],
  "category": "UTILITY"
}

{
  "name": "promo_with_image",
  "language": "ru_RU",
  "content": "Посмотрите наше специальное предложение!",
  "components": [
    {
      "type": "HEADER",
      "format": "IMAGE",
      "example": {
        "header_handle": ["https://example.com/image.jpg"]
      }
    },
    {
      "text": "Спасибо, что выбираете нас!",
      "type": "FOOTER"
    }
  ],
  "category": "MARKETING"
}

function validateTemplateVariables(content, providedVariables) {
  const requiredVars = extractVariables(content); // Извлечь {{var}} из контента
  const providedVars = Object.keys(providedVariables);

  const missing = requiredVars.filter(v => !providedVars.includes(v));
  const extra = providedVars.filter(v => !requiredVars.includes(v));

  if (missing.length > 0) {
    throw new Error(`Отсутствующие переменные: ${missing.join(', ')}`);
  }

  if (extra.length > 0) {
    console.warn(`Предоставлены дополнительные переменные: ${extra.join(', ')}`);
  }
}

await loviService.sendNotification({
  contact: { number: "34666033135" },
  template: "welcome_user",
  variables: {
    name: "Иван",
    company: "TechCorp"
  }
});

await loviService.sendNotification({
  contact: { number: "34666033135" },
  template: "reminder_meeting",
  variables: {
    name: "Иван",
    date: "25 декабря",
    time: "10:00"
  },
  datetime_sending: "2024-12-24T20:00:00Z" // Накануне вечером
});

await loviService.createTemplate({
  name: "welcome_user",
  language: "ru_RU",
  content": "Привет {{name}}! Добро пожаловать в {{company}}."
});

await loviService.createTemplate({
  name: "welcome_user",
  language: "en_US",
  content": "Hello {{name}}! Welcome to {{company}}."
});

const stats = await loviService.getTemplateStats("welcome_user");
// Возвращает: доставки, открытия, клики и т.д.

const report = await loviService.getTemplateReport({
  template: "welcome_user",
  start_date: "2024-01-01",
  end_date: "2024-01-31"
});

// ✅ Хорошие имена
"welcome_user"
"order_confirmation"
"meeting_reminder"

// ❌ Имена, которых следует избегать
"template1"
"new_template_2024"
"test"

// ✅ Ясно и кратко
"Привет {{name}}, ваша встреча подтверждена на {{date}} в {{time}}."

// ❌ Слишком длинно или запутанно
"Уважаемый клиент {{name}}, мы рады сообщить, что ваша запись на наш объект для запрошенного обслуживания была правильно зарегистрирована в нашей системе на дату {{date}} с запланированным временем {{time}} часов. Просим прибыть за 15 минут до указанного времени."

function sanitizeVariables(variables) {
  const sanitized = {};
  for (const [key, value] of Object.entries(variables)) {
    // Удалить потенциально опасные символы
    sanitized[key] = String(value).replace(/[<>]/g, '');
  }
  return sanitized;
}