MasukMulai uji coba gratis
easyCoexistence API resmi

Cara menambahkan WhatsApp ke SaaS Anda dengan Embedded Signup dan Coexistence

Sebuah SaaS menambahkan WhatsApp dengan menghubungkan nomor yang sudah dimiliki setiap pelanggan melalui Embedded Signup milik Meta dengan Coexistence, sehingga nomor tersebut tetap berfungsi di aplikasi WhatsApp Business. Dengan Partner API easyCoexistence, satu sesi koneksi per pelanggan menjalankan alur ini di halaman yang dihosting, Meta mengirim pesan dari nomor tersebut ke webhook_url Anda, dan backend Anda membalas melalui Cloud API dengan token milik pelanggan itu sendiri.

20 mps

Throughput tetap dari nomor yang digunakan dengan aplikasi WhatsApp Business dan Cloud API.

2.24.17

Versi aplikasi WhatsApp Business paling lama yang dapat dihubungkan nomor pelanggan melalui Coexistence.

180 days

Seberapa jauh ke belakang riwayat chat yang dapat dibagikan Meta saat onboarding; harus disinkronkan dalam 24 jam.

24 hours

Jendela layanan pelanggan WhatsApp setelah pesan atau panggilan dari pengguna; setiap pesan baru mengatur ulangnya.

October 15, 2026

Tanggal Meta menghentikan Embedded Signup v2 dan v3, dengan integrasi dipindahkan ke v4.

Apa saja bagian dari integrasi WhatsApp?

Ada lima, dan easyCoexistence menangani yang pertama dan yang terakhir. Produk Anda menangani logika percakapan, kotak masuk, dan apa pun yang ditulis model Anda atau staf pelanggan Anda, sementara Meta membawa pesan antara nomor dan server Anda:

1ConnectEmbedded Signup with Coexistence on a hosted page
2Routewebhook_url set on the number as it connects
3ReceiveMeta posts messages and echoes to your server
4ReplyCloud API calls with the customer's token
5WatchStatus events when the number drops or returns

Apa yang diubah Coexistence bagi pelanggan Anda?

Mereka tetap memakai nomor dan ponsel mereka. Aplikasi WhatsApp Business tetap berjalan berdampingan dengan Cloud API, sehingga staf membalas lewat ponsel sementara produk Anda membalas lewat API, dan apa yang mereka kirim dari aplikasi sampai ke webhook Anda sebagai smb_message_echoes. Ada tiga batasan: nomor mengirim pada tetap 20 pesan per detik, hanya API yang dapat mengirim template, dan Meta memutus nomor bila ponsel tidak aktif selama sekitar 14 hari.

Seperti apa langkah koneksi di produk Anda?

Tombol Connect WhatsApp yang memanggil POST /connect-sessions dari backend Anda dengan redirect_url, id pelanggan Anda sebagai external_ref, serta webhook_url dengan webhook_verify_token, sehingga Meta mengarahkan nomor ke Anda sejak menit pertama. Pelanggan mengonfirmasi daftar periksa singkat di halaman yang dihosting, menjalankan popup Meta, memindai kode QR dengan aplikasi WhatsApp Business, dan kembali ke Anda dengan connection_id. Apakah menjalankan Embedded Signup dari aplikasi Tech Provider Anda sendiri sebagai gantinya dipertimbangkan dalam panduan Embedded Signup.

Bagaimana pesan sampai ke backend Anda?

Dari Meta, langsung ke webhook_url, tanpa singgah di easyCoexistence dan tanpa salinan yang disimpan. Field messages membawa apa yang dikirim pelanggan dan status pesan yang Anda kirim, sementara smb_message_echoes membawa apa yang dikirim staf dari aplikasi. Meta menandatangani setiap pengiriman dengan app secret easyCoexistence yang tidak pernah dibagikan, sehingga secret acak yang panjang di path URL berfungsi sebagai autentikasi. Dua nomor dalam satu WhatsApp Business Account berbagi tujuan yang sama: lakukan routing berdasarkan value.metadata.phone_number_id.

Bagaimana backend Anda membalas dan mengirim template?

Dengan Graph API milik Meta dan token pelanggan dari GET /connections/{id}?credentials=1, yang juga mengembalikan send_endpoint. Teks bebas terkirim dalam 24 jam sejak pesan terakhir orang tersebut; setelah itu, hanya template yang telah disetujui Meta:

  • Balasan: POST /<PHONE_NUMBER_ID>/messages dengan type text, di dalam jendela layanan pelanggan.
  • Template: panggilan yang sama dengan type template, nama template, dan kode bahasanya.
  • Membuat template: POST /<WABA_ID>/message_templates, lalu cek statusnya secara berkala, karena hasil peninjauan tidak sampai ke webhook_url Anda.
  • Media: POST /<PHONE_NUMBER_ID>/media untuk mengunggah; media masuk tiba sebagai ID yang diambil dengan token yang sama.
