Faximo FAXサービス

FaximoサービスでFAXメッセージを送信し、FAX履歴を検索

概要

Faximoは、標準FaximoとFaximoSilverプラットフォームの両方を通じて包括的なFAXサービスを提供します。FAX経由で文書を送信し、詳細な配信レポートとステータス追跡でFAX履歴を追跡できます。

主な機能

FAXIMO_SEND_FAX

• 単一または複数の受信者へのFAXメッセージ送信
• 文書添付ファイルのサポート
• 配信確認と追跡
• カスタマイズ可能なFAX設定とオプション

FAXIMO_SEARCH_HISTORY

• FAX送信履歴の検索
• 配信ステータスとタイミングの追跡
• 履歴FAXレコードへのアクセス
• フィルタリングと検索機能

認証

Faximoは、FaximoまたはFaximoSilverアカウントのログイン資格情報が必要です。

必要な資格情報:

• ログインID
• パスワード

注意: 資格情報は機密情報として扱い、パブリックリポジトリにコミットしないでください。

例: FAX文書送信

- id: prepare_fax_document
  name: prepare_fax_document
  tool: INPUT_FILE
  input:
    - name: description
      value: "FAX経由で送信する文書をアップロード"

- id: send_important_fax
  name: send_important_fax
  tool: FAXIMO_SEND_FAX
  config:
    - name: login_id
      value: "{{secrets.FAXIMO_LOGIN_ID}}"
    - name: password
      value: "{{secrets.FAXIMO_PASSWORD}}"
  input:
    - name: service_type
      value: "faximo"  # または "faximoSilver"
    - name: sendto
      value: "[phone],[phone]"  # 複数のFAX番号
    - name: subject
      value: "重要なビジネス文書 - {{date | format('YYYY-MM-DD')}}"
    - name: body
      value: |
        受信者様
        
        重要なビジネス文書を添付しましたので、ご確認ください。
        
        このFAXはJinbaflowにより自動送信されました。
        
        敬具
        会社名
    - name: attachments
      value: "{{steps.prepare_fax_document.result.file_url}}"
    - name: priority
      value: "high"
    - name: receipt_required
      value: true

- id: log_fax_result
  name: log_fax_result
  tool: OUTPUT_TEXT
  input:
    - name: text
      value: |
        FAX送信完了！
        結果コード: {{steps.send_important_fax.result.result_code}}
        プロセスキー: {{steps.send_important_fax.result.process_key}}
        受付時刻: {{steps.send_important_fax.result.acceptance_time}}
        詳細番号: {{steps.send_important_fax.result.unique_detail_number}}

例: 一括FAXキャンペーン

- id: prepare_recipient_list
  name: prepare_recipient_list
  tool: PYTHON_SANDBOX_RUN
  input:
    - name: code
      value: |
        # FAX受信者リストの準備
        recipients = [
            {"name": "会社A", "fax": "[phone]"},
            {"name": "会社B", "fax": "[phone]"},
            {"name": "会社C", "fax": "[phone]"}
        ]
        
        # カンマ区切りのFAX番号を作成
        fax_numbers = ",".join([r["fax"] for r in recipients])
        print(f"FAX_NUMBERS: {fax_numbers}")
        
        # 受信者サマリーを作成
        print(f"TOTAL_RECIPIENTS: {len(recipients)}")
        for i, recipient in enumerate(recipients, 1):
            print(f"RECIPIENT_{i}: {recipient['name']} - {recipient['fax']}")

- id: upload_campaign_document
  name: upload_campaign_document
  tool: INPUT_FILE
  input:
    - name: description
      value: "FAXキャンペーン用マーケティング文書をアップロード"

- id: send_bulk_fax
  name: send_bulk_fax
  tool: FAXIMO_SEND_FAX
  config:
    - name: login_id
      value: "{{secrets.FAXIMO_LOGIN_ID}}"
    - name: password
      value: "{{secrets.FAXIMO_PASSWORD}}"
  input:
    - name: service_type
      value: "faximo"
    - name: sendto
      value: "{{steps.prepare_recipient_list.result.stdout | regex_search('FAX_NUMBERS: (.+)') | first}}"
    - name: subject
      value: "月次ニュースレター - {{date | format('MMMM YYYY')}}"
    - name: body
      value: |
        貴重なパートナー様
        
        月次ニュースレターを添付いたします。
        
        この通信には、弊社サービスに関する重要な更新情報が含まれています。
        
        継続的なパートナーシップに感謝いたします。
        
        敬具
        マーケティングチーム
    - name: attachments
      value: "{{steps.upload_campaign_document.result.file_url}}"
    - name: send_time
      value: "immediate"
    - name: notification_email
      value: "[e-mail]"

- id: track_campaign_status
  name: track_campaign_status
  tool: OUTPUT_FILE
  input:
    - name: content
      value: |
        FAXキャンペーンレポート
        ==================
        
        日付: {{date | format('YYYY-MM-DD HH:mm:ss')}}
        キャンペーン: 月次ニュースレター
        
        結果:
        - 結果コード: {{steps.send_bulk_fax.result.result_code}}
        - プロセスキー: {{steps.send_bulk_fax.result.process_key}}
        - 受付時刻: {{steps.send_bulk_fax.result.acceptance_time}}
        - 詳細番号: {{steps.send_bulk_fax.result.unique_detail_number}}
        
        受信者数: {{steps.prepare_recipient_list.result.stdout | regex_search('TOTAL_RECIPIENTS: (\\d+)') | first}}
        
        ステータス: 処理中
        
        次のステップ:
        1. 配信ステータスを監視
        2. 配信失敗を確認
        3. 配信確認をフォローアップ
    - name: filename
      value: "fax_campaign_report_{{date | format('YYYY-MM-DD')}}.txt"
    - name: fileType
      value: "txt"

