受信したSMSをTelegramのチャットやWebhookへ転送する方法

受信SMSを転送する目的

SMSの受信を一人の端末だけで管理していると、担当者が不在のときに確認ができません。受信メッセージをチームの共通チャットへ転送しておくと、通知に気づきやすくなり、対応した内容も履歴として残ります。

転送を考える場面には、次のようなものがあります。

• 個人用の受信箱と、業務用の通知を分けておきたい
• 同じ通知を複数人で同時に確認したい
• 受信内容を社内の管理システムに取り込み、記録として保存したい
• 担当者が変わっても情報を引き継げる状態にしておきたい

転送先はTelegramチャットとWebhookの二種類

転送先は大きく二つに分かれます。一つ目はTelegramのチャットです。グループやチャンネル、自分宛のダイレクトメッセージなどを指定し、受信したSMSをそのまま流します。通知を受け取るだけでよい場合に、準備が少なくて済みます。

二つ目はWebhookです。受信した内容をHTTPリクエストとして外部へ送り、社内の管理画面や通知基盤、記録用のデータベースなどとつなぎます。受け取り側の処理を自由に設計できる一方、受信側の実装と運用が必要です。

選ぶときの観点は次のとおりです。

• 必要な準備: Telegramはチャットの用意とIDの確認、Webhookは送信先URLと受信側の実装
• 権限管理: Telegramはチャットのメンバー設定、Webhookは受け取り側の認証設計
• 記録の残し方: Telegramは会話の履歴、Webhookは任意の形式で保存
• 障害時の見え方: Telegramは表示されるだけ、Webhookはエラー処理を自分たちで決める

Telegramチャットへ転送する手順

当サイトでおすすめしているSMS Activate Appでは、受信したSMSの転送先としてTelegramのチャットとWebhookの両方を指定できます。ここではTelegramチャットへの設定手順を示します。

• 転送先のグループを用意します。既存のチームチャットを使うこともできます
• 転送用のボットをチャットに追加し、メッセージを送信できる権限を与えます
• 転送先チャットのIDを確認します
• 管理画面またはTelegram上の設定で、転送先チャットを指定します
• テスト用のSMSを送り、転送された表示形式と本文を確認します

Webhookでチームの基盤とつなぐ

Webhookの送信に失敗した場合にTelegramへ通知するフォールバックを用意しておくと、取りこぼしに気づきやすくなります。また、受信側のログと転送側の記録を照合できるようにしておくと、障害時の切り分けが楽です。

• 送信先URLはHTTPSを使う
• シークレットトークンや署名で、送信元を検証できるようにする
• リクエスト本文はJSONとし、受信番号、受信時刻、本文を含める
• 同じ通知が重複したときに二重登録されないよう、受け取り側で冪等に処理する
• 受け取り側がエラーやタイムアウトを返したときの再試行と、失敗を記録する場所を決めておく

運用時の注意と確認手順

番号と料金についても、運用前に把握しておきましょう。SMS Activate Appの番号は一人で使う専用の番号で、28日間の利用が基本です。料金は$8から、対応地域はオーストラリア、カナダ、イギリス、イスラエル、プエルトリコ、スウェーデン、アメリカ合衆国です。番号はSMSの受信と通話の両方に対応し、管理はウェブサイトまたはTelegramから行えます。残高の入金は銀行カードと暗号資産に対応しています。残高が足りている間は28日ごとに自動で更新され、設定から停止もできます。利用料金は返金の対象にならないため、先に対象のプラットフォームで番号が使えるかを確認してください。

セキュリティにも注意が必要です。転送されるSMSには認証コードが含まれることがあります。転送先チャットの公開範囲とメンバーの権限を絞り、Webhookではシークレットを定期的に見直してください。不要になった番号は、転送設定とあわせて整理しましょう。

• 番号が有効で、SMSを受信できる状態か
• 転送先のチャットIDやWebhookのURLに誤りがないか
• 転送先チャットで、ボットが送信の権限を持っているか
• Webhookの受信側がエラーやタイムアウトを返していないか
• 受信側のログに、リクエストが届いているか