falaai-api 1.21.47

data/docs/AuditoriaRiscoDetectionItemV2.md

@@ -0,0 +1,110 @@
+# FalaAI::AuditoriaRiscoDetectionItemV2
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **turn** | **Integer** | Turn number | [optional] |
+| **interlocutor** | **String** | Speaker | [optional] |
+| **role** | **String** | Role | [optional] |
+| **timestamp_start_s** | **Float** | Start (s) | [optional] |
+| **timestamp_end_s** | **Float** | End (s) | [optional] |
+| **timestamp_formatted** | **String** | Formatted timestamp | [optional] |
+| **term_text** | **String** | Detected term | [optional] |
+| **suggested_term_for_bank** | **Object** | Suggested term for bank | [optional] |
+| **category** | **String** | Category code | [optional] |
+| **category_label** | **String** | Category label (i18n) |  |
+| **category_color** | **String** | Category color | [optional] |
+| **category_icon** | **String** | Category icon | [optional] |
+| **criticality** | **String** | Criticality | [optional] |
+| **category_threshold** | **Float** | Category threshold | [optional] |
+| **category_type** | **String** | Category type | [optional] |
+| **category_group** | **String** | Category group label (i18n) |  |
+| **nature** | **String** | Nature | [optional] |
+| **llm_confidence** | **Float** | LLM confidence | [optional] |
+| **reason** | **String** | Reason | [optional] |
+| **is_valid_context** | **Boolean** | Valid context | [optional] |
+| **risk_probability** | **Float** | Risk probability | [optional] |
+| **risk_impact** | **Float** | Risk impact | [optional] |
+| **category_weight** | **Float** | Category weight | [optional] |
+| **turn_sentiment** | **String** | Turn sentiment | [optional] |
+| **intensity** | **Object** | Intensity | [optional] |
+| **mod_applied** | **Float** | Total modifier applied | [optional] |
+| **mac_applied** | **Float** | Audio modifier applied | [optional] |
+| **mvad_applied** | **Float** | Intensity modifier applied | [optional] |
+| **mod_formula** | **String** | Modifier formula | [optional] |
+| **mac_details** | **Array<Hash<String, Object>>** | MAC details | [optional] |
+| **calibration_reason** | **String** | Calibration reason | [optional] |
+| **final_score** | **Float** | Final score | [optional] |
+| **final_score_formula** | **String** | Final score formula | [optional] |
+| **conversation_limit** | **Object** | Conversation limit | [optional] |
+| **apply_saturation** | **Boolean** | Apply saturation | [optional] |
+| **block_repetition** | **Boolean** | Block repetition | [optional] |
+| **status** | **String** | Status | [optional] |
+| **effective_impact** | **Float** | Effective impact | [optional] |
+| **saturation_factor** | **Float** | Saturation factor | [optional] |
+| **saturation_formula** | **String** | Saturation formula | [optional] |
+| **threshold_formula** | **String** | Threshold formula | [optional] |
+| **blocked_formula** | **String** | Blocked formula | [optional] |
+| **reconciliation_note** | **String** | Reconciliation note | [optional] |
+| **violated_frameworks** | **Array<Object>** | Violated frameworks | [optional] |
+| **citation_fidelity** | **Boolean** | Citation fidelity | [optional][default to true] |
+| **subcategory** | **String** | Subcategory code | [optional] |
+| **subcategory_label** | **String** | Subcategory label (i18n) | [optional] |
+
+## Example
+
+```ruby
+require 'falaai-api'
+
+instance = FalaAI::AuditoriaRiscoDetectionItemV2.new(
+  turn: null,
+  interlocutor: null,
+  role: null,
+  timestamp_start_s: null,
+  timestamp_end_s: null,
+  timestamp_formatted: null,
+  term_text: null,
+  suggested_term_for_bank: null,
+  category: null,
+  category_label: null,
+  category_color: null,
+  category_icon: null,
+  criticality: null,
+  category_threshold: null,
+  category_type: null,
+  category_group: null,
+  nature: null,
+  llm_confidence: null,
+  reason: null,
+  is_valid_context: null,
+  risk_probability: null,
+  risk_impact: null,
+  category_weight: null,
+  turn_sentiment: null,
+  intensity: null,
+  mod_applied: null,
+  mac_applied: null,
+  mvad_applied: null,
+  mod_formula: null,
+  mac_details: null,
+  calibration_reason: null,
+  final_score: null,
+  final_score_formula: null,
+  conversation_limit: null,
+  apply_saturation: null,
+  block_repetition: null,
+  status: null,
+  effective_impact: null,
+  saturation_factor: null,
+  saturation_formula: null,
+  threshold_formula: null,
+  blocked_formula: null,
+  reconciliation_note: null,
+  violated_frameworks: null,
+  citation_fidelity: null,
+  subcategory: null,
+  subcategory_label: null
+)
+```
+

