Hibira Chat API

在 App 裡加上聊天,不用自己寫後端

Hibira 保存每一則訊息、讓每個對話保持順序,並透過 App 已經在用的連線即時送達。誰能和誰聊由你的伺服器決定;使用者會有歷史訊息、已讀回條,離開時也收得到推播。

加入候補名單查看方案

Chat API 目前是 beta。加入候補名單,開放給所有帳號時我們會通知你。

聊天功能需要的都在這裡

訊息保存,永遠照順序

每則訊息在通知任何人之前,都會先拿到對話裡的下一個序號。離線的手機回來時,只要拿它最後的序號之後的訊息,不會漏掉,也不會重複。

已讀回條與未讀數

成員標記讀到哪裡,對話裡的每個人都看得到;每位使用者的收件匣會列出他的對話和未讀數。

輸入中、編輯、收回與表情回應

顯示誰正在輸入,讓使用者修改或收回訊息,也能用表情符號回應。變更會即時送到每位成員,並跟著訊息保存。

離開時也收得到推播

新訊息會透過 Hibira Push 推播給沒有連線的成員,支援網頁、iOS 與 Android,內容是寄件者名稱和訊息的第一行。

檔案與圖片

每個附件最大 25 MB,透過短效連結直接上傳到儲存空間,大檔案不會經過你的伺服器。

內建內容管理

連中文和日文也適用的關鍵字過濾、會自動到期的封鎖與禁言,以及成員檢舉,全部集中在同一份清單給你的團隊處理。

懂中日韓文的搜尋

可以用詞的任何一部分搜尋對話裡的訊息,不分大小寫與全形半形,中文、日文、韓文和英文都適用。

角色與內部備註

可以替成員設定角色,例如客服或管理員。備註可以只給某個角色看:只有那些成員收得到,對其他人也不會算成未讀。

運作方式

  1. 你的伺服器建立對話和成員,用簽章請求,簽法和 Hibira HTTP API 其他部分相同。
  2. 每位使用者登入 App 原本就會開的即時連線。聊天事件送到使用者自己的頻道,不必為每個對話授權頻道。
  3. 訊息即時送出並保存。 你的伺服器可以代使用者傳送,也可以發給頁面短效的使用者 Token,讓頁面直接呼叫 Chat API。
用 Chat API 做的後台聊天頁:對話清單、訊息與上線狀態。
用 Chat API 做的後台聊天頁:對話清單、訊息與上線狀態。

前端可以用 @hibira-io/chat-ui,它提供現成的對話畫面,包含已讀標記、表情回應、檔案與內部備註:

import { createChatClient } from '@hibira-io/chat-ui/hibira';
import { Chat, useChatConversation } from '@hibira-io/chat-ui/react';

const client = createChatClient({ appId: 'your-app-id', tokenUrl: '/hibira/token' });
const conversation = useChatConversation(client, 'trip-1', { pusher, me: userId });
return <Chat conversation={conversation} me={userId} />;

API 位於 /apps/{app_id}/chat:對話與成員、用 after 補齊的訊息、已讀標記、含未讀數的使用者收件匣、搜尋、附件、使用者 Token、內容管理與本月用量。每則新訊息也可以觸發你的 chat_message Webhook。所有請求、事件與限制請見參考文件。

方案

免費

0 美元
  • 每月活躍使用者 500
  • 檔案空間 1 GB
  • 適合 開發並上線聊天功能

Chat 1K

每月 49 美元
  • 每月活躍使用者 1,000
  • 檔案空間 5 GB
  • 適合 成長中的社群或交易平台

Chat 5K

每月 149 美元
  • 每月活躍使用者 5,000
  • 檔案空間 25 GB
  • 適合 每天都會聊天的 App

Chat 20K

每月 349 美元
  • 每月活躍使用者 20,000
  • 檔案空間 100 GB
  • 適合 大型社群與客服團隊

Chat 60K

每月 799 美元
  • 每月活躍使用者 60,000
  • 檔案空間 300 GB
  • 適合 大規模聊天

每個帳號不論即時方案都含每月 500 位活躍使用者,Chat 加購與方案分開計費。年繳可免費 2 個月。使用者在一個月內傳送訊息或標記已讀就算活躍,跨你所有 App 合計;只收訊息的人不計入。查看所有價格。訊息數量沒有硬性上限:方案以平均每位活躍使用者每月約 500 則訊息規劃,若用量遠高於此,我們會先與你聯繫再做任何調整。檔案空間用滿後,新附件會被拒絕,直到刪除舊對話或改選更大的方案。

適用你的技術棧

  • React 與原生 JavaScript:@hibira-io/chat-ui 的對話畫面與用戶端,建立在 pusher-js 上。
  • Laravel 與 Filament:Filament 外掛提供現成的聊天頁與上線狀態。
  • 任何後端:請求的簽法和 Hibira HTTP API 其他部分相同,任何 Pusher 伺服器函式庫的簽章程式碼都能用。
  • iOS、Android 與 Flutter:用即時 SDK 接收事件,App 關閉時的訊息由 Hibira Push 送達。

常見問題

什麼算每月活躍使用者?

在一個日曆月(UTC)內傳送訊息或標記對話已讀的使用者,跨你所有 App 只算一次。只收訊息、或打開 App 但沒有讀的人不計入。

用到方案的使用者上限會怎樣?

本月已計入的使用者照常使用。會超過方案的新使用者,在傳送和閱讀時會收到錯誤,直到下個月,或你改選更大的加購方案,改選後立即生效。

訊息會保存多久?

最近 30 天一定保留。有付費方案或 Chat 加購時,較舊的訊息會封存,API 照樣讀得到;免費方案且沒有加購時,30 天後刪除。

一定要有 Hibira 即時方案嗎?

不用。每個帳號都有每月 500 位活躍使用者,免費方案也一樣。Chat API 和你的即時功能共用同一個帳號、App 與連線。

可以用自己的聊天介面嗎?

可以。API 回傳一般的 JSON、送出一般的事件,任何介面都能用。想要現成的,可以用 @hibira-io/chat-ui。

資料存在哪裡?

訊息存放在亞洲,超過 30 天的封存存放在香港。刪除對話會一併刪除它的訊息與封存。

加入 Chat API 候補名單

留下 Email,告訴我們你在做什麼。Chat API 開放給所有人時我們會寫信給你,在那之前也會邀請一些團隊先加入 beta。

這些資料僅用於回覆您的詢問;詳見隱私權政策。