Multi-integration Webex chat/HTTP bot that unifies phone, AV, and network status for retail store support. Consolidates data from Webex Calling, Meraki, Workspace ONE (MDM), Atlas AMP, RED digital signage, and OptiSigns into rich per-store status commands. Key surfaces: - /phonestatus, /avstatus — per-store phone & AV device reports with clickable Meraki deep-links and per-port detail. - /webexhost — check/assign Webex Meetings host licenses via the Service App; adaptive-card confirmation flow, HTTP-API-gated. - /offboarduser — full Webex Admin offboarding (auth revoke, device wipe, license removal); adaptive-card confirmation. - /jirapoll — on-demand trigger for the hourly Jira poller. - /bulkavstatuscsv — bulk store CSV export with concurrency limits. Automation: - Hourly Jira poller (node-cron) with an X.AI (Grok) ticket classifier that categorizes unassigned tickets as phone/av/skip, extracts store numbers from free-text, and enriches Jira with the same detailed markdown the chat commands emit (converted to Jira ADF, preserves bold + Meraki links). Idempotent via a `bot-enriched` Jira label. Architecture: - Node.js 20+, ESM, Express 5, webex-node-bot-framework. - Layered integrations (integrations/*), services (services/*), commands (commands/*), utils (utils/*). - Shared markdown renderers (services/renderers/*) feed both chat handlers and the Jira poller so the two surfaces stay in sync. - Hand-rolled markdown-to-ADF converter (utils/markdownToAdf.js) — no new npm dependency. - Node built-in test runner (`node --test tests/*.test.js`), 30 tests covering the converter, renderers, and poller ADF assembly. Docker + docker-compose deployment. Config via .env (see .env.example for the full option surface).
117 lines
No EOL
3.6 KiB
JavaScript
117 lines
No EOL
3.6 KiB
JavaScript
// src/integrations/webex/BotClient.js
|
||
import axios from 'axios';
|
||
import FormData from 'form-data';
|
||
import { logger } from '../../utils/logger.js';
|
||
|
||
class BotClient {
|
||
static #instance = null;
|
||
|
||
constructor() {
|
||
if (BotClient.#instance) {
|
||
return BotClient.#instance;
|
||
}
|
||
|
||
const token = process.env.WEBEX_BOT_TOKEN;
|
||
const baseURL = process.env.WEBEX_BASE_URL || 'https://webexapis.com/v1';
|
||
|
||
if (!token) {
|
||
logger('webex:bot', 'WEBEX_BOT_TOKEN is missing – messaging will fail', 'error');
|
||
throw new Error('Missing WEBEX_BOT_TOKEN environment variable');
|
||
}
|
||
|
||
this.axios = axios.create({
|
||
baseURL,
|
||
timeout: 15000,
|
||
headers: {
|
||
Authorization: `Bearer ${token}`,
|
||
'Content-Type': 'application/json',
|
||
},
|
||
});
|
||
|
||
// Global error interceptor for better logging
|
||
this.axios.interceptors.response.use(
|
||
(response) => response,
|
||
(err) => {
|
||
const msg = err.response
|
||
? `${err.response.status} - ${JSON.stringify(err.response.data || {})}`
|
||
: err.message;
|
||
logger('webex:bot', `API error: ${msg}`, 'error');
|
||
return Promise.reject(err);
|
||
}
|
||
);
|
||
|
||
BotClient.#instance = this;
|
||
logger('webex:bot', 'BotClient initialized with bot token from environment');
|
||
}
|
||
|
||
async sendMarkdown(roomId, markdown, textFallback = null) {
|
||
if (!roomId || !markdown) {
|
||
logger('webex:bot', 'sendMarkdown called with missing roomId or markdown', 'warn');
|
||
return null;
|
||
}
|
||
|
||
const payload = { roomId, markdown };
|
||
if (textFallback) payload.text = textFallback;
|
||
|
||
try {
|
||
const response = await this.axios.post('/messages', payload);
|
||
logger('webex:bot', `Sent markdown message to room ${roomId.slice(0, 8)}...`);
|
||
return response.data;
|
||
} catch (err) {
|
||
// Error already logged by interceptor
|
||
throw err;
|
||
}
|
||
}
|
||
|
||
async sendWithAttachment(roomId, buffer, fileName, contentType = 'application/octet-stream', text = 'Attached file') {
|
||
if (!roomId || !buffer || !fileName) {
|
||
logger('webex:bot', 'sendWithAttachment called with missing parameters', 'warn');
|
||
return null;
|
||
}
|
||
|
||
try {
|
||
const form = new FormData();
|
||
form.append('roomId', roomId);
|
||
form.append('text', text);
|
||
form.append('files', buffer, {
|
||
filename: fileName,
|
||
contentType: contentType
|
||
});
|
||
|
||
const response = await this.axios.post('/messages', form, {
|
||
headers: form.getHeaders(), // Let form-data set the correct Content-Type with boundary
|
||
});
|
||
|
||
logger('webex:bot', `Sent attachment "${fileName}" to room ${roomId.slice(0, 8)}...`);
|
||
return response.data;
|
||
} catch (err) {
|
||
logger('webex:bot', `Failed to send attachment ${fileName}: ${err.message}`, 'error');
|
||
throw err;
|
||
}
|
||
}
|
||
|
||
async getRoomDetails(roomId) {
|
||
try {
|
||
const response = await this.axios.get(`/rooms/${roomId}`);
|
||
logger('webex:bot', `Retrieved details for room ${roomId}`);
|
||
return response.data;
|
||
} catch (err) {
|
||
logger('webex:bot', `Failed to get room details for ${roomId}: ${err.message}`, 'warn');
|
||
return null;
|
||
}
|
||
}
|
||
|
||
async addMemberToRoom(roomId, personEmail) {
|
||
try {
|
||
const response = await this.axios.post('/memberships', { roomId, personEmail });
|
||
logger('webex:bot', `Added member ${personEmail} to room ${roomId}`);
|
||
return response.data;
|
||
} catch (err) {
|
||
logger('webex:bot', `Failed to add member ${personEmail} to room ${roomId}: ${err.message}`, 'error');
|
||
throw err;
|
||
}
|
||
}
|
||
}
|
||
|
||
// Export singleton instance
|
||
export default new BotClient(); |