Cara mendapatkan API token pelanggan untuk WhatsApp, Instagram dan TikTok
Partner API easyCoexistence mengembalikan API token dan ID pelanggan yang terhubung dengan satu GET dan ?credentials=1. Untuk nomor WhatsApp, /connections/{id} memberikan waba_id, phone_number_id, base Graph API, endpoint pengiriman, dan token bisnis milik pelanggan. Untuk akun sosial, /channels/{id} memberikan base API jaringan, ID akun di jaringan tersebut, dan access token yang diperbarui untuk Anda, jadi ambil di awal setiap job.
Menambahkan credentials ke GET /connections/{id} untuk nomor WhatsApp dan ke GET /channels/{id} untuk akun sosial.
Masa berlaku access token pengguna Google, jenis yang dibawa panggilan API saluran YouTube.
Masa berlaku access token akun TikTok dari API for Business; refresh token-nya berlaku selama satu tahun.
Lama berlaku token Instagram jangka panjang yang diperbarui, dihitung sejak hari token itu diperbarui.
Access token Page jangka panjang dari Meta tidak memiliki tanggal kedaluwarsa, meski kondisi tertentu dapat membatalkannya.
Panggilan mana yang mengembalikan kredensial koneksi?
GET milik resource itu sendiri dengan ?credentials=1, diautentikasi dengan kunci ec_live_ Anda sebagai bearer token. Nomor WhatsApp berada di /connections/{id} dan akun sosial di /channels/{id}, masing-masing dengan namespace ID sendiri: redirect koneksi memberi Anda connection_id untuk nomor dan channel_id untuk akun sosial. GET /connections dan GET /channels mencantumkannya, dan ?external_ref= mempersempit daftar mana pun ke satu pelanggan. Tanpa parameter itu, panggilan yang sama mengembalikan koneksi tanpa token di dalamnya.
# 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"Apa yang dikembalikan panggilan kredensial nomor WhatsApp?
Koneksi itu sendiri ditambah objek credentials. waba_id dan phone_number_id mengidentifikasi WhatsApp Business Account dan nomor di Graph API Meta, dan token_ready menyatakan apakah token pelanggan sudah tersimpan. Di dalam credentials, graph_api_base dan send_endpoint sudah memuat versi Graph API, dan access_token adalah token bisnis yang diterbitkan Meta saat pelanggan terhubung, dibatasi untuk pelanggan tersebut. Backend Anda kemudian memanggil Meta secara langsung untuk mengirim, mengelola template, mengunggah media, dan mengedit profil bisnis.
- status: connected, degraded, disconnected, banned, suspended, removed atau unknown.
quality_ratingdanmessaging_tier: peringkat Meta, seperti GREEN, dan tingkatan nomor, sepertiTIER_1K.webhook_url: tempat Meta mengirim pesan nomor tersebut, atau null.disconnected_reason,last_checked_at,last_event_atdancreated_at: alasan pemutusan dari Meta jika tercatat, dan stempel waktu 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. …"
}
}Apa yang dikembalikan panggilan kredensial tiap jaringan sosial?
Tampilan saluran, sama seperti GET /channels/{id}, dengan id, channel, external_ref, name, username, external_id, status dan token_ready, ditambah objek credentials. Kredensial setiap jaringan memuat platform, base API, ID akun di jaringan itu, access_token, token_expires_at, token_note, dan contoh panggilan. Kolom ID, dan hal lain yang dibutuhkan suatu jaringan, berbeda:
Mengapa mengambil token sosial per job, bukan menyimpannya?
Karena sebagian token dirotasi dalam sehari, dan panggilan kredensial selalu menjawab dengan token yang valid pada saat itu. Token Google YouTube berlaku satu jam dan token TikTok sehari, dan easyCoexistence memperbarui keduanya sebelum habis. Token Instagram berlaku 60 hari dan diperbarui jauh sebelum itu, yang menerbitkan token baru. Token Page Facebook tidak kedaluwarsa selama Page tetap terhubung. Satu permintaan di awal setiap job memastikan kode Anda tidak pernah memanggil jaringan dengan token yang sudah tidak berlaku.
Apakah token nomor WhatsApp sebaiknya disimpan?
Ya. Itu adalah token bisnis dari Embedded Signup Meta, yang dibatasi Meta untuk pelanggan yang di-onboard itu, dan referensi meminta Anda menyimpannya di sisi Anda, karena dashboard tidak menampilkannya. Bacalah lagi setelah setiap event connection.connected, karena penyambungan ulang dapat menerbitkan token baru. Token nomor yang ditangguhkan atau dihapus tidak lagi disajikan, dan token pelanggan yang tidak lagi diterima Meta sementara nomor tetap merespons akan dicabut, sehingga token_ready menjadi false.
Apa arti token_ready dan token_missing?
token_ready bernilai true saat token pelanggan sudah tersimpan dan koneksi aktif. Pada nomor, nilainya bisa false tepat setelah terhubung, karena Meta terkadang menyelesaikan Embedded Signup tanpa menerbitkan token pelanggan. Halaman hosted kemudian meminta pelanggan menjalankan sekali lagi, dan endpoint event Anda menerima connection.token_missing. Jika mereka melewatkannya, nomor tetap menerima pesan, karena ID-nya valid, tetapi tidak dapat mengirim. Sesi connect baru untuk pelanggan itu menerbitkan token dan tidak pernah menggantikan token yang sudah berfungsi. Saluran sosial tidak memiliki token_missing: sign-in mereka selalu menghasilkan token pelanggan sendiri, sehingga token_ready mengikuti status.
Apa yang dikembalikan saat koneksi tidak memiliki token untuk diberikan?
Respons 200 dengan credentials yang berisi access_token null dan catatan tentang apa yang harus dilakukan, bukan kesalahan. Itu mencakup nomor dengan token_ready false, nomor yang ditangguhkan atau dihapus, dan saluran yang statusnya bukan connected, di mana catatannya meminta sesi connect baru. 404 not_found berarti ID tidak ada di akun Anda, dan 502 credentials_unavailable berarti token sosial yang baru tidak dapat diperoleh saat itu; mencoba kembali, dan periksa status saluran jika terus berulang.
Kesalahan umum
- Menyimpan token YouTube atau TikTok di file konfigurasi. Keduanya kedaluwarsa dalam satu jam dan sehari, jadi panggil endpoint kredensial di awal setiap job dan serahkan pembaruan kepada easyCoexistence.
- Mengirim dari nomor yang token_ready-nya false. Tidak ada token pelanggan untuk memanggil Meta; buka sesi connect baru untuk pelanggan itu, yang akan menerbitkannya.
- Memanggil TikTok dengan header Authorization. Business API-nya menerima token di header Access-Token, dengan business_id akun di setiap permintaan.
- Memanggil LinkedIn hanya dengan bearer token. LinkedIn juga memerlukan header LinkedIn-Version dan X-Restli-Protocol-Version yang tercantum di required_headers, serta URN pada path yang di-URL-encode.
easyCoexistence menghubungkan nomor WhatsApp pelanggan Anda serta akun Instagram, Facebook, TikTok, YouTube dan LinkedIn mereka, dan saluran lainnya, lalu menyerahkan kredensial setiap koneksi ke backend Anda saat diminta, dengan token sosial yang diperbarui dan setiap koneksi dipantau 24/7. US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Apakah token WhatsApp itu milik pelanggan sendiri?
Ya. Itu adalah token bisnis yang diterbitkan Meta saat pelanggan terhubung melalui Embedded Signup, dibatasi untuk pelanggan tersebut. Token sistem easyCoexistence tidak pernah diekspos, dan panggilan hanya mengembalikan token saat token_ready bernilai true.
Berapa lama token akses sosial berlaku?
Token YouTube berlaku satu jam, token TikTok sehari dan token Instagram hingga 60 hari, sedangkan token Page Facebook tidak kedaluwarsa. easyCoexistence memperbarui token yang memang dirotasi, sehingga setiap panggilan kredensial mengembalikan token yang berfungsi saat itu.
Apakah saya perlu aplikasi developer sendiri di setiap jaringan?
Tidak. Pelanggan masuk melalui aplikasi easyCoexistence sendiri di Meta, TikTok, Google dan LinkedIn, dan panggilan kredensial menyerahkan token ke backend Anda untuk memanggil API jaringan tersebut secara langsung.
Dapatkah asisten seperti Claude atau ChatGPT membaca kredensial yang sama?
Dapat. Setelah masuk ke akun Anda melalui server MCP, asisten itu dapat memanggil get_api_credentials untuk nomor dan get_social_credentials untuk akun sosial, yang mengembalikan kredensial yang sama dengan Partner API.
Lanjut membaca
Hubungkan saluran pertama Anda dalam dua menit.
Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.
- Gratis 3 hari
- Batalkan kapan saja
- Hanya API resmi
- Dipantau 24/7
Diverifikasi pada