Log masukMulakan percubaan percuma
easyCoexistence API rasmi

Cara membenarkan pengguna anda menyambungkan akaun WhatsApp, Instagram dan TikTok ke aplikasi anda

Untuk membenarkan pengguna menyambungkan akaun WhatsApp, Instagram dan TikTok ke aplikasi anda, cipta sesi sambungan dengan Partner API easyCoexistence dan hantar pengguna ke URL yang dihoskan. Di sana, mereka menyambungkan nombor WhatsApp melalui Embedded Signup Meta atau log masuk ke Instagram, Facebook, TikTok, YouTube, LinkedIn dan lebih banyak saluran, kemudian kembali ke redirect_url anda dengan id sambungan atau saluran yang baharu. Pautan sah selama satu jam.

1 hour

Tempoh pautan sambungan berfungsi; selepas itu status sesi menunjukkan tamat tempoh dan pautan baharu diperlukan.

50 open

Bilangan sesi sambungan yang boleh dibuka serentak oleh satu akaun, di samping had 100 sesi baharu sejam.

5 statuses

Sesi dicipta, dibuka, disambungkan, dibatalkan atau tamat tempoh, seperti yang dilaporkan oleh GET /connect-sessions/:id.

200 characters

Panjang maksimum URL panggil balik alternatif yang diterima Meta untuk menghala mesej webhook nombor WhatsApp ke tempat lain.

Bagaimana pautan sambungan berfungsi?

Seperti halaman pembayaran. Pelayan anda mencipta sesi, antara muka anda menghantar pelanggan ke URL sesi itu, pelanggan menyambung di halaman di easycoexistence.com, dan pelayar kembali ke redirect_url anda. Pelayan anda kemudian mengesahkan hasilnya dan mengambil bukti kelayakan sambungan baharu, semuanya dengan kunci API anda.

1CreatePOST /connect-sessions from your backend
2SendA redirect or a new tab to the session's url
3ConnectMeta's Embedded Signup, or the network's own sign-in
4ReturnYour redirect_url, with the session, status and new id
5ConfirmGET /connect-sessions/:id, then the credentials

Apa yang dimasukkan dalam permintaan?

Badan JSON yang dihantar ke https://easycoexistence.com/api/v1/connect-sessions, dengan kunci API anda sebagai token Bearer. Hanya redirect_url yang wajib:

  • redirect_url: URL https tempat pelanggan mendarat selepas itu.
  • channel: whatsapp, lalai, atau rangkaian media sosial yang terbuka kepada akaun anda mengikut nama huruf kecilnya, seperti instagram, tiktok atau youtube.
  • external_ref: id anda sendiri untuk pelanggan ini, sehingga 200 aksara.
  • partner_name: nama yang dipaparkan halaman dihoskan, sehingga 80 aksara; nama akaun anda secara lalai.
  • webhook_url dengan webhook_verify_token: untuk nombor sahaja, dan sentiasa bersama. Meta menghantar mesej nombor tersebut ke situ sejak saat ia disambungkan.
Create a session for a WhatsApp number
curl -X POST https://easycoexistence.com/api/v1/connect-sessions \
  -H "Authorization: Bearer $EC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "whatsapp",
    "redirect_url": "https://app.example.com/connect/return",
    "external_ref": "customer_4821",
    "partner_name": "ClinicApp",
    "webhook_url": "https://hooks.example.com/wa/<long-random-secret>",
    "webhook_verify_token": "another-long-random-string"
  }'

Apa yang dikembalikan?

Respons 201 dengan sesi. Hantar pelanggan ke URL, dan simpan id, yang bermula dengan cs_, untuk mencari sesi kemudian. expires_at tamat satu jam selepas sesi dicipta, dan connection_id atau channel_id diisi apabila pelanggan menyambung, bergantung pada saluran sesi. GET /connect-sessions/:id mengembalikan bentuk yang sama pada bila-bila masa.

201 Created
{
  "id": "cs_…",
  "url": "https://easycoexistence.com/connect/cs_…",
  "channel": "whatsapp",
  "status": "created",
  "external_ref": "customer_4821",
  "connection_id": null,
  "channel_id": null,
  "token_ready": false,
  "redirect_url": "https://app.example.com/connect/return",
  "webhook_url": "https://hooks.example.com/wa/<long-random-secret>",
  "last_error": null,
  "expires_at": "2026-10-31T15:00:00.000Z",
  "opened_at": null,
  "finished_at": null,
  "created_at": "2026-10-31T14:00:00.000Z"
}

Apakah ralat yang boleh dikembalikan apabila mencipta sesi?

