lua-cli 3.1.0-alpha.3 → 3.1.0-alpha.4

package/template/src/webhooks/UserEventWebhook.ts

@@ -2,20 +2,20 @@
  * User Event Webhook Example
  * 
  * This webhook receives user events from external systems (e.g., CRM, marketing tools).
- * It validates incoming data and stores events for processing.
+ * It validates incoming data, stores events for processing, and can send template
+ * messages using the Templates API (currently supports WhatsApp templates).
  * 
- * Webhook URL: {API_URL}/webhooks/{agentId}/{webhookId}
+ * Webhook URLs:
+ *   https://webhook.heylua.ai/{agentId}/{webhookId}
+ *   https://webhook.heylua.ai/{agentId}/{webhook-name}
  */
 
-import { LuaWebhook, Data } from "lua-cli";
+import { LuaWebhook, Data, Templates } from "lua-cli";
 import { z } from "zod";
 
 const userEventWebhook = new LuaWebhook({
   name: "user-events",
-  version: "1.0.0",
   description: "Receives user events from external systems",
-  context: "This webhook handles user registration, profile updates, and deletion events. " +
-           "It validates the incoming data, stores events in the database, and can trigger follow-up actions.",
 
   // Validate query parameters (optional source tracking)
   querySchema: z.object({
@@ -35,17 +35,20 @@ const userEventWebhook = new LuaWebhook({
     userId: z.string(),
     email: z.string().email(),
     name: z.string().optional(),
+    phoneNumber: z.string().optional(),
+    channelId: z.string().optional(),
     metadata: z.record(z.any()).optional(),
     timestamp: z.string()
   }),
 
-  execute: async ({ query, headers, body }) => {
-    console.log(`📥 Received ${body.eventType} event for user:`, body.email);
+  execute: async (event: any) => {
+    const { query, headers, body } = event;
+    console.log(`📥 Received ${body?.eventType} event for user:`, body?.email);
     console.log(`📍 Source:`, query?.source || 'unknown');
 
     // Security: Validate API key (in production, use env variable)
     const expectedKey = process.env.WEBHOOK_API_KEY || 'your-secret-key';
-    if (headers['x-api-key'] !== expectedKey) {
+    if (headers?.['x-api-key'] !== expectedKey) {
       throw new Error('Invalid API key');
     }
 
@@ -58,16 +61,41 @@ const userEventWebhook = new LuaWebhook({
     };
 
     const result = await Data.create('user-events', eventData, 
-      `${body.eventType} ${body.email} ${body.name || ''}`
+      `${body?.eventType} ${body?.email} ${body?.name || ''}`
     );
 
     console.log('✅ Event stored successfully:', result.id);
 
+    // Example: Send welcome template on signup using Templates API
+    // Uses Templates.whatsapp namespace for WhatsApp templates
+    let templateResult = null;
+    if (body?.eventType === 'signup' && body?.phoneNumber && body?.channelId) {
+      try {
+        // Search for a welcome template
+        const response = await Templates.whatsapp.list(body.channelId, { search: 'welcome' });
+        const welcomeTemplate = response.templates.find((t: any) => t.status === 'APPROVED');
+        
+        if (welcomeTemplate) {
+          // Send the template message
+          templateResult = await Templates.whatsapp.send(body.channelId, welcomeTemplate.id, {
+            phoneNumbers: [body.phoneNumber],
+            values: {
+              body: { name: body.name || 'there' }
+            }
+          });
+          console.log('📱 Welcome template sent:', templateResult.results[0]?.messages[0]?.id);
+        }
+      } catch (error: any) {
+        console.log('⚠️ Could not send welcome template:', error.message);
+      }
+    }
+
     // Return success response
     return {
       success: true,
       eventId: result.id,
-      userId: body.userId,
+      userId: body?.userId,
+      templateSent: templateResult?.totalErrors === 0,
       timestamp: new Date().toISOString()
     };
   }