Мультитенантный API для соцсетей: один ключ API, много аккаунтов клиентов
Партнёрский API easyCoexistence изначально мультитенантный: один ключ ec_live_ в вашем аккаунте подключает и управляет номерами WhatsApp и аккаунтами соцсетей многих клиентов. Каждое подключение хранит id клиента как external_ref, содержит собственный токен этого клиента, получает собственное назначение вебхука и появляется в подписанных событиях статуса, поэтому GET /channels?external_ref= выводит аккаунты одного клиента.
Самый длинный external_ref, который принимает сессия подключения: ваш собственный id клиента, сохраняемый в создаваемом подключении.
Количество ключей API, которые может одновременно держать аккаунт easyCoexistence; отдельные ключи означают отдельные аккаунты с отдельными счетами.
Сессии подключения, которые может одновременно держать открытыми один аккаунт, и лимит в 100 новых сессий в час.
Возраст, после которого временная метка подписанного события должна отклоняться; HMAC сравнивается за постоянное время.
Как один аккаунт обслуживает многих клиентов?
Ваш аккаунт easyCoexistence представляет ваш продукт, а каждый клиент является меткой на подключениях, которые он приносит. Клиентам не нужен собственный аккаунт, они никогда не видят ваш ключ, и счёт выставляете им вы, а не easyCoexistence:
Как пометить каждое подключение вашим клиентом?
Передайте external_ref в сессии подключения. Значение сохраняется в номере или канале, который создаёт сессия, добавляется в перенаправление и включается в её события статуса. Вход через Facebook или LinkedIn, который подключает несколько страниц, помечает каждую из них. Чтобы увидеть аккаунты одного клиента, отфильтруйте любой из списков:
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 позволяет одному ключу 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 дня бесплатно.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на