@acceliance/twenty-click-to-call 0.1.1 β†’ 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -44,6 +44,22 @@ Notifications go through [ntfy](https://ntfy.sh), an open-source push service yo
44
44
 
45
45
  > Android never lets an app place a call silently: the dialer opens and the user presses call.
46
46
 
47
+ ## πŸ“Έ Screenshots
48
+
49
+ **1. One click on the contact.** The **Call** button (here in French, "Appeler") sits next to "Send email" on every person.
50
+
51
+ ![Call button on a contact](public/gallery/1-call-button.png)
52
+
53
+ **2. The call is logged and opened.** While the phone rings the dialer, Twenty creates a done task, assigned to you and linked to the contact, and opens it for your notes.
54
+
55
+ ![Logged call task opened in the side panel](public/gallery/2-call-logged-task.png)
56
+
57
+ **3. Every call stays in the contact's history.**
58
+
59
+ ![Call tasks on the contact](public/gallery/3-tasks-tab.png)
60
+
61
+ *Screenshots use a fictional contact.*
62
+
47
63
  ## How it works
48
64
 
49
65
  ```
package/manifest.json CHANGED
@@ -6,6 +6,11 @@
6
6
  "author": "Acceliance",
7
7
  "emailSupport": "contact@acceliance.fr",
8
8
  "logo": "public/logo.svg",
9
+ "galleryImages": [
10
+ "public/gallery/1-call-button.png",
11
+ "public/gallery/2-call-logged-task.png",
12
+ "public/gallery/3-tasks-tab.png"
13
+ ],
9
14
  "websiteUrl": "https://github.com/acceliance/twenty-click-to-call",
10
15
  "issueReportUrl": "https://github.com/acceliance/twenty-click-to-call/issues",
11
16
  "applicationVariables": {
@@ -38,11 +43,10 @@
38
43
  "isSecret": false
39
44
  }
40
45
  },
41
- "galleryImages": [],
42
46
  "defaultRoleUniversalIdentifier": "8730c5aa-9120-4ee6-b6bf-87120a1b12e6",
43
- "aboutDescription": "[![Acceliance](https://www.acceliance.fr/media/wdxp1zys/logo-acc-seul-400.png)](https://www.acceliance.fr)\n\n# Click to Call for Twenty, offered by Acceliance\n\n**Your sales team calls contacts from their Android phone in one click, straight from [Twenty CRM](https://twenty.com), and every call is logged automatically. Free, open source, self-hostable.**\n\n[![Maintained by Acceliance](https://img.shields.io/badge/maintained%20by-Acceliance-0097B6)](https://www.acceliance.fr)\n[![License MIT](https://img.shields.io/badge/license-MIT-success)](LICENSE)\n[![npm](https://img.shields.io/npm/v/@acceliance/twenty-click-to-call?logo=npm&label=npm)](https://www.npmjs.com/package/@acceliance/twenty-click-to-call)\n[![CI](https://github.com/acceliance/twenty-click-to-call/actions/workflows/ci.yml/badge.svg)](https://github.com/acceliance/twenty-click-to-call/actions/workflows/ci.yml)\n[![Twenty app](https://img.shields.io/badge/Twenty-2.59%2B-141414)](https://twenty.com)\n[![ntfy](https://img.shields.io/badge/push-ntfy-317F6F)](https://ntfy.sh)\n[![Android](https://img.shields.io/badge/phone-Android-3DDC84?logo=android&logoColor=white)](https://play.google.com/store/apps/details?id=io.heckel.ntfy)\n[![Languages](https://img.shields.io/badge/languages-EN%20%C2%B7%20FR-1F6FEB)](#languages)\n[![Self-hosted](https://img.shields.io/badge/data-stays%20on%20your%20servers-002395)](#requirements)\n\n> **Using Twenty for sales?** Acceliance built this app for its own team and **offers** it to the Twenty community.\n> Questions, feedback or a custom integration: **[contact@acceliance.fr](mailto:contact@acceliance.fr?subject=Twenty%20Click%20to%20Call)**.\n\n---\n\n## πŸš€ Why Click to Call?\n\nSalespeople live in the CRM but call from their mobile. Copying numbers by hand is slow, error-prone, and calls rarely\nget logged.\n\n| | Before | With Click to Call |\n|---|---|---|\n| πŸ“ž **Dialing** | Read the number on screen, type it on the phone | One click in Twenty, one tap on the phone |\n| βœ… **Accuracy** | Typos, wrong country code | Number normalized to international format (`+33…`) |\n| πŸ“ **Activity log** | Calls forgotten in the CRM | Every call logged as a done task on the contact, assigned to the caller |\n| πŸ—’οΈ **Call notes** | Written later, if ever | The task opens right away in the side panel, ready for notes |\n| πŸ” **Privacy** | Numbers in third-party apps | Push through **your own** ntfy server; nothing else leaves your infrastructure |\n| πŸ“± **Setup** | Custom mobile app to build and maintain | The free ntfy Android app, configured in two minutes |\n\n## ✨ What it does\n\n1. Click **Call** on a person in Twenty.\n2. Your phone gets a push notification with the contact's name, company and number.\n3. Tap it: the phone's dialer opens with the number ready. Press call.\n4. The call is logged as a **done task** on the contact, assigned to you, and opens in the side panel so you can take notes.\n\nNotifications go through [ntfy](https://ntfy.sh), an open-source push service you can self-host. No custom mobile app is needed: your team uses the free ntfy Android app.\n\n> Android never lets an app place a call silently: the dialer opens and the user presses call.\n\n## How it works\n\n```\nPerson ─[Call]─► front component ─POST /s/click-to-call/notify─► logic function\n reads the contact with the caller's permissions, builds +33…, publishes to ntfy topic <prefix><user>\n β–Ό\n ntfy server ─► ntfy Android app ─tap─► dialer (tel:+33…)\n```\n\nEach user receives notifications on their own topic: `<prefix>` + the part of their Twenty email before the `@`, made topic-safe. For `jane.doe@example.com` with the default prefix, that's `call-jane-doe`.\n\n## Requirements\n\n- Twenty 2.59 or later, with logic functions enabled on self-hosted servers (`LOGIC_FUNCTION_TYPE=LOCAL` or `LAMBDA`).\n- An ntfy server with access control. Self-hosting is strongly recommended: notifications contain contact names and phone numbers. A Docker setup takes a few minutes ([ntfy docs](https://docs.ntfy.sh/install/)).\n- Android phones with the [ntfy app](https://play.google.com/store/apps/details?id=io.heckel.ntfy).\n\n## Setup\n\n### 1. ntfy server\n\nRun ntfy with `auth-default-access: deny-all`, then create a publisher account and a token for Twenty:\n\n```bash\nntfy user add twenty\nntfy access twenty 'call-*' write-only\nntfy token add twenty # copy the tk_… token\n```\n\nFor each Twenty user (here `jane.doe@example.com`):\n\n```bash\nntfy user add jane-doe\nntfy access jane-doe call-jane-doe read-only\n```\n\n### 2. App settings in Twenty\n\nInstall the app, then open **Settings β†’ Apps β†’ Click to Call β†’ Variables**:\n\n| Variable | Required | Default | Description |\n| --- | --- | --- | --- |\n| `NTFY_URL` | yes | | Your ntfy server, e.g. `https://ntfy.example.com` |\n| `NTFY_TOKEN` | yes | | The publisher token (`tk_…`), stored as a secret |\n| `NTFY_TOPIC_PREFIX` | no | `call-` | Topic prefix for each user |\n| `CALL_TASK_TITLE` | no | `Call` | Title of the logged task (e.g. `Appel`). Empty = no task |\n\n### 3. Each phone\n\nIn the ntfy app: **Settings β†’ Manage users β†’ Add user** with your ntfy server and account, then **+** β†’ topic `call-jane-doe`, tick **Use another server**, enter your server URL and turn on **Instant delivery**.\n\nReload Twenty after installing or updating the app to see the button.\n\n## Permissions\n\nThe app reads the contact and the caller's workspace member, and creates the call task and its link to the contact. It never deletes records. Every action runs with the clicking user's own permissions on top of the app's role.\n\n## Languages\n\nEnglish and French (`locales/`). Contributions for other languages are welcome: run `twenty app translations extract --locale <locale>`.\n\n## Development\n\nRequires Node 24.5+ and Yarn 4 (on Windows, use WSL 2).\n\n```bash\nnpm install -g twenty\nyarn install\ntwenty auth login --url https://your-twenty.example.com\nyarn typecheck && yarn test:unit\ntwenty app apply --create # first install; then `twenty app dev` or `twenty app apply`\n```\n\nReleases are published to npm from GitHub Actions with provenance (`.github/workflows/publish.yml`): bump `version` in `package.json`, then push a `vX.Y.Z` tag.\n\n## License\n\n[MIT](LICENSE) Β© Acceliance\n\n---\n\n## πŸ† Built by Acceliance\n\nClick to Call is a small example of how **Acceliance** connects business tools with automation: a CRM button, a\nserverless function, a self-hosted push service and the phone's own dialer, assembled into one smooth workflow with\nno new mobile app to maintain.\n\n- **Twenty CRM apps**: buttons, logic functions, workflows, data models and integrations for your sales process;\n- **AI automation**: knowledge graphs, RAG, agents (MCP, A2A), governed AI and model-centric architectures;\n- **Sovereign deployments**: on-premise or on the host of your choice, GDPR and AI Act ready.\n\nWant the same approach for your own processes? **[Let's talk](mailto:contact@acceliance.fr?subject=Twenty%20%2F%20AI%20project)**.\nSee also our free AI candidate-matching platform, [CVMatcher](https://github.com/acceliance/CVMatcher-Deploy), and our\nprompt generator, [MasterPrompter](https://masterprompter.acceliance.fr).\n\n## 🀝 About Acceliance\n\n**Acceliance** designs AI and automation architectures and solutions: knowledge graphs, RAG, agents, business\nmodeling, AI governance and sovereign deployments.\n\nπŸ“§ [contact@acceliance.fr](mailto:contact@acceliance.fr) Β· 🌐 [www.acceliance.fr](https://www.acceliance.fr) Β·\nπŸ™ [github.com/acceliance](https://github.com/acceliance)\n\n**Your CRM knows who to call. Now your phone does too.**\n",
47
+ "aboutDescription": "[![Acceliance](https://www.acceliance.fr/media/wdxp1zys/logo-acc-seul-400.png)](https://www.acceliance.fr)\n\n# Click to Call for Twenty, offered by Acceliance\n\n**Your sales team calls contacts from their Android phone in one click, straight from [Twenty CRM](https://twenty.com), and every call is logged automatically. Free, open source, self-hostable.**\n\n[![Maintained by Acceliance](https://img.shields.io/badge/maintained%20by-Acceliance-0097B6)](https://www.acceliance.fr)\n[![License MIT](https://img.shields.io/badge/license-MIT-success)](LICENSE)\n[![npm](https://img.shields.io/npm/v/@acceliance/twenty-click-to-call?logo=npm&label=npm)](https://www.npmjs.com/package/@acceliance/twenty-click-to-call)\n[![CI](https://github.com/acceliance/twenty-click-to-call/actions/workflows/ci.yml/badge.svg)](https://github.com/acceliance/twenty-click-to-call/actions/workflows/ci.yml)\n[![Twenty app](https://img.shields.io/badge/Twenty-2.59%2B-141414)](https://twenty.com)\n[![ntfy](https://img.shields.io/badge/push-ntfy-317F6F)](https://ntfy.sh)\n[![Android](https://img.shields.io/badge/phone-Android-3DDC84?logo=android&logoColor=white)](https://play.google.com/store/apps/details?id=io.heckel.ntfy)\n[![Languages](https://img.shields.io/badge/languages-EN%20%C2%B7%20FR-1F6FEB)](#languages)\n[![Self-hosted](https://img.shields.io/badge/data-stays%20on%20your%20servers-002395)](#requirements)\n\n> **Using Twenty for sales?** Acceliance built this app for its own team and **offers** it to the Twenty community.\n> Questions, feedback or a custom integration: **[contact@acceliance.fr](mailto:contact@acceliance.fr?subject=Twenty%20Click%20to%20Call)**.\n\n---\n\n## πŸš€ Why Click to Call?\n\nSalespeople live in the CRM but call from their mobile. Copying numbers by hand is slow, error-prone, and calls rarely\nget logged.\n\n| | Before | With Click to Call |\n|---|---|---|\n| πŸ“ž **Dialing** | Read the number on screen, type it on the phone | One click in Twenty, one tap on the phone |\n| βœ… **Accuracy** | Typos, wrong country code | Number normalized to international format (`+33…`) |\n| πŸ“ **Activity log** | Calls forgotten in the CRM | Every call logged as a done task on the contact, assigned to the caller |\n| πŸ—’οΈ **Call notes** | Written later, if ever | The task opens right away in the side panel, ready for notes |\n| πŸ” **Privacy** | Numbers in third-party apps | Push through **your own** ntfy server; nothing else leaves your infrastructure |\n| πŸ“± **Setup** | Custom mobile app to build and maintain | The free ntfy Android app, configured in two minutes |\n\n## ✨ What it does\n\n1. Click **Call** on a person in Twenty.\n2. Your phone gets a push notification with the contact's name, company and number.\n3. Tap it: the phone's dialer opens with the number ready. Press call.\n4. The call is logged as a **done task** on the contact, assigned to you, and opens in the side panel so you can take notes.\n\nNotifications go through [ntfy](https://ntfy.sh), an open-source push service you can self-host. No custom mobile app is needed: your team uses the free ntfy Android app.\n\n> Android never lets an app place a call silently: the dialer opens and the user presses call.\n\n## πŸ“Έ Screenshots\n\n**1. One click on the contact.** The **Call** button (here in French, \"Appeler\") sits next to \"Send email\" on every person.\n\n![Call button on a contact](public/gallery/1-call-button.png)\n\n**2. The call is logged and opened.** While the phone rings the dialer, Twenty creates a done task, assigned to you and linked to the contact, and opens it for your notes.\n\n![Logged call task opened in the side panel](public/gallery/2-call-logged-task.png)\n\n**3. Every call stays in the contact's history.**\n\n![Call tasks on the contact](public/gallery/3-tasks-tab.png)\n\n*Screenshots use a fictional contact.*\n\n## How it works\n\n```\nPerson ─[Call]─► front component ─POST /s/click-to-call/notify─► logic function\n reads the contact with the caller's permissions, builds +33…, publishes to ntfy topic <prefix><user>\n β–Ό\n ntfy server ─► ntfy Android app ─tap─► dialer (tel:+33…)\n```\n\nEach user receives notifications on their own topic: `<prefix>` + the part of their Twenty email before the `@`, made topic-safe. For `jane.doe@example.com` with the default prefix, that's `call-jane-doe`.\n\n## Requirements\n\n- Twenty 2.59 or later, with logic functions enabled on self-hosted servers (`LOGIC_FUNCTION_TYPE=LOCAL` or `LAMBDA`).\n- An ntfy server with access control. Self-hosting is strongly recommended: notifications contain contact names and phone numbers. A Docker setup takes a few minutes ([ntfy docs](https://docs.ntfy.sh/install/)).\n- Android phones with the [ntfy app](https://play.google.com/store/apps/details?id=io.heckel.ntfy).\n\n## Setup\n\n### 1. ntfy server\n\nRun ntfy with `auth-default-access: deny-all`, then create a publisher account and a token for Twenty:\n\n```bash\nntfy user add twenty\nntfy access twenty 'call-*' write-only\nntfy token add twenty # copy the tk_… token\n```\n\nFor each Twenty user (here `jane.doe@example.com`):\n\n```bash\nntfy user add jane-doe\nntfy access jane-doe call-jane-doe read-only\n```\n\n### 2. App settings in Twenty\n\nInstall the app, then open **Settings β†’ Apps β†’ Click to Call β†’ Variables**:\n\n| Variable | Required | Default | Description |\n| --- | --- | --- | --- |\n| `NTFY_URL` | yes | | Your ntfy server, e.g. `https://ntfy.example.com` |\n| `NTFY_TOKEN` | yes | | The publisher token (`tk_…`), stored as a secret |\n| `NTFY_TOPIC_PREFIX` | no | `call-` | Topic prefix for each user |\n| `CALL_TASK_TITLE` | no | `Call` | Title of the logged task (e.g. `Appel`). Empty = no task |\n\n### 3. Each phone\n\nIn the ntfy app: **Settings β†’ Manage users β†’ Add user** with your ntfy server and account, then **+** β†’ topic `call-jane-doe`, tick **Use another server**, enter your server URL and turn on **Instant delivery**.\n\nReload Twenty after installing or updating the app to see the button.\n\n## Permissions\n\nThe app reads the contact and the caller's workspace member, and creates the call task and its link to the contact. It never deletes records. Every action runs with the clicking user's own permissions on top of the app's role.\n\n## Languages\n\nEnglish and French (`locales/`). Contributions for other languages are welcome: run `twenty app translations extract --locale <locale>`.\n\n## Development\n\nRequires Node 24.5+ and Yarn 4 (on Windows, use WSL 2).\n\n```bash\nnpm install -g twenty\nyarn install\ntwenty auth login --url https://your-twenty.example.com\nyarn typecheck && yarn test:unit\ntwenty app apply --create # first install; then `twenty app dev` or `twenty app apply`\n```\n\nReleases are published to npm from GitHub Actions with provenance (`.github/workflows/publish.yml`): bump `version` in `package.json`, then push a `vX.Y.Z` tag.\n\n## License\n\n[MIT](LICENSE) Β© Acceliance\n\n---\n\n## πŸ† Built by Acceliance\n\nClick to Call is a small example of how **Acceliance** connects business tools with automation: a CRM button, a\nserverless function, a self-hosted push service and the phone's own dialer, assembled into one smooth workflow with\nno new mobile app to maintain.\n\n- **Twenty CRM apps**: buttons, logic functions, workflows, data models and integrations for your sales process;\n- **AI automation**: knowledge graphs, RAG, agents (MCP, A2A), governed AI and model-centric architectures;\n- **Sovereign deployments**: on-premise or on the host of your choice, GDPR and AI Act ready.\n\nWant the same approach for your own processes? **[Let's talk](mailto:contact@acceliance.fr?subject=Twenty%20%2F%20AI%20project)**.\nSee also our free AI candidate-matching platform, [CVMatcher](https://github.com/acceliance/CVMatcher-Deploy), and our\nprompt generator, [MasterPrompter](https://masterprompter.acceliance.fr).\n\n## 🀝 About Acceliance\n\n**Acceliance** designs AI and automation architectures and solutions: knowledge graphs, RAG, agents, business\nmodeling, AI governance and sovereign deployments.\n\nπŸ“§ [contact@acceliance.fr](mailto:contact@acceliance.fr) Β· 🌐 [www.acceliance.fr](https://www.acceliance.fr) Β·\nπŸ™ [github.com/acceliance](https://github.com/acceliance)\n\n**Your CRM knows who to call. Now your phone does too.**\n",
44
48
  "yarnLockChecksum": "6c6b4084f1cf241045004a78ef14fe02",
45
- "packageJsonChecksum": "81410bfdf4914c90a4e0e6900769b602",
49
+ "packageJsonChecksum": "7f1e5de6d8aead73cc416815ca9ae643",
46
50
  "requiredServerVersionRange": ">=2.59.0",
47
51
  "healthCheckLogicFunction": {
48
52
  "universalIdentifier": "3c507fcc-391c-4e5d-b294-aef81dfd84de"
@@ -134,6 +138,24 @@
134
138
  }
135
139
  ],
