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 категориясындагы үлгү боюнча бир билдирме (буйрутма, эсеп, жөнөтүү) 0,0286 $ турат. API үчүн өзүнчө төлөм жок: ачык API жана вебхуктар расмий WhatsApp линиясынын айына 66 $ жазылуусуна кирет.

Мисал: айына жөнөтүү тууралуу 1000 билдирме болжол менен 28,5515 $ турат, ага линиянын жазылуусу кошулат. Билдирүүлөрдү 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 методдору боюнча суроолорго жооп беребиз.