Перейти до основного вмісту

Огляд

Bubble.io — популярна no-code платформа, яка дає змогу створювати вебдодатки та мобільні додатки без написання жодного рядка коду. Інтегрувавши API соціальних мереж Ayrshare, ви можете керувати акаунтами соціальних мереж своїх користувачів безпосередньо у вашому додатку Bubble. Це можна зробити двома способами:
  • Плагін Bubble Ayrshare: цей зручний варіант потребує мінімального налаштування. Однак він має обмежену функціональність порівняно з Bubble API Connector.
  • Bubble API Connector: для більшої гнучкості та контролю використовуйте Bubble API Connector. Цей підхід дозволяє безпосередньо взаємодіяти з API Ayrshare, забезпечуючи ширший спектр можливостей у вашому додатку Bubble.io.
Цей посібник проведе вас через обидва варіанти інтеграції.

Швидкий старт: плагін Bubble.io Ayrshare

Bubble — одна з найпотужніших no-code платформ для розробки програмного забезпечення. Найпростіший спосіб почати — скористатися плагіном Bubble.io від Ayrshare. Нижче наведено інформацію про розширену інтеграцію з Bubble.
Спочатку створіть акаунт на ayrshare.com. Потім підключіть свої акаунти соціальних мереж.

Підключення соціальних акаунтів

Після підключення акаунтів ви можете перейти до API Dashboard і скопіювати свій API Key.
Пам’ятайте: коли ви вставляєте свій API Key у ваш додаток Bubble, потрібно додати слово «Bearer» перед вашим API Key.Наприклад:Bearer bf55cc6f-76ac-46ce-b497-439d766f6c12
Додайте плагін Ayrshare через маркетплейс плагінів Bubble до вашого додатка Bubble. У полі плагіна “API Key” введіть свій API Key. Тепер ви можете надсилати публікації через ваш додаток Bubble на ваші акаунти соціальних мереж. Зображення нижче — це приклад виклику workflow у Bubble до плагіна для публікації з зображенням. Відео вище пояснює це детальніше. Переконайтеся, що ви використовуєте такі типи параметрів:
  • post: текст, відформатований як JSON-safe
  • platforms: список текстових значень, де кожне значення взяте у лапки, наприклад "facebook","instagram"
  • media: текстова URL-адреса, відформатована як JSON-safe
  • date: дата/час, відформатовані як JSON-safe
Bubble Ayrshare Plugin Call Example Плагін Ayrshare дозволяє публікувати та видаляти публікації. Щоб розкрити всю потужність Ayrshare, ми рекомендуємо використовувати плагін Bubble API Connector та налаштувати його з ендпоінтами, необхідними для вашого додатка.

Плагін Bubble API Connector

Як альтернативу можна використовувати плагін Bubble API Connector, щоб отримати доступ до всіх можливостей API Ayrshare. Ось відео, яке допоможе вам почати роботу з Bubble API Connector разом з Ayrshare і покаже, як публікувати кілька зображень в одній публікації.
API Connector від Bubble може бути дещо примхливим — відсутність однієї закриваючої лапки чи пробілу може призвести до збою підключення. Ми рекомендуємо уважно переглянути відео нижче та повторно переглянути їх, якщо щось не працює.
Нижче ще одне навчальне відео, яке показує, як отримати аналітику соціальних профілів у Bubble.

Публікація на кілька акаунтів соціальних мереж

Ось стаття з оглядом:

Публікація на кілька акаунтів з Bubble

Валідація даних публікації Bubble

Під час публікації в Bubble через API Connector може бути складно визначити, чи надсилаєте ви валідний JSON. Часто, якщо надісланий до Ayrshare JSON невалідний, відповідь буде у форматі HTML. Ayrshare має URL /validateJSON, до якого можна надсилати запити замість звичного ендпоінта /post. Він поверне «Valid» або «Not Valid». Обов’язково встановіть Content-Type як text/plain замість звичного application/json. Натисніть посилання Troubleshooting для «Response Returns as Bad Request», щоб побачити деталі.

Troubleshooting

Завантаження медіафайлів у Bubble

Використовуйте File Uploader від Bubble для завантаження ваших медіафайлів. Ці файли зберігаються на Amazon S3. Ви отримаєте URL-адресу, яку можна використовувати в параметрі тіла mediaUrls ендпоінта /post.

Генерація JWT-токена в Bubble

Щоб згенерувати JWT-токен у Bubble, спочатку потрібно виконати Stringify для private.key, який ви надсилаєте до ендпоінта /profiles/generateJWT. Крок 1: Перейдіть на https://onlinetexttools.com/json-stringify-text і вставте свій private.key у ліве текстове поле введення. Потім скопіюйте stringified-текст праворуч у буфер обміну. Verify your JWT Token Крок 2: У вашому додатку Bubble створіть новий виклик за допомогою API Connector, як показано нижче. Текст у полі privateKey в області Body — це stringified-текст, який ви створили в Кроці 1 вище. Також укажіть наданий domain та profileKey, як показано нижче. Enter the JWT Token in Bubble Крок 3: Натисніть кнопку Initialize call та збережіть відповідь. Поле url у відповіді — це те, на що ваш користувач натисне, щоб перейти на сторінку прив’язки акаунтів соціальних мереж. Verify API connector return in Bubble

Дозвіл користувачам прив’язувати свої соціальні акаунти

Якщо ви використовуєте Launch Plan, Business Plan або Enterprise Plan, це відео покаже вам, як налаштувати Bubble, щоб усі ваші користувачі могли прив’язувати свої соціальні акаунти.

Переписування тексту та публікація в соціальних мережах за допомогою AI у Bubble

Як можна використовувати Ayrshare та Bubble.io для створення додатка для переписування тексту та публікації в соціальних мережах. Додаток бере деякий текст, переписує його 5 різними способами та публікує на ваших соціальних акаунтах.

Bubble API Connector

Ми рекомендуємо використовувати Bubble API Connector для виконання ваших викликів API Ayrshare. Зверніть увагу, що Bubble припиняє всі виклики API після 150 секунд і потім повторює виклик ще раз. Велике відео може оброблятися довше ніж 150 секунд, що призведе до того, що Bubble автоматично спробує повторити публікацію та отримає помилку дублювання. Ми рекомендуємо використовувати заплановану публікацію для великих відео.

Корисні статті в блозі про Bubble