文件Journey OptimizerJourney Optimizer 指南

建立 Webhook webhook

最後更新： 2026年9月13日

建立對象：

  • Intermediate
  • Admin

在此頁面上：​瞭解如何在Adobe Journey Optimizer中建立傳入和回饋簡訊Webhook，以擷取Sinch、Infobip和自訂提供者的選擇加入和選擇退出同意回應以及傳遞事件。

style
shade-box

在Journey Optimizer中建立新API認證時，SMS webhook現在可讓您擷取傳入關鍵字和意見回饋事件，例如傳送和錯誤。 由於每個提供者都有不同的功能，因此有不同的指示可啟用Webhook。
有了webhook現在支援自訂提供者，現在可以從任何提供者收集意見回饋和傳入關鍵字集合，以在Journey Optimizer中報告和採取行動。

  • 新客戶：​您可以依照這裡的指示正確設定SMS webhook。

  • 現有客戶：​您可以從API認證中儲存的資訊移轉至Webhook，而且沒有客戶移轉的時間表。 若現有客戶確實想要移轉至SMS Webhook，則需要依照移轉指南中的紀錄執行移轉步驟。

style
shade-box

概觀 overview

成功建立API認證後，您現在可以設定Webhook以擷取傳入回應，用於管理選擇加入和選擇退出同意，並接收傳遞報表，包括可用的讀取回條。

設定webhook時，您可以根據要擷取的資料型別定義其用途：

  • 傳入：如果您想要擷取同意回應（例如加入或退出），並收集使用者偏好設定，請使用此選項。

  • 回饋：選擇此選項可追蹤傳遞和參與事件，包括傳遞、傳出錯誤、讀取回條（如果適用），以支援報告和分析。

NOTE
傳入關鍵字資料會儲存在​_AJO電子郵件追蹤資料集_​系統資料集中，除非已設定自訂資料集。 在擷取傳入的訊息之前，設定檔必須至少有一個從Journey Optimizer傳送的訊息。 了解更多
IMPORTANT
如果您定義自訂選擇加入、選擇退出、說明或雙重選擇加入關鍵字，這些關鍵字會覆寫Adobe Journey Optimizer的預設傳入關鍵字。 若要讓預設值維持正常運作，請明確將其新增至自訂關鍵字旁。 進一步瞭解選擇退出管理

根據您的提供者，對於需要設定才能成功實作SMS的內容，會有不同的期望：

  • Sinch與Sinch交談：建立一個webhook，以處理傳入與回饋事件。 不需要任何裝載設定。

  • Infobip：建立兩個個別的Webhook，一個用於傳入事件，另一個用於意見反應事件。 任一webhook均不需要任何裝載設定。

  • Twilio：無法使用Webhook。 不支援傳入和意見回饋資料收集。

  • 自訂提供者：建立兩個個別的Webhook，一個用於傳入事件，另一個用於意見反應事件。 兩個Webhook都需要裝載設定才能正常運作。

提供者支援 provider-support

NOTE
唯一支援的webhook格式為JSON。 不支援Webhook的Form-data。

下表顯示哪些提供者支援傳入和意見回饋Webhook，以及是否需要建立裝載：

提供者
傳入Webhook
Webhook意見反應
關鍵字
需要建立裝載
需要Webhook
建立裝載
Infobip
可設定
可設定
可設定
非必要
必要
非必要
Sinch
可設定
可設定
可設定
非必要
不會。 整合
不適用
Sinch對話
可設定
可設定
可設定
非必要
不會。 整合
不適用
Twilio
無法使用
無法使用
無法使用
無法使用
無法使用
不適用
自訂
可設定
可設定
可設定
必要
必要
必要

對於從API憑證移轉至SMS webhook的客戶，移轉路徑的相關資訊可在移轉指南中找到。

建立webhook

適用於Sinch與Sinch對話 create-webhook-sinch

