Apple Messages for Business Setup Guide

Get Started 

1. Login to the Conversation Cloud and go to the left navigation bar > Manage > Channel Setup

Channel Setup link on left navigation bar

 2. Click "Configure" on Apple Messages for Business

Configure Apple Messages for Business

 3. Click "Get Started" on the Apple Messages for Business landing page

AMB Landing Page

Step 1.A: Create Apple Business Account

1. Follow the instructions to create an AMB account on Apple Business Register site.

Create Apple Business Account Page

Step 1.B: Connector Info

1. Fill in the Connector Details: 
   1. Choose a Name for your particular AMB connector
   2. Add a Description (optional)
   3. Enter your Business ID that was created on Apple Business Register (Go to your account on Apple Business Register > Links > Copy ID)

Connector Info Page

Step 2: Configure Connector (Optional)

1. Rich Link Configuration: A rich link is a URL sent to the customer in a chat bubble that includes an image or a video preview. The suggested configuration for sending rich links is to have them automatically generated for each agent or bot message that contains a URL. For this feature to work, the website must meet the following prerequisites:

• The website is publicly available
• The website implements standard OG tags for title, description and image (specification)
• Image URLs must be absolute URLs and images are either PNGs or JPGs

2. File Sharing Configuration: This configuration enables consumers to send images or videos to the conversation. The agents can see the images or download the videos sent by consumers on the Agent Workspace. For more information, click here.

Configure Connector Page

3. Authentication Configuration: If you wish to configure authentication to your AMB connector, first you need to supply your private OAuth 2.0 service details (OAuth URL, Token URL and Client Identifier) on Apple Business Register in your account management area under "Integrated OAuth2 Authentication".

Once you supplied your Authentication details on Apple Register, you have to supply the OAuth Token URL, OAuth Client ID and Client Secret on the AMB Self Service as well to complete the configuration on both sides.

Authentication Configuration on Configure Connector Page

TODO: Add an image of Authentication Configuration

Step 3: Skill Routing (Optional)

Skill Routing is important for controlling which agents receive messages from the Apple Messages for Business channel. Creating a new skill and assigning a target skill can be done on this page, and you can add yourself and other AMB testers to the new skill under User Management > Users in the Conversational Cloud.

Skill Routing Page

Step 4.A: Test Connector

You can test your connector by scanning the QR code (iPhone only) or by clicking on the link to launch the Messages App on your Desktop (Mac only).

Test AMB Connector Page

Step 4.B: Entry Points

In this step, you get an overview of all AMB entry points. There are many options available for customers to start a conversation with a business. You can use Messages for Business buttons and URLs to meet customers in places where they are likely to contact you. You can also enable system features such as Maps or Message Suggest so that customers can start a conversation when locating a business. Plan the user experience and which entry points will be the best fit for your needs.

AMB Entry Points Page