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

Как получить 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=1

Добавляет credentials к GET /connections/{id} для номера WhatsApp и к GET /channels/{id} для аккаунта в соцсети.

1 hour

Срок жизни токена доступа пользователя Google, с которым идут вызовы API канала YouTube.

1 day

Срок действия токена доступа аккаунта TikTok из API for Business; его refresh-токен действителен один год.

60 days

Срок действия обновлённого долгоживущего токена Instagram, отсчитываемый со дня обновления.

No expiry

Долгоживущие токены доступа Page от Meta не имеют срока истечения, однако определённые условия могут их аннулировать.

Какой запрос возвращает учётные данные подключения?

Собственный запрос GET ресурса с ?credentials=1, аутентифицированный вашим ключом ec_live_ как bearer-токеном. Номер WhatsApp находится по адресу /connections/{id}, аккаунт в соцсети по адресу /channels/{id}, и у каждого свой пространство ID: редирект подключения передаёт connection_id для номера и channel_id для аккаунта в соцсети. GET /connections и GET /channels выводят списки, а ?external_ref= сужает любой из них до одного клиента. Без этого параметра те же запросы возвращают подключение без токена.

Credentials for a number and for a social account
# 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.
GET /connections/{id}?credentials=1
{
  "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 и всё, что нужно конкретной сети, различаются:

Instagramgraph_api_base https://graph.instagram.com/v25.0 and account_id_on_meta, the Instagram account's ID. A user token, refreshed before its 60 days run out.
Facebookgraph_api_base https://graph.facebook.com/v25.0 and account_id_on_meta, the Page ID. A Page token that does not expire while the Page stays connected.
TikTokapi_base https://business-api.tiktok.com/open_api/v1.3 and business_id. A day-long token, sent in an Access-Token header with business_id on each call.
YouTubeapi_base https://www.googleapis.com/youtube/v3, analytics_api_base for YouTube Analytics v2, and channel_id. An hour-long Google token, sent as a bearer token.
LinkedInapi_base https://api.linkedin.com/rest, author_urn for the Page or profile, and required_headers with LinkedIn-Version and X-Restli-Protocol-Version 2.0.0.

Почему токен соцсети запрашивается при каждой задаче, а не сохраняется?

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

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 и комментарии соцсетей по вебхукуВебхук на каждое подключение: сообщения WhatsApp напрямую от Meta, защита секретом в URL, а комментарии и DM соцсетей подписаны X-EC-Signature.Как узнать, что подключение клиента к WhatsApp или соцсети отключилосьСобытия connection.* и channel.*: тело запроса, причины вроде PRIMARY_INACTIVITY, X-EC-Signature, повторы около 33 часов и дедупликация по id.Как построить продукт с ИИ-агентом в WhatsApp, Instagram и TikTok ваших клиентовСоздайте продукт с ИИ-агентом в WhatsApp, Instagram, Facebook и TikTok клиентов: Partner API, своя модель и правила каждой сети.Публикация в Instagram, TikTok и Facebook из Python через один APIПубликуйте посты, читайте комментарии и отвечайте на личные сообщения в Instagram, Facebook, TikTok, YouTube и LinkedIn из Python через официальные API.Публикация в Instagram, TikTok и Facebook из Node.js одним APIПубликуйте, планируйте и отвечайте в Instagram, Facebook, TikTok, YouTube и LinkedIn из Node.js и TypeScript через fetch, плюс MCP-инструменты для агента.Токены доступа Instagram: долгоживущие токены, 60 дней и обновлениеКак работают токены доступа Instagram Login: токен на один час после входа, долгоживущий на 60 дней и обновление через 24 часа.

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

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

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

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