{"_id":"@cardtunic/n8n-nodes-whatsapp-cloud-api","name":"@cardtunic/n8n-nodes-whatsapp-cloud-api","dist-tags":{"latest":"0.2.0"},"versions":{"0.2.0":{"name":"@cardtunic/n8n-nodes-whatsapp-cloud-api","version":"0.2.0","description":"n8n community node for sending messages and uploading media with the WhatsApp Cloud API","license":"MIT","packageManager":"pnpm@11.7.0","homepage":"https://github.com/cardtunic/n8n-nodes-whatsapp-cloud-api#readme","repository":{"type":"git","url":"git+https://github.com/cardtunic/n8n-nodes-whatsapp-cloud-api.git"},"bugs":{"url":"https://github.com/cardtunic/n8n-nodes-whatsapp-cloud-api/issues"},"keywords":["n8n-community-node-package","n8n","whatsapp","whatsapp-cloud-api"],"author":{"name":"kaleb","email":"kaleb@sindcomercioto.com.br"},"scripts":{"build":"n8n-node build","build:watch":"tsc --watch","dev":"n8n-node dev","lint":"n8n-node lint","lint:fix":"n8n-node lint --fix","test":"pnpm build && node --test tests/*.test.cjs","release":"n8n-node release","prepublishOnly":"n8n-node prerelease"},"publishConfig":{"access":"public"},"n8n":{"n8nNodesApiVersion":1,"strict":true,"credentials":["dist/credentials/WhatsAppCloudApi.credentials.js"],"nodes":["dist/nodes/WhatsAppCloudApi/WhatsAppCloudApi.node.js"]},"devDependencies":{"@n8n/node-cli":"*","eslint":"9.32.0","prettier":"3.6.2","release-it":"^19.0.4","typescript":"5.9.2"},"peerDependencies":{"n8n-workflow":"*"},"gitHead":"af6efbc4f44d67d4819ab364622472f3330fd8f4","_id":"@cardtunic/n8n-nodes-whatsapp-cloud-api@0.2.0","_nodeVersion":"24.17.0","_npmVersion":"11.13.0","dist":{"integrity":"sha512-5YZ7x9WHwV8VfeNBkWZk0/YFw0GeMwlE6VDSAjmFoPuO7mHXjOznYxl2aJ39CxIjS2L5NUmzPbZpFpIVhFAX/A==","shasum":"84325800e8f2fb1c37d392f20e745bfb7068d5b1","tarball":"https://registry.npmjs.org/@cardtunic/n8n-nodes-whatsapp-cloud-api/-/n8n-nodes-whatsapp-cloud-api-0.2.0.tgz","fileCount":36,"unpackedSize":153152,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIHxvJNHsp215SHfAi4fa5zTJGRN61PcuQ/DNUX7pXax0AiEA6Fr+gzfg/ILGyQitOgNoEsppaq4sP2+3JHr3u7MZuZw="}]},"_npmUser":{"name":"cinutdrac","email":"cardtunic@gmail.com"},"directories":{},"maintainers":[{"name":"cinutdrac","email":"cardtunic@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/n8n-nodes-whatsapp-cloud-api_0.2.0_1787256249842_0.052184274586498436"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-20T20:04:09.608Z","0.2.0":"2026-08-20T20:04:10.027Z","modified":"2026-08-20T20:04:10.317Z"},"maintainers":[{"name":"cinutdrac","email":"cardtunic@gmail.com"}],"description":"n8n community node for sending messages and uploading media with the WhatsApp Cloud API","homepage":"https://github.com/cardtunic/n8n-nodes-whatsapp-cloud-api#readme","keywords":["n8n-community-node-package","n8n","whatsapp","whatsapp-cloud-api"],"repository":{"type":"git","url":"git+https://github.com/cardtunic/n8n-nodes-whatsapp-cloud-api.git"},"author":{"name":"kaleb","email":"kaleb@sindcomercioto.com.br"},"bugs":{"url":"https://github.com/cardtunic/n8n-nodes-whatsapp-cloud-api/issues"},"license":"MIT","readme":"# @cardtunic/n8n-nodes-whatsapp-cloud-api\n\nThis is an n8n community node for sending messages with the WhatsApp Cloud API.\n\n[n8n](https://n8n.io/) is a workflow automation platform.\n\n## Installation\n\nFollow the [community node installation guide](https://docs.n8n.io/integrations/community-nodes/installation/).\n\nInstall this package by name:\n\n```text\n@cardtunic/n8n-nodes-whatsapp-cloud-api\n```\n\n## Operations\n\n### Message\n\n- Send structured text, media, location, contact, reaction, template, and interactive messages\n- Mark an incoming message as read\n- Mark an incoming message as read and display a typing indicator\n\nThe node uses the WhatsApp Cloud API `/messages` endpoint. Marketing-message and encrypted-message endpoints are not included.\n\n### Media\n\n- Upload an n8n binary file through the WhatsApp Media API\n- Return the uploaded media ID for reuse in later message operations\n\n## Credentials\n\nThe credential requires these values from your Meta app's WhatsApp API setup page:\n\n- **Access Token**: A token with `whatsapp_business_messaging` permission for sending and `whatsapp_business_management` permission for template discovery.\n- **WhatsApp Business Phone Number ID**: The ID of the sender phone number, not the displayed phone number.\n- **WhatsApp Business Account ID**: The WABA ID containing the approved message templates.\n\nSee Meta's [Cloud API setup guide](https://developers.facebook.com/docs/whatsapp/cloud-api/get-started#set-up-developer-assets) for instructions.\n\n## Usage\n\nAdd the **WhatsApp Cloud API** node to a workflow and select **Message > Send Message**. Choose a message type and configure the fields shown for that type.\n\nThe structured sender supports:\n\n- Text messages with optional URL previews\n- Audio, document, image, sticker, and video messages by n8n binary file, uploaded media ID, or public URL\n- Location, reaction, and contact messages\n- Templates with header, body, and button components\n- Reply buttons, lists, catalog messages, products, product lists, Flows, call-permission requests, order details, and order-status interactive messages\n- Replies using an optional source message WAMID\n\n### Attachments\n\nFor automatic attachment upload, connect a node that outputs binary data, select an audio, document, image, sticker, or video message, and choose **Binary File** as the media source. Set **Input Binary Field** to the binary property name, typically `data`.\n\nThe node uploads the file to `/media`, inserts the returned media ID into the message, and then sends the message through `/messages`. The output is the final message response. If upload succeeds but sending fails, the uploaded media remains in WhatsApp storage.\n\nUse **Media > Upload** when you want the media ID explicitly or intend to reuse one upload in multiple messages. The operation returns:\n\n```json\n{\n\t\"id\": \"WHATSAPP_MEDIA_ID\"\n}\n```\n\nThe filename and MIME type are read from n8n's binary metadata. Both can be overridden when the metadata is missing or incorrect. Automatic binary upload currently applies to top-level attachments; template media parameters and interactive headers continue to use media IDs or URLs.\n\nWhen **Template** is selected, the node loads approved templates from the configured WhatsApp Business Account. After choosing a template, the language dropdown shows its approved language variants. Expressions can still supply a template name or language code directly.\n\nRecipient numbers must include the country code without spaces or a leading `+`, for example `15551234567`.\n\nFree-form messages can only be sent during the 24-hour customer service window after the recipient contacts your business. Use an approved message template to initiate or resume a conversation outside that window.\n\nMeta permits at most 10 rows across all sections in one list message. Row IDs must be unique because WhatsApp returns the selected row ID in the recipient's reply webhook.\n\nUse **Mark Message as Read** with an incoming message WAMID to send a read receipt. **Mark Read and Show Typing** sends the same receipt together with a text typing indicator. Delivery status is generated by WhatsApp and must be observed through webhooks; it cannot be set through the `/messages` endpoint.\n\n## Compatibility\n\nThis package targets WhatsApp Cloud API `v26.0` and n8n `1.60.0` or later.\n\n## Resources\n\n- [WhatsApp Cloud API documentation](https://developers.facebook.com/docs/whatsapp/cloud-api/)\n- [Interactive message documentation](https://developers.facebook.com/docs/whatsapp/cloud-api/guides/send-messages#interactive-messages)\n- [n8n community node documentation](https://docs.n8n.io/integrations/community-nodes/)\n","readmeFilename":"README.md","_rev":"1-55fd85741357e3340aa40a94b31bb97a"}