對於Sinch和Sinch Conversational，請建立單一webhook來處理傳入和意見反應事件。 不需要自訂裝載設定。

  1. 在左側邊欄中，瀏覽至​管理 > 管道，選取​ 簡訊設定 ​下的​ 簡訊Webhook ​功能表，然後按一下​ 建立Webhook ​按鈕。

  2. 設定您的webhook設定，如下所述：

    • 名稱：輸入webhook的名稱。

    • 選取SMS供應商： Sinch或Sinch Conversational。

    • API認證：從下拉式清單中選擇您先前設定的API認證。

    • 寄件者電話號碼：輸入您要用於通訊的寄件者電話號碼。

  3. 在​ 輸入關鍵字 ​欄位中輸入關鍵字，開始設定輸入關鍵字。 可以新增及移除多個關鍵字。 請注意，關鍵字不區分大小寫。

  4. 從​ 傳入關鍵字類別 ​下拉式清單中選取關鍵字類別，以設定：

    accordion
    選擇加入

    • 啟用經使用者同意選擇加入使用者的關鍵字。 當使用者的訊息符合設定的關鍵字時，其電話號碼會選擇加入以接收SMS訊息。

    • 預設會啟用下列關鍵字：「訂閱」、「是」、「取消停止」、「繼續」、「繼續」和「開始」。 按一下 以移除任何預設關鍵字。

    • 使用​ 回複訊息 ​欄位建立當使用者的傳入訊息符合選擇加入關鍵字時，會自動傳送的訊息。
    accordion
    選擇退出

    • 啟用選擇退出使用者並移除同意傳送行動訊息的關鍵字。 當使用者的訊息符合設定的關鍵字時，其電話號碼會選擇退出接收簡訊。

    • 預設會啟用下列關鍵字： Stop、Quit、Cancel、End、Unsubscribe、No。 按一下 以移除任何預設關鍵字。

    • 使用​ 回複訊息 ​欄位建立當使用者的傳入訊息符合選擇退出關鍵字時，會自動傳送的訊息。

    • 啟用​ 模糊邏輯 ​以偵測與已設定之選擇退出關鍵字相似的關鍵字。 如果使用者的回應接近但不完全相同，則會傳送在​ 模糊自動回應 ​欄位中輸入的訊息。 通常，此訊息會指出未發生選擇退出，並指定取消訂閱所需的確切關鍵字。
    accordion
    雙重選擇加入

    • 啟用雙重選擇加入要求的關鍵字。 當使用者的訊息符合已設定的關鍵字時，他們在此階段未完全選擇加入。 此兩步驟同意工作流程會要求使用者使用第二個關鍵字確認其選擇加入。

    • 使用​ 回複訊息 ​欄位建立符合雙重選擇加入關鍵字時自動傳送的訊息。 此訊息會指示使用者輸入選擇加入關鍵字，以完成選擇加入程式。
    accordion
    說明

    • 啟用在請求說明時提供標準回應的關鍵字。 當使用者的訊息符合設定的關鍵字時，他們將會收到「說明」回複訊息。

    • 預設會啟用下列關鍵字：「說明」、「資訊」、「資訊」。 按一下 以移除任何預設關鍵字。

    • 使用​ 回複訊息 ​欄位建立當使用者的傳入訊息符合Help關鍵字時自動傳送的訊息。
    accordion
    自訂

    • 設定單一自訂關鍵字。 當使用者的訊息符合此關鍵字時，該關鍵字會寫入​ 訊息意見追蹤 ​資料集，以用於報告和建立對象。

    • 建立參照此關鍵字的對象（串流或批次），以用於您的歷程和行銷活動。

  5. 輸入​預設回複訊息。 當使用者的回應不符合任何已設定的關鍵字時，會自動傳送此訊息。

  6. 按一下​ 提交 ​以儲存您的webhook設定。

  7. 您可以從​ Webhooks ​功能表編輯或刪除現有的Webhook。

  8. 存取您新建立的Webhook並複製​Webhook URL。

  9. 使用您的​ Webhook URL ​啟用​ 意見回應 ​和​ 傳入 ​活動以進入Journey Optimizer。