Reply inside the customer service window
curl -X POST "$SEND_ENDPOINT" \
  -H "Authorization: Bearer $CUSTOMER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "5511987654321",
    "type": "text",
    "text": { "body": "Your table for 4 is booked for 8 pm." }
  }'

Bisakah produk Anda mengimpor chat yang sudah ada milik pelanggan?

Sekali, saat koneksi. Dengan webhook_url yang diatur pada sesi, easyCoexistence meminta Meta mengirim kontak nomor tersebut dan, jika pelanggan menyetujuinya di aplikasi, hingga 180 hari chat, yang tiba sebagai webhook smb_app_state_sync dan history. Meta hanya mengizinkannya dalam 24 jam setelah terhubung, jadi pastikan endpoint sudah merespons sebelum tautan dikirim. Panduan riwayat chat membahas payload-nya.

Siapa yang membayar Meta untuk pesan?

Pelanggan Anda. Meta menagihkan pesan yang dikirim backend Anda melalui API ke WhatsApp Business Account milik pelanggan, dengan metode pembayaran yang mereka tambahkan di sana, dan bisnis tanpa metode pembayaran tidak dapat mengirim template pemasaran. easyCoexistence menagih akun Anda per nomor yang terhubung dan tidak pernah menagih pesan atau memberi markup pada harga Meta.

Apa yang terjadi saat sebuah nomor terputus?

URL event Anda menerima connection.disconnected dengan alasan dari Meta bila diketahui. PRIMARY_INACTIVITY adalah aturan 14 hari, dan sesi koneksi baru untuk pelanggan itu akan mengembalikan nomor yang sama. connection.token_missing berarti nomor terhubung tanpa token pelanggan, sehingga nomor itu menerima pesan tetapi tidak dapat mengirim sampai sesi baru menghubungkannya kembali.

Kesalahan umum

  • Mengirim tautan koneksi sebelum endpoint webhook Anda merespons. Impor riwayat berjalan sekali, dalam 24 jam setelah terhubung, dan konten yang dikirim sebelum URL Anda berfungsi akan hilang.
  • Membalas dengan teks bebas setelah jendela layanan tertutup. Setelah 24 jam sejak pesan terakhir orang tersebut, hanya template yang disetujui yang terkirim.
  • Menjalankan kampanye dari satu nomor dengan kecepatan penuh. Nomor Coexistence mengirim 20 pesan per detik, jadi masukkan ke antrean pengiriman setiap nomor pada kecepatan itu.
  • Berharap staf mengirim template dari ponsel. Dalam Coexistence hanya API yang dapat mengirimnya, jadi letakkan pengiriman template di produk Anda.
Melakukan ini dengan EasyCoexistence

easyCoexistence menambahkan WhatsApp ke SaaS Anda dengan Embedded Signup dan Coexistence milik Meta di halaman yang dihosting dan menampilkan nama Anda: pelanggan tetap memakai nomor dan aplikasi WhatsApp Business, Meta mengirim pesan ke server Anda, dan event bertanda tangan menjangkau Anda. API yang sama menghubungkan Instagram, Facebook, TikTok, YouTube, LinkedIn, dan saluran lainnya. US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring penambahan koneksi, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Bisakah pelanggan menghubungkan nomor yang masih ada di penyedia API WhatsApp lain?

Tidak selama nomor itu masih di sana. Daftar periksa yang dihosting meminta nomor yang tidak memiliki penyedia API atau alat otomasi lain, sehingga pelanggan harus memutusnya dari penyedia tersebut terlebih dahulu.

Bisakah SaaS saya mengirim template WhatsApp untuk pelanggannya?

Bisa, melalui Cloud API dengan token setiap pelanggan: buat template di WhatsApp Business Account mereka, tunggu peninjauan Meta, lalu kirim.

Apakah easyCoexistence membaca pesan WhatsApp pelanggan saya?

Tidak. Meta mengirim pesan dari nomor langsung ke webhook_url yang Anda atur. Nomor tanpa webhook_url dialihkan ke acuan cadangan easyCoexistence, yaitu callback tempat pesan dibuang tanpa disimpan.

Berapa biaya easyCoexistence per nomor WhatsApp?

US$ 9 hingga US$ 0.75 per nomor per bulan, sesuai tingkat total koneksi Anda, dengan 3 hari pertama gratis. Biaya pesan Meta ditagihkan ke WhatsApp Business Account masing-masing pelanggan.

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