@operor/provider-wati 0.1.1 → 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# @operor/provider-wati
+
+## 0.2.0
+
+### Minor Changes
+
+- a3c2adc: Upgrade WATI provider to v3 API with improved webhook URL setup, add WATI WhatsApp skill to catalog, add back navigation and Esc-to-exit to CLI setup wizard, and persist business info in .env as a required setup step.
+
+### Patch Changes
+
+- @operor/core@0.2.0

package/dist/index.d.ts

@@ -5,13 +5,13 @@ import { MessageProvider, OutgoingMessage } from "@operor/core";
 interface WatiProviderConfig {
   /** WATI API bearer token */
   apiToken: string;
-  /** WATI tenant ID (appears in the API base URL) */
-  tenantId: string;
+  /** WATI tenant ID — optional in v3 (used for Channel:PhoneNumber targeting in multi-channel setups) */
+  tenantId?: string;
   /** Port for the webhook HTTP server (default: 3001) */
   webhookPort?: number;
   /** Path the webhook listens on (default: /webhook/wati) */
   webhookPath?: string;
-  /** Override the WATI API base URL (default: https://live-mt-server.wati.io/{tenantId}/api) */
+  /** Override the WATI API base URL (default: https://live-mt-server.wati.io) */
   apiBaseUrl?: string;
 }
 interface WatiTemplateParams {

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/WatiProvider.ts"],"mappings":";;;;UAAiB,kBAAA;;EAEf,QAAA;;EAEA,QAAA;EAJiC;EAMjC,WAAA;EANiC;EAQjC,WAAA;EAJA;EAMA,UAAA;AAAA;AAAA,UAce,kBAAA;EACf,YAAA;EACA,UAAA,EAAY,KAAA;IAAQ,IAAA;IAAc,KAAA;EAAA;AAAA;;;cCrBvB,YAAA,SAAqB,YAAA,YAAwB,eAAA;EAAA,SACxC,IAAA;EAAA,QACR,MAAA;EAAA,QACA,MAAA;EAAA,QACA,SAAA;EAAA,QACA,OAAA;EAAA,QACA,WAAA;EAAA,QACA,WAAA;cAEI,MAAA,EAAQ,kBAAA;EAQd,OAAA,CAAA,GAAW,OAAA;EA2BX,UAAA,CAAA,GAAc,OAAA;EAWd,WAAA,CAAY,EAAA,UAAY,OAAA,EAAS,eAAA,GAAkB,OAAA;EAanD,mBAAA,CAAoB,EAAA,UAAY,QAAA,EAAU,kBAAA,GAAqB,OAAA;EAgBrE,QAAA,CAAA;EAAA,QAMQ,kBAAA;EAAA,QAUA,oBAAA;EAAA,QAoCM,UAAA;AAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/WatiProvider.ts"],"mappings":";;;;UAAiB,kBAAA;;EAEf,QAAA;;EAEA,QAAA;EAJiC;EAMjC,WAAA;EANiC;EAQjC,WAAA;EAJA;EAMA,UAAA;AAAA;AAAA,UAGe,kBAAA;EACf,YAAA;EACA,UAAA,EAAY,KAAA;IAAQ,IAAA;IAAc,KAAA;EAAA;AAAA;;;cCVvB,YAAA,SAAqB,YAAA,YAAwB,eAAA;EAAA,SACxC,IAAA;EAAA,QACR,MAAA;EAAA,QACA,MAAA;EAAA,QACA,SAAA;EAAA,QACA,OAAA;EAAA,QACA,WAAA;EAAA,QACA,WAAA;cAEI,MAAA,EAAQ,kBAAA;EASd,OAAA,CAAA,GAAW,OAAA;EA2BX,UAAA,CAAA,GAAc,OAAA;EAWd,WAAA,CAAY,EAAA,UAAY,OAAA,EAAS,eAAA,GAAkB,OAAA;EAenD,mBAAA,CAAoB,EAAA,UAAY,QAAA,EAAU,kBAAA,GAAqB,OAAA;EAkBrE,QAAA,CAAA;EAAA,QAMQ,kBAAA;EAAA,QAUA,oBAAA;EAAA,QAsDM,UAAA;AAAA"}

package/dist/index.js

@@ -13,7 +13,7 @@ var WatiProvider = class extends EventEmitter {
 	constructor(config) {
 		super();
 		this.config = config;
-		this.baseUrl = config.apiBaseUrl || `https://live-mt-server.wati.io/${config.tenantId}/api`;
+		this.baseUrl = (config.apiBaseUrl || "https://live-mt-server.wati.io").replace(/\/+$/, "");
 		this.webhookPort = config.webhookPort || 3001;
 		this.webhookPath = config.webhookPath || "/webhook/wati";
 	}
@@ -46,17 +46,21 @@ var WatiProvider = class extends EventEmitter {
 	}
 	async sendMessage(to, message) {
 		if (!this.connected) throw new Error("WATI provider not connected");
-		await this.apiRequest(`/v1/sendSessionMessage/${to}`, {
+		await this.apiRequest("/api/ext/v3/conversations/messages/text", {
 			method: "POST",
-			body: JSON.stringify({ messageText: message.text })
+			body: JSON.stringify({
+				target: to,
+				text: message.text
+			})
 		});
 		console.log(`📤 [WATI] Sent reply to ${to}`);
 	}
 	async sendTemplateMessage(to, template) {
 		if (!this.connected) throw new Error("WATI provider not connected");
-		await this.apiRequest(`/v2/sendTemplateMessage?whatsappNumber=${encodeURIComponent(to)}`, {
+		await this.apiRequest("/api/ext/v3/conversations/messages/template", {
 			method: "POST",
 			body: JSON.stringify({
+				target: to,
 				template_name: template.templateName,
 				parameters: template.parameters
 			})
@@ -80,24 +84,37 @@ var WatiProvider = class extends EventEmitter {
 			res.writeHead(200).end("ok");
 			try {
 				const payload = JSON.parse(body);
-				if (payload.eventType !== "messageReceived" || payload.fromMe) return;
+				console.log(`📩 [WATI] Webhook received:`, JSON.stringify(payload, null, 2));
+				const text = payload.text || payload.message?.text || payload.message?.body || "";
+				const waId = payload.waId || payload.wa_id || payload.from || "";
+				const messageId = payload.whatsappMessageId || payload.message_id || payload.id || "";
+				const senderName = payload.senderName || payload.sender_name || payload.pushName || "";
+				const timestamp = payload.timestamp || payload.created || "";
+				const fromMe = payload.fromMe ?? payload.from_me ?? payload.owner ?? false;
+				const messageType = payload.type || payload.messageType || "text";
+				if (!text || fromMe) {
+					console.log(`⏭️ [WATI] Skipped: ${!text ? "no text" : "fromMe"} (type: ${messageType})`);
+					return;
+				}
+				const parsedTs = timestamp ? new Date(/^\d+$/.test(String(timestamp)) ? Number(timestamp) * (/^\d{10}$/.test(String(timestamp)) ? 1e3 : 1) : timestamp).getTime() : NaN;
 				const msg = {
-					id: payload.whatsappMessageId,
-					from: payload.waId,
-					text: payload.text,
-					timestamp: new Date(payload.timestamp).getTime(),
+					id: messageId,
+					from: waId,
+					text,
+					timestamp: Number.isFinite(parsedTs) ? parsedTs : Date.now(),
 					channel: "whatsapp",
 					provider: this.name,
 					metadata: {
-						senderName: payload.senderName,
-						messageType: payload.type
+						senderName,
+						messageType
 					}
 				};
-				console.log(`\n📥 [WATI] New message from ${payload.senderName || payload.waId}`);
+				console.log(`\n📥 [WATI] New message from ${senderName || waId}`);
 				console.log(`   Message: "${msg.text}"`);
 				this.emit("message", msg);
 			} catch (err) {
 				console.error("❌ [WATI] Failed to parse webhook payload:", err);
+				console.error("   Raw body:", body);
 			}
 		});
 	}
@@ -113,8 +130,10 @@ var WatiProvider = class extends EventEmitter {
 		});
 		if (!res.ok) {
 			const text = await res.text().catch(() => "");
+			console.error(`❌ [WATI] API ${res.status} ${init.method || "GET"} ${path}: ${text}`);
 			throw new Error(`WATI API error ${res.status}: ${text}`);
 		}
+		console.log(`✅ [WATI] API ${res.status} ${init.method || "GET"} ${path}`);
 		return res;
 	}
 };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/WatiProvider.ts"],"sourcesContent":["import EventEmitter from 'eventemitter3';\nimport * as http from 'node:http';\nimport type { MessageProvider, IncomingMessage, OutgoingMessage } from '@operor/core';\nimport type { WatiProviderConfig, WatiWebhookPayload, WatiTemplateParams } from './types.js';\n\nexport class WatiProvider extends EventEmitter implements MessageProvider {\n  public readonly name = 'wati';\n  private config: WatiProviderConfig;\n  private server: http.Server | null = null;\n  private connected = false;\n  private baseUrl: string;\n  private webhookPort: number;\n  private webhookPath: string;\n\n  constructor(config: WatiProviderConfig) {\n    super();\n    this.config = config;\n    this.baseUrl = config.apiBaseUrl || `https://live-mt-server.wati.io/${config.tenantId}/api`;\n    this.webhookPort = config.webhookPort || 3001;\n    this.webhookPath = config.webhookPath || '/webhook/wati';\n  }\n\n  async connect(): Promise<void> {\n    this.server = http.createServer((req, res) => {\n      if (req.url?.startsWith(this.webhookPath)) {\n        if (req.method === 'GET') {\n          this.handleVerification(req, res);\n        } else if (req.method === 'POST') {\n          this.handleWebhookRequest(req, res);\n        } else {\n          res.writeHead(405).end();\n        }\n      } else {\n        res.writeHead(404).end();\n      }\n    });\n\n    await new Promise<void>((resolve) => {\n      this.server!.listen(this.webhookPort, () => {\n        this.connected = true;\n        console.log(`✅ WATI webhook server listening on port ${this.webhookPort}`);\n        console.log(`   Webhook path: ${this.webhookPath}`);\n        resolve();\n      });\n    });\n\n    this.emit('ready');\n  }\n\n  async disconnect(): Promise<void> {\n    if (this.server) {\n      await new Promise<void>((resolve, reject) => {\n        this.server!.close((err) => (err ? reject(err) : resolve()));\n      });\n      this.server = null;\n    }\n    this.connected = false;\n    console.log('WATI provider disconnected');\n  }\n\n  async sendMessage(to: string, message: OutgoingMessage): Promise<void> {\n    if (!this.connected) {\n      throw new Error('WATI provider not connected');\n    }\n\n    await this.apiRequest(`/v1/sendSessionMessage/${to}`, {\n      method: 'POST',\n      body: JSON.stringify({ messageText: message.text }),\n    });\n\n    console.log(`📤 [WATI] Sent reply to ${to}`);\n  }\n\n  async sendTemplateMessage(to: string, template: WatiTemplateParams): Promise<void> {\n    if (!this.connected) {\n      throw new Error('WATI provider not connected');\n    }\n\n    await this.apiRequest(`/v2/sendTemplateMessage?whatsappNumber=${encodeURIComponent(to)}`, {\n      method: 'POST',\n      body: JSON.stringify({\n        template_name: template.templateName,\n        parameters: template.parameters,\n      }),\n    });\n\n    console.log(`📤 [WATI] Sent template \"${template.templateName}\" to ${to}`);\n  }\n\n  isActive(): boolean {\n    return this.connected;\n  }\n\n  // --- Private helpers ---\n\n  private handleVerification(req: http.IncomingMessage, res: http.ServerResponse): void {\n    const url = new URL(req.url!, `http://localhost:${this.webhookPort}`);\n    const challenge = url.searchParams.get('hub.challenge');\n    if (challenge) {\n      res.writeHead(200, { 'Content-Type': 'text/plain' }).end(challenge);\n    } else {\n      res.writeHead(200).end('ok');\n    }\n  }\n\n  private handleWebhookRequest(req: http.IncomingMessage, res: http.ServerResponse): void {\n    let body = '';\n    req.on('data', (chunk: Buffer) => { body += chunk.toString(); });\n    req.on('end', () => {\n      res.writeHead(200).end('ok');\n\n      try {\n        const payload: WatiWebhookPayload = JSON.parse(body);\n\n        if (payload.eventType !== 'messageReceived' || payload.fromMe) {\n          return;\n        }\n\n        const msg: IncomingMessage = {\n          id: payload.whatsappMessageId,\n          from: payload.waId,\n          text: payload.text,\n          timestamp: new Date(payload.timestamp).getTime(),\n          channel: 'whatsapp',\n          provider: this.name,\n          metadata: {\n            senderName: payload.senderName,\n            messageType: payload.type,\n          },\n        };\n\n        console.log(`\\n📥 [WATI] New message from ${payload.senderName || payload.waId}`);\n        console.log(`   Message: \"${msg.text}\"`);\n\n        this.emit('message', msg);\n      } catch (err) {\n        console.error('❌ [WATI] Failed to parse webhook payload:', err);\n      }\n    });\n  }\n\n  private async apiRequest(path: string, init: RequestInit): Promise<Response> {\n    const url = `${this.baseUrl}${path}`;\n    const res = await fetch(url, {\n      ...init,\n      headers: {\n        'Authorization': `Bearer ${this.config.apiToken}`,\n        'Content-Type': 'application/json',\n        ...init.headers,\n      },\n    });\n\n    if (!res.ok) {\n      const text = await res.text().catch(() => '');\n      throw new Error(`WATI API error ${res.status}: ${text}`);\n    }\n\n    return res;\n  }\n}\n"],"mappings":";;;;AAKA,IAAa,eAAb,cAAkC,aAAwC;CACxE,AAAgB,OAAO;CACvB,AAAQ;CACR,AAAQ,SAA6B;CACrC,AAAQ,YAAY;CACpB,AAAQ;CACR,AAAQ;CACR,AAAQ;CAER,YAAY,QAA4B;AACtC,SAAO;AACP,OAAK,SAAS;AACd,OAAK,UAAU,OAAO,cAAc,kCAAkC,OAAO,SAAS;AACtF,OAAK,cAAc,OAAO,eAAe;AACzC,OAAK,cAAc,OAAO,eAAe;;CAG3C,MAAM,UAAyB;AAC7B,OAAK,SAAS,KAAK,cAAc,KAAK,QAAQ;AAC5C,OAAI,IAAI,KAAK,WAAW,KAAK,YAAY,CACvC,KAAI,IAAI,WAAW,MACjB,MAAK,mBAAmB,KAAK,IAAI;YACxB,IAAI,WAAW,OACxB,MAAK,qBAAqB,KAAK,IAAI;OAEnC,KAAI,UAAU,IAAI,CAAC,KAAK;OAG1B,KAAI,UAAU,IAAI,CAAC,KAAK;IAE1B;AAEF,QAAM,IAAI,SAAe,YAAY;AACnC,QAAK,OAAQ,OAAO,KAAK,mBAAmB;AAC1C,SAAK,YAAY;AACjB,YAAQ,IAAI,2CAA2C,KAAK,cAAc;AAC1E,YAAQ,IAAI,oBAAoB,KAAK,cAAc;AACnD,aAAS;KACT;IACF;AAEF,OAAK,KAAK,QAAQ;;CAGpB,MAAM,aAA4B;AAChC,MAAI,KAAK,QAAQ;AACf,SAAM,IAAI,SAAe,SAAS,WAAW;AAC3C,SAAK,OAAQ,OAAO,QAAS,MAAM,OAAO,IAAI,GAAG,SAAS,CAAE;KAC5D;AACF,QAAK,SAAS;;AAEhB,OAAK,YAAY;AACjB,UAAQ,IAAI,6BAA6B;;CAG3C,MAAM,YAAY,IAAY,SAAyC;AACrE,MAAI,CAAC,KAAK,UACR,OAAM,IAAI,MAAM,8BAA8B;AAGhD,QAAM,KAAK,WAAW,0BAA0B,MAAM;GACpD,QAAQ;GACR,MAAM,KAAK,UAAU,EAAE,aAAa,QAAQ,MAAM,CAAC;GACpD,CAAC;AAEF,UAAQ,IAAI,2BAA2B,KAAK;;CAG9C,MAAM,oBAAoB,IAAY,UAA6C;AACjF,MAAI,CAAC,KAAK,UACR,OAAM,IAAI,MAAM,8BAA8B;AAGhD,QAAM,KAAK,WAAW,0CAA0C,mBAAmB,GAAG,IAAI;GACxF,QAAQ;GACR,MAAM,KAAK,UAAU;IACnB,eAAe,SAAS;IACxB,YAAY,SAAS;IACtB,CAAC;GACH,CAAC;AAEF,UAAQ,IAAI,4BAA4B,SAAS,aAAa,OAAO,KAAK;;CAG5E,WAAoB;AAClB,SAAO,KAAK;;CAKd,AAAQ,mBAAmB,KAA2B,KAAgC;EAEpF,MAAM,YADM,IAAI,IAAI,IAAI,KAAM,oBAAoB,KAAK,cAAc,CAC/C,aAAa,IAAI,gBAAgB;AACvD,MAAI,UACF,KAAI,UAAU,KAAK,EAAE,gBAAgB,cAAc,CAAC,CAAC,IAAI,UAAU;MAEnE,KAAI,UAAU,IAAI,CAAC,IAAI,KAAK;;CAIhC,AAAQ,qBAAqB,KAA2B,KAAgC;EACtF,IAAI,OAAO;AACX,MAAI,GAAG,SAAS,UAAkB;AAAE,WAAQ,MAAM,UAAU;IAAI;AAChE,MAAI,GAAG,aAAa;AAClB,OAAI,UAAU,IAAI,CAAC,IAAI,KAAK;AAE5B,OAAI;IACF,MAAM,UAA8B,KAAK,MAAM,KAAK;AAEpD,QAAI,QAAQ,cAAc,qBAAqB,QAAQ,OACrD;IAGF,MAAM,MAAuB;KAC3B,IAAI,QAAQ;KACZ,MAAM,QAAQ;KACd,MAAM,QAAQ;KACd,WAAW,IAAI,KAAK,QAAQ,UAAU,CAAC,SAAS;KAChD,SAAS;KACT,UAAU,KAAK;KACf,UAAU;MACR,YAAY,QAAQ;MACpB,aAAa,QAAQ;MACtB;KACF;AAED,YAAQ,IAAI,gCAAgC,QAAQ,cAAc,QAAQ,OAAO;AACjF,YAAQ,IAAI,gBAAgB,IAAI,KAAK,GAAG;AAExC,SAAK,KAAK,WAAW,IAAI;YAClB,KAAK;AACZ,YAAQ,MAAM,6CAA6C,IAAI;;IAEjE;;CAGJ,MAAc,WAAW,MAAc,MAAsC;EAC3E,MAAM,MAAM,GAAG,KAAK,UAAU;EAC9B,MAAM,MAAM,MAAM,MAAM,KAAK;GAC3B,GAAG;GACH,SAAS;IACP,iBAAiB,UAAU,KAAK,OAAO;IACvC,gBAAgB;IAChB,GAAG,KAAK;IACT;GACF,CAAC;AAEF,MAAI,CAAC,IAAI,IAAI;GACX,MAAM,OAAO,MAAM,IAAI,MAAM,CAAC,YAAY,GAAG;AAC7C,SAAM,IAAI,MAAM,kBAAkB,IAAI,OAAO,IAAI,OAAO;;AAG1D,SAAO"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/WatiProvider.ts"],"sourcesContent":["import EventEmitter from 'eventemitter3';\nimport * as http from 'node:http';\nimport type { MessageProvider, IncomingMessage, OutgoingMessage } from '@operor/core';\nimport type { WatiProviderConfig, WatiTemplateParams } from './types.js';\n\nexport class WatiProvider extends EventEmitter implements MessageProvider {\n  public readonly name = 'wati';\n  private config: WatiProviderConfig;\n  private server: http.Server | null = null;\n  private connected = false;\n  private baseUrl: string;\n  private webhookPort: number;\n  private webhookPath: string;\n\n  constructor(config: WatiProviderConfig) {\n    super();\n    this.config = config;\n    // v3 API: base URL without tenant ID — token resolves tenant\n    this.baseUrl = (config.apiBaseUrl || 'https://live-mt-server.wati.io').replace(/\\/+$/, '');\n    this.webhookPort = config.webhookPort || 3001;\n    this.webhookPath = config.webhookPath || '/webhook/wati';\n  }\n\n  async connect(): Promise<void> {\n    this.server = http.createServer((req, res) => {\n      if (req.url?.startsWith(this.webhookPath)) {\n        if (req.method === 'GET') {\n          this.handleVerification(req, res);\n        } else if (req.method === 'POST') {\n          this.handleWebhookRequest(req, res);\n        } else {\n          res.writeHead(405).end();\n        }\n      } else {\n        res.writeHead(404).end();\n      }\n    });\n\n    await new Promise<void>((resolve) => {\n      this.server!.listen(this.webhookPort, () => {\n        this.connected = true;\n        console.log(`✅ WATI webhook server listening on port ${this.webhookPort}`);\n        console.log(`   Webhook path: ${this.webhookPath}`);\n        resolve();\n      });\n    });\n\n    this.emit('ready');\n  }\n\n  async disconnect(): Promise<void> {\n    if (this.server) {\n      await new Promise<void>((resolve, reject) => {\n        this.server!.close((err) => (err ? reject(err) : resolve()));\n      });\n      this.server = null;\n    }\n    this.connected = false;\n    console.log('WATI provider disconnected');\n  }\n\n  async sendMessage(to: string, message: OutgoingMessage): Promise<void> {\n    if (!this.connected) {\n      throw new Error('WATI provider not connected');\n    }\n\n    // v3 API: POST /api/ext/v3/conversations/messages/text\n    // target is just the phone number; use Channel:Phone only if channelId is explicitly set\n    await this.apiRequest('/api/ext/v3/conversations/messages/text', {\n      method: 'POST',\n      body: JSON.stringify({ target: to, text: message.text }),\n    });\n\n    console.log(`📤 [WATI] Sent reply to ${to}`);\n  }\n\n  async sendTemplateMessage(to: string, template: WatiTemplateParams): Promise<void> {\n    if (!this.connected) {\n      throw new Error('WATI provider not connected');\n    }\n\n    // v3 API: POST /api/ext/v3/conversations/messages/template\n    await this.apiRequest('/api/ext/v3/conversations/messages/template', {\n      method: 'POST',\n      body: JSON.stringify({\n        target: to,\n        template_name: template.templateName,\n        parameters: template.parameters,\n      }),\n    });\n\n    console.log(`📤 [WATI] Sent template \"${template.templateName}\" to ${to}`);\n  }\n\n  isActive(): boolean {\n    return this.connected;\n  }\n\n  // --- Private helpers ---\n\n  private handleVerification(req: http.IncomingMessage, res: http.ServerResponse): void {\n    const url = new URL(req.url!, `http://localhost:${this.webhookPort}`);\n    const challenge = url.searchParams.get('hub.challenge');\n    if (challenge) {\n      res.writeHead(200, { 'Content-Type': 'text/plain' }).end(challenge);\n    } else {\n      res.writeHead(200).end('ok');\n    }\n  }\n\n  private handleWebhookRequest(req: http.IncomingMessage, res: http.ServerResponse): void {\n    let body = '';\n    req.on('data', (chunk: Buffer) => { body += chunk.toString(); });\n    req.on('end', () => {\n      res.writeHead(200).end('ok');\n\n      try {\n        const payload = JSON.parse(body);\n\n        console.log(`📩 [WATI] Webhook received:`, JSON.stringify(payload, null, 2));\n\n        // WATI sends different payload structures — normalize\n        const text = payload.text || payload.message?.text || payload.message?.body || '';\n        const waId = payload.waId || payload.wa_id || payload.from || '';\n        const messageId = payload.whatsappMessageId || payload.message_id || payload.id || '';\n        const senderName = payload.senderName || payload.sender_name || payload.pushName || '';\n        const timestamp = payload.timestamp || payload.created || '';\n        const fromMe = payload.fromMe ?? payload.from_me ?? payload.owner ?? false;\n        const messageType = payload.type || payload.messageType || 'text';\n\n        if (!text || fromMe) {\n          console.log(`⏭️ [WATI] Skipped: ${!text ? 'no text' : 'fromMe'} (type: ${messageType})`);\n          return;\n        }\n\n        const parsedTs = timestamp ? new Date(\n          // If it's a pure number (unix epoch), parse as integer\n          /^\\d+$/.test(String(timestamp)) ? Number(timestamp) * (/^\\d{10}$/.test(String(timestamp)) ? 1000 : 1) : timestamp\n        ).getTime() : NaN;\n\n        const msg: IncomingMessage = {\n          id: messageId,\n          from: waId,\n          text,\n          timestamp: Number.isFinite(parsedTs) ? parsedTs : Date.now(),\n          channel: 'whatsapp',\n          provider: this.name,\n          metadata: {\n            senderName,\n            messageType,\n          },\n        };\n\n        console.log(`\\n📥 [WATI] New message from ${senderName || waId}`);\n        console.log(`   Message: \"${msg.text}\"`);\n\n        this.emit('message', msg);\n      } catch (err) {\n        console.error('❌ [WATI] Failed to parse webhook payload:', err);\n        console.error('   Raw body:', body);\n      }\n    });\n  }\n\n  private async apiRequest(path: string, init: RequestInit): Promise<Response> {\n    const url = `${this.baseUrl}${path}`;\n    const res = await fetch(url, {\n      ...init,\n      headers: {\n        'Authorization': `Bearer ${this.config.apiToken}`,\n        'Content-Type': 'application/json',\n        ...init.headers,\n      },\n    });\n\n    if (!res.ok) {\n      const text = await res.text().catch(() => '');\n      console.error(`❌ [WATI] API ${res.status} ${init.method || 'GET'} ${path}: ${text}`);\n      throw new Error(`WATI API error ${res.status}: ${text}`);\n    }\n\n    console.log(`✅ [WATI] API ${res.status} ${init.method || 'GET'} ${path}`);\n    return res;\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@operor/provider-wati",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "WATI WhatsApp Business API provider for Agent OS",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "dependencies": {
     "eventemitter3": "^5.0.1",
-    "@operor/core": "0.1.1"
+    "@operor/core": "0.2.0"
   },
   "devDependencies": {
     "tsdown": "^0.20.3",

package/src/WatiProvider.ts

@@ -1,7 +1,7 @@
 import EventEmitter from 'eventemitter3';
 import * as http from 'node:http';
 import type { MessageProvider, IncomingMessage, OutgoingMessage } from '@operor/core';
-import type { WatiProviderConfig, WatiWebhookPayload, WatiTemplateParams } from './types.js';
+import type { WatiProviderConfig, WatiTemplateParams } from './types.js';
 
 export class WatiProvider extends EventEmitter implements MessageProvider {
   public readonly name = 'wati';
@@ -15,7 +15,8 @@ export class WatiProvider extends EventEmitter implements MessageProvider {
   constructor(config: WatiProviderConfig) {
     super();
     this.config = config;
-    this.baseUrl = config.apiBaseUrl || `https://live-mt-server.wati.io/${config.tenantId}/api`;
+    // v3 API: base URL without tenant ID — token resolves tenant
+    this.baseUrl = (config.apiBaseUrl || 'https://live-mt-server.wati.io').replace(/\/+$/, '');
     this.webhookPort = config.webhookPort || 3001;
     this.webhookPath = config.webhookPath || '/webhook/wati';
   }
@@ -63,9 +64,11 @@ export class WatiProvider extends EventEmitter implements MessageProvider {
       throw new Error('WATI provider not connected');
     }
 
-    await this.apiRequest(`/v1/sendSessionMessage/${to}`, {
+    // v3 API: POST /api/ext/v3/conversations/messages/text
+    // target is just the phone number; use Channel:Phone only if channelId is explicitly set
+    await this.apiRequest('/api/ext/v3/conversations/messages/text', {
       method: 'POST',
-      body: JSON.stringify({ messageText: message.text }),
+      body: JSON.stringify({ target: to, text: message.text }),
     });
 
     console.log(`📤 [WATI] Sent reply to ${to}`);
@@ -76,9 +79,11 @@ export class WatiProvider extends EventEmitter implements MessageProvider {
       throw new Error('WATI provider not connected');
     }
 
-    await this.apiRequest(`/v2/sendTemplateMessage?whatsappNumber=${encodeURIComponent(to)}`, {
+    // v3 API: POST /api/ext/v3/conversations/messages/template
+    await this.apiRequest('/api/ext/v3/conversations/messages/template', {
       method: 'POST',
       body: JSON.stringify({
+        target: to,
         template_name: template.templateName,
         parameters: template.parameters,
       }),
@@ -110,31 +115,49 @@ export class WatiProvider extends EventEmitter implements MessageProvider {
       res.writeHead(200).end('ok');
 
       try {
-        const payload: WatiWebhookPayload = JSON.parse(body);
+        const payload = JSON.parse(body);
 
-        if (payload.eventType !== 'messageReceived' || payload.fromMe) {
+        console.log(`📩 [WATI] Webhook received:`, JSON.stringify(payload, null, 2));
+
+        // WATI sends different payload structures — normalize
+        const text = payload.text || payload.message?.text || payload.message?.body || '';
+        const waId = payload.waId || payload.wa_id || payload.from || '';
+        const messageId = payload.whatsappMessageId || payload.message_id || payload.id || '';
+        const senderName = payload.senderName || payload.sender_name || payload.pushName || '';
+        const timestamp = payload.timestamp || payload.created || '';
+        const fromMe = payload.fromMe ?? payload.from_me ?? payload.owner ?? false;
+        const messageType = payload.type || payload.messageType || 'text';
+
+        if (!text || fromMe) {
+          console.log(`⏭️ [WATI] Skipped: ${!text ? 'no text' : 'fromMe'} (type: ${messageType})`);
           return;
         }
 
+        const parsedTs = timestamp ? new Date(
+          // If it's a pure number (unix epoch), parse as integer
+          /^\d+$/.test(String(timestamp)) ? Number(timestamp) * (/^\d{10}$/.test(String(timestamp)) ? 1000 : 1) : timestamp
+        ).getTime() : NaN;
+
         const msg: IncomingMessage = {
-          id: payload.whatsappMessageId,
-          from: payload.waId,
-          text: payload.text,
-          timestamp: new Date(payload.timestamp).getTime(),
+          id: messageId,
+          from: waId,
+          text,
+          timestamp: Number.isFinite(parsedTs) ? parsedTs : Date.now(),
           channel: 'whatsapp',
           provider: this.name,
           metadata: {
-            senderName: payload.senderName,
-            messageType: payload.type,
+            senderName,
+            messageType,
           },
         };
 
-        console.log(`\n📥 [WATI] New message from ${payload.senderName || payload.waId}`);
+        console.log(`\n📥 [WATI] New message from ${senderName || waId}`);
         console.log(`   Message: "${msg.text}"`);
 
         this.emit('message', msg);
       } catch (err) {
         console.error('❌ [WATI] Failed to parse webhook payload:', err);
+        console.error('   Raw body:', body);
       }
     });
   }
@@ -152,9 +175,11 @@ export class WatiProvider extends EventEmitter implements MessageProvider {
 
     if (!res.ok) {
       const text = await res.text().catch(() => '');
+      console.error(`❌ [WATI] API ${res.status} ${init.method || 'GET'} ${path}: ${text}`);
       throw new Error(`WATI API error ${res.status}: ${text}`);
     }
 
+    console.log(`✅ [WATI] API ${res.status} ${init.method || 'GET'} ${path}`);
     return res;
   }
 }

package/src/types.ts

@@ -1,27 +1,16 @@
 export interface WatiProviderConfig {
   /** WATI API bearer token */
   apiToken: string;
-  /** WATI tenant ID (appears in the API base URL) */
-  tenantId: string;
+  /** WATI tenant ID — optional in v3 (used for Channel:PhoneNumber targeting in multi-channel setups) */
+  tenantId?: string;
   /** Port for the webhook HTTP server (default: 3001) */
   webhookPort?: number;
   /** Path the webhook listens on (default: /webhook/wati) */
   webhookPath?: string;
-  /** Override the WATI API base URL (default: https://live-mt-server.wati.io/{tenantId}/api) */
+  /** Override the WATI API base URL (default: https://live-mt-server.wati.io) */
   apiBaseUrl?: string;
 }
 
-export interface WatiWebhookPayload {
-  eventType: string;
-  waId: string;
-  text: string;
-  whatsappMessageId: string;
-  timestamp: string;
-  senderName: string;
-  type: string;
-  fromMe: boolean;
-}
-
 export interface WatiTemplateParams {
   templateName: string;
   parameters: Array<{ name: string; value: string }>;