速率限制

如果 Brightalk 傳回 429 rate_limit_exceeded，表示整合程式對這類操作送出的請求，已超過目前可用配額。回應會直接告訴您需要等待多久。

​

等待後再安全重試

1. 從每一次 429 回應讀取最新的 Retry-After。
2. 至少等待該段時間，再加上一小段隨機延遲。後續若再次收到 429，請依最新的 Retry-After 等待，並逐步增加隨機退避時間，但不得超過呼叫端自訂的上限，避免重試間隔過短或無限重試。
3. 只有在操作可安全重試，且未超過呼叫端自訂的最大嘗試次數、總經過時間或截止期限，才重新送出。一旦達到次數上限或時間期限，請停止重試並回報錯誤。同一個邏輯寫入動作若仍在冪等性文件所述的適用界線內，必須沿用相同的 HTTP 方法、路徑、API 版本、語意相同的請求內容，以及原本的 Idempotency-Key。

共用同一個組織配額的工作程序應彼此協調，不要各自獨立重試。 請勿在程式中寫死一個全域請求上限。Brightalk 會依組織限制請求，也可能對個別金鑰套用較低限制；目前請求一律以回應標頭為準。

​

四個獨立計數器

每個操作會使用四個獨立配額群組的其中一個： 取消及暫停操作使用 write，不是 execution。輪詢逐字稿使用專用配額群組，不會占用一般讀取配額。已接受的執行請求所啟動的電話工作，不會再使用另一筆 HTTP 請求配額。

​

讀取回應標頭

請使用這些值，不要假設每個組織或金鑰都採用相同配額。

​

排隊不等於受到速率限制

通話並行容量是另一種控制。容量暫時已滿時，已接受的工作會保持 queued；不會變成 429，也不會遭丟棄。請查詢 API 資源，並將排隊視為生命週期狀態，而非請求節流訊號。