data/docs/AuditoriaRiscoDetectionsV2.md

@@ -0,0 +1,26 @@
+# FalaAI::AuditoriaRiscoDetectionsV2
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **violations** | [**Array<AuditoriaRiscoDetectionItemV2>**](AuditoriaRiscoDetectionItemV2.md) | Active violations | [optional] |
+| **positives** | [**Array<AuditoriaRiscoDetectionItemV2>**](AuditoriaRiscoDetectionItemV2.md) | Active positives | [optional] |
+| **client_risk_alerts** | **Array<Hash<String, Object>>** | Client risk alerts | [optional] |
+| **client_behavior_alerts** | **Array<Hash<String, Object>>** | Client behavior alerts | [optional] |
+| **client_negatives** | [**Array<AuditoriaRiscoDetectionItemV2>**](AuditoriaRiscoDetectionItemV2.md) | Client negatives | [optional] |
+
+## Example
+
+```ruby
+require 'falaai-api'
+
+instance = FalaAI::AuditoriaRiscoDetectionsV2.new(
+  violations: null,
+  positives: null,
+  client_risk_alerts: null,
+  client_behavior_alerts: null,
+  client_negatives: null
+)
+```
+

data/docs/AuditoriaRiscoIndexerV2.md

@@ -0,0 +1,18 @@
+# FalaAI::AuditoriaRiscoIndexerV2
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **suggested_terms_for_bank** | **Array<Hash<String, Object>>** | Suggested terms for bank | [optional] |
+
+## Example
+
+```ruby
+require 'falaai-api'
+
+instance = FalaAI::AuditoriaRiscoIndexerV2.new(
+  suggested_terms_for_bank: null
+)
+```
+

data/docs/AuditoriaRiscoMetaV2.md

@@ -0,0 +1,28 @@
+# FalaAI::AuditoriaRiscoMetaV2
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** | Analysis id |  |
+| **object** | **String** | Object type | [optional][default to 'auditoria_risco'] |
+| **call_duration_s** | **Float** | Call duration (s) | [optional] |
+| **analyzed_at** | **String** | ISO 8601 analyzed timestamp | [optional] |
+| **usage** | [**AuditoriaRiscoUsageV2**](AuditoriaRiscoUsageV2.md) | Usage block |  |
+| **client_reference_id** | **String** | Echoed client reference id | [optional] |
+
+## Example
+
+```ruby
+require 'falaai-api'
+
+instance = FalaAI::AuditoriaRiscoMetaV2.new(
+  id: null,
+  object: null,
+  call_duration_s: null,
+  analyzed_at: null,
+  usage: null,
+  client_reference_id: null
+)
+```
+

data/docs/AuditoriaRiscoParticipantV2.md

