> ## Documentation Index > Fetch the complete documentation index at: https://docs.jinba.io/llms.txt > Use this file to discover all available pages before exploring further. # 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文書送信 ```yaml theme={null} - 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: "+1-555-123-4567,+1-555-987-6543" # 複数のFAX番号 - name: subject value: "重要なビジネス文書 - {{date | format('YYYY-MM-DD')}}" - name: body value: | 受信者様 重要なビジネス文書を添付しましたので、ご確認ください。 このFAXはJinba Flowにより自動送信されました。 敬具 会社名 - 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キャンペーン ```yaml theme={null} - id: prepare_recipient_list name: prepare_recipient_list tool: PYTHON_SANDBOX_RUN input: - name: code value: | # FAX受信者リストの準備 recipients = [ {"name": "会社A", "fax": "+1-555-111-2222"}, {"name": "会社B", "fax": "+1-555-333-4444"}, {"name": "会社C", "fax": "+1-555-555-6666"} ] # カンマ区切りの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: "admin@yourcompany.com" - 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履歴追跡 ```yaml theme={null} - 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送信レスポンス ```json theme={null} { "result_code": "SUCCESS", "process_key": "FAX123456789", "acceptance_time": "2024-01-15 14:30:00", "unique_detail_number": "DTL001234567" } ``` ### 履歴検索レスポンス ```json theme={null} { "history": [ { "id": "FAX123456", "recipient": "+1-555-123-4567", "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等）に準拠