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

Мультитенантный API для соцсетей: один ключ API, много аккаунтов клиентов

Партнёрский API easyCoexistence изначально мультитенантный: один ключ ec_live_ в вашем аккаунте подключает и управляет номерами WhatsApp и аккаунтами соцсетей многих клиентов. Каждое подключение хранит id клиента как external_ref, содержит собственный токен этого клиента, получает собственное назначение вебхука и появляется в подписанных событиях статуса, поэтому GET /channels?external_ref= выводит аккаунты одного клиента.

200 characters

Самый длинный external_ref, который принимает сессия подключения: ваш собственный id клиента, сохраняемый в создаваемом подключении.

1 key

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

50 open

Сессии подключения, которые может одновременно держать открытыми один аккаунт, и лимит в 100 новых сессий в час.

5 minutes

Возраст, после которого временная метка подписанного события должна отклоняться; HMAC сравнивается за постоянное время.

Как один аккаунт обслуживает многих клиентов?

Ваш аккаунт easyCoexistence представляет ваш продукт, а каждый клиент является меткой на подключениях, которые он приносит. Клиентам не нужен собственный аккаунт, они никогда не видят ваш ключ, и счёт выставляете им вы, а не easyCoexistence:

Your accountOne ec_live_ key, one bill, one status events URL
Your customerYour own id, sent as external_ref
NumberA WhatsApp number at /connections
ChannelA social account at /channels
DestinationA webhook per number or channel

Как пометить каждое подключение вашим клиентом?

Передайте external_ref в сессии подключения. Значение сохраняется в номере или канале, который создаёт сессия, добавляется в перенаправление и включается в её события статуса. Вход через Facebook или LinkedIn, который подключает несколько страниц, помечает каждую из них. Чтобы увидеть аккаунты одного клиента, отфильтруйте любой из списков:

One customer's social accounts and numbers
curl "https://easycoexistence.com/api/v1/channels?external_ref=customer_4821" \
  -H "Authorization: Bearer $EC_API_KEY"

curl "https://easycoexistence.com/api/v1/connections?external_ref=customer_4821" \
  -H "Authorization: Bearer $EC_API_KEY"

Как токены клиентов остаются раздельными?

Каждое подключение хранит собственный токен своего клиента. Токен номера WhatsApp это бизнес-токен, который Meta выдаёт при Embedded Signup и который ограничен активами этого клиента, а токен соцсети это тот, который предоставил её владелец. Учётные данные передаются только через ваш ключ, с вашего бэкенда, а id, которого нет в вашем аккаунте, возвращает 404 not_found. Найдите подключение клиента, которому принадлежит задача, прежде чем запрашивать его токен, чтобы работа одного арендатора никогда не выполнялась в аккаунте другого.

Как работают вебхуки для каждого клиента?

Одно назначение на аккаунт, которое выбираете вы. Направьте каналы на один URL и маршрутизируйте по account_id в теле запроса, или дайте каждому клиенту собственный URL. Каждый канал подписывает запросы собственным секретом из PUT /channels/{id}/webhook, поэтому account_id подсказывает, каким секретом проверять подпись. Сообщения номера идут от Meta на его webhook_url, который задаётся в WhatsApp Business Account, поэтому маршрутизируйте их по phone_number_id.

Как события статуса указывают, какого клиента они касаются?

Через ваш external_ref, который они несут. Один URL для событий на аккаунт получает события connection.* и channel.*, в каждом из которых внутри представление подключения или канала, включая external_ref, а post.published и post.failed несут пост и его канал. События подписываются собственным секретом аккаунта в заголовке X-EC-Signature и повторяются при сбое вашего эндпоинта, поэтому обрабатывайте каждый id доставки один раз.

Как быстро можно подключить много клиентов?

По 50 открытых сессий подключения и 100 новых в час на аккаунт. Meta учитывает каждое первое подключение WhatsApp по общему для всех аккаунтов easyCoexistence лимиту на уровне приложения, а ограничения не дают импорту одной платформы его исчерпать. Создавайте сессию, когда её клиент готов подключиться, а при превышении лимита ответ будет 429 cap_reached или rate_limited.

Что делать, если аккаунт клиента уже подключён в другом месте?