Setiap ralat mempunyai badan yang sama, iaitu objek dengan kod dan mesej, dan mesej menyatakan apa yang perlu diperbetulkan. Mencipta sesi boleh mengembalikan:

  • 400 invalid_json atau invalid_request: badan bukan objek JSON, atau medan gagal pengesahan, seperti redirect_url yang bukan https.
  • 400 channel_unavailable: saluran tidak terbuka kepada akaun ini; mesej menyenaraikan saluran yang terbuka.
  • 401 unauthorized: kunci API tiada atau tidak sah.
  • 402 billing_required: akaun belum ada kad, dan semua yang disambungkan melaluinya dikenakan bayaran kepadanya.
  • 429 cap_reached: 50 sesi sudah dibuka; tunggu sehingga sebahagiannya selesai atau tamat tempoh.
  • 429 rate_limited: lebih daripada 100 sesi dalam sejam ini; mesej menyatakan berapa lama perlu menunggu.

Ke mana pelanggan mendarat selepas itu?

Pada redirect_url anda, dengan hasilnya ditambah pada query string. Hasil yang sama ada pada sesi, yang dibaca oleh pelayan anda dengan GET /connect-sessions/:id:

  • session: id sesi, cs_ diikuti aksara rawak.
  • status: connected, atau cancelled apabila pelanggan memilih Batal dan kembali.
  • external_ref: id anda untuk pelanggan, apabila sesi membawanya.
  • connection_id: id nombor yang baharu, untuk /connections.
  • channel_id: id akaun media sosial yang baharu, untuk /channels.
A number connected
https://app.example.com/connect/return?session=cs_…&status=connected&external_ref=customer_4821&connection_id=…

Apakah status yang boleh dimiliki sesi?

Lima. GET /connect-sessions/:id melaporkan status semasa, dengan opened_at, finished_at dan last_error, yang menyatakan sebab percubaan terkini gagal:

  • created: dicipta oleh pelayan anda, belum dibuka.
  • opened: pelanggan telah memuatkan halaman yang dihoskan.
  • connected: nombor atau akaun media sosial telah disambungkan, dan id-nya ada pada sesi.
  • cancelled: pelanggan keluar melalui Batal dan kembali.
  • expired: jam habis sebelum sesi selesai.

Berapa lama pautan berfungsi?

Satu jam dari penciptaan. Selepas itu halaman yang dihoskan memberitahu pelanggan bahawa pautan telah tamat tempoh, dengan butang kembali ke redirect_url anda ditandakan status=cancelled, dan sesi menunjukkan tamat tempoh. Sebuah akaun boleh memegang 50 sesi terbuka dan mencipta 100 sejam, kerana Meta mengira setiap penyertaan kali pertama dengan had seluruh aplikasi yang dikongsi oleh semua akaun.

Apa fungsi external_ref?

Ia mengaitkan setiap sambungan dengan pelanggan anda. Nilai yang anda hantar disimpan pada nombor atau saluran yang dicipta oleh sesi, ditambah pada pengalihan dan disertakan dalam setiap acara status mengenainya, jadi GET /connections?external_ref=customer_4821 dan GET /channels?external_ref=customer_4821 menyenaraikan apa yang telah disambungkan oleh pelanggan itu. Log masuk Facebook atau LinkedIn boleh membawa beberapa Halaman sekaligus: pengalihan menamakan yang pertama, dan penapis menyenaraikan yang selebihnya. Gunakan id yang stabil daripada pangkalan data anda sendiri, bukan e-mel yang boleh berubah.

Bagaimana jika pelanggan membatalkan atau log masuk gagal?

Ia bergantung pada tempat ia berlaku, dan sesi menyimpan rekodnya:

  • Tetingkap timbul Meta gagal atau ditutup: pelanggan menekan Sambung sekali lagi pada halaman yang sama selagi pautan masih terbuka.
  • Log masuk media sosial dibatalkan atau ditolak: pelanggan kembali ke halaman yang dihoskan dengan sebabnya dan boleh mencuba semula sehingga pautan tamat tempoh.
  • Akaun sudah disambungkan melalui akaun easyCoexistence yang lain: last_error menyatakannya, dan pelanggan log masuk dengan akaun yang berbeza.
  • Pelanggan memilih Batal dan kembali: redirect_url anda menerima status=cancelled dan sesi ditutup, jadi cipta sesi baharu untuk cubaan lain.
  • Pautan telah tamat tempoh: cipta sesi baharu.

Bagaimana jika nombor disambungkan tanpa token pelanggan?