@@ -0,0 +1,22 @@
+# FalaAI::AuditoriaRiscoParticipantV2
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **interlocutor** | **String** | Speaker label | [optional] |
+| **name** | **String** | Participant name | [optional] |
+| **role** | **String** | Role (agent/client/bot/unknown) | [optional] |
+
+## Example
+
+```ruby
+require 'falaai-api'
+
+instance = FalaAI::AuditoriaRiscoParticipantV2.new(
+  interlocutor: null,
+  name: null,
+  role: null
+)
+```
+

data/docs/AuditoriaRiscoParticipantsV2.md

@@ -0,0 +1,26 @@
+# FalaAI::AuditoriaRiscoParticipantsV2
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **identified** | [**Array<AuditoriaRiscoParticipantV2>**](AuditoriaRiscoParticipantV2.md) | Identified participants | [optional] |
+| **call_direction** | **String** | inbound/outbound | [optional] |
+| **role_inference_reliable** | **Boolean** | Role inference reliability | [optional][default to true] |
+| **identification_status** | **String** | Identification status | [optional][default to 'none'] |
+| **unidentified_items_count** | **Integer** | Unidentified items count | [optional][default to 0] |
+
+## Example
+
+```ruby
+require 'falaai-api'
+
+instance = FalaAI::AuditoriaRiscoParticipantsV2.new(
+  identified: null,
+  call_direction: null,
+  role_inference_reliable: null,
+  identification_status: null,
+  unidentified_items_count: null
+)
+```
+

data/docs/AuditoriaRiscoRequest.md

@@ -0,0 +1,38 @@
+# FalaAI::AuditoriaRiscoRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **model** | **String** | Analysis model. Always 'falaai-auditoria-risco-1' | [optional][default to 'falaai-auditoria-risco-1'] |
+| **text** | **String** | Plain transcript (fallback if dialog is empty). At least one of 'dialog' or 'text' required. Max 300,000 characters | [optional][default to ''] |
+| **dialog** | **String** | Diarized transcript with speaker turns. PRIMARY source. Speaker labels accepted (any case): 'Speaker N', 'Interlocutor N', 'Hablante N', 'Locutor N', 'Orador N' (space or underscore). Normalized internally to 'Speaker N' in the response. Max 300,000 characters | [optional][default to ''] |
+| **audio_events** | [**Array<DiagnosticAudioEvent>**](DiagnosticAudioEvent.md) | Audio events with timestamps (correlated with turns when diarization is present) | [optional] |
+| **duration_seconds** | **Float** | Total audio duration in seconds. Required. Max 3h (10800s). |  |
+| **language** | **String** | Language of the transcript being analyzed. Must match the dialog/text language. Accepted: pt-BR, en-US, es-ES. |  |
+| **response_language** | **String** | Language for analysis results (labels, categories, levels, actions, HTML report). Can differ from 'language'. Accepted: pt-BR, en-US, es-ES. |  |
+| **call_direction** | **String** | Who originated the call. inbound=client called, outbound=company called. If omitted, LLM infers from context. | [optional] |
+| **participants** | [**Array<Participant>**](Participant.md) | Explicit participant roles. If omitted, LLM infers from dialog (Lei 17). When provided, used as ground truth — no inference. | [optional] |
+| **response_format** | **String** | Response format version. v1=legacy flat PT-BR, v2=structured EN-US blocks. | [optional][default to 'v2'] |
+| **client_reference_id** | **String** | Optional client-supplied ID echoed verbatim in the response. Use to correlate/sync with your system. Accepted charset: [A-Za-z0-9._:-], max 128 chars. Not idempotency. | [optional] |
+
+## Example
+
+```ruby
+require 'falaai-api'
+
+instance = FalaAI::AuditoriaRiscoRequest.new(
+  model: falaai-auditoria-risco-1,
+  text: null,
+  dialog: Speaker 1: [00:00:00.540 - 00:00:01.139] Hi, Alex.,
+  audio_events: null,
+  duration_seconds: null,
+  language: pt-BR,
+  response_language: en-US,
+  call_direction: inbound,
+  participants: [{interlocutor=Interlocutor 1, name=Antonio, role=client}, {interlocutor=Interlocutor 2, name=Maria, role=agent}],
+  response_format: v2,
+  client_reference_id: call-2026-08-30-001
+)
+```
+