Вход отклоняется. Аккаунт соцсети подключается через один аккаунт easyCoexistence в каждый момент, поэтому, если другой сервис на easyCoexistence его удерживает, в last_error сессии об этом написано, и клиент удаляет подключение там или входит под другим аккаунтом. Внутри вашего аккаунта клиент может подключить сколько угодно аккаунтов, каждый с тем же external_ref.

Как отключить одного клиента?

Перечислите его подключения и каналы по external_ref и выполните DELETE для каждого. Удаление номера отзывает доступ easyCoexistence в Meta и останавливает мониторинг; удаление канала отзывает доступ в сети и отменяет его посты, которые ещё ждут в очереди. Оплата за каждое прекращается в конце цикла, а остальные подключения клиента, как и подключения других арендаторов, не затрагиваются.

Распространённые ошибки

  • Использование email как external_ref. Адреса меняются, а значение сохраняется в каждом подключении, поэтому используйте стабильный id из вашей базы данных.
  • Проверка пересланных событий секретом чужого арендатора. Найдите секрет по account_id из тела запроса, так как каждый канал подписывается собственным.
  • Отправка ссылок на подключение всей клиентской базе сразу. Открытыми может быть только 50 сессий на аккаунт, поэтому приглашайте клиентов волнами.
  • Удаление клиента только в своей базе данных. Его подключения остаются на вашем аккаунте и в вашем счёте, пока каждое не будет удалено через API.
Настройка с EasyCoexistence

easyCoexistence позволяет одному ключу API обслуживать всю вашу клиентскую базу: их номера WhatsApp и аккаунты Instagram, Facebook, TikTok, YouTube и LinkedIn, а также другие каналы. Каждое подключение помечено id вашего клиента, имеет собственный токен, вебхук и подписанные события, и каждое отслеживается круглосуточно. От US$ 9 до US$ 0,75 за подключение в месяц, цена снижается по мере добавления подключений, первые 3 дня бесплатно.

Часто задаваемые вопросы

Нужен ли один аккаунт easyCoexistence на каждого клиента?

Нет. Один аккаунт и его ключ могут держать подключения многих клиентов, которые различаются по external_ref. Отдельные аккаунты нужны только тогда, когда вы хотите отдельные счета.

Могут ли мои клиенты видеть аккаунты друг друга?

Не через easyCoexistence. Они никогда не получают ваш ключ и открывают только собственные ссылки на подключение. Что каждый клиент видит внутри вашего продукта, решает ваш код.

Можно ли дать каждому клиенту отдельный URL вебхука?

Да. У каждого номера и каждого канала своё назначение, поэтому подходит URL для конкретного клиента, как и один общий URL с маршрутизацией по account_id.

Как выставляется счёт за мультитенантный аккаунт?

За подключение суммарно по всем вашим клиентам: от US$ 9 до US$ 0,75 за подключение в месяц, ставка определяется диапазоном вашего общего количества, первые 3 дня бесплатно.

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

API соцсетей под вашим брендом: публикации, комментарии и личные сообщения в вашем SaaSПубликации, ответы на комментарии и личные сообщения в вашем SaaS: что видят клиенты, где по-прежнему упоминается easyCoexistence и какие вызовы API.Как позволить клиентам подключить Instagram к вашему приложениюРазмещённая ссылка для аккаунтов Instagram ваших клиентов: вызов сессии, токен и публикация, ответы на комментарии и DM из вашего приложения.Как добавить WhatsApp в SaaS с помощью Embedded Signup и CoexistenceДобавьте WhatsApp в SaaS: подключайте номера клиентов через Embedded Signup и Coexistence, получайте сообщения, отвечайте в окне 24 часа, отправляйте шаблоны.Аутентификация Partner API: Bearer-ключи ec_live_, ротация и ошибки 401Как Partner API проверяет запросы: один ключ ec_live_ на аккаунт, создаётся в панели или через create_api_key, виден один раз. Ротация сразу.Как узнать, что подключение клиента к WhatsApp или соцсети отключилосьСобытия connection.* и channel.*: тело запроса, причины вроде PRIMARY_INACTIVITY, X-EC-Signature, повторы около 33 часов и дедупликация по id.Как дать вашим пользователям подключать аккаунты WhatsApp, Instagram и TikTok к вашему приложениюРазмещённые ссылки для подключения номеров WhatsApp и аккаунтов соцсетей: запрос сессии, перенаправление, статусы, срок действия и повторные попытки.

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

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

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

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