Jinba FlowでFaximoを使い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
  needs: [prepare_fax_document]
  config:
    - name: login_id
      value: "{{secrets.FAXIMO_LOGIN_ID}}"
    - name: password
      value: "{{secrets.FAXIMO_PASSWORD}}"
  input:
    - name: service_type
      value: "faximoSilver"  # または "faximo"（デフォルト: faximoSilver）
    - name: sendto
      value: "0312345678,0398765432"  # カンマ区切りのFAX番号
    - name: subject
      value: "重要なビジネス文書"
    - name: body
      value: |
        受信者様
        
        重要なビジネス文書を添付しましたので、ご確認ください。
        
        このFAXはJinba Flowにより自動送信されました。
        
        敬具
        会社名
    - name: attachment_urls
      value: "{{steps.prepare_fax_document.result}}"
    - name: attachment_names
      value: "document.pdf"
    - name: retrynum
      value: 1
    - name: resaddress
      value: "admin@yourcompany.com"

- id: log_fax_result
  name: log_fax_result
  tool: OUTPUT_TEXT
  needs: [send_important_fax]
  input:
    - name: value
      value: |
        FAX送信を受け付けました。
        結果コード: {{steps.send_important_fax.result.result}}
        プロセスキー: {{steps.send_important_fax.result.processkey}}
        受付時刻: {{steps.send_important_fax.result.accepttime}}
        詳細番号: {{steps.send_important_fax.result.idxcnt}}

- id: prepare_recipient_list
  name: prepare_recipient_list
  tool: PYTHON_SANDBOX_RUN
  input:
    - name: data_type
      value: OBJECT
    - name: code
      value: |
        import json

        # FAX受信者リストの準備
        recipients = [
            {"name": "会社A", "fax": "0311112222"},
            {"name": "会社B", "fax": "0333334444"},
            {"name": "会社C", "fax": "0355556666"}
        ]
        
        # カンマ区切りのFAX番号を作成
        fax_numbers = ",".join([r["fax"] for r in recipients])
        
        # 受信者サマリーを作成
        print(json.dumps({
            "fax_numbers": fax_numbers,
            "total_recipients": len(recipients),
            "recipients": recipients
        }, ensure_ascii=False))

- 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
  needs: [prepare_recipient_list, upload_campaign_document]
  config:
    - name: login_id
      value: "{{secrets.FAXIMO_LOGIN_ID}}"
    - name: password
      value: "{{secrets.FAXIMO_PASSWORD}}"
  input:
    - name: service_type
      value: "faximoSilver"
    - name: sendto
      value: "{{steps.prepare_recipient_list.result.data.fax_numbers}}"
    - name: subject
      value: "月次ニュースレター"
    - name: body
      value: |
        貴重なパートナー様
        
        月次ニュースレターを添付いたします。
        
        この通信には、弊社サービスに関する重要な更新情報が含まれています。
        
        継続的なパートナーシップに感謝いたします。
        
        敬具
        マーケティングチーム
    - name: attachment_urls
      value: "{{steps.upload_campaign_document.result}}"
    - name: attachment_names
      value: "newsletter.pdf"
    - name: userkey
      value: "newsletter-2026-09"
    - name: resaddress
      value: "admin@yourcompany.com"

- id: track_campaign_status
  name: track_campaign_status
  tool: OUTPUT_FILE
  needs: [send_bulk_fax, prepare_recipient_list]
  input:
    - name: content
      value: |
        FAXキャンペーンレポート
        ==================
        
        キャンペーン: 月次ニュースレター
        
        結果:
        - 結果コード: {{steps.send_bulk_fax.result.result}}
        - プロセスキー: {{steps.send_bulk_fax.result.processkey}}
        - 受付時刻: {{steps.send_bulk_fax.result.accepttime}}
        - 詳細番号: {{steps.send_bulk_fax.result.idxcnt}}
        
        受信者数: {{steps.prepare_recipient_list.result.data.total_recipients}}
        
        ステータス: 処理中
        
        次のステップ:
        1. 配信ステータスを監視
        2. 配信失敗を確認
        3. 配信確認をフォローアップ
    - name: filename
      value: "fax_campaign_report.txt"
    - name: fileType
      value: "txt"

- 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: "faximoSilver"
    - name: from
      value: "2026-09-01 00:00:00"
    - name: to
      value: "2026-09-30 23:59:59"
    - name: maximumresponse
      value: 100

- id: analyze_fax_performance
  name: analyze_fax_performance
  tool: PYTHON_SANDBOX_RUN
  needs: [search_recent_fax_history]
  input:
    - name: code
      value: |
        import json
        from collections import Counter
        
        # FAX履歴結果を解析（各エントリの `status` は13桁の送信結果コード）
        fax_history = json.loads(r'''{{steps.search_recent_fax_history.result.SendResultList}}''')
        
        if not fax_history:
            print("指定期間のFAX履歴が見つかりません。")
        else:
            total_faxes = len(fax_history)
            total_pages = sum(fax.get('pagenum', 0) for fax in fax_history)
            status_counts = Counter(fax.get('status', 'unknown') for fax in fax_history)
            
            print("FAXパフォーマンス分析")
            print("=" * 30)
            print(f"送信FAX総数: {total_faxes}")
            print(f"総ページ数: {total_pages}")
            print()
            print("送信結果コード:")
            for status, count in status_counts.most_common():
                print(f"  {status}: {count}")
            print()
            
            # 上位受信者
            recipients = [fax.get('sendto', '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
  needs: [search_recent_fax_history, analyze_fax_performance]
  input:
    - name: content
      value: |
        FAXパフォーマンスレポート
        ======================
        
        レポート期間: 2026-09-01 から 2026-09-30
        
        {{steps.analyze_fax_performance.result.data}}
        
        推奨事項:
        - 配信失敗を監視し、必要に応じて再送信
        - 送信失敗の受信者FAX番号を確認
        - 配信時間の最適化を検討
        - 互換性向上のため文書フォーマットを確認
        
        詳細な配信ログについては、Faximoサービスダッシュボードを確認してください。
    - name: filename
      value: "fax_performance_report.txt"
    - name: fileType
      value: "txt"

{
  "result": "000000",
  "processkey": "<プロセスキー>",
  "accepttime": "<受付時刻>",
  "idxcnt": "<13桁の詳細番号>"
}

{
  "result": "000000",
  "processkey": "<プロセスキー>",
  "accepttime": "<受付時刻>",
  "count": 1,
  "SendResultList": [
    {
      "idxcnt": "<13桁の詳細番号>",
      "subidxcnt": "<サブ詳細番号>",
      "userkey": "newsletter-2026-09",
      "accept_type": "<受付種別>",
      "senddate": "<送信処理日時>",
      "sendto": "0312345678",
      "tsid": "<TSID>",
      "resaddress": "admin@yourcompany.com",
      "subject": "月次ニュースレター",
      "pagenum": 2,
      "status": "<13桁の送信結果コード>",
      "statusdetail": "<送信結果詳細コード>"
    }
  ]
}