Pengurus Peranti
Cloud API Errors
Error biasa semasa daftar WhatsApp Cloud API dan cara nak betulkan.
Bila anda connect device guna Cloud API, ReplyLa akan buka tetingkap Embedded Signup dari Meta. Kebanyakan masalah sambungan berlaku dalam tetingkap ni, bukan dalam ReplyLa sendiri. Halaman ni menyenaraikan error yang mungkin anda nampak dan cara nak betulkannya.
Halaman ni meliputi signupCloud API sahaja. Nak connect melalui Meta Coexistence pula? Lihat Coexistence Issues.
Proses signup ada empat peringkat, dan error biasanya berlaku pada salah satu daripadanya:
- Akaun Business Manager - mencipta atau memilih akaun Meta Business.
- Akaun WhatsApp Business (WABA) - mencipta akaun WhatsApp.
- Setup nombor telefon - menambah nombor telefon anda.
- Pengesahan nombor telefon - mengesahkan nombor guna kod.
Error Akaun Business Manager
| Error | Maksudnya | Cara Betulkan |
|---|---|---|
| "An error occurred while processing this request" | Kegagalan pemprosesan umum. | Guna akaun Facebook yang aktif. Kalau masih jadi, hubungi support. |
| Had cipta business dah penuh | Meta hadkan berapa banyak akaun Business Manager yang seorang pengguna boleh cipta. | Guna akaun Business sedia ada, atau padam yang tidak digunakan. |
| "Your Facebook account is too new" | Akaun baru tidak boleh mencipta akaun Business serta-merta. | Tunggu beberapa jam, atau guna akaun Facebook yang lebih lama dan mantap. |
| Akaun ditanda kerana aktiviti luar biasa | Meta mengesan aktiviti mencurigakan pada akaun. | Tukar ke akaun Facebook yang berstatus baik. |
| "You're no longer allowed to use Facebook Products to advertise" | Akaun Facebook ada sekatan pengiklanan. | Guna akaun Facebook yang tiada sekatan. |
| Akaun pembayaran dimatikan | Akaun pembayaran yang dipaut dimatikan kerana disyaki melanggar polisi. | Hubungi Meta Support untuk memulihkan akaun. |
| "A user can only create one business user at one time" | Anda cuba mencipta dua akaun Business serentak. | Guna akaun Business Manager sedia ada. |
| Nama business tidak sah | Nama business melanggar peraturan penamaan Meta. | Tukar nama mengikut garis panduan penamaan business Meta. |
Error Akaun WhatsApp Business
| Error | Maksudnya | Cara Betulkan |
|---|---|---|
| Tiada kebenaran admin | Anda tiada akses admin ke akaun Business yang dipilih. | Minta hak admin, atau pilih akaun Business yang anda sendiri uruskan. |
| Perlu pengesahan dahulu | Meta hadkan berapa banyak akaun WhatsApp boleh dicipta sebelum pengesahan. | Lengkapkan pengesahan business dalam Business Manager dahulu. |
| Pengesahan akaun gagal | Akaun Business tidak memenuhi keperluan WhatsApp API. | Semak status pengesahan anda, baca emel penolakan dari Meta, dan hantar semula. |
| Error sistem umum | Masalah sementara di pihak Meta. | Tunggu beberapa minit dan cuba signup semula. |
Error Setup Nombor Telefon
| Error | Maksudnya | Cara Betulkan |
|---|---|---|
| "This phone number already exists in your list" | Nombor tu dah ada dalam akaun anda. | Mulakan semula proses dan pilih nombor sedia ada, bukan menambahnya sekali lagi. |
| Nombor dah daftar dengan WhatsApp | Nombor tu sedang digunakan pada WhatsApp Messenger, Business App, atau API lain. | Nyahdaftar nombor dari aplikasi sedia ada, atau guna nombor lain. |
| "Your verified name violates WhatsApp guidelines" | Nama paparan melanggar peraturan WhatsApp. | Kemas kini nama business mengikut polisi nama paparan WhatsApp. |
| Masalah konfigurasi profil | Butiran profil business tidak lengkap atau tidak sah. | Masukkan semula maklumat profil anda mengikut standard WhatsApp. |
Error Pengesahan Nombor Telefon
| Error | Maksudnya | Cara Betulkan |
|---|---|---|
| Nombor dah disahkan | Nombor dah disahkan tapi statusnya belum di-refresh. | Refresh halaman untuk kemas kini status pengesahan. |
| "Your phone number doesn't appear to be valid" | Format nombor atau provider tidak disokong. | Pastikan nombor betul dan disokong oleh provider telekom yang sah. |
| "You have guessed too many times" | Terlalu banyak kod pengesahan salah telah dimasukkan. | Tunggu 12 jam sebelum cuba lagi. |
| Pengesahan gagal | Masalah rangkaian, kelewatan sistem, atau request tamat masa. | Tunggu sekejap dan cuba pengesahan semula. |
| "You have requested your code too many times" | Anda minta kod baru terlalu kerap. | Tunggu tempoh cooldown sebelum minta kod lain. |
Cuba buat signup dalam tetingkap incognito/private browser sambil log masuk ke akaun Facebook yang betul. Ini mengelak konflik dengan sesi Facebook lain dan selalunya jadi penyelesaian paling cepat untuk banyak error signup.
Masih Tersangkut?
Kalau error masih keluar selepas cuba penyelesaian ni, hubungi support ReplyLa. Sertakan mesej error yang tepat dan screenshot tetingkap signup - ini membantu kami menyelesaikannya dengan lebih cepat.
Soalan Lazim
Tidak. Error ni datang dari proses Embedded Signup Meta, yang digunakan oleh ReplyLa untuk connect WhatsApp melalui Cloud API. Penyelesaiannya dibuat dalam akaun Facebook atau Business Manager anda.
Meta menanda akaun yang terlalu baru atau menunjukkan aktiviti luar biasa. Guna akaun Facebook yang dah lama dan berstatus baik untuk mengelak kebanyakan masalah ni.
Satu nombor hanya boleh aktif pada satu setup WhatsApp pada satu masa. Nyahdaftar nombor tu dari aplikasi WhatsApp dahulu, atau guna Meta Coexistence kalau anda nak terus guna aplikasi tu.