@messagebird/n8n-nodes-bird 0.34.0 → 0.34.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.
@@ -4780,7 +4780,7 @@ exports.birdProperties = [
4780
4780
  required: true,
4781
4781
  displayOptions: { show: { resource: ["whatsapp"], operation: ["send"] } },
4782
4782
  default: "",
4783
- description: "The recipient: a phone number in E.164 format (for example `+14155550100`), a business-scoped user ID (for example `US.13491208655302741918`) for a WhatsApp user whose number you do not have, or a WhatsApp group ID (for example `wag_01krdgeqcxet5s7t44vh8rt9mg`). One-time-passcode templates need a phone number. Bird tracks the customer service window per identity and business number, so reply to the identity a contact's message came from, from the number it reached.",
4783
+ description: "Recipient E.164 number, business-scoped user ID (BSUID, such as `US.13491208655302741918`), or group ID (such as `wag_01krdgeqcxet5s7t44vh8rt9mg`). OTP templates require a phone number. For replies, use the inbound sender identity and receiving business number.",
4784
4784
  },
4785
4785
  {
4786
4786
  displayName: "Additional Fields",
@@ -4796,21 +4796,21 @@ exports.birdProperties = [
4796
4796
  type: "collection",
4797
4797
  placeholder: "Add Field",
4798
4798
  default: {},
4799
- description: "Free-form audio. Deliverable only inside an open customer service window.",
4799
+ description: "Free-form audio; requires an open customer service window",
4800
4800
  options: [
4801
4801
  {
4802
4802
  displayName: "URL",
4803
4803
  name: "url",
4804
4804
  type: "string",
4805
4805
  default: "",
4806
- description: "Public `https` URL of the audio file. WhatsApp fetches it at send time, so it must still be reachable then. AAC, AMR, MP3, M4A or OGG (OPUS codec, mono), up to 16 MB.",
4806
+ description: "Public HTTPS URL fetched at send time. AAC, AMR, MP3, M4A, or OGG (OPUS, mono), up to 16 MB.",
4807
4807
  },
4808
4808
  {
4809
4809
  displayName: "Voice",
4810
4810
  name: "voice",
4811
4811
  type: "boolean",
4812
4812
  default: false,
4813
- description: "Whether to send this as a voice note rather than an audio file. A voice note needs an `.ogg` file encoded with the OPUS codec.",
4813
+ description: "Whether to send as a voice note; requires an `.ogg` file with the OPUS codec",
4814
4814
  },
4815
4815
  ],
4816
4816
  },
@@ -4819,7 +4819,7 @@ exports.birdProperties = [
4819
4819
  name: "contact_cards",
4820
4820
  type: "json",
4821
4821
  default: "",
4822
- description: "Up to five contact cards, each `name` carrying `formatted_name` plus at least one other part. Deliverable only inside an open customer service window.",
4822
+ description: "Up to five cards. Each name needs `formatted_name` and another name part. Requires an open customer service window.",
4823
4823
  },
4824
4824
  {
4825
4825
  displayName: "Document",
@@ -4827,14 +4827,14 @@ exports.birdProperties = [
4827
4827
  type: "collection",
4828
4828
  placeholder: "Add Field",
4829
4829
  default: {},
4830
- description: "A free-form document. Deliverable only inside an open customer service window.",
4830
+ description: "Free-form document; requires an open customer service window",
4831
4831
  options: [
4832
4832
  {
4833
4833
  displayName: "URL",
4834
4834
  name: "url",
4835
4835
  type: "string",
4836
4836
  default: "",
4837
- description: "Public `https` URL of the document. WhatsApp fetches it at send time, so it must still be reachable then. Up to 100 MB; PDF, Word, Excel, PowerPoint and plain text render reliably in the WhatsApp client.",
4837
+ description: "Public HTTPS URL fetched at send time, up to 100 MB. PDF, Word, Excel, PowerPoint, and plain text render reliably.",
4838
4838
  },
4839
4839
  {
4840
4840
  displayName: "Caption",
@@ -4848,7 +4848,7 @@ exports.birdProperties = [
4848
4848
  name: "filename",
4849
4849
  type: "string",
4850
4850
  default: "",
4851
- description: "Name the recipient sees, including the extension. WhatsApp derives one from the URL when you omit it.",
4851
+ description: "Recipient-visible filename with extension",
4852
4852
  },
4853
4853
  ],
4854
4854
  },
@@ -4857,7 +4857,7 @@ exports.birdProperties = [
4857
4857
  name: "from",
4858
4858
  type: "string",
4859
4859
  default: "",
4860
- description: "The business phone number to send from, in E.164 format: a connected number this workspace owns, on the same WhatsApp Business Account as an authored template. Omit it for a Bird-managed template or a group send, which use their own number; every other send requires it.",
4860
+ description: "Connected E.164 number owned by this workspace; for authored templates, use the same WhatsApp Business Account. Omit for Bird-managed templates and groups; required otherwise.",
4861
4861
  },
4862
4862
  {
4863
4863
  displayName: "Image",
@@ -4865,14 +4865,14 @@ exports.birdProperties = [
4865
4865
  type: "collection",
4866
4866
  placeholder: "Add Field",
4867
4867
  default: {},
4868
- description: "A free-form image. Deliverable only inside an open customer service window.",
4868
+ description: "Free-form image; requires an open customer service window",
4869
4869
  options: [
4870
4870
  {
4871
4871
  displayName: "URL",
4872
4872
  name: "url",
4873
4873
  type: "string",
4874
4874
  default: "",
4875
- description: "Public `https` URL of the image. WhatsApp fetches it at send time, so it must still be reachable then. JPEG or PNG, up to 5 MB.",
4875
+ description: "Public HTTPS URL fetched at send time. JPEG/PNG, up to 5 MB.",
4876
4876
  },
4877
4877
  {
4878
4878
  displayName: "Caption",
@@ -4888,7 +4888,7 @@ exports.birdProperties = [
4888
4888
  name: "in_reply_to_message_id",
4889
4889
  type: "string",
4890
4890
  default: "",
4891
- description: "An earlier message to quote above this one: one from the same conversation, between this `to` and `from`, in the last 15 days",
4891
+ description: "Message to quote, from this conversation (`to` and `from`) within the last 15 days",
4892
4892
  },
4893
4893
  {
4894
4894
  displayName: "Interactive",
@@ -4896,56 +4896,56 @@ exports.birdProperties = [
4896
4896
  type: "collection",
4897
4897
  placeholder: "Add Field",
4898
4898
  default: {},
4899
- description: "Free-form interactive content: reply buttons, a list menu, a link button, media cards, or a request for the recipient's location or contact details. Deliverable only inside an open customer service window, and never to a group.",
4899
+ description: "Reply buttons, a list, a link button, media cards, or a location/contact request. Requires an open customer service window; unsupported for groups.",
4900
4900
  options: [
4901
4901
  {
4902
4902
  displayName: "Body Text",
4903
4903
  name: "body_text",
4904
4904
  type: "string",
4905
4905
  default: "",
4906
- description: "The message's main text, required on every kind. Up to 1024 characters, except on a `list`.",
4906
+ description: "Required main text. Maximum 1024 characters, or 4096 for `list`.",
4907
4907
  },
4908
4908
  {
4909
4909
  displayName: "Buttons",
4910
4910
  name: "buttons",
4911
4911
  type: "json",
4912
4912
  default: "",
4913
- description: "The `quick_reply` buttons of a `button` message, in order. Labels must be unique within the message.",
4913
+ description: "Ordered `quick_reply` buttons for `button` messages. Labels must be unique within the message.",
4914
4914
  },
4915
4915
  {
4916
4916
  displayName: "Cards",
4917
4917
  name: "cards",
4918
4918
  type: "json",
4919
4919
  default: "",
4920
- description: "The cards of a `carousel` message, 2 to 10, left to right. A carousel takes no header or footer of its own.",
4920
+ description: "2–10 carousel cards, in display order. No message-level header or footer.",
4921
4921
  },
4922
4922
  {
4923
4923
  displayName: "Cta URL",
4924
4924
  name: "cta_url",
4925
4925
  type: "json",
4926
4926
  default: "",
4927
- description: "The link button to show. Send this on a `cta_url` message.",
4927
+ description: "Link button for a `cta_url` message",
4928
4928
  },
4929
4929
  {
4930
4930
  displayName: "Footer Text",
4931
4931
  name: "footer_text",
4932
4932
  type: "string",
4933
4933
  default: "",
4934
- description: "Optional small print below the body and above the buttons. A `carousel` and both request kinds take no footer.",
4934
+ description: "Small print below the body. Unsupported for carousel and request kinds.",
4935
4935
  },
4936
4936
  {
4937
4937
  displayName: "Header",
4938
4938
  name: "header",
4939
4939
  type: "json",
4940
4940
  default: "",
4941
- description: "Optional content above the body: text on a `list`; text, image, video or document on `button` and `cta_url`. A `carousel` and the two request kinds take none.",
4941
+ description: "For `list`: text only. For `button` and `cta_url`: text, image, video, or document. Unsupported for carousel and request kinds.",
4942
4942
  },
4943
4943
  {
4944
4944
  displayName: "List",
4945
4945
  name: "list",
4946
4946
  type: "json",
4947
4947
  default: "",
4948
- description: "The menu to show. Send this on a `list` message.",
4948
+ description: "Menu for a `list` message",
4949
4949
  },
4950
4950
  {
4951
4951
  displayName: "Type",
@@ -4961,7 +4961,7 @@ exports.birdProperties = [
4961
4961
  { name: "Request Contact Info", value: "request_contact_info" },
4962
4962
  ],
4963
4963
  default: "",
4964
- description: "Which kind of interactive message this is, and which field carries it",
4964
+ description: "Message kind; determines which content field to supply",
4965
4965
  },
4966
4966
  ],
4967
4967
  },
@@ -4971,7 +4971,7 @@ exports.birdProperties = [
4971
4971
  type: "collection",
4972
4972
  placeholder: "Add Field",
4973
4973
  default: {},
4974
- description: "A free-form location. Deliverable only inside an open customer service window.",
4974
+ description: "Free-form location; requires an open customer service window",
4975
4975
  options: [
4976
4976
  {
4977
4977
  displayName: "Latitude",
@@ -4992,14 +4992,14 @@ exports.birdProperties = [
4992
4992
  name: "name",
4993
4993
  type: "string",
4994
4994
  default: "",
4995
- description: "Name of the place, shown above the address",
4995
+ description: "Place name, shown above the address",
4996
4996
  },
4997
4997
  {
4998
4998
  displayName: "Address",
4999
4999
  name: "address",
5000
5000
  type: "string",
5001
5001
  default: "",
5002
- description: "Street address of the place. Shown only when `name` is also set.",
5002
+ description: "Street address; shown only with `name`",
5003
5003
  },
5004
5004
  ],
5005
5005
  },
@@ -5010,7 +5010,7 @@ exports.birdProperties = [
5010
5010
  typeOptions: { multipleValues: true },
5011
5011
  placeholder: "Add Pair",
5012
5012
  default: {},
5013
- description: "Arbitrary JSON object stored on the message and returned on API reads. Maximum 2 KB serialized. Use metadata for per-send context like internal IDs and foreign keys. For low-cardinality filterable labels, use `tags` instead.",
5013
+ description: "Per-message JSON context, such as internal IDs, returned on reads. Maximum 2 KB serialized. Use `tags` for filterable labels.",
5014
5014
  options: [
5015
5015
  {
5016
5016
  displayName: "Pair",
@@ -5037,7 +5037,7 @@ exports.birdProperties = [
5037
5037
  name: "reference",
5038
5038
  type: "string",
5039
5039
  default: "",
5040
- description: "An identifier you want to find this message by, such as an order or ticket number, matched exactly by the message list's `reference` filter. Set it only when you need to search on it, and put any other data in `metadata`. Stored on the message, returned on reads and echoed in webhook payloads. Several messages can share one.",
5040
+ description: "Identifier matched exactly by the message list's `reference` filter; returned on reads and webhooks. May be shared by multiple messages. Put non-searchable context in `metadata`.",
5041
5041
  },
5042
5042
  {
5043
5043
  displayName: "Sticker",
@@ -5045,14 +5045,14 @@ exports.birdProperties = [
5045
5045
  type: "collection",
5046
5046
  placeholder: "Add Field",
5047
5047
  default: {},
5048
- description: "A free-form sticker. Deliverable only inside an open customer service window.",
5048
+ description: "Free-form sticker; requires an open customer service window",
5049
5049
  options: [
5050
5050
  {
5051
5051
  displayName: "URL",
5052
5052
  name: "url",
5053
5053
  type: "string",
5054
5054
  default: "",
5055
- description: "Public `https` URL of the sticker. WhatsApp fetches it at send time, so it must still be reachable then. WebP only, up to 100 KB static or 500 KB animated.",
5055
+ description: "Public HTTPS URL fetched at send time. WebP, up to 100 KB static or 500 KB animated.",
5056
5056
  },
5057
5057
  ],
5058
5058
  },
@@ -5063,7 +5063,7 @@ exports.birdProperties = [
5063
5063
  typeOptions: { multipleValues: true },
5064
5064
  placeholder: "Add Tag",
5065
5065
  default: {},
5066
- description: "Structured `{name, value}` labels for filtering. Tags become first-class query dimensions: filter the list endpoint by tag name. Maximum 20 tags per send. Use tags for low-cardinality dimensions (`category`, `experiment_variant`). For arbitrary structured context you do not need as a filter dimension, use `metadata` instead.",
5066
+ description: "Up to 20 `{name, value}` labels, filterable by name. Use for low-cardinality dimensions such as category; put other context in `metadata`.",
5067
5067
  options: [
5068
5068
  {
5069
5069
  displayName: "Tag",
@@ -5093,21 +5093,21 @@ exports.birdProperties = [
5093
5093
  type: "collection",
5094
5094
  placeholder: "Add Field",
5095
5095
  default: {},
5096
- description: "The template to send, the only content deliverable outside the customer service window. A group takes only templates your workspace authored, outside the authentication category.",
5096
+ description: "Required outside the customer service window. Groups accept workspace-authored, non-authentication templates only.",
5097
5097
  options: [
5098
5098
  {
5099
5099
  displayName: "Bid Multiplier",
5100
5100
  name: "bid_multiplier",
5101
5101
  type: "number",
5102
5102
  default: "",
5103
- description: "Scales the language's maximum price for this message only. The effective bid is the language's `optimization_spec.bid_amount`, times its country multiplier, times this value. At least 0.01 and at most 100; 1 when omitted. Only a language with an `optimization_spec`, on a template still in the `marketing` category, accepts it.",
5103
+ description: "Multiplies `optimization_spec.bid_amount` × country multiplier for this message. Range 0.01–100; default 1. Requires `optimization_spec` on a marketing template language.",
5104
5104
  },
5105
5105
  {
5106
5106
  displayName: "Components",
5107
5107
  name: "components",
5108
5108
  type: "json",
5109
5109
  default: "",
5110
- description: "Values for the template's placeholders. Build it from the template language's `components`: each block's `example_parameters`, with real values, becomes that part's `parameters`. A template's `buttons` block becomes one `button` part per button that has `example_parameters`, in order; a `carousel` becomes one `cards` entry per card, built the same way. A `location` header always needs a part with a `location` parameter. Leave out other blocks without any.",
5110
+ description: "Copy each language component's `example_parameters` into that part's `parameters`, replacing examples with real values. Map `buttons` to one `button` part per button with examples, in order; map `carousel` to `cards`, built likewise. A location header requires a `location` parameter. Omit other blocks without examples.",
5111
5111
  },
5112
5112
  {
5113
5113
  displayName: "ID",
@@ -5121,14 +5121,14 @@ exports.birdProperties = [
5121
5121
  name: "language",
5122
5122
  type: "string",
5123
5123
  default: "",
5124
- description: "Which of the template's languages to send, as a BCP-47 tag (for example `en-US`; Meta's `en_US` is accepted too). Omit it for the template's default language, unless the template sets `language_source_required`. A language the template lacks is handled by its `on_missing_language` setting. The message is priced at the language it resolves to, which the accepted message echoes.",
5124
+ description: "BCP-47 tag (`en-US`; `en_US` also accepted). Defaults to the template's default language unless `language_source_required` is set. Missing variants follow `on_missing_language`. The resolved language determines pricing and is echoed in the accepted message.",
5125
5125
  },
5126
5126
  {
5127
5127
  displayName: "Slug",
5128
5128
  name: "slug",
5129
5129
  type: "string",
5130
5130
  default: "",
5131
- description: "The template to send, by its slug handle (for example `bird_otp`)",
5131
+ description: "Template slug, such as `bird_otp`",
5132
5132
  },
5133
5133
  ],
5134
5134
  },
@@ -5138,21 +5138,21 @@ exports.birdProperties = [
5138
5138
  type: "collection",
5139
5139
  placeholder: "Add Field",
5140
5140
  default: {},
5141
- description: "Free-form text. Deliverable only inside an open customer service window.",
5141
+ description: "Free-form text; requires an open customer service window",
5142
5142
  options: [
5143
5143
  {
5144
5144
  displayName: "Body",
5145
5145
  name: "body",
5146
5146
  type: "string",
5147
5147
  default: "",
5148
- description: "The message text. The WhatsApp client turns any URL it contains into a clickable link.",
5148
+ description: "Message text; URLs become clickable links",
5149
5149
  },
5150
5150
  {
5151
5151
  displayName: "Preview URL",
5152
5152
  name: "preview_url",
5153
5153
  type: "boolean",
5154
5154
  default: false,
5155
- description: "Whether the WhatsApp client previews the first link in `body`. Not returned when the message is read back.",
5155
+ description: "Whether to preview the first link in `body`. Omitted on reads.",
5156
5156
  },
5157
5157
  ],
5158
5158
  },
@@ -5162,14 +5162,14 @@ exports.birdProperties = [
5162
5162
  type: "collection",
5163
5163
  placeholder: "Add Field",
5164
5164
  default: {},
5165
- description: "A free-form video. Deliverable only inside an open customer service window.",
5165
+ description: "Free-form video; requires an open customer service window",
5166
5166
  options: [
5167
5167
  {
5168
5168
  displayName: "URL",
5169
5169
  name: "url",
5170
5170
  type: "string",
5171
5171
  default: "",
5172
- description: "Public `https` URL of the video. WhatsApp fetches it at send time, so it must still be reachable then. MP4 with H.264 video and AAC audio, up to 16 MB.",
5172
+ description: "Public HTTPS URL fetched at send time. MP4 with H.264 video and AAC audio, up to 16 MB.",
5173
5173
  },
5174
5174
  {
5175
5175
  displayName: "Caption",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@messagebird/n8n-nodes-bird",
3
- "version": "0.34.0",
3
+ "version": "0.34.1",
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": {