@messagebird/n8n-nodes-bird 0.9.1 → 0.10.0

package/README.md

@@ -41,7 +41,7 @@ The **Bird** node covers the public Bird API: email and SMS sends, delivery stat
 - **SMS Template** (2) — Get, List
 - **Suppression** (4) — Add, Get, List, Remove
 - **Verify** (3) — Create Next Channel Attempt, Create Verification, Create Verification Check
-- **Voice** (2) — Get, List
+- **Voice** (2) — Get Leg, List Legs
 - **Webhook** (9) — Attempts, Create, Delete, Get, List, Replay, Rotate Secret, Test, Update
 - **WhatsApp** (4) — Get, List, List Events, Send
 - **Workspace** (1) — Get

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

@@ -22,7 +22,7 @@ exports.birdPickers = {
     smsSuppressionsList: { route: "sms_suppressions:list", fields: ["destination"], search: "", pathFrom: [] },
     suppressionList: { route: "suppression:list", fields: ["email"], search: "email", pathFrom: [] },
     emailThreadsList: { route: "email:threads_list", fields: ["subject"], search: "subject", pathFrom: [] },
-    voiceList: { route: "voice:list", fields: ["to"], search: "", pathFrom: [] },
+    voiceLegsList: { route: "voice:legs_list", fields: ["to"], search: "", pathFrom: [] },
     webhooksList: { route: "webhooks:list", fields: ["url"], search: "", pathFrom: [] },
     whatsappList: { route: "whatsapp:list", fields: ["to.phone_number", "to.bsuid", "created_at"], search: "", pathFrom: [] },
 };

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

@@ -194,10 +194,10 @@ exports.birdProperties = [
         noDataExpression: true,
         displayOptions: { show: { resource: ["voice"] } },
         options: [
-            { name: "List", value: "list", action: "List calls", description: "List calls" },
-            { name: "Get", value: "get", action: "Get a call", description: "Get a call" },
+            { name: "List Legs", value: "legs_list", action: "List legs" },
+            { name: "Get Leg", value: "legs_get", action: "Get a leg", description: "Get a leg" },
         ],
-        default: "list",
+        default: "legs_list",
     },
     {
         displayName: "Operation",
@@ -814,7 +814,7 @@ exports.birdProperties = [
                 type: "string",
             },
         ],
