Setting up Apple Business Chat account to allow sending messages

Before you start sending tests messages to your Apple Business Chat Account, you will need access to the following:

  • An Apple device running iOS 11.3 and later or macOS 10.13.4 and later.
  • An organization registered and approved in the Apple Business Register.
  • An account with permissions to create a Business Chat Account (BCA) and connect to a Messaging Service Provider (MSP) in this organization.

Create an Apple Business Chat Account

If you don't have an organization:

  1. Log in to the Apple Business Register.
  2. Click Manage Connections. Manage Connections
  3. In "Business Chat Accounts" click Add. Add Business Chat Accounts
  4. Go to the Home page and click Business Chat Accounts. Business Chat Accounts
  5. Click Add new and then Get start. Get Start
  6. After checking all checkbooks for the Apple policies. Click in next.
  7. In the overview page, click Next.
  8. In the Account Applicant, fill the form with the information about your business.
  9. In the Business Chat Account Type, you can choose if it's a commercial account or an internal test account. Its recommend that if it's your first account, to be internal test account. For this, click in advanced and then mark the box for Internal Test Account.
  10. In Account Contacts, fill with the Technical Contact for your Organization.
  11. In the overview page, click Next.
  12. In the Message Service Provider Configuration, in the "Apple authorized commercial messaging service provider" you can select the Sinch MSP EU or Sinch MSP US depending on which app region is going to be used, then, click Next. ABC MSP Configuration
  13. In the Tester Apple ID page, you need to add testers Apple ID for you Apple Business Chat account. Click Add Apple IDs and fill the form.
  14. After this, in the profile page you need to sent your profile to Review and wait to be approved.

If you already have a Business Chat Account:

  1. In your Home in the Apple Business Register, click Business Chat Accounts under Your Connections. Apple Register
  2. In this new page called Business Chat Accounts, click your Account. Apple Register
  3. In the Message Service Provider section, click Edit. Apple Register
  4. In the Message Service Provider Configuration, in the "Apple authorized commercial messaging service provider" you can select the Sinch MSP EU or Sinch MSP US depending on which app region is going to be used, then, click Next. Apple Register

Connecting your Apple Business Chat account with Conversation API

Access the Sinch Dashboard and do the following steps:

  1. Click Conversation API. Sinch Dashboard
  2. On the left side of the page, click Apps.
  3. In this new page, click NEW APP and fill the Display Name and Region which the App will be located.
  4. Click Go to App or in the Conversation apps page, click the name of your app.
  5. In this new page, in the "Setup Channels" section click Apple Business Chat SET UP CHANNEL.
  6. In this page, you need to put your Business Chat Account ID. This information you can find in your Messages For Business Accounts section in your Apple Register. a. In your account, inside the Messaging Service Provider section, click in Test your Messaging Service Provider connection. b. In this new page, copy the Business Account ID.
  7. Copy the BCA-ID and click SAVE.

Removing Apple Business Chat Integration

Because of Apple Business Chat creation process, you can't remove a MSP, only change it to another.

  1. In your Organization Page, click Business Chat Accounts.
  2. In this new page, click your Business Chat Account.
  3. In the Message Service Provider section of your profile page, click Edit.
  4. Change the MSP.

Or you can reset your integration with the ABC in your APP:

In the Sinch Dashboard, do the following:

  1. Click Apps under Conversation API menu.
  2. Select the name of the app you created with the Sinch MSP.
  3. Click the Apple Business Chat Integration. Dashboard Webhook
  4. In this page, click RESET INTEGRATION and confirm your choice. Dashboard Reset Integration