Sign inGet Started

Update Apple Messages for Business channel settings

PATCH
/v1/amb/businesses/{business_id}/channel-settings
const result = await bird.amb.businesses.settings.update(
  "abz_01krdgeqcxet5s7t44vh8rt9mg",
  { brand_name: "Acme Support", logo_asset_id: null },
);
console.log(result);
प्रतिक्रिया200
{
  "entry_points": [
    {
      "id": "website-footer",
      "group": "support",
      "intent": "general-inquiry",
      "body": "Hi, I have a question about my order."
    }
  ],
  "default_locale": "en-US",
  "brand_name": "Acme Retail",
  "logo_asset_id": "ast_01krdgeqcxet5s7t44vh8rt9mg"
}
Changes the channel settings for your workspace's Apple Messages for Business record. Fields you omit are left as they are, except entry_points: sending it replaces the entire set, since there is no way to add or remove a single entry point without resending the rest.
पैरामीटर
business_id
string
ID of the Apple Messages for Business record, as returned by the business list.
Request Payload
entry_points
array of object
The entry points customers can use to open a conversation with this business. Sending this replaces the entire set; there is no way to add or remove a single entry point without resending the rest.
चाइल्ड पैरामीटर दिखाएँ
entry_points.id
string
आवश्यक
Identifier for this entry point, chosen by you and unique within the business's entry points. A conversation opened through this entry point carries it as entry_point.
entry_points.group
string
आवश्यक
The group value Apple reports on a conversation opened through this entry point. Matched against the group the first inbound message carries.
entry_points.intent
string
आवश्यक
The intent value Apple reports on a conversation opened through this entry point. Matched against the intent the first inbound message carries, together with group.
entry_points.body
string
आवश्यक
The message text pre-filled for the customer when they open a conversation through this entry point.
default_locale
nullable string
The locale used for this business when a conversation reports none of its own, in BCP-47 form. Omit this field to keep the current default, or send null to clear it. Bird converts a configured default to Apple's locale form when sending a message without a conversation locale.
brand_name
string
The brand name shown on the Bird-hosted landing page customers use to connect this business.
logo_asset_id
nullable string
The business's logo, as an asset in your media library. Send null to clear it.
Response Payload
entry_points
array of object
आवश्यक
The entry points customers can use to open a conversation with this business, each matched against the group and intent an inbound message reports.
चाइल्ड एट्रिब्यूट दिखाएँ
entry_points.id
string
आवश्यक
Identifier for this entry point, chosen by you and unique within the business's entry points. A conversation opened through this entry point carries it as entry_point.
entry_points.group
string
आवश्यक
The group value Apple reports on a conversation opened through this entry point. Matched against the group the first inbound message carries.
entry_points.intent
string
आवश्यक
The intent value Apple reports on a conversation opened through this entry point. Matched against the intent the first inbound message carries, together with group.
entry_points.body
string
आवश्यक
The message text pre-filled for the customer when they open a conversation through this entry point.
default_locale
nullable string
The locale used for this business when a conversation reports none of its own, in canonical BCP-47 form. Null until you set one or after you clear it. Bird converts a configured default to Apple's locale form when sending a message without a conversation locale.
brand_name
string
आवश्यक
The brand name shown on the Bird-hosted landing page customers use to connect this business.
logo_asset_id
nullable string
आवश्यक
The business's logo, as an asset in your media library. Null until one is set, either from Apple's own redirect or from a later change here.

संबंधित संसाधन

इस विषय के लिए डॉक्यूमेंटेशन, गाइड और उदाहरणों के साथ आगे बढ़ें। संसाधन अंग्रेज़ी में हैं।

इम्प्लीमेंटेशन ब्रीफ़ पाएँ