Единое API соцсетей для SaaS: одна интеграция для WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn и других каналов
Partner API от easyCoexistence даёт SaaS одну интеграцию для WhatsApp-номеров и аккаунтов в Instagram, Facebook, TikTok, YouTube, LinkedIn и других каналов их клиентов. Один ключ API и один вызов сессии подключения привязывают их. Те же вызовы выводят список, возвращают свежие учётные данные, настраивают вебхуки и отправляют подписанные события статуса, а эндпоинт posts публикует в Instagram, Facebook, TikTok и LinkedIn. Ответы идут через собственный API каждой сети с токеном клиента.
Ключи Partner API привязаны к аккаунту easyCoexistence; каждый номер и каждый аккаунт соцсети, который он подключает, принадлежит этому аккаунту.
Ежемесячная плата за подключение одинакова для номера WhatsApp и аккаунта соцсети и снижается по мере роста их количества.
Посты, которые аккаунт Instagram может опубликовать через API за скользящие 24 часа; карусель считается как один пост.
Видеопосты, которые TikTok публикует для аккаунта через его API, не более шести в минуту.
Окно обслуживания клиентов WhatsApp открывается после сообщения пользователя; когда оно закрывается, можно отправлять только одобренные шаблоны.
Что покрывает одна интеграция?
Работа, которая одинакова во всех сетях, с адреса https://easycoexistence.com/api/v1 и одним ключом ec_live_. Ваш код изучает эти вызовы один раз, а аккаунт клиента в TikTok обрабатывается так же, как его аккаунт в Instagram, с теми же ошибками, теми же идентификаторами и теми же подписанными событиями:
Что по-прежнему решает каждая сеть?
То, что разрешает её API. easyCoexistence подключает, продлевает и отслеживает каждый аккаунт одинаково, а возможности вашего продукта следуют собственным правилам каждой сети, поэтому личные сообщения, события комментариев и типы постов различаются от сети к сети:
Почему номера и аккаунты соцсетей разделены на отдельные ресурсы?
Потому что в них хранится разное. У номера есть телефон, WhatsApp Business Account и рейтинги Meta; у аккаунта соцсети есть имя пользователя и идентификатор в сети. Поэтому номера находятся по адресу /connections, а аккаунты соцсетей по адресу /channels, у каждого свои ID, свой параметр перенаправления, connection_id или channel_id, и свои имена событий. Интеграция, работающая только с WhatsApp, не сталкивается с каналом, пока сама его не запросит, а подключение остаётся единственным вызовом, который у них общий.
Как работает вызов posts для разных сетей?
Тело запроса одинаково везде: text, media, link и publish_at, плюс несколько полей, которые читает одна сеть, например ig_type в Instagram, title и disable_comment в TikTok и image_alt в LinkedIn. Ограничения каждой сети проверяются до постановки поста в очередь:
- Instagram: одно изображение или видео либо карусель из от 2 до 10; изображения в JPEG; поля для ссылки нет; текст до 2 200 символов.
- Facebook: текст, ссылка, одно изображение или одно видео; текст до 63 206 символов.
- TikTok: одно видео или фотопост из от 1 до 35 изображений в JPEG или WebP; ссылки нет; текст до 2 200 символов.
- LinkedIn: текст с одним изображением или одной ссылкой, для которой нужен заголовок; видео нет; текст до 3 000 символов.
Становится ли easyCoexistence посредником между вашим кодом и сетями?
Только там, где это экономит вашу работу: подключение, продление токенов, пересылка событий комментариев и личных сообщений и работа очереди постов. Ответы, чтение данных и всё остальное идут с вашего бэкенда напрямую в API сети с токеном клиента, а Meta доставляет сообщения номера напрямую на ваш сервер. Функция, которую добавит сеть, доступна из вашего кода сразу после её запуска, без ожидания обёртки.
Что происходит, когда подключается новая сеть?
Она появляется как новое значение channel в тех же вызовах. Ваши сессии подключения называют её, её аккаунты появляются в GET /channels, её события используют имена channel.*, и каждый аккаунт стоит столько же, сколько любое другое подключение. Канал, который аккаунт пока не может использовать, возвращает 400 channel_unavailable, а в сообщении перечисляются каналы, открытые для него.
Как настроить
- Create a keyIn the dashboard under Profile, Developers, create the ec_live_ key and store it in your backend's secrets.
- Save a cardAdd a card to the account, since connect sessions answer 402 billing_required until one is saved.
- Connect each customerCreate a connect session with the channel and your customer's id as external_ref, and send the customer to its url.
- Set the webhooksGive each number a webhook_url and each social account a destination with PUT /channels/{id}/webhook.
- Post and replyPublish with POST /channels/{id}/posts and reply through each network's API with fresh credentials.
Распространённые ошибки
- Создание личных сообщений для TikTok, YouTube или LinkedIn. У этих подключений нет личных сообщений, поэтому там планируйте ответы на комментарии, а ответы на личные сообщения оставьте для WhatsApp, Instagram и Messenger.
- Отправка поста в Instagram без медиа. Instagram требует изображение или видео, и запрос отклоняется до постановки в очередь, поэтому прикрепляйте медиа отдельно для каждой сети.
- Хранение channel_id и connection_id в одном столбце без указания типа. Это разные ресурсы с разными ID, поэтому фиксируйте, какому ресурсу принадлежит каждое значение.
- Публикация в LinkedIn из ленты без проверки. Условия API LinkedIn ограничивают автоматическую публикацию, поэтому сначала пусть человек одобрит каждый пост в LinkedIn.
easyCoexistence даёт вашему SaaS одну интеграцию для WhatsApp-номеров клиентов и их аккаунтов в Instagram, Facebook, TikTok, YouTube и LinkedIn, а также других каналов: ссылки подключения, учётные данные, вебхуки, события статуса и посты через официальный API каждой сети, с мониторингом каждого подключения 24/7. От US$ 9 до US$ 0,75 за подключение в месяц, по мере добавления подключений цена снижается; первые 3 дня бесплатно.
Часто задаваемые вопросы
Может ли один эндпоинт получать события от всех сетей?
Да. Направьте назначение каждого канала на один и тот же URL и маршрутизируйте по platform и account_id в теле. Сообщения номера WhatsApp приходят от Meta на его собственный webhook_url, который может быть тем же сервером.
Нужно ли мне регистрировать своё приложение в Meta, TikTok, Google и LinkedIn?
Нет. Клиенты входят через приложения easyCoexistence в этих сетях, а ваш бэкенд получает токен, нужный для вызова API каждой сети.
В какие сети публикует эндпоинт posts?
Instagram, страницы Facebook, TikTok и LinkedIn. Видео YouTube загружаются через собственный API YouTube с учётными данными канала.
Сколько стоит унифицированное API easyCoexistence?
Одинаково во всех сетях: от US$ 9 до US$ 0,75 за подключение в месяц, цена определяется диапазоном вашего общего количества. Первые 3 дня бесплатно.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на