data/docs/AuditoriaRiscoScoresV2.md

@@ -0,0 +1,20 @@
+# FalaAI::AuditoriaRiscoScoresV2
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **conversation** | [**AuditoriaRiscoConversationScoresV2**](AuditoriaRiscoConversationScoresV2.md) | Conversation scores |  |
+| **per_participant** | **Hash<String, Object>** | Per-participant KPIs | [optional] |
+
+## Example
+
+```ruby
+require 'falaai-api'
+
+instance = FalaAI::AuditoriaRiscoScoresV2.new(
+  conversation: null,
+  per_participant: null
+)
+```
+

data/docs/AuditoriaRiscoScoringExplanationV2.md

@@ -0,0 +1,20 @@
+# FalaAI::AuditoriaRiscoScoringExplanationV2
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **summary** | **String** | Explanation summary | [optional] |
+| **steps** | **Array<Object>** | Explanation steps | [optional] |
+
+## Example
+
+```ruby
+require 'falaai-api'
+
+instance = FalaAI::AuditoriaRiscoScoringExplanationV2.new(
+  summary: null,
+  steps: null
+)
+```
+

data/docs/AuditoriaRiscoSummaryV2.md

@@ -0,0 +1,48 @@
+# FalaAI::AuditoriaRiscoSummaryV2
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **total_turns** | **Integer** | Total turns | [optional] |
+| **total_calibrated** | **Integer** | Total calibrated detections | [optional] |
+| **active** | **Integer** | Active detections | [optional] |
+| **tolerated** | **Integer** | Tolerated detections | [optional] |
+| **blocked** | **Integer** | Blocked detections | [optional] |
+| **audio_events_used** | **Integer** | Audio events used | [optional] |
+| **audio_events_aggravated** | **Integer** | Audio events aggravated | [optional] |
+| **mac_audio_applied** | **Object** | MAC audio applied | [optional] |
+| **mvad_applied** | **Object** | MVAD applied | [optional] |
+| **total_participants** | **Integer** | Total participants | [optional] |
+| **total_agents** | **Integer** | Total agents | [optional] |
+| **total_clients** | **Integer** | Total clients | [optional] |
+| **total_bots** | **Integer** | Total bots | [optional] |
+| **total_unknown** | **Integer** | Total unknown | [optional] |
+| **client_risk_alerts_count** | **Integer** | Client risk alerts count | [optional] |
+| **client_behavior_alerts_count** | **Integer** | Client behavior alerts count | [optional] |
+
+## Example
+
+```ruby
+require 'falaai-api'
+
+instance = FalaAI::AuditoriaRiscoSummaryV2.new(
+  total_turns: null,
+  total_calibrated: null,
+  active: null,
+  tolerated: null,
+  blocked: null,
+  audio_events_used: null,
+  audio_events_aggravated: null,
+  mac_audio_applied: null,
+  mvad_applied: null,
+  total_participants: null,
+  total_agents: null,
+  total_clients: null,
+  total_bots: null,
+  total_unknown: null,
+  client_risk_alerts_count: null,
+  client_behavior_alerts_count: null
+)
+```
+

data/docs/AuditoriaRiscoTimelineV2.md

@@ -0,0 +1,22 @@
+# FalaAI::AuditoriaRiscoTimelineV2
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **turns_sentiment** | **Array<Hash<String, Object>>** | Per-turn sentiment | [optional] |
+| **audio_events** | **Array<Hash<String, Object>>** | Audio events (i18n) | [optional] |
+| **audio_groups_found** | **Array<Hash<String, Object>>** | Audio groups found | [optional] |
+
+## Example
+
+```ruby
+require 'falaai-api'
+
+instance = FalaAI::AuditoriaRiscoTimelineV2.new(
+  turns_sentiment: null,
+  audio_events: null,
+  audio_groups_found: null
+)
+```
+

