Apple Messages for Business

For service requests, users initiate a conversation and will reach out to you. To link incoming messages to your outbound messages, the from/to field is used with an Apple Messages for Business-identifier value.

An Apple Messages for Business-identifier or the 'Opaque user identifier' as Apple calls it, is a string of alpha numerical characters that you have received as the from address in an incoming message. This is the only information you have about a user on the Apple platform. You do not receive the name, profile image, location or anything else the user has not shared themselves within conversation. It is possible, but not necessary, that you will receive a UUID as an end-user identifier. This identifier is mapped in the CM.com platform.

Apple Messages for Business supports receiving text messages and receiving media messages.

Apple Messages for Business intent and group values identifiers

It is possible to define intent, group and body parameters in the link that is presented to end-users to start the conversation. These values will be forwarded to your webhook. Intent and group can be used to route traffic directly to the appropriate actions or persons. read more

Do note that the intent and group will only be sent in the first message of the conversation.

{
    "reference": "515836577",
    "messageContext": "",
    "from": {
        "number": "6f2de4d4cc6aa17da2e11c3bff5843aa",
        "name": ""
    },
    "to": {
        "number": "00iMsg20241c26-f863-4faf-8bb2-ad4213641caa"
    },
    "message": {
        "text": "Hi",
        "media": {
            "mediaUri": "",
            "contentType": "",
            "title": ""
        },
        "custom": {
            "MESSAGETYPE": "Text",
            "INTENT": "apidocs",
            "GROUP": "techsupport"
        }
    },
    "groupings": [
        "",
        "",
        ""
    ],
    "time": "2021-05-19 15:42:28",
    "timeUtc": "2021-05-19T13:42:28",
    "channel": "Apple Messages for Business"
}

Apple Messages for Business List picker or time picker response

When using a list or time picker, the label of the selected element will be sent as text in the response.

{
    "reference": "515836578",
    "messageContext": "",
    "from": {
        "number": "6f2de4d4cc6aa17da2e11c3bff5843aa",
        "name": ""
    },
    "to": {
        "number": "00iMsg20241c26-f863-4faf-8bb2-ad4213641caa"
    },
    "message": {
        "text": "Ace of Spades",
        "media": {
            "mediaUri": "",
            "contentType": "",
            "title": ""
        },
        "custom": {
            "MESSAGETYPE": "Text"
        }
    },
    "groupings": [
        "",
        "",
        ""
    ],
    "time": "2021-05-19 16:04:45",
    "timeUtc": "2021-05-19T14:04:45",
    "channel": "Apple Messages for Business"
}

Apple Messages for Business Closing the conversation

Conversations in Apple Messages for Business remain active for use as long as the end user does not close the conversation. When that does happen you will receive a 'Close' message and are no longer allowed or able to send messages to this user.

{
    "reference": "515836576",
    "messageContext": "",
    "from": {
        "number": "6f2de4d4cc6aa17da2e11c3bff5843aa",
        "name": ""
    },
    "to": {
        "number": "00iMsg20241c26-f863-4faf-8bb2-ad4213641caa"
    },
    "message": {
        "text": "CLOSE_CONVERSATION",
        "media": {
            "mediaUri": "",
            "contentType": "",
            "title": ""
        },
        "custom": {
            "MESSAGETYPE": "Close"
        }
    },
    "groupings": [
        "",
        "",
        ""
    ],
    "time": "2021-05-19 17:04:45",
    "timeUtc": "2021-05-19T15:04:45",
    "channel": "Apple Messages for Business"
}

Apple Messages for Business Other

It is also possible to make a payment using Apple Pay. Setting this up requires some custom work and we therefor ask you to contact our support team.

If you have your own app and want to have your own Apple Messages for Business integrations than this is possible as well. Again, please contact our support team.