# 機器人Dynamic API（加購功能）

### 卡片介紹

購買 Dynamic API 模組後，您可以在機器人模組中使用 Call an API卡片：

<div align="left"><figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2FZ70Adn7ntoOdwBzKlzR3%2F%E5%8D%A1%E7%89%87%E8%AA%AA%E6%98%8E.png?alt=media&#x26;token=ed91186b-78e1-4e7a-8b7c-59b2184ce7e1" alt="" width="375"><figcaption></figcaption></figure></div>

1. Endpoint：品牌的API位址，例如：<https://www.example.com/get\\_point。>
2. Headers：API所需的額外資訊，例如請求的資料格式。
3. Payload：品牌需要查詢的資料，例如會員ID、會員電話號碼或產品/活動資料。
4. Success Follow up Message Block：API 成功傳送資料後，回覆給顧客的對話模組。

### 卡片功能

Call an API卡片可以做到：

✅ **資料查詢**：即時查詢其他資料庫的最新資訊。

✅ **資料傳送**：將顧客輸入的資訊傳送到指定的資料庫中。

資料查詢的功能是根據顧客想要搜尋的資料，透過品牌提供的 API 連接資料庫，將搜尋結果回傳至 Omnichat，Omnichat 再將資料轉換為機器人訊息，發送到顧客的社群渠道。

<figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2FqdAg8I5WVUgulHX0ZyLQ%2Fcall%20an%20api%E5%8A%9F%E8%83%BD.png?alt=media&#x26;token=ac8611a1-25d5-4a80-aecd-27d5edd5605f" alt=""><figcaption><p>利用Call an API卡片查詢資料</p></figcaption></figure>

{% hint style="info" %}
從品牌資料庫回傳的查詢結果，會以訊息的形式呈現給社群渠道好友，但這些資料不會儲存在 Omnichat 的[自訂屬性](https://docs.omnichat.ai/features/she-qun-ke-hu-zi-liao-ping-tai/zi-ding-shu-xing-jia-gou-gong-neng)中。
{% endhint %}

此外，這張卡片也可以呼叫其他系統執行動作，例如發Email、SMS簡訊、App通知等。

<figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2FrlvGpWrePa3d6ao3OP4P%2Fcall%20an%20api%E5%85%B6%E4%BB%96%E7%B3%BB%E7%B5%B1%E5%9F%B7%E8%A1%8C%E5%8B%95%E4%BD%9C.png?alt=media&#x26;token=929ea366-b16d-4c22-9e9a-026029079e71" alt=""><figcaption><p>Call an API卡片也可以呼叫其他系統執行動作</p></figcaption></figure>

### 應用情境

#### <mark style="background-color:orange;">資料查詢</mark>

**個人化資訊 - 個人會員資料**

透過已經綁定的顧客資料，可以即時查詢會員資訊，例如個人訂單、出貨進度、兌換券或是旅遊行程等細節。

{% hint style="success" %}
**情境範例：適用於旅遊產業**

當顧客完成會員身份認證、綁定手機後，即可在 LINE 上查詢會員資料。

顧客點擊「我的票券」，透過Call an API卡片即可查詢未使用的票券資訊。

查詢後，系統會透過預先設定好的 Chatbot 版型自動回覆顧客查詢結果，方便又快速。
{% endhint %}

<figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2FAzTRQdsE40vu6FrDkh3y%2F%E6%97%85%E9%81%8A%E7%A5%A8%E5%88%B8.png?alt=media&#x26;token=b9f00d21-aefa-4d34-a000-a32e358cd4d4" alt=""><figcaption><p>不用客服介入，顧客可立即查詢個人化資料</p></figcaption></figure>

#### 非個人化資訊 - 時效資訊

提供的是和個人化無關的即時資料，例如熱銷商品、最新活動或熱門新聞等，不需要先綁定顧客資料，也能直接調用資料給顧客。

{% hint style="success" %}
**情境範例1：適用於金融媒體**

金融媒體的顧客經常詢問最新的首刷禮活動，由於活動更新頻繁，只要透過 Call an API 卡片，直接從品牌資料庫中獲取最新資料進行回覆，這樣不僅能節省行銷和客服的工作時間，還能確保顧客即時獲取最新資訊。
{% endhint %}

<figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2FjLk62lN1YUrWBSW812nh%2F%E9%87%91%E8%9E%8D%E5%AA%92%E9%AB%94%E6%83%85%E5%A2%83.png?alt=media&#x26;token=c94d4e2f-647a-4d12-b908-1986e33201cf" alt=""><figcaption><p>顧客與 Chatbot 互動，讓顧客隨時取得最新資訊</p></figcaption></figure>

{% hint style="success" %}
**情境範例2：適用於零售產業**

消費者常會參考熱銷榜來獲取消費靈感，透過 Call an API 卡片，系統能直接從品牌資料庫提取最新資料、自動回覆給顧客，行銷人員不需要手動更新 Chatbot 內容，顧客也能即時收到最新的資訊。
{% endhint %}

<figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2FsLBq3FP6DjxSkL7bykb8%2F%E9%9B%B6%E5%94%AE%E7%94%A2%E6%A5%AD.png?alt=media&#x26;token=862b9543-da32-45a3-93e6-efd4db91111d" alt=""><figcaption><p>熱銷產品推薦，不用再手動更新，隨時保持最新資訊</p></figcaption></figure>

#### <mark style="background-color:orange;">資料傳送</mark>

當顧客與 Chatbot 互動並輸入資訊（如問卷調查或活動報名）時，可以透過「Call an API」卡片將資料傳送到品牌資料庫，讓系統根據顧客資料即時傳送回應。

{% hint style="success" %}
**情境範例：適用於顧客填寫問卷、活動資料時使用**

當顧客透過Chatbot提供個人資料（例如姓名、聯絡方式、報名資訊）時，這些資料會儲存在 Omnichat的「自訂屬性」中。

系統會透過 Call an API 卡片，將顧客的自訂屬性資料傳送至品牌的資料庫，資料庫隨後會回傳填寫或報名是否成功的訊息至 Omnichat，最後再以Chatbot訊息通知顧客填寫/報名結果。
{% endhint %}

<figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2FkaOHpKL0rsKcxniivGH7%2F%E5%95%8F%E5%8D%B7%E5%9B%9E%E5%82%B3%E8%B3%87%E6%96%99.png?alt=media&#x26;token=76f98071-2f67-4516-a212-070833637c1f" alt=""><figcaption><p>將顧客的個人資料回傳至品牌資料庫</p></figcaption></figure>

如果您想要了解更多應用情境，歡迎到[官網首頁](https://www.omnichat.ai/tw/)右下角，點選對話插件詢問Omnichat客服團隊🙌