Как получить API-токены клиентов для WhatsApp, Instagram и TikTok
Партнёрский API easyCoexistence возвращает API-токен подключённого клиента и его идентификаторы одним запросом GET с ?credentials=1. Для номера WhatsApp /connections/{id} отдаёт waba_id, phone_number_id, базовый адрес Graph API, эндпоинт отправки и собственный бизнес-токен клиента. Для аккаунта в соцсети /channels/{id} отдаёт базовый адрес API сети, ID аккаунта в ней и токен доступа, который для вас обновляется, поэтому запрашивайте его в начале каждой задачи.
Добавляет credentials к GET /connections/{id} для номера WhatsApp и к GET /channels/{id} для аккаунта в соцсети.
Срок жизни токена доступа пользователя Google, с которым идут вызовы API канала YouTube.
Срок действия токена доступа аккаунта TikTok из API for Business; его refresh-токен действителен один год.
Срок действия обновлённого долгоживущего токена Instagram, отсчитываемый со дня обновления.
Долгоживущие токены доступа Page от Meta не имеют срока истечения, однако определённые условия могут их аннулировать.
Какой запрос возвращает учётные данные подключения?
Собственный запрос GET ресурса с ?credentials=1, аутентифицированный вашим ключом ec_live_ как bearer-токеном. Номер WhatsApp находится по адресу /connections/{id}, аккаунт в соцсети по адресу /channels/{id}, и у каждого свой пространство ID: редирект подключения передаёт connection_id для номера и channel_id для аккаунта в соцсети. GET /connections и GET /channels выводят списки, а ?external_ref= сужает любой из них до одного клиента. Без этого параметра те же запросы возвращают подключение без токена.
# A WhatsApp number
curl "https://easycoexistence.com/api/v1/connections/$CONNECTION_ID?credentials=1" \
-H "Authorization: Bearer $EC_API_KEY"
# A social account
curl "https://easycoexistence.com/api/v1/channels/$CHANNEL_ID?credentials=1" \
-H "Authorization: Bearer $EC_API_KEY"Что возвращает запрос учётных данных номера WhatsApp?
Само подключение и объект credentials. waba_id и phone_number_id определяют бизнес-аккаунт WhatsApp и номер в Graph API Meta, а token_ready показывает, сохранён ли токен клиента. Внутри credentials поля graph_api_base и send_endpoint уже содержат версию Graph API, а access_token это бизнес-токен, который Meta выдала при подключении клиента, ограниченный этим клиентом. Ваш бэкенд затем обращается к Meta напрямую, чтобы отправлять сообщения, управлять шаблонами, загружать медиа и редактировать бизнес-профиль.
- status: connected, degraded, disconnected, banned, suspended, removed или unknown.
quality_ratingиmessaging_tier: рейтинг качества Meta, например GREEN, и уровень номера, напримерTIER_1K.webhook_url: адрес вебхука, куда Meta отправляет сообщения номера, или null.disconnected_reason,last_checked_at,last_event_atиcreated_at: причина отключения от Meta, если она зафиксирована, и временные метки в формате ISO 8601.
{
"id": "<CONNECTION_ID>",
"external_ref": "customer_4821",
"connect_session_id": "cs_…",
"phone": "+55 11 9…",
"name": "Clínica Sorriso",
"waba_id": "<WABA_ID>",
"phone_number_id": "<PHONE_NUMBER_ID>",
"status": "connected",
"quality_rating": "GREEN",
"messaging_tier": "TIER_1K",
"platform_type": "…",
"token_ready": true,
"webhook_url": "https://hooks.example.com/wa/<long-random-secret>",
"disconnected_reason": null,
"last_checked_at": "2026-10-31T09:00:00.000Z",
"last_event_at": "2026-10-31T08:41:12.000Z",
"created_at": "2026-10-20T14:03:55.000Z",
"credentials": {
"graph_api_base": "https://graph.facebook.com/v25.0",
"send_endpoint": "https://graph.facebook.com/v25.0/<PHONE_NUMBER_ID>/messages",
"access_token": "EAAG…",
"note": "The customer's own business token, scoped to their assets. …"
}
}Что возвращает запрос учётных данных каждой соцсети?
Представление канала, то же, что GET /channels/{id}: id, channel, external_ref, name, username, external_id, status и token_ready, а также объект credentials. В credentials каждой сети есть platform, базовый адрес API, ID аккаунта в этой сети, access_token, token_expires_at, token_note и примеры вызовов. Поле ID и всё, что нужно конкретной сети, различаются:
Почему токен соцсети запрашивается при каждой задаче, а не сохраняется?
Потому что некоторые токены обновляются в течение суток, а запрос учётных данных всегда возвращает токен, действительный в данный момент. Токен Google для YouTube действует час, токен TikTok сутки, и easyCoexistence обновляет оба до истечения срока. Токен Instagram действует 60 дней и обновляется заранее, при этом выдаётся новый токен. Токен страницы Facebook не истекает, пока страница подключена. Один запрос в начале каждой задачи не даёт вашему коду вызывать сеть с истёкшим токеном.
Нужно ли сохранять токен номера WhatsApp?
Да. Это бизнес-токен из Embedded Signup Meta, который Meta ограничивает этим клиентом, и документация просит сохранять его у вас, так как панель управления его не показывает. Читайте его заново после каждого события connection.connected, потому что переподключение может выдать новый. Токен приостановленного или удалённого номера больше не отдаётся, а токен клиента, который Meta перестаёт принимать, пока номер отвечает, отзывается, и token_ready становится false.
Что означают token_ready и token_missing?
token_ready равно true, когда токен клиента сохранён и подключение работает. У номера оно может быть false сразу после подключения, так как Meta иногда завершает Embedded Signup без выдачи токена клиента. Размещённая страница тогда просит клиента пройти процедуру ещё раз, а ваш эндпоинт событий получает connection.token_missing. Если клиент её пропускает, номер получает сообщения, поскольку его ID верны, но отправлять не может. Новая сессия подключения для этого клиента выдаёт токен и никогда не заменяет уже работающий. У каналов соцсетей нет token_missing: вход всегда даёт собственный токен клиента, поэтому token_ready следует за status.
Что возвращается, когда у подключения нет токена?
Ответ 200, в котором credentials содержат access_token: null и примечание о том, что делать, а не ошибку. Это относится к номеру с token_ready false, к приостановленному или удалённому номеру и к каналу, чей status не connected: тогда примечание просит новую сессию подключения. 404 not_found означает, что ID нет в вашем аккаунте, а 502 credentials_unavailable означает, что свежий токен соцсети в этот момент получить не удалось; повторите запрос, а если ошибка повторяется, проверьте status канала.
Распространённые ошибки
- Хранение токена YouTube или TikTok в конфигурационном файле. Они истекают за час и за сутки, поэтому запрашивайте эндпоинт учётных данных в начале каждой задачи и оставьте обновление easyCoexistence.
- Отправка с номера, у которого token_ready равен false. У вас нет токена клиента для вызовов Meta; откройте новую сессию подключения для этого клиента, она выдаст токен.
- Вызов TikTok с заголовком Authorization. Его Business API принимает токен в заголовке Access-Token, а business_id аккаунта передаётся в каждом запросе.
- Вызов LinkedIn только с bearer-токеном. LinkedIn также требует заголовки LinkedIn-Version и X-Restli-Protocol-Version, перечисленные в required_headers, а URN в путях кодируются по правилам URL.
easyCoexistence подключает номера WhatsApp ваших клиентов и их аккаунты в Instagram, Facebook, TikTok, YouTube и LinkedIn, а также другие каналы. По запросу передаёт вашему бэкенду учётные данные каждого подключения, обновляет токены соцсетей и круглосуточно отслеживает каждое подключение. От US$ 9 до US$ 0,75 за подключение в месяц, с понижением по мере добавления подключений, первые 3 дня бесплатно.
Часто задаваемые вопросы
Токен WhatsApp принадлежит клиенту?
Да. Это бизнес-токен, который Meta выдаёт при подключении клиента через Embedded Signup, и он ограничен этим клиентом. Системный токен easyCoexistence никогда не раскрывается, а запрос возвращает токен только при token_ready равном true.
Сколько живут токены доступа соцсетей?
Токен YouTube действует час, TikTok сутки, Instagram до 60 дней, а токен страницы Facebook не истекает. easyCoexistence обновляет токены, которые ротируются, поэтому каждый запрос учётных данных возвращает токен, который работает прямо сейчас.
Нужно ли мне собственное приложение разработчика в каждой сети?
Нет. Клиенты входят через собственное приложение easyCoexistence в Meta, TikTok, Google и LinkedIn, а запрос учётных данных передаёт вашему бэкенду токен для прямых вызовов API этой сети.
Может ли ассистент, например Claude или ChatGPT, читать те же учётные данные?
Да. Войдя в ваш аккаунт через MCP-сервер, он может вызвать get_api_credentials для номера и get_social_credentials для аккаунта в соцсети. Он возвращает те же учётные данные, что и Partner API.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на