data/docs/AuditoriaRiscoUsageV2.md

@@ -0,0 +1,22 @@
+# FalaAI::AuditoriaRiscoUsageV2
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **characters** | **Integer** | Characters analyzed |  |
+| **credits_consumed** | **Integer** | Credits consumed |  |
+| **processing_ms** | **Integer** | Processing time (ms) |  |
+
+## Example
+
+```ruby
+require 'falaai-api'
+
+instance = FalaAI::AuditoriaRiscoUsageV2.new(
+  characters: null,
+  credits_consumed: null,
+  processing_ms: null
+)
+```
+

data/docs/AuditoriaRiscoV2.md

@@ -0,0 +1,46 @@
+# FalaAI::AuditoriaRiscoV2
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **meta** | [**AuditoriaRiscoMetaV2**](AuditoriaRiscoMetaV2.md) | Identification + usage |  |
+| **participants** | [**AuditoriaRiscoParticipantsV2**](AuditoriaRiscoParticipantsV2.md) | Participants/roles/direction |  |
+| **verdict** | [**AuditoriaRiscoVerdictV2**](AuditoriaRiscoVerdictV2.md) | Verdict + level + applied actions |  |
+| **scores** | [**AuditoriaRiscoScoresV2**](AuditoriaRiscoScoresV2.md) | Consolidated + per-participant scores |  |
+| **detections** | [**AuditoriaRiscoDetectionsV2**](AuditoriaRiscoDetectionsV2.md) | violations/positives/client alerts |  |
+| **analysis** | [**AuditoriaRiscoAnalysisV2**](AuditoriaRiscoAnalysisV2.md) | global_metrics + final_analysis + frameworks |  |
+| **timeline** | [**AuditoriaRiscoTimelineV2**](AuditoriaRiscoTimelineV2.md) | turns_sentiment + audio_events + groups |  |
+| **audio_event_model** | [**AuditoriaRiscoAudioEventModelV2**](AuditoriaRiscoAudioEventModelV2.md) | MAC audio event semantics |  |
+| **categories_summary** | **Hash<String, Object>** | Per-category summary (keyed by category) |  |
+| **indexer** | [**AuditoriaRiscoIndexerV2**](AuditoriaRiscoIndexerV2.md) | Suggested terms for bank |  |
+| **summary** | [**AuditoriaRiscoSummaryV2**](AuditoriaRiscoSummaryV2.md) | Executive summary counts |  |
+| **acoes_i18n** | **Hash<String, Object>** | Used actions i18n catalog (keyed by action) |  |
+| **audit_decisions** | [**AuditoriaRiscoAuditDecisionsV2**](AuditoriaRiscoAuditDecisionsV2.md) | Risk origin + validator changes |  |
+| **scoring_explanation** | [**AuditoriaRiscoScoringExplanationV2**](AuditoriaRiscoScoringExplanationV2.md) | Score composition explanation |  |
+| **html_report** | **String** | HTML report (base64 gzip) |  |
+
+## Example
+
+```ruby
+require 'falaai-api'
+
+instance = FalaAI::AuditoriaRiscoV2.new(
+  meta: null,
+  participants: null,
+  verdict: null,
+  scores: null,
+  detections: null,
+  analysis: null,
+  timeline: null,
+  audio_event_model: null,
+  categories_summary: null,
+  indexer: null,
+  summary: null,
+  acoes_i18n: null,
+  audit_decisions: null,
+  scoring_explanation: null,
+  html_report: null
+)
+```
+

data/docs/AuditoriaRiscoV2Response.md

@@ -0,0 +1,18 @@
+# FalaAI::AuditoriaRiscoV2Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **response** | [**AuditoriaRiscoV2**](AuditoriaRiscoV2.md) | Public response V2 — always returned |  |
+
+## Example
+
+```ruby
+require 'falaai-api'
+
+instance = FalaAI::AuditoriaRiscoV2Response.new(
+  response: null
+)
+```
+

