🚀 Get TikTok DMs and Ads in Wati Team Inbox and convert social engagement into revenue See TikTok on Wati🚀 TikTok DMs + Ads now in Team Inbox →

Instagram API

Instagram API:透過 REST 管理留言,透過 MCP 處理 DM。

讀取新留言、公開回覆、發送私訊,並在 DM 中延續對話。專為開發者與充滿創意的程式設計師打造。偏好 WhatsApp?請在回覆中附上您的號碼連結。

  • API 支援中留言:列表、回覆、私訊回覆、權限

最後更新於

現今 Instagram API 支援的功能

功能使用方式狀態
留言:列出貼文與留言、公開回覆REST API上線中
私訊回覆留言REST API上線中
DM:發送與接收MCP 伺服器透過 MCP 上線中
DMREST API即將推出,候補名單

尚不支援:隱藏或刪除留言,以及 Instagram Webhook 事件。

  • 16,000+遍布 190+ 個國家的企業
  • 4.6/5G2 上的平均評分
  • 官方Meta 企業合作夥伴與 WhatsApp BSP
G2 Leader, ChatbotsG2 Leader Mid-Market, ChatbotsG2 Momentum Leader, ChatbotsG2 Most Implementable, WhatsApp MarketingISO 27001GDPR

一個留言。締造更多對話。

公開回應、私下回覆,並在 DM 中持續交流。或將聊天轉移至 WhatsApp。

  • 從範本開始核准的範本可開啟對話,無論是針對單一客戶還是 10,000 名客戶。
  • 在聊天中延續客戶回覆後即可傳送文字、多媒體與按鈕。
  • 由您的團隊接手Webhook 通知您的程式碼,團隊收件匣則連結您的團隊成員。
產品

發送。回覆。收到回音。交接。

InstagramInstagram 留言與私訊

同時建立 Instagram 自動化。

列出貼文留言、公開回覆或發送私人回覆。

廣播

個人化訊息,大規模發送。

選擇已核准的範本並傳送給多達 10,000 名收件者。每個人都會取得各自的變數,且每個結果都會透過數字回傳。

訊息

回覆的不只是文字。

在 24 小時的視窗內,發送文字、圖片、檔案、回覆按鈕與列表選擇器,並在您作業時顯示正在輸入的指示器。

訂單更新與警示

適時提供正確的更新。

當有變更時,您的商店、預約或計費系統會發送已核准的範本。客戶只需點擊按鈕或回覆即可。

自動回覆與聊天機器人

由您的程式碼來回答。

訊息 Webhook 會將每則新訊息帶到您的伺服器。使用發送端點回覆,或在 Pro 和 Business 方案上啟動 Wati 聊天機器人。

Webhooks

每次回覆,一落地即時掌握。

Webhooks 會將新訊息、已讀回條、點擊和失敗推送到您的 URL。無需輪詢。

團隊收件匣

程式碼啟動,人工完成。

回覆會落入 Wati 團隊收件匣。透過 API 指派操作人員、設定狀態並新增標籤,以便由適當的人員接手處理。

聯絡人與區隔

您的 CRM,在 Wati 中鏡射。

使用自訂屬性建立和更新聯絡人,然後在傳送訊息前預覽區段。

開始使用

三步驟即可上線。

  1. 連線

    連線您的號碼

    透過 Wati 內嵌的 Meta 嵌入式註冊來連結您的 WhatsApp 號碼。

  2. 驗證

    取得 token

    在 Wati 中建立 API token,並僅授予您需要的權限範圍。請將其妥善保管在您的伺服器上。

  3. 傳送

    發送您的第一個呼叫

    透過一個請求發送已核准的範本。然後新增 webhook 以追蹤遞送狀態。

您的第一個請求解析

以下說明單一請求包含的內容,以及各部分在訊息中顯示的位置。

  1. 哪則留言

    您要回覆的留言。列出貼文留言時即可取得其 ID。

    comment_id在 URL 路徑中
  2. 來自哪個帳號

    已連線至 Wati 的 Instagram 帳號。

    channel
  3. 收件者

    撰寫該留言的人,取自該則留言。

    userIduserName
  4. 傳送內容

    長度不超過 1,000 個字元的純文字,或帶有按鈕的範本。

    type = texttexttype = template
  5. 您收到的回應

    回傳 200 且 ok 設為 true,表示私密回覆已成功送出。請使用與其他呼叫相同的 Authorization 標頭。

    ok: trueresult: success

