Заявете ранен достъп

Посочете името си и имейл адрес или телефонен номер. Ще Ви изпратим информация за достъп до Tajo.

На тази страница

Създаване на контакт

Добавяйте нови клиенти към Вашата база с контакти в Brevo заедно с информация за програмата за лоялност и персонализирани атрибути за индивидуална комуникация.

Бърз старт

Основно създаване на контакт

POST https://api.brevo.com/v3/contacts
Content-Type: application/json
api-key: YOUR_API_KEY

{
  "email": "[email protected]",
  "attributes": {
    "FIRSTNAME": "John",
    "LASTNAME": "Doe",
    "LOYALTY_POINTS": 1500,
    "LOYALTY_TIER": "Gold",
    "SIGNUP_DATE": "2024-01-15",
    "LAST_PURCHASE": "2024-01-20",
    "TOTAL_SPENT": 299.99
  },
  "listIds": [1, 2],
  "updateEnabled": true
}

Отговор

{
  "id": 123456
}

Интеграция с програмата за лоялност

Нов клиент с атрибути за лоялност

{
  "email": "[email protected]",
  "attributes": {
    "FIRSTNAME": "Sarah",
    "LASTNAME": "Johnson",
    "PHONE": "+1234567890",
    "LOYALTY_ID": "LYL-2024-001",
    "LOYALTY_POINTS": 0,
    "LOYALTY_TIER": "Bronze",
    "PREFERRED_REWARDS": "Discounts",
    "BIRTHDAY": "1990-05-15",
    "SIGNUP_SOURCE": "Website",
    "REFERRAL_CODE": "REF-12345",
    "COMMUNICATION_PREFERENCES": "Email,SMS",
    "PURCHASE_CATEGORIES": ["Electronics", "Fashion"],
    "AVERAGE_ORDER_VALUE": 0
  },
  "listIds": [1], // New customers list
  "emailBlacklisted": false,
  "smsBlacklisted": false,
  "updateEnabled": true
}

Актуализация на съществуващ клиент

{
  "email": "[email protected]",
  "attributes": {
    "LOYALTY_POINTS": 2500,
    "LOYALTY_TIER": "Platinum",
    "LAST_PURCHASE": "2024-01-25",
    "TOTAL_SPENT": 1299.99,
    "RECENT_PURCHASES": ["Product A", "Product B"],
    "ENGAGEMENT_SCORE": 8.5,
    "LAST_EMAIL_OPENED": "2024-01-24",
    "PREFERRED_CONTACT_TIME": "Evening"
  },
  "listIds": [1, 3], // Add to platinum customers list
  "updateEnabled": true
}

Специфични за Tajo атрибути

Данни за лоялността на клиента

Име на атрибута	Тип	Описание
`LOYALTY_ID`	String	Уникален идентификатор в програмата за лоялност
`LOYALTY_POINTS`	Number	Текущ баланс от точки
`LOYALTY_TIER`	String	Текущо ниво (Bronze, Silver, Gold, Platinum)
`POINTS_EARNED_YTD`	Number	Точки, натрупани през тази година
`POINTS_REDEEMED_YTD`	Number	Точки, използвани през тази година
`TIER_PROGRESS`	Number	Напредък към следващото ниво (%)
`NEXT_TIER_POINTS`	Number	Необходими точки за следващото ниво

Поведение при покупка

Име на атрибута	Тип	Описание
`TOTAL_SPENT`	Number	Стойност за целия период на връзката
`AVERAGE_ORDER_VALUE`	Number	Средна стойност на покупка
`PURCHASE_FREQUENCY`	String	Колко често пазарува клиентът
`LAST_PURCHASE`	Date	Дата на последната покупка
`FAVORITE_CATEGORIES`	Array	Предпочитани продуктови категории
`SEASONAL_BUYER`	Boolean	Пазарува сезонно

Показатели за ангажираност

Име на атрибута	Тип	Описание
`ENGAGEMENT_SCORE`	Number	Оценка на ангажираността от 1 до 10
`EMAIL_OPEN_RATE`	Number	Личен процент на отваряния
`CLICK_THROUGH_RATE`	Number	Личен CTR в проценти
`LAST_EMAIL_OPENED`	Date	Последно взаимодействие с имейл
`PREFERRED_CHANNEL`	String	Имейл, SMS, WhatsApp

Групово създаване на контакти

Създайте няколко контакта наведнъж:

{
  "contacts": [
    {
      "email": "[email protected]",
      "attributes": {
        "FIRSTNAME": "Alice",
        "LOYALTY_POINTS": 500,
        "LOYALTY_TIER": "Bronze"
      }
    },
    {
      "email": "[email protected]",
      "attributes": {
        "FIRSTNAME": "Bob",
        "LOYALTY_POINTS": 1200,
        "LOYALTY_TIER": "Silver"
      }
    }
  ],
  "listIds": [1],
  "updateEnabled": true
}

Обработка на грешки

Често срещани грешки и решения:

{
  "code": "duplicate_parameter",
  "message": "Contact already exists",
  "details": {
    "email": "[email protected]",
    "existingId": 123456
  }
}

{
  "code": "invalid_parameter",
  "message": "Invalid list ID",
  "details": {
    "listIds": [999]
  }
}

Добри практики за Tajo

Винаги включвайте основните полета за лоялност: LOYALTY_POINTS, LOYALTY_TIER, LOYALTY_ID
Разрешавайте актуализациите: позволете обновяване на вече съществуващи контакти
Използвайте списъци за сегментиране: организирайте контактите по ниво, поведение и предпочитания
Проследявайте ангажираността: наблюдавайте процента на взаимодействие с имейлите и SMS
Синхронизирайте данните редовно: поддържайте данните за лоялност актуални спрямо Вашата система

Следващи стъпки

Актуализиране на атрибути на контакт
Управление на списъци с контакти
Настройване на персонализирани атрибути
Масов импорт на контакти

Транзакционни имейли

Транзакционни SMS

Контакти

Събития