1С-ті WhatsApp Business API-мен қалай байланыстыруға болады: REST API арқылы базадан хабарландыру

WazzaBee-де WhatsApp-қа арналған дайын 1С модулі жоқ: 1С хабарламаларды ашық REST API арқылы жібереді, бір хабарландыруға келісілген үлгісі бар бір HTTP-сұраныс, POST /v1/messages/send, жеткілікті. Клиенттердің жауаптары мен жеткізу мәртебелерін 1С вебхук арқылы алады: оны WazzaBee сіздің сервеңіздің мекенжайына жібереді.

Таныс жағдай: 1С-те шот қойылды, тауар жөнелтілді, ал клиент бұл туралы білмейді. Менеджер контрагент карточкасынан нөмірді көшіріп, өз телефонындағы WhatsApp-ты ашады да, қолмен жазады. Күніне он тапсырыс болса, шыдауға болады. Жүзге жеткенде сағаттар кетеді, нөмірлер шатасады, ал төлем ешкім хабарламағаны үшін ғана кешігеді.

Төменде: 1С-тен не жіберуге болады, неге бірінші хабарлама тек үлгімен жіберіледі, API-ге сұраныс қалай көрінеді, бір хабарландыру қанша тұрады және бағдарламашыға не істеу керек. Байланыстың өзі туралы қысқаша WhatsApp және 1С бетінде жазылған.

1С-ке арналған WhatsApp API қарапайым тілмен не?

Бұл интернеттегі мекенжай: базаңыз оған «клиентке мына хабарламаны жібер» деген команда жібереді. Мекенжай WazzaBee-ге тиесілі, ал хабарлама клиентке ресми WhatsApp Business API нөміріңізден барады. 1С WhatsApp-пен тікелей байланыспайды: ол WazzaBee API шлюзіне HTTPS-сұраныстар жібереді.

Шлюздің негізгі мекенжайы: https://api.wazzabee.com/api-gateway. Әр сұраныс Authorization: Bearer тақырыбында кілт алып жүреді. Кілт кабинетте, «Коннекторлар» → «API» бөлімінде беріледі. Кілт қалай тексерілетіні және шлюз қандай қателер қайтаратыны API-дегі авторизация мақаласында сипатталған.

1С-тен WhatsApp-қа қандай хабарландырулар жіберуге болады?

Базада оқиғасы бар және Meta келіскен үлгісі бар кез келген хабарландыру. Көбіне мына сценарийлерді автоматтандырады:

• Тапсырыс қабылданды: тапсырыс нөмірі мен құрамы құжат жазылғаннан кейін бірден клиентке кетеді.
• Шот қойылды: мәтінде сома мен төлем мерзімі, шоттың PDF файлын үлгінің тақырыбы ретінде тіркеуге болады.
• Төлем мерзімі жақындады: күнінен бірнеше күн бұрын еске салу.
• Төлем түсті: ақшаның келгенін растау.
• Тауар жөнелтілді: жөнелту күні мен жүкқұжат нөмірі.
• Құжаттар дайын: актіні немесе шартты алуға болады.
• Тауар келді: тапсырыспен күткен клиенттерге.
• Кері байланыс: мәміле жабылғаннан кейін қысқа сұрақ.

Бұл дайын баптаулар емес, сценарийлер. Жіберуді 1С-тің қай құжаты іске қосатынын және клиент қандай мәтін алатынын сіз бен бағдарламашыңыз шешесіз. Әр оқиғаның өз үлгісі бар.

Неге 1С-тен бірінші хабарламаны үлгімен жіберу керек?

Meta ережелері осылай: бизнес клиентке бірінші болып тек келісілген үлгімен жаза алады. Еркін мәтінге клиенттің соңғы кіріс хабарламасынан кейін 24 сағат ішінде рұқсат етіледі. 1С-тен келетін хабарландыру әрдайым дерлік бірінші кетеді, сондықтан әр оқиғаға өз үлгісі керек.

Үлгі WazzaBee кабинетінде ресми WhatsApp желісі үшін жасалады және Meta модерациясына жіберіледі. API арқылы үлгілер жіберіледі, ал жасау мен өңдеу кабинетте жүреді. {{1}}, {{2}} айнымалылары атты, тапсырыс нөмірін, соманы немесе күнді қояды. Мәтін мысалдары мен үлгі санаттары WazzaBee-дегі WhatsApp HSM-үлгілері мақаласында жиналған.

Мәтінді қадағалаңыз: хабарландыруда жеңілдік немесе сатып алуға шақыру пайда болса, Meta үлгіні маркетинг санатына жатқызуы мүмкін, сонда әр хабарлама қымбатырақ болады.

1С-тен WazzaBee API шлюзіне сұраныс қалай құрылады?

Бір хабарландыру: денесінде JSON бар https://api.wazzabee.com/api-gateway/v1/messages/send мекенжайына бір POST-сұраныс. Үлгі үшін text өрісінің орнына templateName мен айнымалылар беріледі. API арқылы WABA-үлгілерін жіберу құжаттамасы бойынша сұраныс былай көрінеді:

curl -X POST "https://api.wazzabee.com/api-gateway/v1/messages/send" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channelId": "550e8400-e29b-41d4-a716-446655440000",
    "chatId": "77001234567",
    "templateName": "order_shipped",
    "templateLanguage": "ru",
    "templateVariables": {"1": "Айгерим", "2": "1234"}
  }'

