@messagebird/n8n-nodes-bird 0.48.0 → 0.50.0

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.
@@ -52,7 +52,7 @@ exports.birdEvents = [
52
52
  { name: "verify.attempt.sent", value: "verify.attempt.sent", description: "A one-time passcode was dispatched to the recipient on a channel" },
53
53
  { name: "verify.attempt.undelivered", value: "verify.attempt.undelivered", description: "A one-time passcode failed to deliver to the recipient" },
54
54
  { name: "verify.verification.created", value: "verify.verification.created", description: "A verification session was created and its first one-time passcode is being sent" },
55
- { name: "verify.verification.failed", value: "verify.verification.failed", description: "The verification ended without the recipient receiving a passcode: every planned channel reported that its send would not arrive" },
55
+ { name: "verify.verification.failed", value: "verify.verification.failed", description: "The verification ended without the recipient receiving a passcode: no channel Bird tried sent one, and Bird tries no further channel" },
56
56
  { name: "verify.verification.verified", value: "verify.verification.verified", description: "The verification was successfully resolved: the recipient confirmed the correct code" },
57
57
  { name: "voice_call.answered", value: "voice_call.answered", description: "The called party answered and media began flowing" },
58
58
  { name: "voice_call.ended", value: "voice_call.ended", description: "The call ended after either party hung up or call setup failed" },
@@ -3160,7 +3160,7 @@ exports.birdProperties = [
3160
3160
  name: "error_code",
3161
3161
  type: "string",
3162
3162
  default: "",
3163
- description: "Keep only messages whose failure reason (`last_error.code`) matches; separate values with a comma to match any of several. One of `invalid_destination`, `unreachable`, `blocked_by_carrier`, `blocked_by_fraud_protection`, `blocked_by_recipient`, `landline_unreachable`, `content_rejected`, `sender_unregistered`, `recipient_opted_out`, `provider_unavailable`, `insufficient_balance`, or `unknown`. With a `status` or `error_code` filter a page can hold fewer messages than `limit`, or none; keep paging until `next_cursor` is null.",
3163
+ description: "Keep only messages whose failure reason (`last_error.code`) matches; separate values with a comma to match any of several. Accepts any SMS error code, including codes added later, such as `invalid_destination`, `unreachable`, `blocked_by_carrier`, `blocked_by_fraud_protection`, `blocked_by_recipient`, `landline_unreachable`, `content_rejected`, `sender_unregistered`, `recipient_opted_out`, `provider_unavailable`, `insufficient_balance`, `workspace_suspended`, or `unknown`. With a `status` or `error_code` filter a page can hold fewer messages than `limit`, or none; keep paging until `next_cursor` is null.",
3164
3164
  },
3165
3165
  {
3166
3166
  displayName: "From",
@@ -5473,7 +5473,7 @@ exports.birdProperties = [
5473
5473
  name: "from",
5474
5474
  type: "string",
5475
5475
  default: "",
5476
- 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.",
5476
+ description: "Return only legs placed from this calling party, matched exactly. Give a number 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. A `usr_` ID matches the recorded calling party exactly as given; it does not establish who placed the call. Use `number` instead to match part of a number, or either side of the leg.",
5477
5477
  },
5478
5478
  {
5479
5479
  displayName: "Number",
@@ -5600,7 +5600,7 @@ exports.birdProperties = [
5600
5600
  type: "collection",
5601
5601
  placeholder: "Add Field",
5602
5602
  default: {},
5603
- description: "Per-request overrides applied to this verification only",
5603
+ description: "Per-request overrides applied to this verification only. `language` picks one of Bird's built-in translations; a custom sender that carries its own template renders the language that template stocks instead. An email template pinned to a custom email sender falls back to its own default language rather than to English (Verify only accepts templates whose language settings fall back). A WhatsApp authentication template follows its own missing-language policy: it falls back to its default or, when set to fail, refuses the send for a language it does not stock. The requested tag stays fixed for the verification.",
5604
5604
  options: [
5605
5605
  {
5606
5606
  displayName: "Android App Hash",
@@ -5649,7 +5649,7 @@ exports.birdProperties = [
5649
5649
  name: "language",
5650
5650
  type: "string",
5651
5651
  default: "",
5652
- description: "Which of the built-in message translations to send. It applies to SMS, email and WhatsApp, and has no effect on a Telegram verification. A tag with no translation of its own falls back to its base language, and then to English. The attempt's `template_language` reports which translation was used. The tag is fixed for the verification, so a resend arrives in the same language as the first message. Omit it and the language is read from the recipient phone number's country, so a French number gets French without you asking. Set it to override that. A verification with no phone number, and one whose country has no translation here, sends English. Supported: en, ar, bg, cs, da, de, el, es, fi, fr, he, hi, hr, hu, ID, it, ja, ko, lt, lv, mk, mn, ms, nb-NO, nl, no, pl, pt, ro, ru, sk, sl, sr, sv, th, tr, uk, vi, zh, zh-TW. Every one of them is available on SMS and email. Mongolian (mn) is the one WhatsApp cannot carry, so a WhatsApp passcode falls back to English for it.",
5652
+ description: "Which of the built-in message translations to send. It applies to SMS, email and WhatsApp, and has no effect on a Telegram verification. A tag with no translation of its own falls back to its base language, and then to English. The attempt's `template_language` reports which translation was used. The tag is fixed for the verification, so a resend arrives in the same language as the first message. Omit it and the language is read from the recipient phone number's country, so a French number gets French without you asking. Set it to override that. A verification with no phone number, and one whose country has no translation here, sends English. Supported: en, ar, bg, cs, da, de, el, es, fi, fr, he, hi, hr, hu, ID, it, ja, ko, lt, lv, mk, mn, ms, nb-NO, nl, no, pl, pt, ro, ru, sk, sl, sr, sv, th, tr, uk, vi, zh, zh-TW. Every one of them is available on SMS and on Bird's built-in email. Mongolian (mn) is the one WhatsApp cannot carry, so a WhatsApp passcode falls back to English for it. A custom sender that carries its own template sends that template's content instead: a custom WhatsApp sender uses its authentication template's approved languages under that template's missing-language policy, and a custom email sender pinned to one of your email templates uses the template's published languages, falling back to the template's default language rather than to English. The requested tag stays fixed for the verification; the dashboard's verification detail shows the language each attempt actually rendered.",
5653
5653
  },
5654
5654
  ],
5655
5655
  },
@@ -9652,7 +9652,7 @@ exports.birdProperties = [
9652
9652
  name: "labels",
9653
9653
  type: "string",
9654
9654
  default: "",
9655
- description: "Match every listed custom label. Repeat labels to supply more than one. System label names are refused. Separate multiple values with a comma.",
9655
+ description: "Match every listed custom label. Repeat labels to supply more than one. System label names are refused. Names match in any casing. Separate multiple values with a comma.",
9656
9656
  },
9657
9657
  {
9658
9658
  displayName: "Mailbox ID",
@@ -9769,7 +9769,7 @@ exports.birdProperties = [
9769
9769
  type: "collection",
9770
9770
  placeholder: "Add Field",
9771
9771
  default: {},
9772
- description: "Custom labels to add or remove. System and reserved names are refused; use read and folder for thread state. The resulting custom-label set must contain at most 20 labels; larger sets return 422.",
9772
+ description: "Custom labels to add or remove, or the full set to replace them with. Send `set` on its own; combining it with `add` or `remove` returns 422. System names are refused; use read and folder for thread state. Reserved names are refused too, except a label the conversation already carries from before its name was reserved, which can still be removed, and kept in a `set` in any casing. The resulting custom-label set must contain at most 20 labels; larger sets return 422. A custom name added or set that the workspace does not have yet becomes a workspace label that stays after it is removed from every conversation; once the workspace has 100 labels, a write that would create one more is refused with `E17058`. Custom label names match the workspace's labels in any casing, so adding `Urgent` where the workspace has `urgent` applies `urgent`, and responses return the workspace's spelling.",
9773
9773
  options: [
9774
9774
  {
9775
9775
  displayName: "Add",
@@ -9785,6 +9785,13 @@ exports.birdProperties = [
9785
9785
  default: "",
9786
9786
  description: "Labels to take off. Separate multiple values with a comma.",
9787
9787
  },
9788
+ {
9789
+ displayName: "Set",
9790
+ name: "set",
9791
+ type: "string",
9792
+ default: "",
9793
+ description: "The custom labels the conversation should carry, replacing all of its current ones. Leaving it blank sends nothing; to take every custom label off, list them under Remove. Separate multiple values with a comma.",
9794
+ },
9788
9795
  ],
9789
9796
  },
9790
9797
  {
@@ -9901,7 +9908,7 @@ exports.birdProperties = [
9901
9908
  name: "label",
9902
9909
  type: "string",
9903
9910
  default: "",
9904
- description: "Filter to messages that have this label. `trash` lists trashed messages. Any other label, whether that is `archive`, `spam`, `blocked`, `unread` or one of your own, lists the messages that have it and are not in the trash. When omitted, every message that is not trashed is returned, whichever folder the conversation is in.",
9911
+ description: "Filter to messages that have this label. `trash` lists trashed messages. Any other label, whether that is `archive`, `spam`, `blocked`, `unread` or one of your own, lists the messages that have it and are not in the trash. When omitted, every message that is not trashed is returned, whichever folder the conversation is in. A custom label name matches in any casing.",
9905
9912
  },
9906
9913
  {
9907
9914
  displayName: "Include",
@@ -10848,7 +10855,7 @@ exports.birdProperties = [
10848
10855
  type: "collection",
10849
10856
  placeholder: "Add Field",
10850
10857
  default: {},
10851
- description: "Label changes to apply. Labels in `add` are applied and labels in `remove` are taken off; other labels are left untouched. Adding a label that is already present, or removing one that is not, has no effect. On a message, adding or removing `unread` flips read state. Adding or removing `trash` moves it to or out of the trash. Placement labels cannot be applied to a message; use `folder` on [Update a thread](/docs/api/reference/update-email-thread) (`PATCH /v1/email/threads/{thread_id}`) to move its conversation. A sent message cannot use unread. Custom labels are 1-64 characters with no commas, control characters, or leading or trailing whitespace. System label names and a small reserved set (`all`, `archived`, `deleted`, `draft`, `drafts`, `flagged`, `important`, `junk`, `muted`, `none`, `outbox`, `pinned`, `read`, `scheduled`, `snoozed`, `starred`) cannot be used as custom labels, in any casing. A conversation or message has at most 20 labels, system labels included.",
10858
+ description: "Label changes to apply. Labels in `add` are applied and labels in `remove` are taken off; other labels are left untouched. Adding a label that is already present, or removing one that is not, has no effect. `set` instead replaces every custom label and leaves system labels as they are; send it on its own, since combining it with `add` or `remove` returns 422. On a message, adding or removing `unread` flips read state. Adding or removing `trash` moves it to or out of the trash. Placement labels cannot be applied to a message; use `folder` on [Update a thread](/docs/api/reference/update-email-thread) (`PATCH /v1/email/threads/{thread_id}`) to move its conversation. A sent message cannot use unread. Custom labels are 1-64 characters with no commas, control characters, or leading or trailing whitespace. System label names and a small reserved set (`all`, `archived`, `assigned`, `closed`, `deleted`, `draft`, `drafts`, `flagged`, `important`, `junk`, `muted`, `none`, `open`, `outbox`, `pinned`, `read`, `scheduled`, `snoozed`, `starred`) cannot be applied as custom labels, in any casing. A label applied before its name was reserved can still be removed, added again under the same name with no effect, and kept in a `set` in any casing. A conversation or message has at most 20 labels, system labels included. A custom name added or set that the workspace does not have yet becomes a workspace label that stays after it is removed from every conversation; once the workspace has 100 labels, a write that would create one more is refused with `E17058`. A name in both `add` and `remove` is removed and does not count as added. Custom label names match the workspace's labels in any casing: adding `Urgent` where the workspace has `urgent` applies `urgent`, and responses return the workspace's spelling.",
10852
10859
  options: [
10853
10860
  {
10854
10861
  displayName: "Add",
@@ -10864,6 +10871,13 @@ exports.birdProperties = [
10864
10871
  default: "",
10865
10872
  description: "Labels to take off. Separate multiple values with a comma.",
10866
10873
  },
10874
+ {
10875
+ displayName: "Set",
10876
+ name: "set",
10877
+ type: "string",
10878
+ default: "",
10879
+ description: "The custom labels the message should carry, replacing all of its current ones; system labels such as `unread` and `trash` are unchanged. Leaving it blank sends nothing; to take every custom label off, list them under Remove. Separate multiple values with a comma.",
10880
+ },
10867
10881
  ],
10868
10882
  },
10869
10883
  {
@@ -11014,7 +11028,7 @@ exports.birdProperties = [
11014
11028
  name: "label",
11015
11029
  type: "string",
11016
11030
  default: "",
11017
- description: "Filter to messages that have this label. `trash` lists trashed messages. Any other label, whether that is `archive`, `spam`, `blocked`, `unread` or one of your own, lists the messages that have it and are not in the trash. When omitted, received messages in the inbox and all sent messages are returned.",
11031
+ description: "Filter to messages that have this label. `trash` lists trashed messages. Any other label, whether that is `archive`, `spam`, `blocked`, `unread` or one of your own, lists the messages that have it and are not in the trash. When omitted, received messages in the inbox and all sent messages are returned. A custom label name matches in any casing.",
11018
11032
  },
11019
11033
  {
11020
11034
  displayName: "Status",
@@ -152,7 +152,7 @@ exports.birdRoutes = {
152
152
  "email:mailboxes_receive_rules_delete": { method: "DELETE", path: "/v1/email/mailboxes/{mailbox_id}/receive-rules/{rule_id}", pathParams: ["mailbox_id", "rule_id"], topLevel: ["mailbox_id", "rule_id"], collections: ["additionalFields"], query: [], body: [], jsonFields: [], structured: {}, renames: {}, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: false, collection: false, idempotencyHeader: true, scopes: ["mailbox_management"] },
153
153
  "email:threads_list": { method: "GET", path: "/v1/email/threads", pathParams: [], topLevel: [], collections: ["additionalFields"], query: ["mailbox_id", "contact_id", "folder", "read_state", "labels", "participant", "subject", "after", "before", "limit", "starting_after", "ending_before"], body: [], jsonFields: [], structured: {}, renames: {}, arrayFields: ["labels"], dateTimeFields: ["after", "before"], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: true, collection: true, idempotencyHeader: false, scopes: ["mailbox"] },
154
154
  "email:threads_get": { method: "GET", path: "/v1/email/threads/{thread_id}", pathParams: ["thread_id"], topLevel: ["thread_id"], collections: ["additionalFields"], query: [], body: [], jsonFields: [], structured: {}, renames: {}, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: false, collection: false, idempotencyHeader: false, scopes: ["mailbox"] },
155
- "email:threads_update": { method: "PATCH", path: "/v1/email/threads/{thread_id}", pathParams: ["thread_id"], topLevel: ["thread_id"], collections: ["updateFields"], query: [], body: ["read", "folder", "labels", "contact_id"], jsonFields: [], structured: { "labels": "struct" }, renames: {}, arrayFields: ["labels.add", "labels.remove"], dateTimeFields: [], nullableFields: ["contact_id"], binaryFields: [], rawBodyField: "", paginated: false, collection: false, idempotencyHeader: true, scopes: ["mailbox"] },
155
+ "email:threads_update": { method: "PATCH", path: "/v1/email/threads/{thread_id}", pathParams: ["thread_id"], topLevel: ["thread_id"], collections: ["updateFields"], query: [], body: ["read", "folder", "labels", "contact_id"], jsonFields: [], structured: { "labels": "struct" }, renames: {}, arrayFields: ["labels.add", "labels.remove", "labels.set"], dateTimeFields: [], nullableFields: ["contact_id"], binaryFields: [], rawBodyField: "", paginated: false, collection: false, idempotencyHeader: true, scopes: ["mailbox"] },
156
156
  "email:threads_delete": { method: "DELETE", path: "/v1/email/threads/{thread_id}", pathParams: ["thread_id"], topLevel: ["thread_id"], collections: ["additionalFields"], query: ["permanent"], body: [], jsonFields: [], structured: {}, renames: {}, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: false, collection: false, idempotencyHeader: true, scopes: ["mailbox"] },
157
157
  "email:threads_messages_list": { method: "GET", path: "/v1/email/threads/{thread_id}/messages", pathParams: ["thread_id"], topLevel: ["thread_id"], collections: ["additionalFields"], query: ["direction", "label", "include", "limit", "starting_after", "ending_before"], body: [], jsonFields: [], structured: {}, renames: {}, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: true, collection: true, idempotencyHeader: false, scopes: ["mailbox"] },
158
158
  "email:threads_messages_get": { method: "GET", path: "/v1/email/threads/{thread_id}/messages/{message_id}", pathParams: ["thread_id", "message_id"], topLevel: ["thread_id", "message_id"], collections: ["additionalFields"], query: [], body: [], jsonFields: [], structured: {}, renames: {}, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: false, collection: false, idempotencyHeader: false, scopes: ["mailbox"] },
@@ -171,7 +171,7 @@ exports.birdRoutes = {
171
171
  "realtime:apps_keys_revoke": { method: "POST", path: "/v1/realtime/apps/{realtime_app_id}/keys/{realtime_app_key_id}/revoke", pathParams: ["realtime_app_id", "realtime_app_key_id"], topLevel: ["realtime_app_id", "realtime_app_key_id"], collections: ["additionalFields"], query: [], body: [], jsonFields: [], structured: {}, renames: {}, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: false, collection: false, idempotencyHeader: true, scopes: ["realtime"] },
172
172
  "realtime:regions_list": { method: "GET", path: "/v1/realtime/regions", pathParams: [], topLevel: [], collections: ["additionalFields"], query: [], body: [], jsonFields: [], structured: {}, renames: {}, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: false, collection: true, idempotencyHeader: false, scopes: ["realtime"] },
173
173
  "email:list_events": { method: "GET", path: "/v1/email/messages/{message_id}/events", pathParams: ["message_id"], topLevel: ["message_id"], collections: ["additionalFields"], query: ["limit", "starting_after", "ending_before", "type"], body: [], jsonFields: [], structured: {}, renames: {}, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: true, collection: true, idempotencyHeader: false, scopes: ["emails"] },
174
- "email:threads_messages_update": { method: "PATCH", path: "/v1/email/threads/{thread_id}/messages/{message_id}", pathParams: ["thread_id", "message_id"], topLevel: ["thread_id", "message_id"], collections: ["updateFields"], query: [], body: ["labels", "contact_id"], jsonFields: [], structured: { "labels": "struct" }, renames: {}, arrayFields: ["labels.add", "labels.remove"], dateTimeFields: [], nullableFields: ["contact_id"], binaryFields: [], rawBodyField: "", paginated: false, collection: false, idempotencyHeader: true, scopes: ["mailbox"] },
174
+ "email:threads_messages_update": { method: "PATCH", path: "/v1/email/threads/{thread_id}/messages/{message_id}", pathParams: ["thread_id", "message_id"], topLevel: ["thread_id", "message_id"], collections: ["updateFields"], query: [], body: ["labels", "contact_id"], jsonFields: [], structured: { "labels": "struct" }, renames: {}, arrayFields: ["labels.add", "labels.remove", "labels.set"], dateTimeFields: [], nullableFields: ["contact_id"], binaryFields: [], rawBodyField: "", paginated: false, collection: false, idempotencyHeader: true, scopes: ["mailbox"] },
175
175
  "email:threads_messages_delete": { method: "DELETE", path: "/v1/email/threads/{thread_id}/messages/{message_id}", pathParams: ["thread_id", "message_id"], topLevel: ["thread_id", "message_id"], collections: ["additionalFields"], query: ["permanent"], body: [], jsonFields: [], structured: {}, renames: {}, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: false, collection: false, idempotencyHeader: true, scopes: ["mailbox"] },
176
176
  "email:mailboxes_messages_list": { method: "GET", path: "/v1/email/mailboxes/{mailbox_id}/messages", pathParams: ["mailbox_id"], topLevel: ["mailbox_id"], collections: ["additionalFields"], query: ["label", "direction", "status", "after", "before", "include", "limit", "starting_after", "ending_before"], body: [], jsonFields: [], structured: {}, renames: {}, arrayFields: [], dateTimeFields: ["after", "before"], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: true, collection: true, idempotencyHeader: false, scopes: ["mailbox"] },
177
177
  "domains:list_events": { method: "GET", path: "/v1/email/domains/{domain_id}/events", pathParams: ["domain_id"], topLevel: ["domain_id"], collections: ["additionalFields", "sort"], query: ["sort", "order", "limit", "starting_after", "ending_before"], body: [], jsonFields: [], structured: {}, renames: {}, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: true, collection: true, idempotencyHeader: false, scopes: ["domains"] },
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@messagebird/n8n-nodes-bird",
3
- "version": "0.48.0",
3
+ "version": "0.50.0",
4
4
  "description": "The official Bird node for n8n: email, SMS, WhatsApp, and verification, plus a webhook trigger for Bird events.",
5
5
  "license": "MIT",
6
6
  "author": {