Add Apple Messages for Business features - Amazon Connect

Add Apple Messages for Business features

Deflect calls with Apple’s Message Suggest

With Message Suggest you can allow users to choose between voice and messaging when tapping on your business phone number in Safari, Maps, Siri, or Search.

To enable Message Suggest, send an email to the Apple Messages for Business Team at with the following information and Apple can set up the channel for you:

  • Provide all of your primary phone numbers, including high call volume phone numbers.

  • Provide phone contact hours to set customer expectations for your after-hours message.

  • Provide intent, group, and body parameters to associate with each phone number.

  • Provide an estimate of how many customers your agents can support per day. This can be increased or decreased depending on operational capacity.

To learn more about enabling Message Suggest, see Apple’s Message Suggest FAQs.

Embed Apple Messages for Business buttons

To embed Apple Messages for Business buttons on your website or mobile app, do the following:

  1. Add Apple’s Messages for Business JS (JavaScript) library to your webpage headers.

  2. Add a div container to house the button.

  3. Customize the banner, fallback support, and button color to meet your brand’s needs.

The Messages for Business button must contain the following, at minimum:

  • A class attribute to specify the type of container: banner, phone, or message. For more information, see Messages for Business Button Class and Data.

  • A data-apple-business-id attribute with the business ID you received when you registered your company with Messages for Business.

For information about how you can enable these buttons, see Apple’s documentation for Adding a Messages for Business Button to Your Website.

Start a chat from a URL

You can give your customers the ability to start a conversation with you from your website or an email message.

For example, customers may start a chat using a URL that you provide. When they click the URL, the system redirects them to Messages so they can send your business a text message.

You decide how and where to provide the URL. You can include it as a link in an email message, on your website, or use it as the action for a button in your app.

Use the URL, replacing your-business-id with the business ID you received from Apple after registering with Messages for Business.

Following are optional query string parameters you can include in the URL:

  • biz-intent-id: Use to specify the intention, or purpose, of the chat.

  • biz-group-id: Use to indicate the group, department, or individuals best qualified to handle the customer's specific question or problem.

  • body: Use to prepopulate the message so the customer only presses Send to start the conversation.

For more information, see About Intent, Group, and Body Values on the Apple Documentation website.

Following is an example of what the URL might look like for a customer with a credit card question question for the billing department:


Add list pickers and time pickers

A list picker prompts your customer to select an item, such as a product or the reason for their inquiry. A time picker prompts your customer to choose an available time slot, such as to schedule an appointment.

For information about how to set up list pickers and time pickers, see Add interactive messages to chat.

Rich links show an inline preview of a URL that contains an image. Unlike normal URLs, customers can view the image immediately in a chat without choosing a "Tap to Load Preview" message.

To learn more about Apple Messages for Business rich links, see Rich Links on the Apple Developer website.

To use rich links in Amazon Connect chat messages, your URL and images must meet the following requirements:

  • Your website must use Facebook Open Graph tags. For more information, see A Guide to Sharing for Webmasters.

  • The image accompanying the URL must be .jpeg, .jpg, or .png.

  • The website must be HTML.


When you first use the rich link feature, we recommend that you send the URL in a message separate from your chat text, as shown in the following example.

Use Apple Messages for Business contact attributes in contact flows

Contact attributes enable you to store temporary information about the contact so you can use it in the flow.

For example, if you have different lines of business using Apple Messages for Business, you can branch to different flows based on the AppleBusinessChatGroup contact attribute. Or, if you want to route Apple Messages for Business messages differently from other chat messages, you can branch based on MessagingPlatform.

For more information about contact attributes, see Use Amazon Connect contact attributes.

Use the following contact attributes to route Apple Messages for Business customers.

Attribute Description Type JSON


The messaging platform from where the customer request originated.

Exact value: AppleBusinessChat

User-defined $.Attributes.MessagingPlatform


The customer’s opaque ID provided by Apple. This remains constant for the AppleID and a business. You can use this to identify if the message is from a new customer or a returning customer.

User-defined $.Attributes.AppleBusinessChatCustomerId


You can define the intent or purpose of the chat. This parameter is included in a URL that initiates a chat session in Messages when a customer chooses the Business Chat button.

User-defined $.Attributes.AppleBusinessChatIntent


You define the group which designates the department or individuals best qualified to handle the customer’s particular question or problem. This parameter is included in a URL that initiates a chat session in Messages when a customer chooses the Business Chat button.

User-defined $.Attributes.AppleBusinessChatGroup


Defines the language and AWS Region preferences that the user wants to see in their user interface. It consists of a language identifier (ISO 639-1) and a Region identifier (ISO 3166). For example, en_US.

User-defined $.Attributes.AppleBusinessChatLocale