Мұнда order_shipped: жөнелту туралы үлгіңіздің шартты аты, {{1}} клиенттің атын, {{2}} тапсырыс нөмірін алады. Әр өріс нені білдіреді:

1С-тің өзінде сұраныс платформаның стандартты HTTPСоединение және HTTPЗапрос объектілерімен жиналады. JSON жолын ЗаписьJSON арқылы құрастыру ыңғайлы. Бағдарламашыға арналған нобай:

Соединение = Новый HTTPСоединение("api.wazzabee.com", 443, , , , 30, Новый ЗащищенноеСоединениеOpenSSL);
Запрос = Новый HTTPЗапрос("/api-gateway/v1/messages/send");
Запрос.Заголовки.Вставить("Authorization", "Bearer " + КлючAPI);
Запрос.Заголовки.Вставить("Content-Type", "application/json");
Запрос.УстановитьТелоИзСтроки(ТелоJSON, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
Ответ = Соединение.ОтправитьДляОбработки(Запрос);
// Ответ.КодСостояния 202: хабарлама кезекке қабылданды

202 коды хабарлама кезекке қабылданғанын білдіреді, жеткізілгенін емес. Жауапта queueId келеді: оны 1С құжатында сақтаңыз, кейін мәртебе сол арқылы салыстырылады. API кілтін модуль мәтінінде емес, базаның қорғалған баптауларында ұстаңыз. Барлық параметрлер, файл жіберу және қате кодтары Хабарлама жіберу бөлімінде сипатталған.

1С клиенттердің жауаптары мен жеткізу мәртебелерін қалай алады?

Вебхук арқылы: клиент жауап бергенде немесе хабарламаның мәртебесі өзгергенде WazzaBee сервеңіздің мекенжайына POST-сұраныс жібереді. Вебхукты кабинетте, «Коннекторлар» → «API» → «Кіріс хабарламаларға арналған webhook» блогында немесе PATCH /v1/webhooks сұранысымен қосуға болады.

1С-те вебхукты веб-серверде жарияланған HTTP-сервиспен қабылдауға болады. Шлюз талаптары: мекенжай тек https, интернеттен қолжетімді, жергілікті емес және ішкі желіде емес. Тест сұранысына сервер 200 кодымен жауап беруі керек, әйтпесе вебхук қосылмайды. Әр хабарлама HMAC-SHA256 арқылы қол қойылған, қолтаңбаны тексеру Webhooks бөлімінде сипатталған.

Сервер 10 секунд ішінде жауап бермесе, WazzaBee жіберуді қайталайды, шамамен бір тәулікте 8 әрекетке дейін. Сондықтан 200 кодын бірден қайтарып, өңдеуді жауаптан кейін жасаңыз. Қайталауларда X-Webhook-Delivery-Id бірдей, сол арқылы бір хабарламаны екі рет жазып алмау оңай. Клиенттердің жауаптары WazzaBee кабинетінің чаттарында да көрінеді, сондықтан менеджер әңгімені өзі жалғастыра алады.

1С-тен WhatsApp-қа бір хабарландыру қанша тұрады?

Utility санатындағы үлгі бойынша бір хабарландыру (тапсырыс, шот, жөнелту) 13,60 ₸ тұрады. API үшін бөлек төлем жоқ: ашық API мен вебхуктар ресми WhatsApp желісінің айына 29 900 ₸ жазылымына кіреді.

Мысал: айына жөнелту туралы 1000 хабарландыру шамамен 13 600 ₸ тұрады, оған желі жазылымы қосылады. Хабарламаларды Meta өз ережелері бойынша тарифтейді. 2026 жылғы 1 қазаннан бастап Қазақстан Meta-да жеке нарық, ал 24 сағаттық терезедегі жауаптар да ақылы болды.

1С бағдарламашысы қадам бойынша не істеуі керек?

Бос базадан жұмыс істейтін хабарландыруларға дейін жеті қадам:

1. WazzaBee-де ресми WhatsApp желісін қосыңыз. Бұл 15 минут алады, тәртібі WABA қосу бойынша қадамдық нұсқаулықта.
2. Кабинетте 1С оқиғаларына үлгілер жасап, Meta мақұлдауын күтіңіз.
3. Кілтті алыңыз: «Коннекторлар» → «API» карточкасы → «Қосу». Кілт бір рет көрсетіледі, оны бірден сақтаңыз.
4. GET /v1/channels сұранысымен желінің channelId-ін біліп, 1С баптауларына жазыңыз.
5. Жіберуді жасаңыз: керек құжат жазылғанда 1С JSON құрастырып, POST /v1/messages/send жібереді, ал queueId-ді құжатқа сақтайды.
6. messages_incoming және messages_status жазылымдарымен вебхук қосып, әр хабарламаның қолтаңбасын тексеріңіз.
7. Байланысты тексеріңіз: желі GET /v1/channels ішінде active мәртебесімен көрінеді, тест хабарламасы екінші нөміріңізге жетеді, жауап кабинет чатында және вебхукта шығады.

Дайын сұраныстары бар қысқа жол API-мен жылдам бастау мақаласында жиналған. Хабарландыруларды базалық жіберуге 1С бағдарламашысына әдетте бірнеше сағат жетеді. 1С-ті өзіміз пысықтамаймыз: кілтті, құжаттаманы береміз және API әдістері бойынша сұрақтарға жауап береміз.