Интеграциялар · Kafka · Azure AD · оқиғалық алмасу
Kafka арқылы Bitrix24-тің оқиғалық интеграциясы
Клиент:
NDA
Санат: Интеграциялар
Стек: Node.js, Kafka (kafkajs), Bitrix24 REST, Azure AD, Telegram-алерттер
Мерзім: 2–5 апта
Мәселе
Сыртқы жүйеге бөлек HTTP сұраныстары масштабталмайтын және оқиғалар тарихын қалдырмайтын: ақаулықта алмасу жай ғана жоғалатын, ал үзілістер туралы клиенттердің шағымынан кейін ғана білетін.
Шектеулер
Оқиғаларды CRM жазбаларымен ішкі ID бойынша емес, бизнес-кілт бойынша сәйкестендіру қажет болды, өңдеуші құлағанда оқиғаларды жоғалтуға болмайтын, ақаулықтар туралы жылдам хабарлау керек болды, әрі қызметкерлердің CRM-дегі қолжетімділігі корпоративтік анықтамалықпен синхронды болуы тиіс еді.
Не істедім
- Оқиғаларды Kafka топигіне жариялайтын HTTP қабылдағыш
- CRM-де бизнес-кілт бойынша мәмілені табатын немесе жасайтын Kafka тұтынушысы
- Мәміле картасында кепіл және қарыз алушы деректері үшін кастомды өрістер
- Қызметкерлер есептік жазбаларын Azure AD-мен синхрондау
- Оқиғаны өңдеу қатесінде мәміле картасына сілтемесі бар Telegram-алерттер
- Алмасуды тоқтатпай оқиға схемасын дамыту
Архитектура
External system
→ HTTP → Kafka producer
→ Kafka topic
→ Consumer
→ Bitrix24 REST
→ Azure AD
→ Сілтемесі бар Telegram-алерттер
Нәтиже
Алмасу оқиғалық және «төзімді» болды: өңдеушідегі ақаулық оқиғаны жоғалтпайды және үнсіз қалмайды — тыныштықтың орнына қайталау мен алерт бар.
Нені қайта қолдануға болады
HTTP → Kafka producer
Бизнес-кілт бойынша сәйкестендіретін consumer
Өңдеу ақаулықтары үшін Telegram алерт схемасы