View a markdown version of this page

接收流程回應和狀態變更 - AWS最終使用者傳訊社交
流程回應訊息流程狀態變更通知流程版本過期警告

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

接收流程回應和狀態變更

當使用者完成流程或流程狀態變更時，AWS最終使用者傳訊社交會透過您現有的設定事件目的地傳送 Webhook 通知。不需要額外的設定或新的事件類型 — 流程事件會自動交付到您用於訊息和交付收據的相同事件目的地。您必須啟用事件目的地才能接收這些通知。如需詳細資訊，請參閱將訊息和事件目的地新增至 AWS 最終使用者傳訊社交。

流程回應訊息

當使用者完成流程時，您會收到輸入訊息，其中包含 類型interactive和 子類型 nfm_reply。response_json 欄位包含使用者以 JSON 字串提交的資料。

下列範例顯示流程回應 Webhook 承載：

{
    "messages": [
        {
            "from": "14085551234",
            "id": "wamid.XXX",
            "timestamp": "1234567890",
            "type": "interactive",
            "interactive": {
                "type": "nfm_reply",
                "nfm_reply": {
                    "response_json": "{\"name\":\"John Doe\",\"email\":\"john@example.com\",\"phone\":\"+14085551234\"}",
                    "body": "Sent",
                    "name": "flow"
                }
            }
        }
    ]
}

response_json 包含對應於 Flow JSON 中定義之表單欄位名稱的鍵/值對，以及使用者輸入的值。剖析此 JSON 字串以擷取提交的資料。

流程狀態變更通知

當中繼變更流程的狀態時 （例如，從 PUBLISHED 變更為 BLOCKED)，您會透過事件目的地收到通知。下列範例顯示狀態變更承載：

{
    "entry": [
        {
            "id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
            "changes": [
                {
                    "value": {
                        "event": "FLOW_STATUS_CHANGE",
                        "flow_id": "{FLOW_ID}",
                        "old_status": "PUBLISHED",
                        "new_status": "BLOCKED",
                        "reason": "Policy violation detected"
                    },
                    "field": "flows"
                }
            ]
        }
    ]
}

監控這些狀態變更事件，以偵測中繼區塊或調節流程的時間，讓您可以採取修正動作。

流程版本過期警告

當流程使用的 Flow JSON 版本接近其end-of-life時，中繼會傳送警告 Webhook。當版本過期時，您必須先更新至較新的版本，才能傳送流程。

{
    "entry": [
        {
            "id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
            "changes": [
                {
                    "value": {
                        "event": "FLOW_VERSION_EXPIRY_WARNING",
                        "flow_id": "{FLOW_ID}",
                        "warning": "Your current Flow version will freeze in 21 days. You won't be able to send the Flow after it expires. Please migrate to the recommended version as soon as possible."
                    },
                    "field": "flows"
                }
            ]
        }
    ]
}

當您收到此警告時，透過UpdateWhatsAppFlowAssets呼叫更新後的 JSON 來更新 Flow JSON 以使用建議的版本 （目前為 7.3)，然後重新發佈 Flow。