wexa-chat 0.3.0 → 0.3.2

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.js

@@ -566,6 +566,7 @@ function createMessagesService(models, hooks = {}) {
      * @returns The created message
      */
     async sendMessage(args) {
+      var _a, _b;
       const {
         organizationId,
         conversationId,
@@ -659,7 +660,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 +713,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 +732,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 +780,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
       });
@@ -852,7 +855,7 @@ function createMessagesService(models, hooks = {}) {
      */
     async receiveLinkedinMessage(args) {
       const { linkedinChatId, message, messageId, senderName, senderProfileUrl } = args;
-      const conversation = await Conversation.findOne({ linkedinChatId }).lean();
+      const conversation = await Conversation.findOne({ linkedinChatId }).sort({ lastMessageAt: -1 }).lean();
       if (!conversation) {
         throw new Error("Conversation not found for given linkedinChatId");
       }