例: FAX履歴追跡

- id: search_recent_fax_history
  name: search_recent_fax_history
  tool: FAXIMO_SEARCH_HISTORY
  config:
    - name: login_id
      value: "{{secrets.FAXIMO_LOGIN_ID}}"
    - name: password
      value: "{{secrets.FAXIMO_PASSWORD}}"
  input:
    - name: service_type
      value: "faximo"
    - name: date_from
      value: "{{date | date_add(-30, 'days') | format('YYYY-MM-DD')}}"  # 過去30日
    - name: date_to
      value: "{{date | format('YYYY-MM-DD')}}"
    - name: status_filter
      value: "all"  # または "success", "failed", "pending"

- id: analyze_fax_performance
  name: analyze_fax_performance
  tool: PYTHON_SANDBOX_RUN
  input:
    - name: code
      value: |
        import json
        from collections import Counter
        
        # FAX履歴結果を解析
        fax_history = {{steps.search_recent_fax_history.result.history}}
        
        if not fax_history:
            print("指定期間のFAX履歴が見つかりません。")
        else:
            # 配信ステータスを分析
            statuses = [fax.get('status', 'unknown') for fax in fax_history]
            status_counts = Counter(statuses)
            
            total_faxes = len(fax_history)
            successful_faxes = status_counts.get('delivered', 0)
            failed_faxes = status_counts.get('failed', 0)
            pending_faxes = status_counts.get('pending', 0)
            
            success_rate = (successful_faxes / total_faxes * 100) if total_faxes > 0 else 0
            
            print("FAXパフォーマンス分析")
            print("=" * 30)
            print(f"送信FAX総数: {total_faxes}")
            print(f"配信成功: {successful_faxes}")
            print(f"配信失敗: {failed_faxes}")
            print(f"配信待機中: {pending_faxes}")
            print(f"成功率: {success_rate:.1f}%")
            print()
            
            # 上位受信者
            recipients = [fax.get('recipient', 'unknown') for fax in fax_history]
            top_recipients = Counter(recipients).most_common(5)
            
            print("上位受信者:")
            for recipient, count in top_recipients:
                print(f"  {recipient}: {count} FAX")

- id: create_performance_report
  name: create_performance_report
  tool: OUTPUT_FILE
  input:
    - name: content
      value: |
        FAXパフォーマンスレポート
        ======================
        
        レポート期間: {{steps.search_recent_fax_history.input.date_from}} から {{steps.search_recent_fax_history.input.date_to}}
        生成日時: {{date | format('YYYY-MM-DD HH:mm:ss')}}
        
        {{steps.analyze_fax_performance.result.stdout}}
        
        推奨事項:
        - 配信失敗を監視し、必要に応じて再送信
        - 送信失敗の受信者FAX番号を確認
        - 配信時間の最適化を検討
        - 互換性向上のため文書フォーマットを確認
        
        詳細な配信ログについては、Faximoサービスダッシュボードを確認してください。
    - name: filename
      value: "fax_performance_report_{{date | format('YYYY-MM-DD')}}.txt"
    - name: fileType
      value: "txt"

FAX設定オプション

サービスタイプ

• faximo: 標準Faximoサービス
• faximoSilver: プレミアムFaximoSilverサービス

優先度レベル

• low: 標準配信
• normal: 通常優先度（デフォルト）
• high: 高優先度配信
• urgent: 緊急配信

送信オプション

• immediate: 即座に送信
• scheduled: 特定時刻にスケジュール
• business_hours_only: 営業時間内のみ送信
• retry_failed: 送信失敗時に自動再試行

レスポンスデータ

FAX送信レスポンス

{
  "result_code": "SUCCESS",
  "process_key": "FAX[phone]",
  "acceptance_time": "2024-01-15 14:30:00",
  "unique_detail_number": "DTL001234567"
}

履歴検索レスポンス

{
  "history": [
    {
      "id": "FAX123456",
      "recipient": "[phone]",
      "subject": "ビジネス文書",
      "status": "delivered",
      "send_time": "2024-01-15 14:30:00",
      "delivery_time": "2024-01-15 14:32:15"
    }
  ]
}

使用例

• 文書配信: 契約書、請求書、法的文書の送信
• マーケティングキャンペーン: ニュースレターやプロモーション資料の配布
• コンプライアンス通信: 規制通知やコンプライアンス文書の送信
• 緊急通知: メールでは不十分な場合の緊急通信
• 医療: 医療記録と処方箋の送信
• 法務サービス: 法廷文書と法的対応
• 不動産: 不動産文書と契約書
• 政府通信: 公式通知とフォーム

ベストプラクティス

FAXフォーマット

• クリアで高コントラストの文書を使用
• 小さなフォントを避ける（最小10pt推奨）
• 一括送信前に文書フォーマットをテスト
• 連絡先情報を含むカバーページを含める

配信最適化

• 配信率向上のため営業時間内に送信
• 送信前にFAX番号を確認
• 配信ステータスを監視し、失敗した送信を再試行
• 適切な優先度レベルを使用

セキュリティ考慮事項

• FAX送信前に機密文書を暗号化
• 安全な資格情報ストレージを使用
• 監査証跡のためにすべてのFAX活動を記録
• 業界規制（HIPAA等）に準拠