data/docs/AuditoriaRiscoVerdictV2.md

@@ -0,0 +1,30 @@
+# FalaAI::AuditoriaRiscoVerdictV2
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **label** | **String** | Human-readable verdict | [optional] |
+| **level_code** | **String** | Classification level code | [optional] |
+| **color** | **String** | Level color | [optional] |
+| **icon** | **String** | Level icon | [optional] |
+| **risk_matrix** | **Hash<String, Object>** | Risk matrix | [optional] |
+| **applied_actions** | [**Array<AuditoriaRiscoAppliedActionV2>**](AuditoriaRiscoAppliedActionV2.md) | Applied actions | [optional] |
+| **decision_details** | **Object** | Decision details | [optional] |
+
+## Example
+
+```ruby
+require 'falaai-api'
+
+instance = FalaAI::AuditoriaRiscoVerdictV2.new(
+  label: null,
+  level_code: null,
+  color: null,
+  icon: null,
+  risk_matrix: null,
+  applied_actions: null,
+  decision_details: null
+)
+```
+

data/docs/CreateEmailAlertRequest.md

@@ -0,0 +1,22 @@
+# FalaAI::CreateEmailAlertRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **name** | **String** | Nome identificador |  |
+| **email** | **String** | Email destino |  |
+| **events** | [**Array<EmailEvent>**](EmailEvent.md) | Eventos subscritos |  |
+
+## Example
+
+```ruby
+require 'falaai-api'
+
+instance = FalaAI::CreateEmailAlertRequest.new(
+  name: Financeiro,
+  email: finance@empresa.com,
+  events: [payment.failed, subscription.renewed]
+)
+```
+

data/docs/CreateWebhookRequest.md

@@ -0,0 +1,24 @@
+# FalaAI::CreateWebhookRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **name** | **String** | Nome identificador do webhook |  |
+| **url** | **String** | URL HTTPS que recebera POST com HMAC FalaAI-Signature |  |
+| **events** | [**Array<WebhookEvent>**](WebhookEvent.md) | Eventos subscritos (10 alertas) |  |
+| **retry_enabled** | **Boolean** | Retry exponencial 5 tentativas quando true (false=1 tentativa) | [optional][default to false] |
+
+## Example
+
+```ruby
+require 'falaai-api'
+
+instance = FalaAI::CreateWebhookRequest.new(
+  name: Alertas FalaAI,
+  url: https://webhook.site/00000000-0000-0000-0000-000000000000,
+  events: [credits.low, credits.exhausted, payment.failed],
+  retry_enabled: false
+)
+```
+

data/docs/DiagnosticAnalysisMap.md

@@ -0,0 +1,28 @@
+# FalaAI::DiagnosticAnalysisMap
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **dialogue_summary** | [**DiagnosticTextAnalysis**](DiagnosticTextAnalysis.md) | Detailed conversation summary |  |
+| **contact_reason** | [**DiagnosticTextAnalysis**](DiagnosticTextAnalysis.md) | Initial contact reason |  |
+| **identified_action** | [**DiagnosticCategoricalAnalysis**](DiagnosticCategoricalAnalysis.md) | Action taken / resolution |  |
+| **identified_label** | [**DiagnosticCategoricalAnalysis**](DiagnosticCategoricalAnalysis.md) | Theme classification |  |
+| **sentiment** | [**DiagnosticCategoricalAnalysis**](DiagnosticCategoricalAnalysis.md) | Predominant sentiment |  |
+| **participants_identified** | [**Array<ParticipantDiagnostic>**](ParticipantDiagnostic.md) | Identified participants and roles (same field names as auditoria) | [optional] |
+
+## Example
+
+```ruby
+require 'falaai-api'
+
+instance = FalaAI::DiagnosticAnalysisMap.new(
+  dialogue_summary: null,
+  contact_reason: null,
+  identified_action: null,
+  identified_label: null,
+  sentiment: null,
+  participants_identified: null
+)
+```
+

