Twilio

實體、作業和動作

所有整合連接器都會為所連應用程式的物件提供抽象層。您只能透過這個抽象化程序存取應用程式的物件。抽象化會以實體、作業和動作的形式呈現。

• 實體： 實體可以視為已連結應用程式或服務中的物件，或是屬性集合。實體的定義因連接器而異。舉例來說，在資料庫連接器中，資料表是實體；在檔案伺服器連接器中，資料夾是實體；在訊息系統連接器中，佇列是實體。

  不過，連接器可能不支援或沒有任何實體，在這種情況下，Entities 清單會是空白。

• 作業： 作業是指您可以在實體上執行的活動。您可以對實體執行下列任一操作：
  • 列出
  • 取得
  • 建立
  • 更新
  • 刪除

  從可用清單中選取實體，系統會產生該實體可用的作業清單。如需作業的詳細說明，請參閱 Connectors 工作的實體作業。 不過，如果連接器不支援任何實體作業，系統就不會在 Operations 清單中列出這些不支援的作業。

• 動作： 動作是透過連接器介面提供給整合的第一類函式。動作可讓您變更一或多個實體，且因連接器而異。一般來說，動作會有一些輸入參數和輸出參數。不過，連接器可能不支援任何動作，此時 Actions 清單會是空白。

系統限制

Twilio 連接器每秒可處理 25 筆交易 (每個節點)，並節流任何超出此限制的交易。根據預設，Integration Connectors 會為連線分配 2 個節點 (以提高可用性)。

如要瞭解 Integration Connectors 適用的限制，請參閱「限制」一文。

範例

本節說明如何使用這個連接器執行部分實體作業。

範例 - 列出所有錄製內容

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取「錄音」。
3. 選取「List」作業，然後按一下「完成」。

範例 - 取得單一錄音檔

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取「錄音」。
3. 選取「Get」作業，然後按一下「完成」。
4. 將實體 ID 設為「取得單一錄音」。如要設定實體 ID，請在「Connectors」(連結器) 工作的「Task Input」(工作輸入) 部分，按一下「entityId」，然後在「Default Value」(預設值) 欄位中輸入 RE2e915e78549694bd0a0742d2d39454e5。

範例 - 刪除通話

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取「通話」。
3. 選取「Delete」作業，然後按一下「完成」。
4. 將實體 ID 設為「Delete a Calls」(刪除通話)。如要設定實體 ID，請在「Connectors」(連結器) 工作的「Task Input」(工作輸入) 部分，按一下「entityId」，然後在「Default Value」(預設值) 欄位中輸入 CAaa4a99c300bd9d1bcc0d1ae9dcd248c6。

範例 - 建立通話意見回饋

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取「意見回饋」。
3. 選取「Create」作業，然後按一下「完成」。
4. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
                       "Sid": "CAdefbf2b4caa7df11dc48106385e32345",
                       "QualityScore": 5
                     }

   執行這個範例後，Connector 工作的 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

   {
                       "Sid": "CAdefbf2b4caa7df11dc48106385e32345"
                     }

範例 - 建立通話意見回饋摘要

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 FeedbackSummary。
3. 選取「Create」作業，然後按一下「完成」。
4. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
                       "StartDate": "2014-06-01",
                       "EndDate": "2014-06-04"
                     }

   執行這個範例後，Connector 工作的 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

   {
                       "Sid": "FS11f26a89d7260fb8cef070b768fcf5d1"
                     }

範例 - 建立訊息

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取「訊息」。
3. 選取「Create」作業，然後按一下「完成」。
4. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
                       "To": "whatsapp:+9178923*****",
                       "Sender": "whatsapp:+14155238886",
                       "Body": "Message is sent from Google Cloud"
                     }

   執行這個範例後，Connector 工作的 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

   {
                       "Sid": "SMdfde81ab903c0a9e67f932f9bef91090"
                     }

範例 - 更新訊息

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取「訊息」。
3. 選取「Update」作業，然後按一下「完成」。
4. 將實體 ID 設為「更新訊息」。如要設定實體 ID，請在「Connectors」(連結器) 工作的「Task Input」(工作輸入) 部分，按一下「entityId」，然後在「Default Value」(預設值) 欄位中輸入 SM3ad97d41e786c02bca47c8ce1745053b。
5. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
                       "Body": ""
                     }

或者，您也可以將 filterClause 設為 SM3ad97d41e786c02bca47c8ce1745053b，而非指定 entityId。

執行這個範例後，Connector 工作的 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

{}

範例 - 更新 IncomingPhoneNumbers

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 IncomingPhoneNumbers。
3. 選取「Update」作業，然後按一下「完成」。
4. 將實體 ID 設為要更新的 IncomingPhoneNumbers。如要設定實體 ID，請在「Connectors」(連結器) 工作的「Task Input」(工作輸入) 部分，按一下「entityId」，然後在「Default Value」(預設值) 欄位中輸入 PN4047ac009a15885690a50a1d388b8411。
5. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
                       "Name": "name of IncomingPhoneNumber is getting updated"
                     }

或者，您也可以將 filterClause 設為 PN4047ac009a15885690a50a1d388b8411，而非指定 entityId。

執行這個範例後，Connector 工作的 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

{
                    "Sid": "PN4047ac009a15885690a50a1d388b8411"
                  }

範例 - 更新 OutgoingCallerIds

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 OutgoingCallerIds。
3. 選取「Update」作業，然後按一下「完成」。
4. 將實體 ID 設為「Update an OutgoingCallerIds」。如要設定實體 ID，請在「Connectors」(連結器) 工作的「Task Input」(工作輸入) 部分，按一下「entityId」，然後在「Default Value」(預設值) 欄位中輸入 PN6f5f9bf39cb1801a6e21a5a80d274bdd。
5. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
                       "Name": "Name Updated for 99025*****"
                     }

或者，您也可以將 filterClause 設為 PN6f5f9bf39cb1801a6e21a5a80d274bdd，而非指定 entityId。

執行這個範例後，Connector 工作的 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

{
                    "Sid": "PN6f5f9bf39cb1801a6e21a5a80d274bdd"
                  }