136
140
  "publicAssets": [
141
+ {
142
+ "filePath": "public/gallery/1-call-button.png",
143
+ "fileName": "1-call-button.png",
144
+ "fileType": "png",
145
+ "checksum": "54696e88707c8307ad0a7b6315145888"
146
+ },
147
+ {
148
+ "filePath": "public/gallery/2-call-logged-task.png",
149
+ "fileName": "2-call-logged-task.png",
150
+ "fileType": "png",
151
+ "checksum": "d855cc57506c1aa0f840ccf60d3447ff"
152
+ },
153
+ {
154
+ "filePath": "public/gallery/3-tasks-tab.png",
155
+ "fileName": "3-tasks-tab.png",
156
+ "fileType": "png",
157
+ "checksum": "ac197dbe382c04881a6cc12745982d71"
158
+ },
137
159
  {
138
160
  "filePath": "public/logo.svg",
139
161
  "fileName": "logo.svg",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@acceliance/twenty-click-to-call",
3
- "version": "0.1.1",
3
+ "version": "0.1.2",
4
4
  "description": "Twenty CRM app: call a contact from your Android phone in one click (ntfy push opens the dialer) and log the call as a task.",
5
5
  "license": "MIT",
6
6
  "author": "Acceliance",
Binary file
Binary file