wexa-chat 0.3.1 → 0.3.3

package/README.md

@@ -312,6 +312,73 @@ await chat.services.messages.sendMessage({
 });
 ```
 
+##### Email Threading Explained
+
+Email threading works by maintaining a stable `thread_id` across all messages in the same conversation:
+
+**How it works:**
+
+1. **First Email (New Thread)**
+   - Recruiter sends first email → Unipile returns `provider_id: "A"`
+   - Conversation stores `emailChatId = "A"` (the thread identifier)
+   - Message stores `metadata.email.providerId = "A"`
+
+2. **Candidate Replies**
+   - Webhook arrives with `thread_id: "A"` and new `provider_id: "B"`
+   - System finds conversation by `emailChatId = "A"`
+   - Message stores `metadata.email.providerId = "B"`
+
+3. **Recruiter Replies (Threading)**
+   - To continue the thread, pass `replyTo: "B"` (candidate's provider_id)
+   - Unipile returns new `provider_id: "C"`
+   - `emailChatId` remains `"A"` (NOT updated for replies)
+   - Message stores `metadata.email.providerId = "C"`
+
+**Key Points:**
+- `emailChatId` = Set ONCE on first email, used to find conversation
+- `replyTo` = Previous message's `provider_id`, maintains email thread
+- `providerId` = Current message's ID, stored for future replies
+
+**Example: Reply to candidate's email**
+
+```ts
+// 1. Get the last message from candidate
+const messages = await chat.services.messages.listMessages({
+  organizationId: 'org-123',
+  conversationId: 'conv-456',
+  limit: 10,
+});
+
+const lastCandidateMsg = messages.items
+  .find(m => m.senderModel === 'Application');
+
+// 2. Extract their providerId for threading
+const replyToId = lastCandidateMsg?.metadata?.email?.providerId;
+
+// 3. Send reply with replyTo
+await chat.services.messages.sendMessage({
+  organizationId: 'org-123',
+  conversationId: 'conv-456',
+  senderModel: 'User',
+  senderId: 'user-1',
+  text: 'Great to hear from you! Let me provide more details...',
+  source: [sourceType.EMAIL],
+  connectorIds: {
+    email: { connectorId: 'em-connector-1', contactId: 'john@candidate.com' },
+  },
+  metadata: {
+    email: {
+      subject: 'Re: Job Opportunity',
+      recipientName: 'John Doe',
+      replyTo: replyToId,  // ← This keeps emails in the same thread
+    }
+  }
+});
+```
+
+**Without `replyTo`:** Each email creates a new thread (separate email chains)  
+**With `replyTo`:** All emails stay in one thread (Gmail conversation view)
+
 #### Multi-Platform Messages
 
 ```ts

package/dist/index.d.cts

@@ -176,6 +176,7 @@ interface IMessage extends Document {
         linkedin?: {
             subject?: string;
             isInMail?: boolean;
+            linkedinApi?: string;
             senderName?: string;
             senderProfileUrl?: string;
         };
@@ -276,6 +277,7 @@ type SendMessageArgs = {
         linkedin?: {
             subject?: string;
             isInMail?: boolean;
+            linkedinApi?: 'classic' | 'recruiter' | 'sales_navigator';
         };
     };
 };

package/dist/index.d.ts

@@ -176,6 +176,7 @@ interface IMessage extends Document {
         linkedin?: {
             subject?: string;
             isInMail?: boolean;
+            linkedinApi?: string;
             senderName?: string;
             senderProfileUrl?: string;
         };
@@ -276,6 +277,7 @@ type SendMessageArgs = {
         linkedin?: {
             subject?: string;
             isInMail?: boolean;
+            linkedinApi?: 'classic' | 'recruiter' | 'sales_navigator';
         };
     };
 };

package/dist/index.js

