ВойтиНачать бесплатный пробный период
easyCoexistence Официальные API

Единое 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 каждой сети с токеном клиента.

1 key

Ключи Partner API привязаны к аккаунту easyCoexistence; каждый номер и каждый аккаунт соцсети, который он подключает, принадлежит этому аккаунту.

US$ 9 to US$ 0.75

Ежемесячная плата за подключение одинакова для номера WhatsApp и аккаунта соцсети и снижается по мере роста их количества.

100 posts

Посты, которые аккаунт Instagram может опубликовать через API за скользящие 24 часа; карусель считается как один пост.

15 a day

Видеопосты, которые TikTok публикует для аккаунта через его API, не более шести в минуту.

24 hours

Окно обслуживания клиентов WhatsApp открывается после сообщения пользователя; когда оно закрывается, можно отправлять только одобренные шаблоны.

Что покрывает одна интеграция?

Работа, которая одинакова во всех сетях, с адреса https://easycoexistence.com/api/v1 и одним ключом ec_live_. Ваш код изучает эти вызовы один раз, а аккаунт клиента в TikTok обрабатывается так же, как его аккаунт в Instagram, с теми же ошибками, теми же идентификаторами и теми же подписанными событиями:

ConnectPOST /connect-sessions, with channel set to the network
ListGET /connections for numbers, GET /channels for social accounts
Credentials?credentials=1 on either, with tokens renewed for you
WebhooksPUT /connections/{id}/webhook or PUT /channels/{id}/webhook
Status eventsconnection.* and channel.*, signed, with your external_ref
PostsPOST /channels/{id}/posts, now or at publish_at
RemoveDELETE on the connection or the channel

Что по-прежнему решает каждая сеть?

То, что разрешает её API. easyCoexistence подключает, продлевает и отслеживает каждый аккаунт одинаково, а возможности вашего продукта следуют собственным правилам каждой сети, поэтому личные сообщения, события комментариев и типы постов различаются от сети к сети:

WhatsAppMessages and replies on the Cloud API, templates outside the 24-hour window
InstagramPosts, carousels, Reels and Stories; comments; replies to DMs
FacebookPage posts; comments; replies to Messenger DMs
TikTokVideo and photo posts; public replies to comments; no DMs
YouTubeUploads and comments through YouTube's own API; no DMs
LinkedInPosts a person approves, text with an image or a link; no DMs

Почему номера и аккаунты соцсетей разделены на отдельные ресурсы?

Потому что в них хранится разное. У номера есть телефон, 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, а в сообщении перечисляются каналы, открытые для него.

Как настроить

  1. Create a keyIn the dashboard under Profile, Developers, create the ec_live_ key and store it in your backend's secrets.
  2. Save a cardAdd a card to the account, since connect sessions answer 402 billing_required until one is saved.
  3. Connect each customerCreate a connect session with the channel and your customer's id as external_ref, and send the customer to its url.
  4. Set the webhooksGive each number a webhook_url and each social account a destination with PUT /channels/{id}/webhook.
  5. 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

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 дня бесплатно.

Читайте дальше

API соцсетей под вашим брендом: публикации, комментарии и личные сообщения в вашем SaaSПубликации, ответы на комментарии и личные сообщения в вашем SaaS: что видят клиенты, где по-прежнему упоминается easyCoexistence и какие вызовы API.Мультитенантный API для соцсетей: один ключ API, много аккаунтов клиентовОдин ключ API для аккаунтов клиентов в соцсетях и WhatsApp: метка external_ref, токены раздельно, вебхуки и события по каждому клиенту.Как добавить WhatsApp в SaaS с помощью Embedded Signup и CoexistenceДобавьте WhatsApp в SaaS: подключайте номера клиентов через Embedded Signup и Coexistence, получайте сообщения, отвечайте в окне 24 часа, отправляйте шаблоны.Как добавить публикацию в TikTok в ваш SaaSПубликация в TikTok для вашего SaaS: подключайте TikTok клиентов, публикуйте видео и фотопосты сразу или позже одним запросом и отслеживайте каждый пост.Как получить API-токены клиентов для WhatsApp, Instagram и TikTokПоля учётных данных для номера WhatsApp и аккаунтов в соцсетях, а также как работают обновление токенов и token_ready.Публикация в Instagram, TikTok, Facebook, YouTube и LinkedIn через один APIПубликуйте и планируйте посты в Instagram, Reels, Stories, видео TikTok, YouTube и LinkedIn из Claude, ChatGPT или кода.

Подключите первый канал за две минуты.

Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.

  • 3 дня бесплатно
  • Отмена в любой момент
  • Только официальные API
  • Мониторинг 24/7

Проверено по состоянию на