API соцсетей для агентств: ведите аккаунты клиентов из собственного ПО
API соцсетей для агентств позволяет собственному ПО агентства подключать, публиковать, отвечать и формировать отчёты по аккаунтам каждого клиента. С Partner API от easyCoexistence номер WhatsApp клиента и его аккаунты в Instagram, Facebook, TikTok, YouTube и LinkedIn присоединяются к аккаунту агентства по ссылкам подключения, помеченным id клиента, а один ключ API планирует, направляет и отслеживает все эти аккаунты.
Наибольшая длина external_ref, которую принимает сессия подключения: собственный id агентства для клиента, он сохраняется в каждом подключении.
Срок, в течение которого ссылка подключения работает для клиента, который её открыл.
Что нужно приложению Meta, чтобы обслуживать профессиональные аккаунты Instagram, которыми оно не владеет и которыми не управляет, после проверки App Review и верификации Business.
Роль на странице LinkedIn, которая нужна участнику для разрешения rw_organization_admin, управляющего страницами и читающего их отчётность.
Когда прекращается оплата подключения клиента, которое агентство удаляет через API.
Как API организует клиентов агентства?
По вашему id клиента. Передавайте его как external_ref в каждой сессии подключения: он остаётся на каждом номере и аккаунте, которые создаёт сессия, и возвращается в каждом событии статуса. GET /channels?external_ref=client_118 выводит социальные аккаунты этого клиента, с &channel=instagram можно сузить выборку до одной сети, а GET /connections?external_ref=client_118 выводит его номера WhatsApp. Все клиенты находятся на одном аккаунте агентства под одним ключом ec_live_, и это ставит весь объём в один ценовой диапазон.
curl "https://easycoexistence.com/api/v1/channels?external_ref=client_118" \
-H "Authorization: Bearer $EC_API_KEY"
curl "https://easycoexistence.com/api/v1/connections?external_ref=client_118" \
-H "Authorization: Bearer $EC_API_KEY"Как клиент передаёт доступ?
Через ссылку, которую отправляет агентство. POST /connect-sessions с сетью в поле channel, external_ref клиента и названием агентства в partner_name возвращает url. Клиент открывает его, входит через экран согласия самой сети или запускает всплывающее окно Meta и сканирует QR-код для номера WhatsApp, а затем возвращается на redirect_url агентства. Вход через Facebook или LinkedIn может передать сразу несколько страниц, каждая становится отдельным подключением, поэтому сверяйте список с брифом клиента.
Как агентство публикует для клиентов?
Из собственного потока одобрения. ПО агентства хранит черновики до подтверждения клиентом, затем отправляет каждый одобренный пост на POST /channels/:id/posts с publish_at, до 90 дней вперёд. GET /channels/:id/posts показывает календарь одного аккаунта, GET /posts с фильтром статуса показывает всё, что ждёт, по всем клиентам, а post.published и post.failed сообщают менеджеру аккаунта, что произошло. Посты LinkedIn всегда проходят одобрение человека, и шаг подтверждения агентства уже это обеспечивает.
Как агентство отвечает на комментарии и личные сообщения клиентов?
Из одного входящего потока с маршрутизацией по аккаунту. PUT /channels/:id/webhook задаёт адрес вебхука для каждого аккаунта Instagram, страницы Facebook и аккаунта TikTok. Каждый пересланный комментарий, упоминание или личное сообщение содержит account_id, который соответствует клиенту. Сообщения номера WhatsApp идут от Meta на webhook_url, заданный для этого номера. Ответы уходят через API каждой сети с учётными данными из GET /channels/:id?credentials=1, а команда агентства может также работать с клиентами в Claude или ChatGPT через коннектор MCP на том же аккаунте.
Как агентство строит отчёты для клиентов?
По собственной аналитике каждой сети, с учётными данными аккаунта клиента. Данные Instagram и Facebook берутся из Graph API Meta, TikTok из его API для бизнеса, YouTube из YouTube Analytics, базовый адрес которого входит в учётные данные, а LinkedIn из его эндпоинтов статистики. Задание агентства для отчётов в начале каждого запуска получает свежие учётные данные по каждому аккаунту, забирает показатели за период и сохраняет их под external_ref клиента.
Как агентство узнаёт, что аккаунту клиента нужно внимание?
Из подписанных событий статуса. channel.disconnected и connection.disconnected несут external_ref клиента, поэтому ПО агентства может оповестить менеджера аккаунта этого клиента и отправить клиенту новую ссылку подключения. Каждое подключение мониторится круглосуточно, а владельцу агентства тоже приходит письмо, когда подключение отключается. Клиент, который отзывает доступ в настройках сети, проявляется так же.
Что происходит в API, когда клиент уходит?
Задание агентства по отключению клиентов выводит подключения клиента по external_ref и вызывает DELETE /channels/:id и DELETE /connections/:id для каждого. Оплата за них прекращается в конце цикла, запланированные посты на удалённом канале отменяются, а токен удалённого социального аккаунта забывается. Номер WhatsApp остаётся в Cloud API, пока клиент не отключит его в приложении WhatsApp Business.
Распространённые ошибки
- Постановка постов клиентов в очередь до их одобрения. Поставленный в очередь пост публикуется в своё время без дополнительной проверки, поэтому держите черновики на шаге одобрения и отправляйте их только после подтверждения.
- Передача ключа Partner API во фронтенд клиентского портала. Ключ даёт доступ к учётным данным всех клиентов на аккаунте, поэтому держите его на сервере агентства.
- Ожидание событий комментариев из канала YouTube клиента или страницы LinkedIn. easyCoexistence не получает их ни от одной из этих сетей, поэтому задание отчётов или входящих читает их через API каждой сети.
easyCoexistence даёт собственному ПО агентства один API для номеров WhatsApp клиентов и их аккаунтов в Instagram, Facebook, TikTok, YouTube и LinkedIn, а также другие каналы по мере их появления: ссылки подключения с привязкой по клиентам, очередь публикаций, пересылку комментариев и личных сообщений, свежие учётные данные для отчётов и круглосуточный мониторинг каждого подключения. От US$ 9 до US$ 0,75 за подключение в месяц, со снижением по мере добавления подключений, с бесплатным пробным периодом 3 дня.
Часто задаваемые вопросы
Нужен ли клиентам собственный аккаунт easyCoexistence?
Нет. Клиент открывает ссылку и входит, а подключение присоединяется к аккаунту агентства, где оно оплачивается и мониторится.
Может ли агентство держать клиентов на отдельных ключах API?
На одном аккаунте один ключ. Отдельные ключи означают отдельные аккаунты easyCoexistence, каждый из которых оплачивается с первого диапазона, поэтому большинство агентств разделяют клиентов по external_ref.
Видит ли клиент название агентства при подключении?
Да. Страница подключения показывает название, переданное как partner_name. Экран согласия сети называет easyCoexistence приложением, которое запрашивает доступ.
Сколько стоит easyCoexistence для агентства?
От US$ 9 до US$ 0,75 за подключение клиента в месяц, со снижением по мере добавления клиентов, одинаково во всех сетях, с бесплатным пробным периодом 3 дня.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на