ブログ
- ガイド
Telegramのスーパーグループ移行：Chat IDを安全に更新する
migrate_to_chat_idとmigrate_from_chat_idを使い、送信先だけを更新して履歴を保持する方法。移行と送信リトライを切り分けます。
続きを読む → - 比較
Telegram Webhook の返信：レスポンス本文と個別の sendMessage 呼び出しを比較
Telegram は webhook のレスポンス内で sendMessage を実行できますが、結果は取得できません。個別 API 呼び出しと UnifyPort の受信確認との違いを解説します。
続きを読む → - ガイド
Telegram getUpdates の offset：重複処理と更新の取りこぼしを防ぐ
Telegram が更新を確認済みにするタイミングを理解し、永続化した受信箱とチェックポイントで、再起動による取りこぼしや業務処理の重複を防ぎます。
続きを読む → - ガイド
Telegram getWebhookInfo：未配信の更新と配信エラーを診断する
pending_update_count、last_error_date、last_error_message を正しく読み取り、Telegram webhook の配信障害と後続処理の問題を切り分けます。
続きを読む → - 比較
Telegram Webhookのsecret_tokenとHMAC：受信側で何を検証するか
Telegramのsecret_tokenは共有トークンを渡すヘッダーであり、本文の署名ではありません。UnifyPortのHMACと比較し、検証契約の混同を防ぎます。
続きを読む → - ガイド
Telegramボットがグループのメッセージを受信しない？プライバシーモードを確認
個人チャットや指定コマンドは届くのに、グループの通常メッセージが届かない場合の確認事項。プライバシーモード、権限、再追加、allowed_updatesを切り分けます。
続きを読む → - チュートリアル
WhatsApp Passkey QR認証を安全に完了し、Webhookで受信する手順
UnifyPortでWhatsAppのQR + Passkey認証を扱う実装ガイド。messaging accountの作成、WebAuthn Passkey分岐、署名付きWebhookイベントの検証までを説明します。
続きを読む → - ガイド
X ChatのDMトラブル対策：ログイン状態・鍵のバージョン・署名を確認する
X Chatの送信・復号エラーを、アカウント認証、会話鍵、メッセージ署名、Webhook配信に分けて調査し、リクエストの証跡を残す方法。
続きを読む → - チュートリアル
Telegram getUpdates と setWebhook の競合を安全に切り替える Runbook
Telegram ボットが getUpdates と setWebhook の切り替え後に更新を受け取れないときの確認手順です。現在の受信モードを確認し、古い受信経路を外し、保留中の updates を扱い、統合 inbound webhook が適切か判断します。
続きを読む → - チュートリアル
Telegram のメディア添付を統一 Webhook で処理する：写真、音声、ドキュメント、連絡先、位置情報
UnifyPort の標準 message.received イベントで Telegram のメディアメッセージを扱う方法。テキスト、添付、連絡先、位置情報をマッピングし、HMAC-SHA256 検証後に安全に保存します。
続きを読む →