如果您的webhook使用附加到現有頻道設定的API認證，webhook將立即生效。 否則，請建立新的頻道設定。

➡️進一步瞭解通道設定

針對Infobip create-webhook-infobip

針對Infobip，建立兩個個別的Webhook：一個用於意見反應事件，另一個用於傳入事件。

  1. 在左側邊欄中，瀏覽至​管理 > 管道，選取​ 簡訊設定 ​下的​ 簡訊Webhook ​功能表，然後按一下​ 建立Webhook ​按鈕。

  2. 設定您的webhook設定，如下所述：

    • 名稱：輸入webhook的名稱。

    • 選取SMS供應商： Infobip。

    • 型別：選擇意見反應或傳入。 您需要分別建立這兩個專案，我們從傳入開始。

    • API認證：從下拉式清單中選擇您先前設定的API認證。

    • 寄件者電話號碼：輸入您要用於通訊的寄件者電話號碼。

  3. 在​ 輸入關鍵字 ​欄位中輸入關鍵字，開始設定輸入關鍵字。 可以新增及移除多個關鍵字。 請注意，關鍵字不區分大小寫。

  4. 從​ 傳入關鍵字類別 ​下拉式清單中選取關鍵字類別，以設定：

    accordion
    選擇加入

    • 啟用經使用者同意選擇加入使用者的關鍵字。 當使用者的訊息符合設定的關鍵字時，其電話號碼會選擇加入以接收SMS訊息。

    • 預設會啟用下列關鍵字：「訂閱」、「是」、「取消停止」、「繼續」、「繼續」和「開始」。 按一下 以移除任何預設關鍵字。

    • 使用​ 回複訊息 ​欄位建立當使用者的傳入訊息符合選擇加入關鍵字時，會自動傳送的訊息。
    accordion
    選擇退出

    • 啟用選擇退出使用者並移除同意傳送行動訊息的關鍵字。 當使用者的訊息符合設定的關鍵字時，其電話號碼會選擇退出接收簡訊。

    • 預設會啟用下列關鍵字： Stop、Quit、Cancel、End、Unsubscribe、No。 按一下 以移除任何預設關鍵字。

    • 使用​ 回複訊息 ​欄位建立當使用者的傳入訊息符合選擇退出關鍵字時，會自動傳送的訊息。

    • 啟用​ 模糊邏輯 ​以偵測與已設定之選擇退出關鍵字相似的關鍵字。 如果使用者的回應接近但不完全相同，則會傳送在​ 模糊自動回應 ​欄位中輸入的訊息。 通常，此訊息會指出未發生選擇退出，並指定取消訂閱所需的確切關鍵字。
    accordion
    雙重選擇加入

    • 啟用雙重選擇加入要求的關鍵字。 當使用者的訊息符合已設定的關鍵字時，他們在此階段未完全選擇加入。 此兩步驟同意工作流程會要求使用者使用第二個關鍵字確認其選擇加入。

    • 使用​ 回複訊息 ​欄位建立符合雙重選擇加入關鍵字時自動傳送的訊息。 此訊息會指示使用者輸入選擇加入關鍵字，以完成選擇加入程式。
    accordion
    說明

    • 啟用在請求說明時提供標準回應的關鍵字。 當使用者的訊息符合設定的關鍵字時，他們將會收到「說明」回複訊息。

    • 預設會啟用下列關鍵字：「說明」、「資訊」、「資訊」。 按一下 以移除任何預設關鍵字。

    • 使用​ 回複訊息 ​欄位建立當使用者的傳入訊息符合Help關鍵字時自動傳送的訊息。
    accordion
    自訂

    • 設定單一自訂關鍵字。 當使用者的訊息符合此關鍵字時，該關鍵字會寫入​ AJO電子郵件追蹤 ​資料集，以用於報告和建立受眾。

    • 建立參照此關鍵字的對象（串流或批次），以用於您的歷程和行銷活動。

  5. 輸入​預設回複訊息。 當使用者的回應不符合任何已設定的關鍵字時，會自動傳送此訊息。

  6. 按一下​ 提交 ​以儲存您的webhook設定。

  7. 在​ Webhooks ​功能表中，您現在需要為Infobip建立​意見回饋 webhook。

  8. 設定您的webhook設定，如下所述：

    • 名稱：輸入webhook的名稱。

    • 選取SMS供應商： Infobip。

    • 型別：選擇意見反應。

  9. 按一下​ 提交 ​以儲存您的意見回饋webhook設定。

  10. 您可以從​ Webhooks ​功能表編輯或刪除現有的Webhook。

  11. 存取您新建立的Webhook，並從每個Webhook複製​Webhook URL。

  12. 您現在可以使用這些URL來啟用回呼URL，以將意見回饋和傳入事件帶入Journey Optimizer。