-        description: "ID of the message to fetch, as returned by the send response",
+        description: "ID of the message to fetch. A broadcast records one message per recipient, and [List email messages](/docs/api/reference/list-email-messages) returns those copies alongside ordinary sends. For a single send, this is the message's own ID, as returned by the send response.",
     },
     {
         displayName: "Return All",
@@ -4326,7 +4326,7 @@ exports.birdProperties = [
         required: true,
         displayOptions: { show: { resource: ["whatsapp"], operation: ["send"] } },
         default: "",
-        description: "The message recipient: a phone number in E.164 format (for example `+31612345678`), or the recipient's business-scoped user ID (for example `US.13491208655302741918`), which addresses a WhatsApp user whose phone number you do not have. A value that is neither returns a `422` `WhatsAppInvalidRecipient`. One-time-passcode templates require a phone number and return a `422` `WhatsAppRecipientNotSupportedForTemplate` when sent to a business-scoped user ID.",
+        description: "The message recipient: a phone number in E.164 format (for example `+31612345678`), the recipient's business-scoped user ID (for example `US.13491208655302741918`), which addresses a WhatsApp user whose phone number you do not have, or a WhatsApp group ID (for example `wag_01krdgeqcxet5s7t44vh8rt9mg`), which sends to every participant of that group. A value that is none of these returns a `422` `WhatsAppInvalidRecipient`. One-time-passcode templates require a phone number and return a `422` `WhatsAppRecipientNotSupportedForTemplate` when sent to a business-scoped user ID. A group ID naming no group this workspace holds returns a `404` `WhatsAppGroupNotFound`, and one whose group is not active returns a `409` `WhatsAppGroupNotActive`. Content a group cannot take is refused ahead of both, so a group ID paired with interactive content returns the `422` below whether or not the group exists.",
     },
     {
         displayName: "Additional Fields",
@@ -4403,7 +4403,7 @@ exports.birdProperties = [
                 name: "from",
                 type: "string",
                 default: "",
-                description: "The business phone number to send from, in E.164 format. Omit it for a Bird-managed template, which selects its own number from its category: setting it there returns a `422` `WhatsAppSenderNotAllowed`. Every other send, whether free-form content of any kind or a template your workspace authored, requires it, and the number must be one this workspace owns. Omitting it returns a `422` `WhatsAppSenderRequired`, and naming a number this workspace cannot send from returns a `422` `WhatsAppSenderNotFound`. Naming a number this workspace owns but that sits on a different WhatsApp Business Account than an authored template returns a `422` `WhatsAppSenderWABAMismatch`. A number this workspace holds but has not finished connecting returns a `422` `WhatsAppSenderNotConnected`.",
+                description: "The business phone number to send from, in E.164 format. Omit it for a Bird-managed template, which selects its own number from its category: setting it there returns a `422` `WhatsAppSenderNotAllowed`. Every other send, whether free-form content of any kind or a template your workspace authored, requires it, and the number must be one this workspace owns. Omitting it returns a `422` `WhatsAppSenderRequired`, and naming a number this workspace cannot send from returns a `422` `WhatsAppSenderNotFound`. Naming a number this workspace owns but that sits on a different WhatsApp Business Account than an authored template returns a `422` `WhatsAppSenderWABAMismatch`. A number this workspace holds but has not finished connecting returns a `422` `WhatsAppSenderNotConnected`. Omit it for a group send too: the group sends on its own number, so naming one returns a `422` `WhatsAppSenderNotAllowed`.",
             },
             {
                 displayName: "Image",
@@ -4442,7 +4442,7 @@ exports.birdProperties = [
                 type: "collection",
                 placeholder: "Add Field",
                 default: {},
-                description: "Free-form interactive content to send instead of a template: body text plus reply buttons, a menu, a link button, media cards, or a single button asking the recipient to share their location or their phone number. Deliverable only inside an open 24-hour customer service window, which the contact opens by messaging or calling you and resets each time they do it again. A send into a closed window is refused with a `422` `WhatsAppServiceWindowClosed` before anything is created or charged; one whose window closes between accept and dispatch fails asynchronously, with `service_window_expired` on the message's `last_error`.",
+                description: "Free-form interactive content to send instead of a template: body text plus reply buttons, a menu, a link button, media cards, or a single button asking the recipient to share their location or their phone number. Deliverable only inside an open 24-hour customer service window, which the contact opens by messaging or calling you and resets each time they do it again. A send into a closed window is refused with a `422` `WhatsAppServiceWindowClosed` before anything is created or charged; one whose window closes between accept and dispatch fails asynchronously, with `service_window_expired` on the message's `last_error`. WhatsApp does not deliver interactive content to a group, so a group recipient returns a `422` `WhatsAppGroupContentNotSupported`.",
                 options: [
                     {
                         displayName: "Body Text",
@@ -4632,7 +4632,7 @@ exports.birdProperties = [
                 type: "collection",
                 placeholder: "Add Field",
                 default: {},
-                description: "The template to send. A Bird-managed template selects the sender number from the template's category, so `from` must be omitted. A template is the only content deliverable outside a customer service window.",
+                description: "The template to send. A Bird-managed template selects the sender number from the template's category, so `from` must be omitted. A template is the only content deliverable outside a customer service window. A group send takes a template your workspace authored in any category but authentication: WhatsApp does not deliver an authentication template to a group, which returns a `422` `WhatsAppGroupContentNotSupported`. A Bird-managed template sends from a Bird-owned number that no group is scoped to, so addressing one to a group returns a `422` `WhatsAppInvalidRecipient`.",
                 options: [
                     {
                         displayName: "ID",
@@ -4815,6 +4815,13 @@ exports.birdProperties = [
                 default: "",
                 description: "Filter by sender, exact match. The sender is your business number on an outbound message and the contact on an inbound one, matching the `from` each message returns. Accepts an E.164 phone number, or a business-scoped user ID to name the contact. Only a contact is ever identified by a business-scoped user ID, so `from=<business-scoped user ID>` matches inbound messages only.",
             },
+            {
+                displayName: "Group ID",
+                name: "group_id",
+                type: "string",
+                default: "",
+                description: "Filter by the WhatsApp group the message belongs to, in either direction: the group an outbound message was addressed to, or the group an inbound message arrived through. Matches the `group_id` on each message's `to`. It names one group, so there is no way to ask for the messages that belong to no group: omit it to list group and one-to-one messages together.",
+            },
             {
                 displayName: "Phone Number",
                 name: "phone_number",
@@ -4909,7 +4916,7 @@ exports.birdProperties = [
         displayName: "Return All",
         name: "returnAll",
         type: "boolean",
-        displayOptions: { show: { resource: ["voice"], operation: ["list"] } },
+        displayOptions: { show: { resource: ["voice"], operation: ["legs_list"] } },
         default: false,
         description: "Whether to return all results or only up to a given limit",
     },
@@ -4918,7 +4925,7 @@ exports.birdProperties = [
         name: "limit",
         type: "number",
         typeOptions: { minValue: 1 },
-        displayOptions: { show: { resource: ["voice"], operation: ["list"] } },
+        displayOptions: { show: { resource: ["voice"], operation: ["legs_list"] } },
         default: 50,
         description: "Max number of results to return",
     },
@@ -4928,8 +4935,15 @@ exports.birdProperties = [
         type: "collection",
         placeholder: "Add Field",
         default: {},
-        displayOptions: { show: { resource: ["voice"], operation: ["list"] } },
+        displayOptions: { show: { resource: ["voice"], operation: ["legs_list"] } },
         options: [
+            {
+                displayName: "Call ID",
+                name: "call_id",
+                type: "string",
+                default: "",
+                description: "Return only legs belonging to this call, which is how the legs of one multi-party or transferred call are correlated",
+            },
             {
                 displayName: "Direction",
                 name: "direction",
@@ -4940,49 +4954,42 @@ exports.birdProperties = [
                     { name: "Outbound", value: "outbound" },
                 ],
                 default: "",
-                description: "Return only calls in this direction",
+                description: "Return only legs in this direction",
             },
             {
                 displayName: "From",
                 name: "from",
                 type: "string",
                 default: "",
-                description: "Return only calls placed from this calling party number, matched as a whole number rather than as a fragment. Give it in international form: `+14155551234`, `14155551234`, and `0014155551234` all select the same calls. A number given without a country code is read as an international one, so give the country code to be sure of what you are matching. Use `number` instead to match part of a number, or either side of the call.",
+                description: "Return only legs placed from this calling party number, matched as a whole number rather than as a fragment. Give it in international form: `+14155551234`, `14155551234`, and `0014155551234` all select the same legs. A number given without a country code is read as an international one, so give the country code to be sure of what you are matching. Use `number` instead to match part of a number, or either side of the leg.",
             },
             {
                 displayName: "Number",
                 name: "number",
                 type: "string",
                 default: "",
-                description: "Return only calls where the calling or called number contains this value. Matches a partial number, so a country or area-code prefix returns every call to or from it. Combines with `from`/`to`, which match one side exactly.",
-            },
-            {
-                displayName: "Session ID",
-                name: "session_id",
-                type: "string",
-                default: "",
-                description: "Return only calls belonging to this session, which is how the legs of one multi-party or transferred call are correlated",
+                description: "Return only legs where the calling or called number contains this value. Matches a partial number, so a country or area-code prefix returns every leg to or from it. Combines with `from`/`to`, which match one side exactly.",
             },
             {
                 displayName: "Sip Trunk ID",
                 name: "sip_trunk_id",
                 type: "string",
                 default: "",
-                description: "Return only calls carried by this SIP trunk",
+                description: "Return only legs carried by this SIP trunk",
             },
             {
                 displayName: "Started After",
                 name: "started_after",
                 type: "dateTime",
                 default: "",
-                description: "Return only calls that started at or after this instant, inclusive. RFC 3339 timestamp.",
+                description: "Return only legs that started at or after this instant, inclusive. RFC 3339 timestamp.",
             },
             {
                 displayName: "Started Before",
                 name: "started_before",
                 type: "dateTime",
                 default: "",
-                description: "Return only calls that started at or before this instant, inclusive. RFC 3339 timestamp.",
+                description: "Return only legs that started at or before this instant, inclusive. RFC 3339 timestamp.",
             },
             {
                 displayName: "Status",
@@ -5000,7 +5007,7 @@ exports.birdProperties = [
                     { name: "Unknown", value: "unknown" },
                 ],
                 default: [],
-                description: "Return only calls with one of these statuses, comma-separated. In-flight and final statuses may be combined freely.",
+                description: "Return only legs with one of these statuses, comma-separated. In-flight and final statuses may be combined freely.",
             },
             {
                 displayName: "Tag",
@@ -5014,24 +5021,24 @@ exports.birdProperties = [
                 name: "to",
                 type: "string",
                 default: "",
-                description: "Return only calls placed to this called party number, matched as a whole number rather than as a fragment. Give it in international form: `+16505559876`, `16505559876`, and `0016505559876` all select the same calls. A number given without a country code is read as an international one, so give the country code to be sure of what you are matching. Use `number` instead to match part of a number, or either side of the call.",
+                description: "Return only legs placed to this called party number, matched as a whole number rather than as a fragment. Give it in international form: `+16505559876`, `16505559876`, and `0016505559876` all select the same legs. A number given without a country code is read as an international one, so give the country code to be sure of what you are matching. Use `number` instead to match part of a number, or either side of the leg.",
             },
         ],
     },
     {
-        displayName: "Call",
-        name: "call_id",
+        displayName: "Leg",
+        name: "leg_id",
         type: "resourceLocator",
         required: true,
         default: { mode: "list", value: "" },
-        displayOptions: { show: { resource: ["voice"], operation: ["get"] } },
+        displayOptions: { show: { resource: ["voice"], operation: ["legs_get"] } },
         modes: [
             {
                 displayName: "From List",
                 name: "list",
                 type: "list",
-                placeholder: "Select a Call...",
-                typeOptions: { searchListMethod: "voiceList", searchable: true },
+                placeholder: "Select a Leg...",
+                typeOptions: { searchListMethod: "voiceLegsList", searchable: true },
             },
             {
                 displayName: "By ID",
@@ -9394,7 +9401,7 @@ exports.birdProperties = [
                 type: "string",
             },
         ],
-        description: "ID of the message whose stored content to fetch, as returned by the send response",
+        description: "ID of the message whose stored content to fetch. A broadcast records one message per recipient, and [List email messages](/docs/api/reference/list-email-messages) returns those copies alongside ordinary sends. For a single send, this is the message's own ID, as returned by the send response.",
     },
     {
         displayName: "Message",
@@ -9417,7 +9424,7 @@ exports.birdProperties = [
                 type: "string",
             },
         ],
-        description: "ID of the message whose recipients to list, as returned by the send response",
+        description: "ID of the message whose recipients to list. A broadcast records one message per recipient, and [List email messages](/docs/api/reference/list-email-messages) returns those copies alongside ordinary sends. For a single send, this is the message's own ID, as returned by the send response.",
     },
     {
         displayName: "Return All",
@@ -9877,7 +9884,7 @@ exports.birdProperties = [
                 type: "string",
             },
         ],
-        description: "ID of the message whose timeline to read, as returned by the send response",
+        description: "ID of the message whose timeline to read. A broadcast records one message per recipient, and [List email messages](/docs/api/reference/list-email-messages) returns those copies alongside ordinary sends. For a single send, this is the message's own ID, as returned by the send response.",
     },
     {
         displayName: "Return All",

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

@@ -58,10 +58,10 @@ exports.birdRoutes = {
     "sms_keyword_rules:delete": { method: "DELETE", path: "/v1/sms/keyword-rules/{id}", pathParams: ["id"], topLevel: ["id"], collections: ["additionalFields"], query: [], body: [], jsonFields: [], structured: {}, renames: {}, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: false, collection: false, idempotencyHeader: true, scopes: ["sms_management"] },
     "whatsapp:send": { method: "POST", path: "/v1/whatsapp/messages", pathParams: [], topLevel: ["to"], collections: ["additionalFields"], query: [], body: ["to", "from", "template", "text", "image", "video", "audio", "sticker", "document", "location", "interactive", "contact_cards", "in_reply_to_message_id", "tags", "metadata"], jsonFields: ["template.components", "interactive.header", "interactive.buttons", "interactive.list", "interactive.cta_url", "interactive.cards", "contact_cards"], structured: { "template": "struct", "text": "struct", "image": "struct", "video": "struct", "audio": "struct", "sticker": "struct", "document": "struct", "location": "struct", "interactive": "struct", "tags": "list", "metadata": "map" }, renames: {}, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: false, collection: false, idempotencyHeader: true, scopes: ["whatsapp"] },
     "whatsapp:get": { method: "GET", path: "/v1/whatsapp/messages/{message_id}", pathParams: ["message_id"], topLevel: ["message_id"], collections: ["additionalFields"], query: [], body: [], jsonFields: [], structured: {}, renames: {}, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: false, collection: false, idempotencyHeader: false, scopes: ["whatsapp"] },
-    "whatsapp:list": { method: "GET", path: "/v1/whatsapp/messages", pathParams: [], topLevel: [], collections: ["additionalFields"], query: ["limit", "starting_after", "ending_before", "created_after", "created_before", "status", "direction", "to", "from", "phone_number", "bsuid", "category", "tag"], body: [], jsonFields: [], structured: {}, renames: {}, arrayFields: ["status", "tag"], dateTimeFields: ["created_after", "created_before"], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: true, collection: true, idempotencyHeader: false, scopes: ["whatsapp"] },
+    "whatsapp:list": { method: "GET", path: "/v1/whatsapp/messages", pathParams: [], topLevel: [], collections: ["additionalFields"], query: ["limit", "starting_after", "ending_before", "created_after", "created_before", "status", "direction", "to", "from", "phone_number", "bsuid", "category", "group_id", "tag"], body: [], jsonFields: [], structured: {}, renames: {}, arrayFields: ["status", "tag"], dateTimeFields: ["created_after", "created_before"], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: true, collection: true, idempotencyHeader: false, scopes: ["whatsapp"] },
     "whatsapp:list_events": { method: "GET", path: "/v1/whatsapp/messages/{message_id}/events", pathParams: ["message_id"], topLevel: ["message_id"], collections: ["additionalFields"], query: ["type"], body: [], jsonFields: [], structured: {}, renames: {}, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: false, collection: true, idempotencyHeader: false, scopes: ["whatsapp"] },
-    "voice:list": { method: "GET", path: "/v1/voice/calls", pathParams: [], topLevel: [], collections: ["additionalFields"], query: ["direction", "status", "session_id", "sip_trunk_id", "from", "to", "number", "tag", "started_after", "started_before", "limit", "starting_after", "ending_before"], body: [], jsonFields: [], structured: {}, renames: {}, arrayFields: ["status", "tag"], dateTimeFields: ["started_after", "started_before"], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: true, collection: true, idempotencyHeader: false, scopes: ["voice"] },
-    "voice:get": { method: "GET", path: "/v1/voice/calls/{call_id}", pathParams: ["call_id"], topLevel: ["call_id"], collections: ["additionalFields"], query: [], body: [], jsonFields: [], structured: {}, renames: {}, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: false, collection: false, idempotencyHeader: false, scopes: ["voice"] },
+    "voice:legs_list": { method: "GET", path: "/v1/voice/legs", pathParams: [], topLevel: [], collections: ["additionalFields"], query: ["direction", "status", "call_id", "sip_trunk_id", "from", "to", "number", "tag", "started_after", "started_before", "limit", "starting_after", "ending_before"], body: [], jsonFields: [], structured: {}, renames: {}, arrayFields: ["status", "tag"], dateTimeFields: ["started_after", "started_before"], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: true, collection: true, idempotencyHeader: false, scopes: ["voice"] },
+    "voice:legs_get": { method: "GET", path: "/v1/voice/legs/{leg_id}", pathParams: ["leg_id"], topLevel: ["leg_id"], collections: ["additionalFields"], query: [], body: [], jsonFields: [], structured: {}, renames: {}, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: false, collection: false, idempotencyHeader: false, scopes: ["voice"] },
     "verify:verifications_create": { method: "POST", path: "/v1/verify/verifications", pathParams: [], topLevel: ["to"], collections: ["additionalFields"], query: [], body: ["to", "options", "metadata"], jsonFields: [], structured: { "to": "struct", "options": "struct", "metadata": "map" }, renames: {}, arrayFields: ["options.channels"], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: false, collection: false, idempotencyHeader: true, scopes: ["verify"] },
     "verify:verifications_check": { method: "POST", path: "/v1/verify/verifications/check", pathParams: [], topLevel: ["to", "code"], collections: ["additionalFields"], query: [], body: ["to", "code"], jsonFields: [], structured: { "to": "struct" }, renames: {}, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: false, collection: false, idempotencyHeader: true, scopes: ["verify"] },
     "verify:verifications_next_channel": { method: "POST", path: "/v1/verify/verifications/next-channel", pathParams: [], topLevel: ["to"], collections: ["additionalFields"], query: [], body: ["to"], jsonFields: [], structured: { "to": "struct" }, renames: {}, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: false, collection: false, idempotencyHeader: true, scopes: ["verify"] },

package/package.json

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