本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 EventBridge 進行監控
<a name="monitor-event-bridge"></a>

AWS 最終使用者傳訊 SMS 會將事件傳送至 EventBridge 以進行註冊、SMS、MS 和語音事件。您可以使用 EventBridge 來撰寫採取動作的規則，例如在收到特定事件類型時通知您。如需詳細資訊，請參閱《Amazon EventBridge 使用者指南》中的下列主題：
+ [什麼是 Amazon EventBridge？](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html)
+ [Amazon EventBridge 事件](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html)
+ [Amazon EventBridge 事件模式](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html)
+ [Amazon EventBridge 規則](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)

AWS End User Messaging SMS 會將下列事件直接傳送至 EventBridge：
+ 文字訊息交付狀態已更新
+ 媒體訊息傳遞狀態已更新
+ 語音訊息傳遞狀態已更新
+ 註冊狀態變更

對於文字、媒體和語音訊息事件，下列範例中的 `detail`區段類似 [範例事件資料](configuration-sets-event-format.md)。

## 已交付簡訊的事件
<a name="event-delivered-sms-message"></a>

```
{
    "version": "0",
    "id": "5c0fa4f8-e4ba-ed02-6101-c795472fccd0",
    "detail-type": "Text Message Delivery Status Updated",
    "source": "aws.sms-voice",
    "account": "111122223333",
    "time": "2025-10-01T18:20:41Z",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "eventType": "TEXT_SUCCESSFUL",
        "eventVersion": "1.0",
        "eventTimestamp": 1759342841377,
        "isFinal": true,
        "originationPhoneNumber": "VAJZNBLLDX",
        "isoCountryCode": "ES",
        "isInternationalSend": false,
        "mcc": "214",
        "mnc": "05",
        "carrierName": "Movistar",
        "messageId": "ed23196c-75ce-4727-93ee-7bf72b64998f",
        "messageRequestTimestamp": 1759342840978,
        "messageEncoding": "GSM",
        "messageType": "TRANSACTIONAL",
        "messageStatus": "SUCCESSFUL",
        "messageStatusDescription": "Message has been accepted by phone carrier",
        "totalMessageParts": 1,
        "totalMessagePrice": 0.06087,
        "totalCarrierFee": 0.0,
        "protectConfiguration": {
            "protectConfigurationId": "protect-e06e5d722c31455286262a108e7d863d",
            "protectStatus": "ALLOW"
        }
    }
}
```

## 已傳送簡訊的事件
<a name="event-sent-sms-message"></a>

```
{
    "version": "0",
    "id": "4111946b-816c-e73a-9ea0-a8367b9d57e4",
    "detail-type": "Text Message Delivery Status Updated",
    "source": "aws.sms-voice",
    "account": "555555555555",
    "time": "2024-10-16T17:20:24Z",
    "region": "eu-west-2",
    "resources": [],
    "detail": {
        "eventType": "TEXT_SUCCESSFUL",
        "eventVersion": "1.0",
        "eventTimestamp": 1729099224788,
        "isFinal": true,
        "originationPhoneNumber": "+18445550123",
        "isoCountryCode": "US",
        "isInternationalSend": false,
        "messageId": "9539975a-e71f-45f3-b496-8d98dc098a77",
        "messageRequestTimestamp": 1729099224438,
        "messageEncoding": "GSM",
        "messageType": "PROMOTIONAL",
        "messageStatus": "SUCCESSFUL",
        "messageStatusDescription": "Message has been accepted by phone carrier",
        "totalMessageParts": 1,
        "totalMessagePrice": 0.00581,
        "totalCarrierFee": 0.00302,
        "protectConfiguration": {
            "protectConfigurationId": "protect-e06e5d722c31455286262a108e7d863d",
            "protectStatus": "ALLOW"
        }
    }
}
```

## 已傳送語音訊息的事件
<a name="event-sent-voice-message"></a>

```
{
    "version": "0",
    "id": "3bd18839-b5b4-79c5-1b18-bd6545f40566",
    "detail-type": "Voice Message Delivery Status Updated",
    "source": "aws.sms-voice",
    "account": "444455556666",
    "time": "2024-10-16T17:18:50Z",
    "region": "eu-west-2",
    "resources": [],
    "detail": {
        "eventType": "VOICE_INITIATED",
        "eventVersion": "1.0",
        "eventTimestamp": 1729099130226,
        "isFinal": false,
        "originationPhoneNumber": "+18445550123",
        "isoCountryCode": "US",
        "messageId": "1d2295bd-ac9b-4517-821f-7c6d95d789a1",
        "messageRequestTimestamp": 1729099129845,
        "messageStatus": "INITIATED"
    }
}
```

## 註冊狀態變更的事件
<a name="event-registration-status-change"></a>

AWS End User Messaging SMS 會將下列註冊狀態變更傳送至 Amazon EventBridge：

`CLOSED`, `CREATED`, `COMPLETE`, `DELETED`, `PROVISIONING`, `REQUIRES_AUTHENTICATION`, `REQUIRES_UPDATES`, `REVIEWING`, `SUBMITTED`

如需這些狀態值的定義，請參閱 AWS End User Messaging SMS API 參考中的 [RegistrationInformation](https://docs.aws.amazon.com/pinpoint/latest/apireference_smsvoicev2/API_RegistrationInformation.html)。

```
{
    "version": "0",
    "id": "d2e8812b-d34c-90f9-a8a9-3f18e15d1db9",
    "detail-type": "Registration Status Change",
    "source": "aws.sms-voice",
    "account": "111122223333",
    "time": "2025-09-26T17:42:25Z",
    "region": "us-east-1",
    "resources": ["arn:aws:sms-voice:us-east-1:111122223333:registration/registration-30a16a8b7cec478a8e37febbb9005348"],
    "detail": {
        "registrationDetails": {
            "registrationId": "registration-30a16a8b7cec478a8e37febbb9005348",
            "registrationVersionNumber": 1,
            "registrationType": "ZZ_LONG_CODE_REGISTRATION",
            "registrationStatusChangeTimestamp": 1758908543000,
            "currentStatus": "SUBMITTED"
        },
        "registrationArn": "arn:aws:sms-voice:us-east-1:111122223333:registration/registration-30a16a8b7cec478a8e37febbb9005348"
    }
}
```