如果您的webhook使用附加到現有頻道設定的API認證，webhook將立即生效。 否則，請建立新的頻道設定。

➡️進一步瞭解通道設定

自訂提供者 create-webhook-custom

針對自訂SMS提供者，建立兩個個別的Webhook：一個用於意見反應事件，另一個用於傳入事件。

  1. 在左側邊欄中，瀏覽至​管理 > 管道，選取​ 簡訊設定 ​下的​ 簡訊Webhook ​功能表，然後按一下​ 建立Webhook ​按鈕。

  2. 設定您的webhook設定，如下所述：

    • 名稱：輸入webhook的名稱。

    • 選取簡訊供應商：自訂。

    • 型別：選擇意見反應或傳入。 您需要分別建立這兩個專案，我們從傳入開始。

    • API認證：從下拉式清單中選擇您先前設定的API認證。

    • 寄件者電話號碼：輸入您要用於通訊的寄件者電話號碼。

  3. 在​ 輸入關鍵字 ​欄位中輸入關鍵字，開始設定輸入關鍵字。 可以新增及移除多個關鍵字。 請注意，關鍵字不區分大小寫。

  4. 從​ 傳入關鍵字類別 ​下拉式清單中選取關鍵字類別，以設定：

    accordion
    選擇加入

    • 啟用經使用者同意選擇加入使用者的關鍵字。 當使用者的訊息符合設定的關鍵字時，其電話號碼會選擇加入以接收SMS訊息。

    • 預設會啟用下列關鍵字：「訂閱」、「是」、「取消停止」、「繼續」、「繼續」和「開始」。 按一下 以移除任何預設關鍵字。

    • 使用​ 回複訊息 ​欄位建立當使用者的傳入訊息符合選擇加入關鍵字時，會自動傳送的訊息。
    accordion
    選擇退出

    • 啟用選擇退出使用者並移除同意傳送行動訊息的關鍵字。 當使用者的訊息符合設定的關鍵字時，其電話號碼會選擇退出接收簡訊。

    • 預設會啟用下列關鍵字： Stop、Quit、Cancel、End、Unsubscribe、No。 按一下 以移除任何預設關鍵字。

    • 使用​ 回複訊息 ​欄位建立當使用者的傳入訊息符合選擇退出關鍵字時，會自動傳送的訊息。

    • 啟用​ 模糊邏輯 ​以偵測與已設定之選擇退出關鍵字相似的關鍵字。 如果使用者的回應接近但不完全相同，則會傳送在​ 模糊自動回應 ​欄位中輸入的訊息。 通常，此訊息會指出未發生選擇退出，並指定取消訂閱所需的確切關鍵字。
    accordion
    雙重選擇加入

    • 啟用雙重選擇加入要求的關鍵字。 當使用者的訊息符合已設定的關鍵字時，他們在此階段未完全選擇加入。 此兩步驟同意工作流程會要求使用者使用第二個關鍵字確認其選擇加入。

    • 使用​ 回複訊息 ​欄位建立符合雙重選擇加入關鍵字時自動傳送的訊息。 此訊息會指示使用者輸入選擇加入關鍵字，以完成選擇加入程式。
    accordion
    說明

    • 啟用在請求說明時提供標準回應的關鍵字。 當使用者的訊息符合設定的關鍵字時，他們將會收到「說明」回複訊息。

    • 預設會啟用下列關鍵字：「說明」、「資訊」、「資訊」。 按一下 以移除任何預設關鍵字。

    • 使用​ 回複訊息 ​欄位建立當使用者的傳入訊息符合Help關鍵字時自動傳送的訊息。
    accordion
    自訂

    • 設定單一自訂關鍵字。 當使用者的訊息符合此關鍵字時，該關鍵字會寫入​ 訊息意見追蹤 ​資料集，以用於報告和建立對象。

    • 建立參照此關鍵字的對象（串流或批次），以用於您的歷程和行銷活動。

  5. 輸入​預設回複訊息。 當使用者的回應不符合任何已設定的關鍵字時，會自動傳送此訊息。

  6. 建立與來自提供者的JSON相符的自訂裝載。 請注意，唯一支援的webhook格式為JSON。 不支援Webhook的Form-data。

    傳入webhook需要下列欄位，才能從提供者的webhook接收值：

    • InboundMessage：從使用者收到的傳入訊息或關鍵字。
    • ProfileNumber：傳送訊息之使用者的電話號碼。
    • RequestID：您的SMS提供者提供的唯一識別碼，用於識別特定交易。
    • OriginTimestamp：收到訊息時的時間戳記（UTC格式）。
    • InboundNumber：用於此Webhook設定的電話號碼。
    note tip
    TIP
    開啟​安裝指南，以取得範例JSON裝載和逐步指南。

  7. 建立JSON檔案時，請按一下​檢視裝載編輯器，然後將JSON裝載複製並貼到編輯器並儲存。

  8. 按一下​ 提交 ​以儲存您的webhook設定。

  9. 在​ Webhooks ​功能表中，您現在需要為自訂提供者建立​意見回饋 webhook。

  10. 設定您的webhook設定，如下所述：

    • 名稱：輸入webhook的名稱。

    • 選取簡訊供應商：自訂。

    • 型別：選擇意見反應。

  11. 從您的提供者建立符合JSON格式的自訂裝載。 請注意，唯一支援的webhook格式為JSON。 不支援Webhook的Form-data。

    意見回饋webhook需要下列欄位來接收來自提供者webhook的值：

    • 使用者端參考：在承載中傳回的唯一識別碼，以供記錄之用。
    • 代碼：您的SMS提供者提供的失敗代碼。
    • 狀態：您的SMS提供者提供的失敗狀態。
    accordion
    裝載範例
    code language-json 
    {
"clientReference": "\{\{client_reference\}\}",
"statuses": [
    {
        "code": "\{\{failureCode\}\}",
        "status": "\{\{feedbackStatus\}\}"
    }
]
}

  12. 按一下「檢視裝載編輯器」，然後將您的JSON裝載複製並貼到編輯器並儲存。

  13. 按一下​ 提交 ​以儲存您的意見回饋webhook設定。

  14. 您可以從​ Webhooks ​功能表編輯或刪除現有的Webhook。

  15. 存取您新建立的Webhook，並從每個Webhook複製​Webhook URL。

  16. 設定簡訊提供者將​ 意見反應 ​和​ 傳入 ​事件傳送至Journey Optimizer中的這些webhook URL。

    設定指示因SMS提供者而異。 如需設定回撥URL的詳細資訊，請參閱提供者的檔案。

