@messagebird/n8n-nodes-bird 0.2.0 → 0.3.0

package/README.md

@@ -46,6 +46,16 @@ The **Bird** node covers the public Bird API: email and SMS sends, delivery stat
 
 The **Bird Trigger** node starts a workflow when Bird delivers a subscribed event (an email delivered, a bounce, an inbound SMS, and 50 more). It registers the webhook automatically with your API key, verifies every delivery as a [Standard Webhook](https://www.standardwebhooks.com) before the workflow runs, and deduplicates redelivered events. One Bird webhook is created per workflow; workspace webhook quotas apply.
 
+## Examples
+
+[`examples/`](examples/) carries ready-to-import workflows, each with its setup notes on the canvas:
+
+- **[Contact form → welcome email](examples/01-contact-form-welcome-email.json)** — an n8n form captures a sign-up and Bird sends the welcome email.
+- **[Order shipped → SMS from a stored template](examples/02-order-shipped-sms-template.json)** — a webhook triggers an SMS whose copy and translations live in Bird, not the workflow.
+- **[Bounce & complaint handler](examples/03-bounce-complaint-handler.json)** — Bird Trigger suppresses the address and notifies the team.
+
+Import one with **Workflows → New Workflow → More options (⋮) → Import from File**. [`examples/README.md`](examples/README.md) lists the operations and the API-key scopes each needs.
+
 ## Credentials
 
 Create an API key in the Bird dashboard under **API keys**, near the bottom of the sidebar, and paste it into the **Bird API** credential. The key is all the node needs — nothing else to configure. The credential's help text lists the scopes the key needs; the credential test verifies the key against your workspace.

package/dist/nodes/Bird/generated/properties.gen.js

@@ -4946,6 +4946,13 @@ exports.birdProperties = [
                         default: [],
                         description: "Reorder or narrow the delivery channels for this request. List channel names in the order to try them; a channel you omit is not used for this request, and a channel not already enabled for the recipient is ignored. A list that leaves no usable channel fails the request with `422`. Omit the field to use the configured order.",
                     },
+                    {
+                        displayName: "Language",
+                        name: "language",
+                        type: "string",
+                        default: "",
+                        description: "Which of the built-in message translations to send. SMS is translated; every other channel sends English whatever you set here. A tag with no translation of its own falls back to its base language, then to English. The tag is fixed for the verification, so a resend arrives in the same language as the first message. Omit to send in English.",
+                    },
                 ],
             },
             {
@@ -8014,7 +8021,7 @@ exports.birdProperties = [
                     { name: "1y", value: "1y" },
                 ],
                 default: "",
-                description: "How long the mailbox remembers message metadata, extracted text, and attachments. Message bodies and raw MIME stay available for 30 days regardless of tier. Tiers longer than 30 days require a plan that includes them. Lowering the tier deletes remembered messages older than the new horizon, and requires `confirm=true` when that would happen.",
+                description: "How long the mailbox remembers message metadata, extracted text, and attachments. Message bodies and raw MIME stay available for 30 days regardless of tier. Tiers longer than 30 days require a plan that includes them. Lowering the tier immediately hides remembered messages older than the new horizon. Deletion waits at least ten minutes and until the background retention update has processed every stored message. The update starts every ten minutes and can take hours for large mailboxes; the next hourly purge deletes eligible messages. A lowering that would affect messages requires `confirm=true`.",
             },
         ],
     },
@@ -8209,7 +8216,7 @@ exports.birdProperties = [
                 typeOptions: { multipleValues: true },
                 placeholder: "Add Attachment",
                 default: {},
-                description: "File attachments. The send is rejected when the estimated generated message size exceeds 20 MB (bodies plus all attachments after base64 encoding). Keep total raw attachment content at or below 15 MB for reliable headroom. Attachment metadata stays on the message's `attachment_manifest`, and the bytes are downloadable for 30 days.",
+                description: "File attachments. The send is rejected when the estimated generated message size exceeds 20 MB (bodies plus all attachments after base64 encoding). Keep total raw attachment content at or below 15 MB for reliable headroom. Attachment metadata stays on the message's `attachment_manifest`, and the bytes are downloadable for the mailbox's retention tier.",
                 options: [
                     {
                         displayName: "Attachment",
@@ -8992,7 +8999,7 @@ exports.birdProperties = [
                 typeOptions: { multipleValues: true },
                 placeholder: "Add Attachment",
                 default: {},
-                description: "File attachments to include with the reply. The send is rejected when the estimated generated message size exceeds 20 MB (bodies plus all attachments after base64 encoding). Keep total raw attachment content at or below 15 MB for reliable headroom. Attachment metadata stays on the message's `attachment_manifest`, and the bytes are downloadable for 30 days.",
+                description: "File attachments to include with the reply. The send is rejected when the estimated generated message size exceeds 20 MB (bodies plus all attachments after base64 encoding). Keep total raw attachment content at or below 15 MB for reliable headroom. Attachment metadata stays on the message's `attachment_manifest`, and the bytes are downloadable for the mailbox's retention tier.",
                 options: [
                     {
                         displayName: "Attachment",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@messagebird/n8n-nodes-bird",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "The official Bird node for n8n: email, SMS, WhatsApp, and verification, plus a webhook trigger for Bird events.",
   "license": "MIT",
   "author": {