Log masukMulakan percubaan percuma
easyCoexistence API rasmi

Cara mendapatkan token API pelanggan anda untuk WhatsApp, Instagram dan TikTok

Partner API easyCoexistence memulangkan token API dan ID milik pelanggan yang disambungkan melalui satu GET dengan ?credentials=1. Bagi nombor WhatsApp, /connections/{id} memberikan waba_id, phone_number_id, URL asas Graph API, endpoint hantar dan token perniagaan milik pelanggan itu sendiri. Bagi akaun media sosial, /channels/{id} memberikan URL asas API rangkaian, ID akaun di platform itu dan token akses yang diperbaharui untuk anda, jadi dapatkannya pada permulaan setiap tugas.

?credentials=1

Menambah parameter ?credentials=1 kepada GET /connections/{id} bagi nombor WhatsApp dan kepada GET /channels/{id} bagi akaun media sosial.

1 hour

Jangka hayat token akses pengguna Google, jenis yang dibawa oleh panggilan API saluran YouTube.

1 day

Tempoh sah token akses akaun TikTok daripada API for Business; token penyegarannya sah selama satu tahun.

60 days

Tempoh token Instagram jangka panjang yang disegarkan kekal sah, dikira dari hari ia disegarkan.

No expiry

Token Halaman Meta jangka panjang tidak mempunyai tarikh tamat, namun syarat tertentu boleh membatalkannya.

Panggilan manakah memulangkan kelayakan sambungan?

GET sumber itu sendiri dengan ?credentials=1, disahkan menggunakan kunci ec_live_ anda sebagai token pembawa. Nombor WhatsApp terletak di /connections/{id} dan akaun media sosial di /channels/{id}, masing-masing dengan ruang ID sendiri: ubah hala selepas menyambung memberikan connection_id bagi nombor dan channel_id bagi akaun media sosial. GET /connections dan GET /channels menyenaraikannya, dan ?external_ref= mempersempit mana-mana senarai itu kepada seorang pelanggan. Tanpa parameter, panggilan yang sama memulangkan sambungan tanpa token di dalamnya.

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"

Apakah yang dipulangkan panggilan kelayakan nombor WhatsApp?

Sambungan itu sendiri ditambah objek credentials. waba_id dan phone_number_id mengenal pasti WhatsApp Business Account dan nombor itu pada Graph API Meta; token_ready menyatakan sama ada token pelanggan sudah tersimpan. Dalam credentials, graph_api_base dan send_endpoint sudah membawa versi Graph API, dan access_token ialah token perniagaan yang dikeluarkan Meta semasa pelanggan menyambung, terhad kepada pelanggan itu. Backend anda kemudian memanggil Meta secara terus untuk menghantar, mengurus template, memuat naik media dan menyunting profil perniagaan.

  • status: connected, degraded, disconnected, banned, suspended, removed atau unknown.
  • quality_rating dan messaging_tier: penarafan kualiti Meta, seperti GREEN, dan tahap nombor itu, seperti TIER_1K.
  • webhook_url: tempat Meta menghantar mesej nombor itu, atau null.
  • disconnected_reason, last_checked_at, last_event_at dan created_at: sebab pemutusan Meta jika ada rekodnya, serta cap masa 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. …"
  }
}

Apa yang dipulangkan panggilan kelayakan setiap rangkaian media sosial?

Paparan saluran itu, sama seperti GET /channels/{id}, dengan id, channel, external_ref, name, username, external_id, status dan token_ready, ditambah objek credentials. Kelayakan setiap rangkaian mengandungi platform, URL asas API, ID akaun pada rangkaian itu, access_token, token_expires_at, token_note dan contoh panggilan. Medan ID, dan apa-apa lagi yang diperlukan sesuatu rangkaian, berbeza:

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.

Mengapa mendapatkan token media sosial bagi setiap tugas, bukannya menyimpannya?

Kerana sesetengahnya ditukar ganti dalam masa sehari, dan panggilan kelayakan sentiasa menjawab dengan token yang sah pada saat itu. Token Google YouTube bertahan satu jam dan token TikTok sehari, dan easyCoexistence memperbaharui kedua-duanya sebelum tamat tempoh. Token Instagram bertahan 60 hari dan diperbaharui jauh sebelum itu, yang mengeluarkan token baharu. Token Halaman Facebook tidak tamat tempoh selagi Halaman kekal disambungkan. Satu permintaan pada permulaan setiap tugas memastikan kod anda tidak pernah memanggil rangkaian dengan token yang sudah tamat tempoh.

Patutkah anda menyimpan token nombor WhatsApp?

Ya. Ia ialah token perniagaan daripada Embedded Signup Meta, yang Meta hadkan kepada pelanggan yang telah didaftarkan itu, dan rujukan meminta anda menyimpannya di pihak anda, kerana dashboard tidak memaparkannya. Baca semula selepas setiap peristiwa connection.connected, kerana sambungan semula boleh mengeluarkan yang baharu. Token nombor yang digantung atau dialih keluar tidak lagi diberikan, dan token pelanggan yang Meta berhenti terima semasa nombor itu masih menjawab akan ditarik balik, yang menjadikan token_ready bernilai false.

