@acceliance/twenty-click-to-call 0.0.0-stage → 0.1.1

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/manifest.json ADDED
@@ -0,0 +1,209 @@
1
+ {
2
+ "application": {
3
+ "universalIdentifier": "911f3bf1-e2a2-4725-ba51-3e4f8bddd7d4",
4
+ "displayName": "Click to Call",
5
+ "description": "Call a contact from your Android phone in one click: a push notification opens the phone's dialer with the number, and the call is logged as a task.",
6
+ "author": "Acceliance",
7
+ "emailSupport": "contact@acceliance.fr",
8
+ "logo": "public/logo.svg",
9
+ "websiteUrl": "https://github.com/acceliance/twenty-click-to-call",
10
+ "issueReportUrl": "https://github.com/acceliance/twenty-click-to-call/issues",
11
+ "applicationVariables": {
12
+ "NTFY_URL": {
13
+ "universalIdentifier": "fb766589-4e65-4044-aaf3-3b6a26ca625d",
14
+ "label": "ntfy server URL",
15
+ "description": "Base URL of your ntfy server, without trailing slash (e.g. https://ntfy.example.com). Self-hosting is recommended: notifications contain contact names and phone numbers.",
16
+ "isSecret": false,
17
+ "isRequired": true
18
+ },
19
+ "NTFY_TOKEN": {
20
+ "universalIdentifier": "e73bb165-5c61-4b41-84fc-0c316d224ba3",
21
+ "label": "ntfy access token",
22
+ "description": "Access token (tk_…) of an ntfy account allowed to publish to <topic prefix>*.",
23
+ "isSecret": true,
24
+ "isRequired": true
25
+ },
26
+ "NTFY_TOPIC_PREFIX": {
27
+ "universalIdentifier": "d07550a5-4a1e-4a06-99e0-7be0a53cd109",
28
+ "label": "ntfy topic prefix",
29
+ "description": "Each user's notifications go to <prefix><email local part>, e.g. jane.doe@example.com -> call-jane-doe. The phone subscribes to that topic.",
30
+ "value": "call-",
31
+ "isSecret": false
32
+ },
33
+ "CALL_TASK_TITLE": {
34
+ "universalIdentifier": "9ef4c8e7-8f39-4e2f-ba54-417ce0a7fe28",
35
+ "label": "Call task title",
36
+ "description": "Title of the done task logged on the contact for each call (e.g. \"Appel\" in French). Leave empty to log no task.",
37
+ "value": "Call",
38
+ "isSecret": false
39
+ }
40
+ },
41
+ "galleryImages": [],
42
+ "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",
44
+ "yarnLockChecksum": "6c6b4084f1cf241045004a78ef14fe02",
45
+ "packageJsonChecksum": "81410bfdf4914c90a4e0e6900769b602",
46
+ "requiredServerVersionRange": ">=2.59.0",
47
+ "healthCheckLogicFunction": {
48
+ "universalIdentifier": "3c507fcc-391c-4e5d-b294-aef81dfd84de"
49
+ }
50
+ },
51
+ "objects": [],
52
+ "fields": [],
53
+ "indexes": [],
54
+ "permissionFlags": [],
55
+ "roles": [
56
+ {
57
+ "universalIdentifier": "8730c5aa-9120-4ee6-b6bf-87120a1b12e6",
58
+ "label": "Click to Call default function role",
59
+ "description": "Click to Call default function role",
60
+ "recordsPermissions": {
61
+ "canReadAllRecords": true,
62
+ "canCreateAllRecords": false,
63
+ "canUpdateAllRecords": false,
64
+ "canSoftDeleteAllRecords": false,
65
+ "canDestroyAllRecords": false,
66
+ "objects": [
67
+ {
68
+ "objectUniversalIdentifier": "20202020-1ba1-48ba-bc83-ef7e5990ed10",
69
+ "canReadAllRecords": true,
70
+ "canCreateAllRecords": true,
71
+ "canUpdateAllRecords": true,
72
+ "canSoftDeleteAllRecords": false,
73
+ "canDestroyAllRecords": false,
74
+ "universalIdentifier": "4de8c649-9c17-5f09-83dd-017754bfe29b"
75
+ },
76
+ {
77
+ "objectUniversalIdentifier": "20202020-5a9a-44e8-95df-771cd06d0fb1",
78
+ "canReadAllRecords": true,
79
+ "canCreateAllRecords": true,
80
+ "canUpdateAllRecords": true,
81
+ "canSoftDeleteAllRecords": false,
82
+ "canDestroyAllRecords": false,
83
+ "universalIdentifier": "f829e17e-4b45-5f86-8167-78b4ebdd6925"
84
+ }
85
+ ]
86
+ },
87
+ "canBeAssignedToUsers": false,
88
+ "canBeAssignedToApiKeys": false,
89
+ "permissionFlagUniversalIdentifiers": []
90
+ }
91
+ ],
92
+ "skills": [],
93
+ "agents": [],
94
+ "workflows": [],
95
+ "connectionProviders": [],
96
+ "messagingProviders": [],
97
+ "mcpServers": [],
98
+ "logicFunctions": [
99
+ {
100
+ "universalIdentifier": "3c507fcc-391c-4e5d-b294-aef81dfd84de",
101
+ "name": "health-check",
102
+ "handlerName": "default.config.handler",
103
+ "sourceHandlerPath": "src/logic-functions/health-check.ts",
104
+ "builtHandlerPath": "src/logic-functions/health-check.mjs",
105
+ "builtHandlerChecksum": "4f013cd49b7dbdf95eb54139c62f591e"
106
+ },
107
+ {
108
+ "universalIdentifier": "cadd059b-5eea-4c90-b3b2-7919c9b84535",
109
+ "name": "send-call-notification",
110
+ "description": "Sends a push (ntfy) to the clicking user's phone (tap opens the dialer) and logs a done call task on the contact.",
111
+ "timeoutSeconds": 15,
112
+ "httpRouteTriggerSettings": {
113
+ "path": "/click-to-call/notify",
114
+ "httpMethod": "POST",
115
+ "isAuthRequired": true
116
+ },
117
+ "handlerName": "default.config.handler",
118
+ "sourceHandlerPath": "src/logic-functions/send-call-notification.ts",
119
+ "builtHandlerPath": "src/logic-functions/send-call-notification.mjs",
120
+ "builtHandlerChecksum": "e625a168afb9f34b35af247efc42962b"
121
+ }
122
+ ],
123
+ "frontComponents": [
124
+ {
125
+ "universalIdentifier": "6416339b-a860-4a07-8765-74d8d3002408",
126
+ "name": "call-on-mobile",
127
+ "description": "Sends the selected contact's number to the user's phone as a push notification",
128
+ "isHeadless": true,
129
+ "componentName": "CallOnMobile",
130
+ "sourceComponentPath": "src/front-components/call-on-mobile.tsx",
131
+ "builtComponentPath": "src/front-components/call-on-mobile.mjs",
132
+ "builtComponentChecksum": "e612f0d93bf7a740ef1a39673fbd91199baf7997519ca3768be90d6f25f52baf",
133
+ "usesSdkClient": true
134
+ }
135
+ ],
136
+ "publicAssets": [
137
+ {
138
+ "filePath": "public/logo.svg",
139
+ "fileName": "logo.svg",
140
+ "fileType": "svg",
141
+ "checksum": "04105e1c3a3a65e106c76daac3762a28"
142
+ }
143
+ ],
144
+ "views": [],
145
+ "viewFields": [],
146
+ "navigationMenuItems": [],
147
+ "pageLayouts": [],
148
+ "pageLayoutTabs": [],
149
+ "pageLayoutWidgets": [],
150
+ "commandMenuItems": [
151
+ {
152
+ "universalIdentifier": "cee7e741-e05e-4cbf-a2c0-d8616703fa6a",
153
+ "label": "Call on mobile",
154
+ "shortLabel": "Call",
155
+ "isPinned": true,
156
+ "availabilityType": "RECORD_SELECTION",
157
+ "availabilityObjectUniversalIdentifier": "20202020-e674-48e5-a542-72570eee7213",
158
+ "frontComponentUniversalIdentifier": "6416339b-a860-4a07-8765-74d8d3002408"
159
+ }
160
+ ],
161
+ "timelineActivityTypes": [],
162
+ "settingsMenuItems": [],
163
+ "validationRules": [],
164
+ "relatedRecordPaths": [],
165
+ "sourceFiles": [
166
+ {
167
+ "filePath": "src/constants/universal-identifiers.ts",
168
+ "checksum": "611cce30ab85a7ba0c4c6749296e5469"
169
+ },
170
+ {
171
+ "filePath": "src/front-components/call-on-mobile.tsx",
172
+ "checksum": "5150cdb4d9903b5ad8cf8ffbc509fe05"
173
+ },
174
+ {
175
+ "filePath": "src/logic-functions/health-check.ts",
176
+ "checksum": "76226e2e68f38a18fc1bad7c17c1faf9"
177
+ },
178
+ {
179
+ "filePath": "src/logic-functions/send-call-notification.ts",
180
+ "checksum": "99cee4749976a409e89268a23d4fe73b"
181
+ },
182
+ {
183
+ "filePath": "src/types/notify-result.ts",
184
+ "checksum": "078bed37935fdebd305c615c6dc9b653"
185
+ },
186
+ {
187
+ "filePath": "src/utils/build-tel-uri.ts",
188
+ "checksum": "5042d3bb640ae37eb0c6e5afedb1658e"
189
+ },
190
+ {
191
+ "filePath": "src/utils/topic-for-member.ts",
192
+ "checksum": "c9f4b0633816d195bc16378599c2a345"
193
+ },
194
+ {
195
+ "filePath": "tsconfig.json",
196
+ "checksum": "8d3ba534b75f4ad2c989f966877f5973"
197
+ }
198
+ ],
199
+ "translations": {
200
+ "fr-FR": {
201
+ "g3SduJ": "Tâche d'appel non créée : {reason}",
202
+ "QLIp/t": "Notification non envoyée : {reason}",
203
+ "JIhaae": "Notification envoyée sur votre téléphone : {name}",
204
+ "y0FEyr": "Sélectionnez un seul contact.",
205
+ "eSc6Ek": "Appeler sur mobile",
206
+ "v7izz9": "Appeler"
207
+ }
208
+ }
209
+ }
package/package.json CHANGED
@@ -1,6 +1,54 @@
1
1
  {
2
2
  "name": "@acceliance/twenty-click-to-call",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "0.1.1",
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
+ "license": "MIT",
6
+ "author": "Acceliance",
7
+ "homepage": "https://github.com/acceliance/twenty-click-to-call#readme",
8
+ "repository": {
9
+ "type": "git",
10
+ "url": "git+https://github.com/acceliance/twenty-click-to-call.git"
11
+ },
12
+ "bugs": {
13
+ "url": "https://github.com/acceliance/twenty-click-to-call/issues"
14
+ },
15
+ "keywords": [
16
+ "twenty-app",
17
+ "twenty",
18
+ "twenty-crm",
19
+ "click-to-call",
20
+ "ntfy",
21
+ "android",
22
+ "telephony"
23
+ ],
24
+ "engines": {
25
+ "node": "^24.5.0 || ^26.5.1",
26
+ "npm": "please-use-yarn",
27
+ "yarn": ">=4.0.2",
28
+ "twenty": ">=2.59.0"
29
+ },
30
+ "packageManager": "yarn@4.18.1",
31
+ "scripts": {
32
+ "twenty": "twenty",
33
+ "lint": "oxlint -c .oxlintrc.json .",
34
+ "lint:fix": "oxlint --fix -c .oxlintrc.json .",
35
+ "typecheck": "tsgo --noEmit -p tsconfig.spec.json",
36
+ "test": "vitest run",
37
+ "test:watch": "vitest",
38
+ "test:unit": "vitest run --config vitest.unit.config.ts"
39
+ },
40
+ "devDependencies": {
41
+ "@types/node": "^24.7.2",
42
+ "@types/react": "^19.0.0",
43
+ "@typescript/native-preview": "^7.0.0-dev.20260116.1",
44
+ "oxlint": "^0.16.0",
45
+ "react": "^19.0.0",
46
+ "react-dom": "^19.0.0",
47
+ "twenty-client-sdk": "2.59.0",
48
+ "twenty-sdk": "2.59.0",
49
+ "twenty-ui": "2.59.0",
50
+ "typescript": "^5.9.3",
51
+ "vite-tsconfig-paths": "^4.2.1",
52
+ "vitest": "^4.1.12"
53
+ }
54
+ }
@@ -0,0 +1,5 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 80 80" fill="none">
2
+ <rect width="80" height="80" rx="16" fill="#1F7A4D"/>
3
+ <path d="M30.6 21.5c-1-1-2.6-1.1-3.7-.2l-4.3 3.4c-1.6 1.3-2.3 3.4-1.7 5.4 3.6 12 13 21.4 25 25 2 .6 4.1-.1 5.4-1.7l3.4-4.3c.9-1.1.8-2.7-.2-3.7l-5.6-5.6c-1-1-2.6-1.1-3.7-.2l-3.2 2.6c-4.6-2.3-8.3-6-10.6-10.6l2.6-3.2c.9-1.1.8-2.7-.2-3.7l-5.6-5.6z" fill="#FAFAFA"/>
4
+ <path d="M47 20a13 13 0 0 1 13 13M47 27a6 6 0 0 1 6 6" stroke="#FAFAFA" stroke-width="3.5" stroke-linecap="round"/>
5
+ </svg>
@@ -0,0 +1,24 @@
1
+ export const APP_DISPLAY_NAME = 'Click to Call';
2
+ export const APP_DESCRIPTION =
3
+ "Call a contact from your Android phone in one click: a push notification opens the phone's dialer with the number, and the call is logged as a task.";
4
+
5
+ export const APPLICATION_UNIVERSAL_IDENTIFIER = '911f3bf1-e2a2-4725-ba51-3e4f8bddd7d4';
6
+ export const DEFAULT_ROLE_UNIVERSAL_IDENTIFIER = '8730c5aa-9120-4ee6-b6bf-87120a1b12e6';
7
+ export const HEALTH_CHECK_UNIVERSAL_IDENTIFIER = '3c507fcc-391c-4e5d-b294-aef81dfd84de';
8
+
9
+ export const SEND_CALL_NOTIFICATION_LOGIC_FUNCTION_UNIVERSAL_IDENTIFIER =
10
+ 'cadd059b-5eea-4c90-b3b2-7919c9b84535';
11
+ export const CALL_ON_MOBILE_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER =
12
+ '6416339b-a860-4a07-8765-74d8d3002408';
13
+ export const CALL_ON_MOBILE_COMMAND_MENU_ITEM_UNIVERSAL_IDENTIFIER =
14
+ 'cee7e741-e05e-4cbf-a2c0-d8616703fa6a';
15
+
16
+ export const NTFY_URL_VARIABLE_UNIVERSAL_IDENTIFIER = 'fb766589-4e65-4044-aaf3-3b6a26ca625d';
17
+ export const NTFY_TOKEN_VARIABLE_UNIVERSAL_IDENTIFIER = 'e73bb165-5c61-4b41-84fc-0c316d224ba3';
18
+ export const NTFY_TOPIC_PREFIX_VARIABLE_UNIVERSAL_IDENTIFIER =
19
+ 'd07550a5-4a1e-4a06-99e0-7be0a53cd109';
20
+ export const CALL_TASK_TITLE_VARIABLE_UNIVERSAL_IDENTIFIER =
21
+ '9ef4c8e7-8f39-4e2f-ba54-417ce0a7fe28';
22
+
23
+ // Route served under /s (the front component calls '/s' + this path)
24
+ export const SEND_CALL_NOTIFICATION_ROUTE_PATH = '/click-to-call/notify';