Перейти до основного вмісту
Інтегратори на плані Business або Enterprise можуть підключати соціальні акаунти своїх клієнтів під субпрофілями. За допомогою MCP Server агент створює субпрофіль, націлює на нього дії та формує URL єдиного входу для підключення, який клієнт відкриває, щоб під’єднати свої акаунти.

Процес

1

Створіть субпрофіль

Викличте create_profile (на рівні акаунта — без profileKey). Він поверне profile key для нового субпрофіля.
2

Націльтеся на субпрофіль

Використовуйте отриманий profile key у подальших викликах — або через заголовок Profile-Key на з’єднанні, або як аргумент profileKey для кожного виклику. Про пріоритет див. Connect & Setup.
3

Сформуйте URL для підключення соцмереж

Викличте generate_jwt_social_linking_url, щоб сформувати URL єдиного входу для підключення. Ключ підпису JWT та домен підключення визначаються на боці сервера — виклик не передає жодних заголовків X-Ayrshare-*, приватного ключа чи домену.
4

Клієнт підключає свої акаунти

Клієнт відкриває URL і авторизує (через OAuth) свої соціальні акаунти. Підключені акаунти прив’язуються до субпрофіля.

Вимоги

generate_jwt_social_linking_url вимагає profileKey. Якщо жоден не визначено, виклик поверне 400 з повідомленням “Profile Key is required…”.Для вашого акаунта має бути виділено домен для підключення соцмереж. Ця можливість доступна на планах Business та Enterprise.

Стани помилок

Наступні кроки

Connect & Setup

Автентифікація та націлення на профіль.

Каталог інструментів

27 інструментів, згрупованих за доменом, з описом призначення та області дії.