@@ -566,6 +566,7 @@ function createMessagesService(models, hooks = {}) {
      * @returns The created message
      */
     async sendMessage(args) {
+      var _a, _b;
       const {
         organizationId,
         conversationId,
@@ -593,32 +594,67 @@ function createMessagesService(models, hooks = {}) {
         const linkedinMeta = metadata == null ? void 0 : metadata.linkedin;
         lastLinkedInId = LinkedinConnector == null ? void 0 : LinkedinConnector.connectorId;
         if (LinkedinConnector) {
-          tasks.push({
-            name: "linkedin",
-            run: async () => {
-              const path = paths.linkedin.startChat(String(LinkedinConnector.connectorId));
-              const payload = {
-                linkedin_url: LinkedinConnector.contactId,
-                text
-              };
-              if (linkedinMeta == null ? void 0 : linkedinMeta.subject) {
-                payload.subject = linkedinMeta.subject;
-              }
-              if (linkedinMeta == null ? void 0 : linkedinMeta.isInMail) {
-                payload.linkedin_inmail = linkedinMeta.isInMail;
-              }
-              console.log("LinkedIn payload:", payload);
-              try {
-                const res = await getAxios().post(path, payload);
-                const data = res.data;
-                console.log("linkedinChatId", data);
-                linkedinChatId = data.chat_data.chat_id;
-                return { status: "fulfilled", value: data };
-              } catch (error) {
-                return { status: "rejected", reason: error };
-              }
+          if (linkedinMeta == null ? void 0 : linkedinMeta.isInMail) {
+            const missingFields = [];
+            if (!linkedinMeta.subject) missingFields.push("subject");
+            if (!linkedinMeta.linkedinApi) missingFields.push("linkedinApi");
+            if (missingFields.length > 0) {
+              failed_source.push({
+                source: "linkedin",
+                message: `InMail requires the following fields: ${missingFields.join(", ")}`
+              });
+            } else {
+              tasks.push({
+                name: "linkedin",
+                run: async () => {
+                  const path = paths.linkedin.startChat(String(LinkedinConnector.connectorId));
+                  const payload = {
+                    linkedin_url: LinkedinConnector.contactId,
+                    text
+                  };
+                  if (linkedinMeta.subject) {
+                    payload.subject = linkedinMeta.subject;
+                  }
+                  if (linkedinMeta.linkedinApi) {
+                    payload.linkedin_api = linkedinMeta.linkedinApi;
+                  }
+                  if (linkedinMeta.isInMail) {
+                    payload.linkedin_inmail = linkedinMeta.isInMail;
+                  }
+                  try {
+                    const res = await getAxios().post(path, payload);
+                    const data = res.data;
+                    linkedinChatId = data.chat_data.chat_id;
+                    return { status: "fulfilled", value: data };
+                  } catch (error) {
+                    return { status: "rejected", reason: error };
+                  }
+                }
+              });
             }
-          });
+          } else {
+            tasks.push({
+              name: "linkedin",
+              run: async () => {
+                const path = paths.linkedin.startChat(String(LinkedinConnector.connectorId));
+                const payload = {
+                  linkedin_url: LinkedinConnector.contactId,
+                  text
+                };
+                if (linkedinMeta == null ? void 0 : linkedinMeta.linkedinApi) {
+                  payload.linkedin_api = linkedinMeta.linkedinApi;
+                }
+                try {
+                  const res = await getAxios().post(path, payload);
+                  const data = res.data;
+                  linkedinChatId = data.chat_data.chat_id;
+                  return { status: "fulfilled", value: data };
+                } catch (error) {
+                  return { status: "rejected", reason: error };
+                }
+              }
+            });
+          }
         } else {
           failed_source.push({ source: "linkedin", message: "Missing connector configuration" });
         }
@@ -659,7 +695,7 @@ function createMessagesService(models, hooks = {}) {
           tasks.push({
             name: "email",
             run: async () => {
-              var _a;
+              var _a2;
               const path = paths.email.sendEmail(String(emailConnector.connectorId));
               const primaryRecipient = {
                 display_name: (emailMeta == null ? void 0 : emailMeta.recipientName) || "Recipient",
@@ -712,7 +748,7 @@ function createMessagesService(models, hooks = {}) {
                 const res = await getAxios().post(path, payload);
                 console.log("Email response:", res.data);
                 const data = res.data;
-                if ((_a = data.mail_sent_data) == null ? void 0 : _a.provider_id) {
+                if ((_a2 = data.mail_sent_data) == null ? void 0 : _a2.provider_id) {
                   emailChatId = data.mail_sent_data.provider_id;
                   console.log("Email provider_id extracted:", emailChatId);
                 } else {
@@ -731,12 +767,12 @@ function createMessagesService(models, hooks = {}) {
       if (tasks.length > 0) {
         const results = await Promise.allSettled(tasks.map((t) => t.run()));
         results.forEach((result, idx) => {
-          var _a, _b, _c, _d, _e, _f;
+          var _a2, _b2, _c, _d, _e, _f;
           const name = tasks[idx].name;
           if (result.status === "fulfilled") {
             success_source.push(name);
           } else {
-            const error = ((_c = (_b = (_a = result.reason) == null ? void 0 : _a.response) == null ? void 0 : _b.data) == null ? void 0 : _c.detail) || ((_e = (_d = result.reason) == null ? void 0 : _d.response) == null ? void 0 : _e.data) || ((_f = result.reason) == null ? void 0 : _f.message) || "Unknown error";
+            const error = ((_c = (_b2 = (_a2 = result.reason) == null ? void 0 : _a2.response) == null ? void 0 : _b2.data) == null ? void 0 : _c.detail) || ((_e = (_d = result.reason) == null ? void 0 : _d.response) == null ? void 0 : _e.data) || ((_f = result.reason) == null ? void 0 : _f.message) || "Unknown error";
             failed_source.push({
               source: name,
               message: typeof error === "string" ? error : JSON.stringify(error)
@@ -779,7 +815,9 @@ function createMessagesService(models, hooks = {}) {
       if (lastEmailId) conversationUpdate.lastEmailId = lastEmailId;
       if (linkedinChatId) conversationUpdate.linkedinChatId = linkedinChatId;
       if (whatsappChatId) conversationUpdate.whatsappChatId = whatsappChatId;
-      if (emailChatId) conversationUpdate.emailChatId = emailChatId;
+      if (emailChatId && !((_b = (_a = args.metadata) == null ? void 0 : _a.email) == null ? void 0 : _b.replyTo)) {
+        conversationUpdate.emailChatId = emailChatId;
+      }
       await Conversation.findByIdAndUpdate(conversationId, {
         $set: conversationUpdate
       });