如果您的webhook使用附加到現有頻道設定的API認證，webhook將立即生效。 否則，請建立新的頻道設定。

➡️進一步瞭解通道設定

AI Knowledge Reference

This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.

For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.

  • TL;DR: This page explains how to create inbound and feedback SMS webhooks in Adobe Journey Optimizer to capture opt-in and opt-out consent responses and delivery events for Sinch, Sinch Conversational, Infobip, and custom providers.

Intents:

  • Create an SMS webhook to capture inbound consent responses and user preferences
  • Create a feedback webhook to track delivery and engagement events
  • Configure inbound keyword categories such as Opt-In, Opt-Out, Double Opt-In, Help, and Custom
  • Configure custom JSON payloads for a custom provider’s inbound and feedback webhooks
  • Copy the webhook URL to bring inbound and feedback events into Journey Optimizer

Glossary:

  • Inbound webhook: Webhook type used to capture consent responses, such as opt-ins or opt-outs, and to collect user preferences (product-specific)
  • Feedback webhook: Webhook type used to track delivery and engagement events, including deliveries, outbound errors, and read receipts where applicable (product-specific)
  • Inbound Keyword Category: The drop-down grouping keywords into Opt-In, Opt-Out, Double Opt-In, Help, and Custom (product-specific)
  • Double Opt-In: A two-step consent workflow where matching a keyword does not fully opt in the user until they confirm with a second keyword (product-specific)
  • Fuzzy Logic: An Opt-Out option that detects keywords similar to configured Opt-Out keywords and sends the Fuzzy Auto Response when a response is close but not exact (product-specific)
  • Default Reply Message: The message automatically sent when a user’s response does not match any configured keyword (product-specific)

