Hacktober apps fix (#15733)

- update dependencies in mailchimp, stripe and last email interaction
apps
- fix logic in mailchimp integration, now it's triggered by update of
People records and allows for update Mailchimp records
- fix logic in stripe integration, now properly reads data from webhook
- update READMEs to make it more understandable to non-technical users

Author: BOHEUS

packages/twenty-apps/hacktoberfest-2025/last-email-interaction/.yarn/install-state.gz

@@ -17,5 +17,5 @@ twenty app sync
 
 ## Flow
 - Checks if fields are created, if not, creates them on fly
-- Extracts the timedate of message and calculates the last interaction status
+- Extracts the datetime of message and calculates the last interaction status
 - Fetches all users and companies connected to them and updates their Last interaction and Interaction status fields

packages/twenty-apps/hacktoberfest-2025/last-email-interaction/README.md

@@ -9,13 +9,11 @@ const config: ApplicationConfig = {
     TWENTY_API_KEY: {
       universalIdentifier: 'aae3f523-4c1f-4805-b3ee-afeb676c381e',
       isSecret: true,
-      value: '',
       description: 'Required to send requests to Twenty',
     },
     TWENTY_API_URL: {
       universalIdentifier: '6d19bb04-45bb-46aa-a4e5-4a2682c7b19d',
       isSecret: false,
-      value: '',
       description: 'Optional, defaults to cloud API URL',
     },
   },

packages/twenty-apps/hacktoberfest-2025/last-email-interaction/application.config.ts

@@ -10,7 +10,7 @@
   "packageManager": "[email protected]",
   "dependencies": {
     "axios": "^1.12.2",
-    "twenty-sdk": "^0.0.3"
+    "twenty-sdk": "^0.0.4"
   },
   "devDependencies": {
     "@types/node": "^24.7.2"

packages/twenty-apps/hacktoberfest-2025/last-email-interaction/package.json

@@ -1,13 +1,11 @@
 import axios from 'axios';
-import { setTimeout } from 'timers/promises';
 import { type ServerlessFunctionConfig } from 'twenty-sdk/application';
 
 const TWENTY_API_KEY = process.env.TWENTY_API_KEY ?? '';
 const TWENTY_URL =
   process.env.TWENTY_API_URL !== '' && process.env.TWENTY_API_URL !== undefined
     ? `${process.env.TWENTY_API_URL}/rest`
     : 'https://api.twenty.com/rest';
-const DELAY = 500;
 
 const create_last_interaction = (id: string) => {
   return {
@@ -100,6 +98,53 @@ const interactionData = (date: string, status: string) => {
   };
 };
 
+const updateInteractionStatus = async (objectName: string, id: string, messageDate: string, status: string) => {
+  const options = {
+    method: 'PATCH',
+    url: `${TWENTY_URL}/${objectName}/${id}`,
+    headers: {
+      'Content-Type': 'application/json',
+      Authorization: `Bearer ${TWENTY_API_KEY}`,
+    },
+    data: {
+      lastInteraction: messageDate,
+      interactionStatus: status
+    }
+  };
+  try {
+    const response = await axios.request(options);
+    if (response.status === 200) {
+      console.log('Successfully updated company last interaction field');
+    }
+  } catch (error) {
+    if (axios.isAxiosError(error)) {
+      throw error;
+    }
+    throw error;
+  }
+}
+
+const fetchRelatedCompanyId = async (id: string) => {
+  const options = {
+    method: 'GET',
+    url: `${TWENTY_URL}/people/${id}`,
+    headers: {
+      Authorization: `Bearer ${TWENTY_API_KEY}`,
+    },
+  };
+  try {
+    const req = await axios.request(options);
+    if (req.status === 200 && req.data.person.companyId !== null && req.data.person.companyId !== undefined) {
+      return req.data.person.companyId;
+    }
+  } catch (error) {
+    if (axios.isAxiosError(error)) {
+      throw error;
+    }
+    throw error;
+  }
+}
+
 export const main = async (params: {
   properties: Record<string, any>;
   recordId: string;
@@ -147,7 +192,6 @@ export const main = async (params: {
       if (response2.status === 201) {
         console.log('Successfully created company last interaction field');
       }
-      await setTimeout(DELAY);
     }
     if (company_interaction_status === undefined) {
       const response2 = await axios.request(
@@ -156,7 +200,6 @@ export const main = async (params: {
       if (response2.status === 201) {
         console.log('Successfully created company interaction status field');
       }
-      await setTimeout(DELAY);
     }
     if (person_last_interaction === undefined) {
       const response2 = await axios.request(
@@ -165,7 +208,6 @@ export const main = async (params: {
       if (response2.status === 201) {
         console.log('Successfully created person last interaction field');
       }
-      await setTimeout(DELAY);
     }
     if (person_interaction_status === undefined) {
       const response2 = await axios.request(
@@ -174,11 +216,10 @@ export const main = async (params: {
       if (response2.status === 201) {
         console.log('Successfully created person interaction status field');
       }
-      await setTimeout(DELAY);
     }
 
     // Extract the timestamp of message
-    const messageDate = properties.receivedAt;
+    const messageDate = properties.after.receivedAt;
     const interactionStatus = calculateStatus(messageDate);
 
     // Get the details of person and related company
@@ -190,87 +231,30 @@ export const main = async (params: {
       },
     };
     const messageDetails = await axios.request(messageOptions);
-    await setTimeout(DELAY);
-    const peopleIds = [];
+    const peopleIds: string[] = [];
     for (const participant of messageDetails.data.messages
       .messageParticipants) {
       peopleIds.push(participant.personId);
     }
 
     const companiesIds = [];
     for (const id of peopleIds) {
-      const options = {
-        method: 'GET',
-        url: `${TWENTY_URL}/people/${id}`,
-        headers: {
-          Authorization: `Bearer ${TWENTY_API_KEY}`,
-        },
-      };
-      try {
-        const req = await axios.request(options);
-        companiesIds.push(req.data.person.companyId);
-        await setTimeout(DELAY);
-      } catch (error) {
-        if (axios.isAxiosError(error)) {
-          throw error;
-        }
-        throw error;
-      }
+      companiesIds.push(await fetchRelatedCompanyId(id));
     }
     // Update the field value depending on the timestamp
     for (const id of peopleIds) {
-      const peopleOptions = {
-        method: 'PATCH',
-        url: `${TWENTY_URL}/people/${id}`,
-        headers: {
-          'Content-Type': 'application/json',
-          Authorization: `Bearer ${TWENTY_API_KEY}`,
-        },
-        data: interactionData(messageDate, interactionStatus),
-      };
-      try {
-        const response = await axios.request(options);
-        if (response.status === 200) {
-          console.log('Successfully updated company last interaction field');
-          await setTimeout(DELAY);
-        }
-      } catch (error) {
-        if (axios.isAxiosError(error)) {
-          throw error;
-        }
-        throw error;
-      }
+     await updateInteractionStatus("people", id, messageDate, interactionStatus);
     }
 
     for (const id of companiesIds) {
-      const companiesOptions = {
-        method: 'PATCH',
-        url: `${TWENTY_URL}/companies/${id}`,
-        headers: {
-          'Content-Type': 'application/json',
-          Authorization: `Bearer ${TWENTY_API_KEY}`,
-        },
-        data: interactionData(messageDate, interactionStatus),
-      };
-      try {
-        const req = await axios.request(companiesOptions);
-        if (req.status === 200) {
-          console.log(`Successfully updated company with ID ${id}`);
-          await setTimeout(DELAY);
-        }
-      } catch (error) {
-        if (axios.isAxiosError(error)) {
-          throw error;
-        }
-        throw error;
-      }
+      await updateInteractionStatus("companies", id, messageDate, interactionStatus);
     }
   } catch (error) {
     if (axios.isAxiosError(error)) {
-      console.error(error);
+      console.error(error.message);
       return {};
     }
-    console.log(error);
+    console.error(error);
     return {};
   }
 };

packages/twenty-apps/hacktoberfest-2025/last-email-interaction/serverlessFunctions/test/src/index.ts

@@ -5,13 +5,14 @@ __metadata:
   version: 8
   cacheKey: 10c0
 
-"Last email interaction@workspace:.":
-  version: 0.0.0-use.local
-  resolution: "Last email interaction@workspace:."
+"@types/node@npm:^24.7.2":
+  version: 24.10.0
+  resolution: "@types/node@npm:24.10.0"
   dependencies:
-    axios: "npm:^1.12.2"
-  languageName: unknown
-  linkType: soft
+    undici-types: "npm:~7.16.0"
+  checksum: 10c0/f82ed7194e16f5590ef7afdc20c6d09068c76d50278b485ede8f0c5749683536e3064ffa8def8db76915196afb3724b854aa5723c64d6571b890b14492943b46
+  languageName: node
+  linkType: hard
 
 "async-function@npm:^1.0.0":
   version: 1.0.0
@@ -217,6 +218,16 @@ __metadata:
   languageName: node
   linkType: hard
 
+"last-email-interaction@workspace:.":
+  version: 0.0.0-use.local
+  resolution: "last-email-interaction@workspace:."
+  dependencies:
+    "@types/node": "npm:^24.7.2"
+    axios: "npm:^1.12.2"
+    twenty-sdk: "npm:^0.0.4"
+  languageName: unknown
+  linkType: soft
+
 "math-intrinsics@npm:^1.1.0":
   version: 1.1.0
   resolution: "math-intrinsics@npm:1.1.0"
@@ -246,3 +257,17 @@ __metadata:
   checksum: 10c0/fe7dd8b1bdbbbea18d1459107729c3e4a2243ca870d26d34c2c1bcd3e4425b7bcc5112362df2d93cc7fb9746f6142b5e272fd1cc5c86ddf8580175186f6ad42b
   languageName: node
   linkType: hard
+
+"twenty-sdk@npm:^0.0.4":
+  version: 0.0.4
+  resolution: "twenty-sdk@npm:0.0.4"
+  checksum: 10c0/550f1d85bf0701396c9dd2d4c6bc55ba1b067fce13636f8540eec60ab6a4257c6d7cd86cb3f62e0974bf99467bc31270d92b17b9681a1b7a6281b7ef97224080
+  languageName: node
+  linkType: hard
+
+"undici-types@npm:~7.16.0":
+  version: 7.16.0
+  resolution: "undici-types@npm:7.16.0"
+  checksum: 10c0/3033e2f2b5c9f1504bdc5934646cb54e37ecaca0f9249c983f7b1fc2e87c6d18399ebb05dc7fd5419e02b2e915f734d872a65da2e3eeed1813951c427d33cc9a
+  languageName: node
+  linkType: hard

packages/twenty-apps/hacktoberfest-2025/last-email-interaction/yarn.lock

@@ -5,6 +5,7 @@ Synchronizing contacts between Twenty and Mailchimp
 ## Requirements
 - twenty-cli `npm install -g twenty-cli`
 - an `apiKey`. Go to `https://twenty.com/settings/api-webhooks` to generate one
+- Mailchimp API key - Mailchimp > avatar in top right corner > Profile > Extras > API keys
 
 ## Setup
 1. Add app to your workspace
@@ -13,13 +14,20 @@ twenty auth login
 cd mailchimp-synchronizer
 twenty app sync
 ```
-
 2. Go to Settings > Integrations > Mailchimp synchronizer > Settings and add required variables
 
 ## Flow
 - Check if required variables are set, if not, exit
-- Validate data based on set constraints
-- If all constraints are checked, send a request to Mailchimp with new contact
+- Validate data based on set constraints, if data doesn't match constraints, exit
+- Check if person already exists in Mailchimp:
+  - if yes, check if UPDATE_PERSON is set to true
+    - if UPDATE_PERSON is true, check if Twenty record is the same as Mailchimp record
+      - if they're the same, exit
+      - if not, update
+    - if UPDATE_PERSON is false, exit
+  - if person doesn't exist in Mailchimp, send a request to Mailchimp with new contact
 
 ## Note
-- SMS support is experimental and may cause errors
+- SMS support is experimental and may cause errors
+- constraints are directly responsible for sent data so if e.g. you want to have a company name in 
+Mailchimp, you have to set IS_COMPANY_CONSTRAINT to true