Apakah maksud token_ready dan token_missing?

token_ready bernilai true apabila token pelanggan tersimpan dan sambungan itu aktif. Pada nombor, ia boleh bernilai false sejurus selepas menyambung, kerana Meta kadangkala menamatkan Embedded Signup tanpa mengeluarkan token pelanggan. Halaman yang dihoskan kemudian meminta pelanggan menjalankannya sekali lagi, dan endpoint peristiwa anda menerima connection.token_missing. Jika mereka melangkaunya, nombor itu menerima mesej, kerana ID-nya sah, tetapi tidak boleh menghantar. Sesi sambungan baharu bagi pelanggan itu mengeluarkan token dan sekali-kali tidak menggantikan token yang sudah berfungsi. Saluran media sosial tidak mempunyai token_missing: log masuk mereka sentiasa menghasilkan token pelanggan sendiri, jadi token_ready mengikut status.

Apa yang dipulangkan apabila sambungan tidak mempunyai token untuk diberikan?

Respons 200 yang objek credentials-nya mengandungi access_token null dan nota yang memberitahu apa yang perlu dilakukan, bukannya ralat. Ini termasuk nombor dengan token_ready false, nombor yang digantung atau dialih keluar, dan saluran yang statusnya bukan connected, yang notanya meminta sesi sambungan baharu. 404 not_found bermaksud ID itu tiada dalam akaun anda, dan 502 credentials_unavailable bermaksud token media sosial yang baharu tidak dapat diperoleh pada ketika itu; cuba semula, dan semak status saluran jika ia berulang.

Kesilapan biasa

  • Menyimpan token YouTube atau TikTok dalam cache atau fail konfigurasi. Ia tamat tempoh dalam masa satu jam dan sehari, jadi panggil endpoint kelayakan pada permulaan setiap tugas dan serahkan penyegaran kepada easyCoexistence.
  • Menghantar dari nombor yang token_ready bernilai false. Tiada token pelanggan untuk memanggil Meta; buka sesi sambungan baharu bagi pelanggan itu, yang akan mengeluarkan satu.
  • Memanggil TikTok dengan header Authorization. Business API-nya menerima token dalam header Access-Token, dengan business_id akaun dalam setiap permintaan.
  • Memanggil LinkedIn dengan token pembawa sahaja. LinkedIn juga memerlukan header LinkedIn-Version dan X-Restli-Protocol-Version yang disenaraikan dalam required_headers, dan URN dalam laluan dikodkan URL.
Menggunakan EasyCoexistence untuk ini

easyCoexistence menyambungkan nombor WhatsApp pelanggan anda serta akaun Instagram, Facebook, TikTok, YouTube dan LinkedIn milik mereka, dan lebih banyak saluran, kemudian menyerahkan kelayakan setiap sambungan kepada backend anda apabila diminta, dengan token media sosial diperbaharui dan setiap sambungan dipantau 24/7. Daripada US$ 9 hingga US$ 0.75 bagi setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan 3 hari percubaan percuma.

Soalan lazim

Adakah token WhatsApp itu milik pelanggan sendiri?

Ya. Ia ialah token perniagaan yang Meta keluarkan apabila pelanggan menyambung melalui Embedded Signup, terhad kepada pelanggan itu. Token sistem easyCoexistence tidak pernah didedahkan, dan panggilan itu hanya memulangkan token apabila token_ready bernilai true.

Berapa lama token akses media sosial bertahan?

Token YouTube bertahan satu jam, token TikTok sehari dan token Instagram sehingga 60 hari, manakala token Halaman Facebook tidak tamat tempoh. easyCoexistence memperbaharui yang ditukar ganti, jadi setiap panggilan kelayakan memulangkan token yang berfungsi sekarang.

Adakah saya perlukan aplikasi pembangun sendiri pada setiap rangkaian?

Tidak. Pelanggan log masuk melalui aplikasi easyCoexistence sendiri di Meta, TikTok, Google dan LinkedIn, dan panggilan kelayakan menyerahkan kepada backend anda token untuk memanggil API rangkaian itu secara terus.

Bolehkah pembantu seperti Claude atau ChatGPT membaca kelayakan yang sama?

Ya. Selepas log masuk ke akaun anda melalui pelayan MCP, ia boleh memanggil get_api_credentials bagi nombor dan get_social_credentials bagi akaun media sosial, yang memulangkan kelayakan yang sama seperti Partner API.

Teruskan membaca

Sambungkan saluran pertama anda dalam masa dua minit.

Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.

  • 3 hari percuma
  • Batal bila-bila masa
  • API rasmi sahaja
  • Dipantau 24/7

Disahkan pada