POST /api/ext/v3/comments/{comment_id}/privateReply。留言與回覆文字僅為範例。請參閱說明文件中的請求說明

可直接複製的程式碼隱藏程式碼
POST/api/ext/v3/comments/{comment_id}/privateReply
curl -X POST "https://live-mt-server.wati.io/api/ext/v3/comments/$COMMENT_ID/privateReply" \
  -H "Authorization: Bearer $WATI_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "yourbrand",
    "userId": "17841400000000000",
    "userName": "maya",
    "type": "text",
    "text": "Hi Maya, yes we do. Chat with us on WhatsApp for shipping options."
  }'
200 範例回應來自說明文件結構的回應格式
{
  "ok": true,
  "result": "success"
}
內建功能

Wati 為您處理好一切,讓您無後顧之憂。

號碼註冊上線

透過 Meta 的嵌入式註冊(Embedded Signup)進行連線。WhatsApp Business 帳號將直接註冊至您的企業名下。

範本狀態

審核、品質與類別變更將以 Webhook 形式發送,讓您在發送失敗前就能掌握狀況。

Webhook 重試機制

最多重試 144 次,每 10 分鐘一次。如果您的端點持續失敗,Wati 將會寄發電子郵件通知您。

速率限制與佇列

若發送速度過快,將收到帶有 Retry-After 標頭的 429 回應。已被接受的訊息將會在佇列中等候。

真人客服轉接

提供共用的團隊收件匣,用於處理不應僅由程式碼回答的對話。

範圍限定的 API 權杖

v3 支援範圍限定權杖,讓每個整合功能僅取得所需的存取權限。

排程發送

只要透過一次呼叫即可排程稍後發送範本。Wati 將會準時發送。

事先估算成本

在發送任何內容之前,先估算廣播訊息的成本。

技術內幕

依功能分類的端點。

範本

透過已審核的範本立即或排程發起對話。

文件 →
GET/messageTemplatesPOST/messageTemplates/sendPOST/messageTemplates/schedule

群發廣播

讀取活動結果與每位收件人的狀態,並事先估算成本。

文件 →
GET/broadcastsGET/broadcasts/{broadcast_id}/recipientsPOST/broadcasts/estimate-cost

訊息傳遞

在 24 小時視窗內以文字、多媒體或按鈕回覆。

文件 →
POST/conversations/messages/textPOST/conversations/messages/fileViaUrlPOST/conversations/messages/interactivePOST/conversations/typingIndicator

聊天機器人 Pro+

列出您的 Wati 聊天機器人,並為聯絡人啟動機器人。

文件 →
GET/chatbotsPOST/chatbots/start

Webhooks

管理訂閱並列出您可以接收的事件類型。

文件 →
GET/webhooksGET/webhooks/event-typesPUT/webhooks/{id}

聯絡人與客群

從您的 CRM 同步聯絡人與屬性,然後針對特定客群進行行銷。

文件 →
POST/contactsPUT/contactsPOST/segments/evaluate

團隊收件匣

指派客服人員、變更狀態、新增或移除標籤。

文件 →
PUT/conversations/{target}/operatorPUT/conversations/{target}/statusPOST/conversations/{target_conv}/tags

Instagram

列出貼文與留言、公開或私密回覆、檢查權限。

文件 →
GET/posts/{post_id}/commentsPOST/comments/{comment_id}/repliesPOST/comments/{comment_id}/privateReplyGET/channels/{channel}/permissions

路徑相對於 https://live-mt-server.wati.io/api/ext/v3。建立 webhook 會使用舊版路徑 POST /{tenantId}/api/v2/webhookEndpoints。

對於 AI 代理程式,Wati MCP 伺服器涵蓋相同的 WhatsApp 動作,並能以文字回覆 Instagram 私訊和 Messenger 聊天。

查看全部 19 種 WhatsApp webhook 事件類型

訊息

  • message
  • newContactMessageReceived
  • sessionMessageSent_v2
  • templateMessageSent_v2

傳遞狀態

  • sentMessageDELIVERED_v2
  • sentMessageREAD_v2
  • sentMessageREPLIED_v2
  • templateMessageFailed

範本與帳號

  • templateReviewed
  • templateQualityUpdated
  • templateCategoryUpdated
  • wabaStatusReviewUpdate
  • PhoneNumberQualityUpdatedEvent
  • accountUpdated
  • accountDeleted
  • phoneNumberDeleted

互動與通話

  • chatbotTriggered
  • ctaUrlClicked
  • call.status