Kadang-kadang Meta menyelesaikan Embedded Signup tanpa mengeluarkan token perniagaan milik pelanggan. Halaman yang dihoskan kemudian meminta satu lagi proses, yang mengambil beberapa saat. Jika pelanggan melangkaunya, sesi menunjukkan disambungkan dengan token_ready false dan URL acara anda menerima connection.token_missing: nombor itu menerima mesej, kerana id-nya sah, tetapi tidak dapat menghantar sehingga sesi sambungan baharu menyambungkannya semula dan mengeluarkan token.

Bagaimana jika webhook_url gagal semakan Meta?

Nombor tetap disambungkan. Meta menyemak webhook_url dengan jabat tangan GET, yang dilepasi oleh endpoint anda dengan mengulang hub.challenge apabila hub.verify_token sepadan. Jika gagal, last_error pada sesi bermula dengan webhook_url was not applied dan memberikan sebab Meta, dan PUT /connections/:id/webhook menetapkan destinasi sebaik sahaja endpoint menjawab. Ditetapkan dalam tempoh 24 jam selepas penyambungan, ia masih menerima import sekali sahaja bagi kenalan dan, jika pelanggan bersetuju untuk berkongsinya, sejarah sembang.

Apa yang dilihat pelanggan?

Halaman di easycoexistence.com dengan nama anda daripada partner_name, dan tanpa akaun, e-mel atau kad untuk diisi. Untuk nombor WhatsApp, ia memaparkan senarai semak kelayakan ringkas, kemudian tetingkap timbul Meta dan kod QR untuk diimbas dengan aplikasi WhatsApp Business. Untuk akaun media sosial, ia memaparkan satu butang, seperti Teruskan dengan TikTok, yang membuka skrin kebenaran rangkaian itu dalam tab yang sama, jadi ia turut berfungsi pada telefon.

Kesilapan biasa

  • Mempercayai query string sahaja. Sesiapa sahaja boleh menaip status=connected ke dalam URL, jadi sahkan dengan GET /connect-sessions/:id daripada pelayan anda sebelum menandakan pelanggan sebagai disambungkan.
  • Membenamkan pautan dalam iframe. Hantar pelanggan kepadanya dengan pengalihan atau tab baharu, kerana halaman yang dihoskan dan log masuk yang dibukanya memang direka untuk berjalan begitu.
  • Membuat pautan terlebih dahulu. Setiap pautan berfungsi selama sejam dan setiap yang terbuka dikira ke had 50, jadi cipta sesi apabila pelanggan hampir menyambung.
  • Menghantar webhook_url lebih panjang daripada 200 aksara. Meta menerima URL panggil balik alternatif sehingga 200 aksara, jadi yang lebih panjang tidak diguna pakai dan nombor itu disambungkan tanpanya.
Menggunakan EasyCoexistence untuk ini

easyCoexistence menyambungkan nombor WhatsApp pelanggan anda serta akaun Instagram, Facebook, TikTok, YouTube dan LinkedIn mereka, dan lebih banyak saluran, kepada perisian anda melalui satu pautan dihoskan, kemudian memberikan pelayan anda bukti kelayakan setiap sambungan, webhook dan acara status yang ditandatangani. Daripada US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan 3 hari pertama percuma.

Soalan lazim

Bolehkah satu pautan sambungan digunakan dua kali?

Tidak. Pautan selesai dengan satu nombor, atau dengan satu log masuk media sosial, yang di Facebook atau LinkedIn boleh membawa beberapa Halaman. Selepas itu ia dibaca sebagai disambungkan, jadi cipta sesi baharu untuk sambungan seterusnya.

Bolehkah saya hantar pautan melalui e-mel atau sembang?

Boleh, selagi pelanggan membukanya dalam masa sejam. Id sesi dalam URL itulah yang membenarkan halaman tersebut, jadi hantar setiap pautan hanya kepada pelanggan yang untuknya ia dibuat.

Adakah halaman yang dihoskan berfungsi pada telefon?

Log masuk media sosial berfungsi, kerana ia dibuka dalam tab yang sama. Nombor WhatsApp paling baik disambungkan dari komputer: pada telefon, tetingkap timbul Meta dibuka sebagai tab baharu, dan telefon itu sendiri diperlukan untuk mengimbas kod QR.

Bagaimana saya tahu pelanggan telah menyambung tanpa membuat tinjauan?

Tetapkan URL acara status dalam dashboard di bawah Profil, Pembangun. easyCoexistence kemudian menghantar connection.connected atau channel.connected, ditandatangani dan membawa external_ref anda, sebaik sahaja sambungan dibuat.

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