はじめに
イントロダクション
UnifyPort は、Telegram・WhatsApp・LINE・X（旧Twitter）・Zalo・TikTok を 1 つの REST API と 1 本の標準 webhook イベントストリームに統合します。送信は POST /v1/messages、受信はすべて正規化されたイベントとして届きます — プロバイダ固有 SDK は不要で、必要に応じて公式 UnifyPort Node.js / PHP / Go / Python SDK を利用できます。
概要
ワークスペース
分離の境界。X-Api-Key ヘッダはちょうど 1 つのワークスペースに解決され、そのワークスペースへのフルアクセスを付与します — リクエストボディに追加の workspace id は不要です。
アカウント
1 つのチャネルログイン = 1 台の仮想デバイス。API で作成し、プロバイダが対応するフロー（QR、認証コード、またはセッション取り込み）で認証してから、そのアカウントで送受信します。
ランタイム
各アカウントの背後にあるライブ接続プロセス。認証成功後に自動で起動し、その状態は runtime_status として公開されます。完全なステートマシンはアカウントライフサイクルを参照してください。
Webhook
受信トラフィックを永続化する入口です。UnifyPort には REST のメッセージ履歴取得 API も、取り逃した配信の保証付き再送もありません。先に webhook を登録して到着時に保存してください。WhatsApp の HistorySync は初回同期や再接続後に限定的な best-effort の直近履歴を届ける場合がありますが、完全なアーカイブではありません。
API キーを検証
Shell
curl https://api.unifyport.ai/v1/workspace \
-H "X-Api-Key: <YOUR_API_KEY>"注記
- ベース URL：https://api.unifyport.ai。すべての /v1 エンドポイントは X-Api-Key リクエストヘッダで認証します。
- UnifyPort は現在、限定されたお客様に提供しています。ワークスペースへのアクセスと最初の API キーの取得については、チームまでお問い合わせください。
- JSON success and error responses carry a top-level request_id; requests with no response body, such as successful 204 deletes, expose it only through the X-Request-Id response header. Quote that value when reporting issues. Send your own X-Request-Id request header and it is echoed as client_request_id in JSON responses for client-side reconciliation.