Перейти до вмісту
Blackbird API

Mailchimp

Переглянути на Github

Перед налаштуванням

Ви повинні переконатися, що у вас є обліковий запис Mailchimp та доступ до нього. Наш додаток використовує OAuth 2.0 для автентифікації, тому вам не потрібно надавати жодних API-ключів. Вас перенаправлять на сторінку входу Mailchimp для авторизації додатка. Зауважте, цей додаток використовує Mailchimp Marketing API, щоб забезпечити оптимізований досвід управління вашими маркетинговими зусиллями.

Підключення

  1. Перейдіть до розділу Додатки та знайдіть додаток Mailchimp. Ви можете скористатися пошуком, щоб знайти його.
  2. Натисніть Add Connection.
  3. Назвіть ваше підключення для подальшого використання, наприклад, ‘Моя організація’.
  4. Натисніть Authorize connection.
  5. Вас перенаправлять на сторінку входу Mailchimp. Введіть свої облікові дані та авторизуйте додаток.
  6. Підтвердіть, що з’явилося підключення і статус показує Connected.

Підключення

Actions

Campaigns

  • Search campaigns - Пошук кампаній за вказаними критеріями.
  • Get campaign - Отримання кампанії за вказаним ID.
  • Create campaign - Створення кампанії з вказаними даними.
  • Update campaign - Оновлення кампанії з вказаними даними.
  • Delete campaign - Видалення кампанії за вказаним ID.

Campaign content

  • Get campaign content - Отримання вмісту кампанії за вказаним ID.
  • Update campaign content - Оновлення вмісту кампанії з вказаними даними.
  • Get campaign content as HTML - Отримання вмісту кампанії за вказаним ID у форматі HTML.
  • Update campaign content from HTML - Оновлення вмісту кампанії з вказаним ID з HTML-файлу або додаткового введення. Ця дія корисна в парі з дією Get campaign content as HTML, коли вам потрібно отримати вміст кампанії як HTML, а потім перекласти документ.

Events

  • On campaigns created - Подія опитування. Спрацьовує після вказаного часового інтервалу та повертає нові кампанії. Ця подія використовує параметр запиту since_create_time для фільтрації кампаній, створених після вказаного часу.
  • On campaigns updated - Подія опитування. Спрацьовує після вказаного часового інтервалу та повертає оновлені кампанії. Ця подія зберігає останні 20 кампаній та їхні хеш-значення (HTML-вмісту) в пам’яті. Коли подія спрацьовує, вона порівнює хеш-значення збережених кампаній з хеш-значеннями останніх кампаній. Якщо хеш-значення відрізняються, подія повертає оновлені кампанії. Ключовий момент тут - отримання лише 20 кампаній, відсортованих за create_time у порядку спадання. Це зроблено для уникнення складності та проблем з продуктивністю.

Обробка помилок

Наш додаток повертає помилки у структурованому форматі. Нижче наведені типові відповіді про помилки, з якими ви можете зіткнутися:

  1. Стандартна відповідь про помилку Стандартна відповідь про помилку включає такі поля:
Type: {Type}, Title: {Title}, Status: {Status}, Detail: {Detail}, Instance: {Instance}
  • Type: Тип помилки.
  • Title: Короткий заголовок, що описує помилку.
  • Status: HTTP-код статусу, пов’язаний з помилкою.
  • Detail: Детальне повідомлення, що пояснює помилку.
  • Instance: Унікальний ідентифікатор для цього конкретного випадку помилки.
  1. Складна відповідь про помилку з внутрішніми помилками

Якщо об’єкт помилки містить додаткові внутрішні помилки, відповідь включатиме поле Errors з більш детальною інформацією:

Type: {Type}, Title: {Title}, Status: {Status}, Detail: {Detail}, Instance: {Instance}, Errors: Field: {x.Field}, Message: {x.Message}, ...
  • Errors: Список внутрішніх помилок, кожна з яких містить:
    • Field: Конкретне поле, пов’язане з помилкою. Наприклад, first_name.
    • Message: Повідомлення, що описує помилку для цього поля.

Якщо ви зіткнулися з помилкою, будь ласка, перевірте повідомлення про помилку та спробуйте вирішити проблему. Якщо вам потрібна додаткова допомога, зверніться до нас.

Відсутні функції

API Mailchimp дуже широкий, і ми працюємо над додаванням більшої кількості функцій до нашого додатка. Якщо вам потрібна конкретна функція, зверніться до нас. Ви можете перевірити кінцеві точки API та доступні функції в документації Mailchimp API.

Зворотній зв’язок

Хочете використовувати цей додаток або маєте відгук про нашу реалізацію? Зв’яжіться з нами, використовуючи встановлені канали або створіть issue.