Guardrails:

  • The only webhook format supported is JSON; form-data for webhooks is not supported.
  • Inbound keyword data is stored in the AJO Email Tracking Dataset system dataset, unless a custom dataset is configured.
  • A profile must have at least one message sent from Journey Optimizer before incoming messages are captured.
  • Sinch and Sinch Conversational use a single webhook that handles both inbound and feedback events, with no payload configuration required.
  • Infobip uses two separate webhooks, one for inbound and one for feedback events, with no payload configuration required.
  • Twilio webhooks are not available; inbound and feedback data collection is not supported.
  • A custom provider uses two separate webhooks, one for inbound and one for feedback events, and payload configuration is required for both to function.
  • Default enabled keywords are Opt-In (Subscribe, Yes, Unstop, Continue, Resume, Begin), Opt-Out (Stop, Quit, Cancel, End, Unsubscribe, No), and Help (Help, Info, Information).
  • Keywords are not case sensitive.
  • The Custom keyword category configures a single custom keyword.
  • The custom inbound webhook payload requires the fields InboundMessage, ProfileNumber, RequestID, OriginTimestamp, and InboundNumber.
  • The custom feedback webhook payload requires the fields Client Reference, Code, and Status.
  • If the webhook uses API credentials attached to an existing channel configuration, it takes effect immediately; otherwise you must create a new channel configuration.

Terminology:

  • Canonical name: SMS Webhook — Acronym: n/a — variants: SMS webhooks, Callback URL
  • Do not confuse: “Inbound” webhook (captures consent responses and user preferences) ≠ “Feedback” webhook (tracks delivery and engagement events)
  • Do not confuse: “Opt-In” (grants consent) ≠ “Double Opt-In” (two-step consent requiring confirmation with a second keyword)
  • Do not confuse: “Reply Message” (sent when an inbound message matches a configured keyword) ≠ “Default Reply Message” (sent when the response does not match any configured keyword) ≠ “Fuzzy Auto Response” (sent when a response is close but not an exact Opt-Out keyword)

FAQ:

  • Q: What is the difference between an inbound and a feedback webhook? — An inbound webhook captures consent responses such as opt-ins and opt-outs and collects user preferences, while a feedback webhook tracks delivery and engagement events such as deliveries, outbound errors, and read receipts where applicable.
  • Q: How many webhooks do I create for each provider? — Sinch and Sinch Conversational use one webhook for both event types; Infobip and custom providers use two separate webhooks; Twilio webhooks are not available.
  • Q: Which webhook format is supported? — Only JSON is supported; form-data for webhooks is not supported.
  • Q: Which fields must a custom inbound payload include? — InboundMessage, ProfileNumber, RequestID, OriginTimestamp, and InboundNumber.
  • Q: When does a webhook take effect? — If it uses API credentials attached to an existing channel configuration, it takes effect immediately; otherwise you must create a new channel configuration.
  • Q: Why are incoming messages not captured for a profile? — A profile must have at least one message sent from Journey Optimizer before incoming messages are captured.
recommendation-more-help
journey-optimizer-help