☁️ WhatsApp Cloud API (WACA) арнасын Meta-ға тікелей қосу
WACA дегеніміз тікелей қосылған ресми WhatsApp Cloud API. WhatsApp Business аккаунты мен нөмір сіздің Meta бизнес-портфолиоңызда тұрады, ал хабарламалар үшін Meta өз мөлшерлемесі бойынша төлемді компанияңыздың картасынан алады. WazzaBee тек арнаға жазылым ақысын алады, хабарламаларға үстеме баға қоспайды. Қосылу 15 минут алады.
WACA ма, әлде WABA ма: қайсысын таңдау керек
| WACA (тікелей) | WABA (WazzaBee арқылы) | |
|---|---|---|
| Meta-ға кім төлейді | Компанияңыз, Meta аккаунтындағы карта арқылы | WazzaBee, ал сіз арна балансын толтырасыз |
| Хабарламаларға үстеме баға | Жоқ | Хабарлама бағасына кіреді |
| Қалай қосылады | Meta қосымшасы, токен және кабинеттегі үш өріс | Кабинеттен тікелей Facebook арқылы кіру |
| Телефондағы WhatsApp қосымшасы | Жоқ, нөмір тек API арқылы жұмыс істейді | Coexistence арқылы сақтап қалуға болады |
| Айына 1 000 тегін жауап | Иә, әр нөмірге | Жоқ |
Компанияңызда халықаралық төлемдерге арналған карта болмаса немесе Meta әзірлеуші кабинетімен айналысқыңыз келмесе, WABA қосыңыз. Барлық тәсілдің салыстыруы мен шығын калькуляторы WhatsApp Cloud API бетінде берілген.
Не дайындау керек
- ✅ Компания әкімшісінің Facebook аккаунты;
- ✅ Meta Business Suite ішіндегі бизнес-портфолио: бұрыннан бар немесе 1-қадам бойынша жасалған;
- ✅ SMS немесе қоңырау қабылдай алатын және WhatsApp қосымшасында тіркелмеген телефон нөмірі;
- ✅ Халықаралық онлайн төлемдерге рұқсат берілген Visa немесе Mastercard банк картасы;
- ✅ Көрші қойындыда ашық тұрған WazzaBee кабинеті.
Нөмір кәдімгі WhatsApp-та тіркелген бе? Телефондағы қосымшаны сақтау керек болса, WABA-ны Coexistence режимінде қосыңыз: сол нөмір қосымшада да, ресми арнада да жұмыс істейді, ал соңғы жарты жылдағы хат алмасуды көшіруге болады. WACA-да нөмір тек API арқылы жұмыс істейді, сондықтан оны босатады: WhatsApp → Баптаулар (Settings) → Аккаунт (Account) → Аккаунтты жою (Delete account), 3 минут күтіп, жалғастырыңыз.
📱 Қадам-қадаммен қосу
1-қадам. Meta бизнес-портфолиосы
business.facebook.com сайтын ашып, Facebook арқылы кіріңіз. Компанияңызда портфолио әлі жоқ болса, «Аккаунт жасау» (Create account) батырмасын басып, компания атауын, атыңызды және жұмыс поштаңызды жазыңыз.
«Баптаулар» (Settings) → «Компания туралы ақпарат» (Business info) бөлімінде заңды атауды, мекенжайды, телефон мен сайтты тіркеу құжаттарындағыдай етіп көрсетіңіз. Жаппай тарату лимитін көтеру қажет болғанда компанияның верификациядан өтетін-өтпейтіні осыған байланысты.
2-қадам. Әзірлеуші кабинетіндегі қосымша
- developers.facebook.com/apps сайтын ашыңыз. Алғаш кіргенде Meta әзірлеуші ретінде тіркелуді сұрайды: телефоныңыз бен поштаңызды растаңыз.
- «Қосымша жасау» (Create app) батырмасын басыңыз.
- Атауын, мысалы «WhatsApp WazzaBee», және байланыс поштасын енгізіңіз.
- Сценарийлер тізімінен «Клиенттермен WhatsApp арқылы байланысу» (Connect with customers through WhatsApp) тармағын таңдаңыз.
- 1-қадамдағы бизнес-портфолиоңызды таңдап, жасауды аяқтаңыз.
3-қадам. Телефон нөмірі
- Қосымша мәзірінде WhatsApp → «API баптау» (API Setup) бөлімін ашыңыз.
- Нөмірлер блогында «Телефон нөмірін қосу» (Add phone number) батырмасын басыңыз.
- WhatsApp профилін толтырыңыз: көрсетілетін атау, санат және сипаттама. Атауды клиенттер көреді, сондықтан компания атауын жарнамалық сөздерсіз жазыңыз.
- Нөмірді енгізіп, растау тәсілін таңдаңыз: SMS немесе қоңырау. Келген кодты енгізіңіз.
- Алты саннан тұратын екі қадамды растаудың PIN кодын орнатып, оны сақтап қойыңыз. Ол нөмірді көшіргенде және көк белгі алу үшін керек болады.
ℹ️ Осы бөлімде Meta телефон нөмірінің ID (Phone number ID) және WhatsApp Business аккаунтының ID (WhatsApp Business Account ID) мәндерін көрсетеді. Екеуін де көшіріп алыңыз, олар 7-қадамда керек болады.
4-қадам. Төлем тәсілі
- WhatsApp Manager бетін ашып, өз WhatsApp Business аккаунтыңызды таңдаңыз.
- «Аккаунт баптаулары» (Account settings) → «Төлем тәсілдері» (Payment methods) бөліміне өтіп, «Төлем тәсілін қосу» (Add payment method) батырмасын басыңыз.
- Елді және аккаунт валютасын таңдаңыз. Карта байланғаннан кейін валютаны өзгерту мүмкін емес.
- Карта деректерін енгізіп, сақтаңыз.
⚠️ Бұл қадамды өткізіп жібермеңіз. Төлем тәсілі болмаса, Meta ақылы хабарламаларды жеткізбейді, ал 2026 жылғы 1 қазаннан бастап айына тегін мыңнан асатын клиенттерге берілетін кәдімгі жауаптарды да жеткізбейді.
5-қадам. Жүйелік пайдаланушы
«API баптау» (API Setup) бөліміндегі кәдімгі токен 24 сағат қана жарамды, тұрақты жұмыс үшін жүйелік пайдаланушының токені керек.
- Meta Business Suite ішінде «Компания баптаулары» (Business settings) → «Пайдаланушылар» (Users) → «Жүйелік пайдаланушылар» (System users) бөлімін ашыңыз.
- «Қосу» (Add) батырмасын басып, атын енгізіңіз, мысалы «wazzabee», және «Әкімші» (Admin) рөлін таңдаңыз.
- «Активтерді тағайындау» (Assign assets) батырмасын басыңыз. «Қосымшалар» (Apps) қойындысында 2-қадамдағы қосымшаны белгілеп, толық қолжетімділікті қосыңыз.
- «WhatsApp аккаунттары» (WhatsApp accounts) қойындысында өз аккаунтыңызды белгілеп, оған да толық қолжетімділікті қосыңыз.
6-қадам. Тұрақты токен
- Жүйелік пайдаланушы бетінде «Токен жасау» (Generate token) батырмасын басыңыз.
- 2-қадамдағы қосымшаны таңдаңыз.
- Жарамдылық мерзімі: «Ешқашан» (Never).
- whatsapp_business_messaging және whatsapp_business_management рұқсаттарын белгілеңіз.
- «Жасау» (Generate) батырмасын басып, токенді бірден көшіріп алыңыз. Meta оны екінші рет көрсетпейді.
🔒 Токен компания атынан хабарлама жіберуге толық қолжетімділік береді. Оны мессенджерлер арқылы жібермеңіз және ешқайда жарияламаңыз. Тек WazzaBee кабинетіне қойыңыз.
7-қадам. WazzaBee-де қосу
- Кабинетте «Байланыс арналары» бөлімін ашып, «Арна қосу» батырмасын басыңыз.
- WhatsApp, содан кейін WhatsApp Cloud API (WACA) тармағын таңдаңыз.
- Арна атауын енгізіңіз, оны тек сіздің менеджерлеріңіз көреді.
- 6-қадамдағы токенді, 3-қадамдағы телефон нөмірінің ID және WhatsApp Business аккаунтының ID мәндерін қойыңыз.
- «Қосу» батырмасын басыңыз. WazzaBee токенді тексеріп, webhook мекенжайы мен растау токенін көрсетеді.
8-қадам. Кіріс хабарламаларға арналған webhook
- Meta қосымшасына қайта оралыңыз: WhatsApp → «Конфигурация» (Configuration).
- Webhook блогында «Өзгерту» (Edit) батырмасын басып, WazzaBee кабинетіндегі мекенжай мен растау токенін қойып, сақтаңыз.
- Webhook өрістерінің тізімінде messages өрісіне жазылыңыз.
- Қосылған нөмірге өз телефоныңыздан хабарлама жіберіңіз. Ол WazzaBee чаттарында пайда болса, арна жұмыс істеп тұр.
💳 Қанша тұрады
| Не үшін | Кімге төлейсіз |
|---|---|
| Арнаға жазылым | WazzaBee-ге, теңгемен, доллармен немесе еуромен |
| Жаппай тарату, хабарландырулар, растау кодтары | Meta-ға, картадан алушы елінің мөлшерлемесі бойынша |
| 24 сағаттық терезедегі клиенттерге жауаптар | Meta-ға, 2026 жылғы 1 қазаннан бастап әр нөмірге айына берілетін 1 000 тегін жауаптан асқанда |
| Кіріс хабарламалар | Тегін |
Жазылымның өзекті бағасын, Meta-ның Қазақстан мен Қырғызстан бойынша мөлшерлемелерін және калькуляторды WhatsApp Cloud API бетінен қараңыз.
🛠 Не дұрыс болмай қалуы мүмкін
| Мәселе | Шешімі |
|---|---|
| «This phone number is already registered» | Нөмір WhatsApp қосымшасында тіркелген. Телефондағы аккаунтты жойып, 3 минут күтіңіз де, 3-қадамды қайталаңыз |
| Растау коды келмейді | Қоңырау арқылы растауды таңдаңыз. Виртуалды нөмірлерге және WhatsApp-тан жақында жойылған нөмірлерге SMS жиі келмейді |
| «Клиенттермен WhatsApp арқылы байланысу» сценарийі жоқ | Қосымша басқа түрмен жасалған. Жаңасын жасап, жасау кезінде бизнес-портфолионы таңдаңыз |
| Жүйелік пайдаланушыны жасау мүмкін емес | Сізде портфолио әкімшісінің құқығы жоқ. Портфолио иесінен толық қолжетімділік беруді сұраңыз |
| WazzaBee токен жарамсыз деп хабарлайды | Токен толық көшірілмеген, жарамдылық мерзімімен шығарылған немесе whatsapp_business_messaging және whatsapp_business_management рұқсаттарынсыз жасалған. 6-қадам бойынша жаңасын шығарыңыз |
| Шығыс хабарламалар кетеді, кіріс хабарламалар келмейді | Webhook бапталмаған немесе messages өрісіне жазылым жоқ. 8-қадамды тексеріңіз |
| Хабарламалар жеткізілмейді, төлем қатесі шығады | Карта байланбаған немесе төлем қабылданбаған. WhatsApp Manager ішіндегі «Төлем тәсілдері» (Payment methods) бөлімін тексеріп, банкте халықаралық төлемдерге рұқсат алыңыз |
| Үлгі қабылданбады | Бас тарту себебі WazzaBee-де көрінеді. Мәтінді жиі кездесетін қателерді талдау бойынша түзетіп, қайта жіберіңіз |
➡️ Әрі қарай не істеу керек
- Хабарлама лимиттері, нөмірдің деңгейі мен сапасы: тәулігіне 250 алушыдан қалай асуға болады;
- Хабарлама үлгілері: клиенттерге бірінші болып жазу үшін не керек;
- Bitrix24 қосу: WhatsApp хат-хабары CRM-нің ашық желілерінде.
