設定
SMSメッセージを送信する前に、モジュールをSMSゲートウェイプロバイダーに接続し、送信者設定を構成する必要があります。このページでは、すべての設定オプションについて説明します。
モジュール設定へのアクセス
- Concord CRMの管理パネルにログインします
- サイドバーからカスタムSMS -> 設定に移動します
- 設定ページにセクション別に整理されたすべての設定オプションが表示されます
SMSゲートウェイの設定
カスタムSMSモジュールでは、メッセージを配信するために外部SMSゲートウェイが必要です。ゲートウェイセクションでプロバイダーの認証情報を構成します。
サポートされるゲートウェイ
| プロバイダー | 必要な認証情報 |
|---|---|
| Twilio | Account SID、Auth Token、送信者電話番号 |
| Vonage | API Key、API Secret、送信者電話番号 |
| その他 | API Key/Token、Sender ID(プロバイダーにより異なる) |
ゲートウェイの接続
- カスタムSMS -> 設定 -> ゲートウェイに移動します
- ドロップダウンからSMSプロバイダーを選択します
- 選択したプロバイダーに必要な認証情報を入力します
- 送信者電話番号またはSender IDを設定します
- 保存をクリックします
- テストSMS送信ボタンを使用して接続を確認します
電話番号はE.164形式(例:+1234567890)で入力してください。ほとんどの配信失敗は、送信者番号または受信者番号の形式が正しくないことが原因です。
テストSMS
ゲートウェイの認証情報を保存した後、必ずテストメッセージを送信してください:
- テストSMS送信をクリックします
- アクセスできる電話番号を入力します
- 送信をクリックします
- メッセージが電話に届くことを確認します
テストが失敗した場合は、認証情報を再確認し、ゲートウェイアカウントがアクティブで残高が十分であることを確認してください。
送信者設定
Sender ID / 電話番号
受信者がメッセージを受信した際に表示される送信者のアイデンティティです。プロバイダーと国に応じて:
- 電話番号 -- ゲートウェイプロバイダーから購入した番号(最も一般的)
- 英数字Sender ID -- 一部の地域でサポートされるカスタムテキストラベル(例:「MyCRM」)
英数字Sender IDはすべての国でサポートされているわけではありません。地域の対応状況については、ゲートウェイプロバイダーのドキュメントを確認してください。英数字IDから送信されたメッセージには返信できません。
デフォルトの国コード
デフォルトの国コードを設定すると、毎回入力する必要がなくなります。モジュールは国コードのない番号に自動的に国コードを付加します。
- カスタムSMS -> 設定 -> 一般に移動します
- デフォルトの国コードを設定します(例:米国は
+1、英国は+44) - 保存をクリックします
スケジューリング設定
カスタムSMSモジュールは、将来の配信のためにメッセージのスケジューリングをサポートしています。スケジュールされたメッセージが時間通りに送信されるよう、以下を確認してください:
cronジョブの設定
スケジュールされたSMSメッセージは、Concord CRMのcronジョブによって送信されます。cronが構成され実行されていることを確認してください:
* * * * * php /path/to/concord/artisan schedule:run >> /dev/null 2>&1
cronジョブが実行されていない場合、スケジュールされたメッセージはキューに残り、cronが実行されるまで配信されません。
タイムゾーン
スケジューリングシステムは、Concord CRMの設定で構成されたタイムゾーンを使用します。確認または更新するには:
- Concord CRMの設定 -> 一般に移 動します
- タイムゾーン設定を確認します
- スケジュールされたメッセージが期待通りの時間に送信されるよう、ローカルタイムゾーンと一致していることを確認します
CRMアクション連携
モジュールはさまざまなCRMアクションからトリガーできます。どのアクションでSMSオプションを表示するかを構成します:
- カスタムSMS -> 設定 -> 連携に移動します
- 各CRMアクションタイプのSMSを有効または無効にします:
- 通話 -- 通話記録後にSMSを送信
- タスク -- タスク更新に関連するSMSを送信
- メール -- メールコミュニケーションをSMSで補完
- 会議 -- 会議の確認やリマインダーを送信
- 期限 -- 近づく期限についてコンタクトに通知
- 保存をクリックします
アクションタイプが有効になると、対応するCRMレコードにSMS送信ボタンが表示されます。
配信ステータスの追跡
モジュールはゲートウェイプロバイダーからの配信ステータスを自動的に追跡します。ステータスの更新はwebhookを通じて受信されます:
| ステータス | 意味 |
|---|---|
| キュー中 | メッセージがゲートウェイに受理され、配信待ち |
| 送信済み | メッセージがキャリアネットワークに送信された |
| 配信済み | 受信者へのメッセージ配信が確認された |
| 失敗 | 配信失敗(無効な番号、キャリアの問題) |
一部のゲートウェイプロバイダーは、より詳細な追跡のために配信確認(DLR)をサポートしています。最も正確なステータス更新のために、プロバイダーのダッシュボードでDLRを有効にしてください。
設定のトラブルシューティング
| 問題 | 解決策 |
|---|---|
| テストSMSが届かない | 認証情報を確認し、ゲートウェイアカウントの残高をチェック |
| 「無効な送信者」エラー | 送信者番号がゲートウェイで確認/購入されていることを確認 |
| スケジュールされたメッセージが送信されない | cronジョブがアクティブで毎分実行されていることを確認 |
| 配信ステータスが更新されない | ゲートウェイプロバイダーのダッシュボードでwebhook設定を確認 |
| 国コードが適用されない | 一般設定でデフォルトの国コードが保存されていることを確認 |