data/docs/DiagnosticAudioEvent.md

@@ -0,0 +1,26 @@
+# FalaAI::DiagnosticAudioEvent
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **event** | **String** | Audio event type. E.g.: [laughter], [sigh] |  |
+| **start_s** | **Float** | Start time in seconds | [optional] |
+| **end_s** | **Float** | End time in seconds | [optional] |
+| **duration_s** | **Float** | Duration in seconds | [optional] |
+| **formatted_timestamp** | **String** | Formatted timestamp (HH:MM:SS.ms) | [optional] |
+
+## Example
+
+```ruby
+require 'falaai-api'
+
+instance = FalaAI::DiagnosticAudioEvent.new(
+  event: [laughter],
+  start_s: 72.98,
+  end_s: 74.34,
+  duration_s: 1.36,
+  formatted_timestamp: 00:01:12.980
+)
+```
+

data/docs/DiagnosticCategoricalAnalysis.md

@@ -0,0 +1,22 @@
+# FalaAI::DiagnosticCategoricalAnalysis
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **list_choice** | **String** | Selected value from classification list (used in action, label, sentiment) | [optional] |
+| **justification** | **String** | Justification for the choice | [optional] |
+| **evidence_phrases** | **Array<String>** | Verbatim transcript excerpts supporting the analysis | [optional] |
+
+## Example
+
+```ruby
+require 'falaai-api'
+
+instance = FalaAI::DiagnosticCategoricalAnalysis.new(
+  list_choice: Informative,
+  justification: Information about required documentation was provided,
+  evidence_phrases: [[00:01:36.640 - 00:02:02.659] No, same thing: proof of address...]
+)
+```
+

data/docs/DiagnosticRequest.md

@@ -0,0 +1,30 @@
+# FalaAI::DiagnosticRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **model** | **String** | Analysis model. Always 'falaai-diagnostic-1' | [optional][default to 'falaai-diagnostic-1'] |
+| **text** | **String** | Plain transcript (fallback if dialog is empty). At least one of 'dialog' or 'text' required. Max 300,000 characters | [optional][default to ''] |
+| **dialog** | **String** | Diarized transcript with speaker turns. PRIMARY source. At least one of 'dialog' or 'text' required. Speaker labels accepted (any case): 'Speaker N', 'Interlocutor N', 'Hablante N', 'Locutor N', 'Orador N' (space or underscore). Normalized internally to 'Speaker N' in the response. Max 300,000 characters | [optional][default to ''] |
+| **audio_events** | [**Array<DiagnosticAudioEvent>**](DiagnosticAudioEvent.md) | Detected audio events with timestamps (required when using dialog) | [optional] |
+| **language** | **String** | Transcript language. Required. Accepted: en-US, pt-BR, es-ES, es-MX, fr-FR, de-DE, it-IT, pt-PT, zh-CN, ja-JP, ko-KR, ar-SA, hi-IN, ru-RU, id-ID, tr-TR, nl-NL, pl-PL, vi-VN, th-TH, en-GB |  |
+| **duration_seconds** | **Float** | Total audio duration in seconds. Required. Max 3h (10800s). |  |
+| **client_reference_id** | **String** | Optional client-supplied ID echoed verbatim in the response. Use to correlate/sync with your system. Accepted charset: [A-Za-z0-9._:-], max 128 chars. Not idempotency. | [optional] |
+
+## Example
+
+```ruby
+require 'falaai-api'
+
+instance = FalaAI::DiagnosticRequest.new(
+  model: falaai-diagnostic-1,
+  text: null,
+  dialog: Speaker 1: [00:00:00.540 - 00:00:01.139] Hi, Alex.,
+  audio_events: null,
+  language: pt-BR,
+  duration_seconds: null,
+  client_reference_id: call-2026-08-30-001
+)
+```
+