亦提供多個事件的 BSUID 版本。Webhook 文件

限制與方案

明確限制。公開透明。

30 至 100 每 10 秒

範本發送

發送範本的呼叫次數,取決於您的方案(Growth、Pro 或 Business)。

10,000 位收件人

每次 v3 發送呼叫

一個範本最多可發送給 10,000 人,每人皆可有各自的變數。

24 小時 視窗

自由格式回覆

文字、多媒體與按鈕需要開啟中的客服視窗。若超出此視窗,請改發送範本。

429 Retry-After

當發送速度過快時

Wati 會告知您需要等候的時間。被接受的訊息將會在佇列中進行處理。

詳細速率限制與方案可用性
各方案記載的速率限制
端點GrowthProBusiness
/addContact, /getContacts10 / 10 秒10 / 10 秒10 / 10 秒
/getMessages10 / 10 秒10 / 10 秒10 / 10 秒
/sendTemplateMessage30 / 10 秒60 / 10 秒100 / 10 秒
/sendTemplateMessages30 / 10 秒60 / 10 秒100 / 10 秒

限制如 錯誤與速率限制 (Errors & Rate Limits) 中所公布,依端點名稱列出。v1 批次呼叫最多可包含 1,000 位聯絡人。核心訊息傳遞、範本與聯絡人端點適用於所有方案。團隊指派、聊天狀態、聊天機器人與自訂客群需要 Pro 或Business 方案。一次更新大量聯絡人的屬性需要 Business 方案。各方案的端點可用性。若需要更高的限制,請與 Wati 洽詢您的使用需求。

常見問題

常見問題

完整的 API 參考文件為公開內容。閱讀文件

Wati Instagram API 可以做什麼?

目前此 API 可以列出您的 Instagram 貼文及其留言、傳回未讀留言數量、公開回覆留言、向留言者發送私訊回覆,以及檢查您帳號的留言權限。公開回覆最多可達 2,200 個字元,私人文字回覆最多可達 1,000 個字元。

我可以在沒有龐大工程團隊的情況下建立 Instagram 自動化嗎?

可以。留言端點是帶有 bearer 權杖的標準 REST 呼叫,因此 AI 應用程式建構工具可以透過簡短的描述來編寫它們。一個很好的初步建構專案:檢查新留言、公開回覆,然後傳送私訊回覆。如果您已經在使用 AI 代理程式,Wati MCP 伺服器可以使用文字回覆 Instagram 小盒子 (DM)。

回覆之前如何檢查我的 Instagram 權限?

使用您連接的 Instagram 頻道呼叫 GET /channels/{channel}/permissions。回應會告訴您是否已授權留言權限,並列出任何遺失的範圍,以便您的自動化作業可以在回覆失敗前停止。

我需要懂得寫程式嗎?

比以前少很多。AI 應用程式建構工具可以根據日常英文說明編寫 API 呼叫,而此頁面上的範例也展示了每個呼叫。

您仍然需要連接至 Wati 的 WhatsApp 電話號碼、API 權杖,以及經 Meta 批准的範本,才能開始對話。如果 AI 工具編寫了程式碼,請確認您的權杖保留在伺服器上。

API 速率限制是多少?

在所有方案中,聯絡人和訊息記錄呼叫均限制為每 10 秒 10 次請求。範本發送在 Growth、Pro 和 Business 方案中分別限制為每 10 秒 30、60 或 100 次請求。當您達到限制時,您會收到帶有 Retry-After 標頭的 HTTP 429。如需更高的限制,請聯絡 Wati。

我可以隨時向客戶發送訊息嗎?

在 WhatsApp 上,自由格式文字、媒體和互動式訊息需要開啟 24 小時的客戶服務視窗。在該視窗之外,請使用經 Meta 批准的範本來開始對話。

WhatsApp Business 應用程式與 API 有何不同?

Business 應用程式適用於手機上的手動聊天,最多可連結 5 部裝置,廣播清單上限為 256 個聯絡人。API 將 WhatsApp 連接到您自己的系統。您可以大量發送批准的範本、自動回覆、接收 webhooks,並在團隊收件匣中共用一個號碼。

我的方案包含哪些端點?

核心訊息、範本和聯絡人端點包含在所有方案中。團隊指派、聊天狀態、聊天機器人和自訂區隔需要 Pro 或 Business 方案。文件中依方案列出了端點可用性。

您的第一則訊息只需一個請求。

免費開始,在 Wati 中連線您的 WhatsApp 電話號碼並進行您的第一次呼叫。