falaai-api 1.21.49 → 1.21.54

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cd424a4222684b15b8858c2545873748ae0186905e13df8b87edb5b9cc7a0176
-  data.tar.gz: 36d4614309d8ddeaa0b647fb7a9f141a4ed102fbb7761faafa8b3fb106e3cb54
+  metadata.gz: 2124fbb4e1ed6511a5749326aa954da95d70c298e244a5b80dc09c214b66f8d3
+  data.tar.gz: ea43b97e08f90260511970b2616066aef0433d0948a512a12e34c36bfa7ba0e2
 SHA512:
-  metadata.gz: 4eab457d32570575ae15027dd0e4499330d3aeb7fc6447bc67674c5ace493a6aca993c590155b596efae744bfdb65079f2f631f745bd14e1898e86b61c673926
-  data.tar.gz: da26196663d8efa3e9f4fa79d124739c698ca455187fd84e510fc6a0c08a41581d7b691cc07595f711a2f95c24cfc71932da0bd9af1a3a3b077a0b4d97757b30
+  metadata.gz: 9c41a3551e9c471ff24cdfbd1849ff772af1ed55844834dfb22299d0a6f5f44e5bd7b16f2ac3595db8df0a02d7c62771c53fd0b02982351f883cec089dfe5808
+  data.tar.gz: c90657bb08a24f46ca3854bea50be4f6e1a05e60885c3afab871f51925fc238b2b98565456a43d11aa5e3d945081f217f704a9dc1d2696e8eed8b0494d303627

data/README.md

@@ -28,23 +28,6 @@ Telegram voice -> your STT           ->  FalaAI Risk Audit
 CRM conversation                     ->  FalaAI Risk Audit
 ```
 
-## Use the APIs the way you want
-
-Every FalaAI API is **independent and optional** — chain any subset, in any combination.
-
-```mermaid
-flowchart LR
-  A["Audio"] -.->|optional| T["Transcribe"]
-  T --> X["Text / dialog"]
-  S["Your own STT / CRM / chat / existing transcript"] --> X
-  X -.->|optional| D["Diagnostic"]
-  X -.->|optional| R["Risk Audit"]
-  D --> O["Structured intelligence + auditable report"]
-  R --> O
-```
-
-> Skip **Transcribe** if you already have text. Call only **Diagnostic**, only **Risk Audit**, or both.
-
 ## Install
 
 ```bash
@@ -137,10 +120,38 @@ FalaAI API is an **AI conversation-intelligence API** for analyzing customer-ser
 
 ## Use cases
 
-- **Contact center / Quality** — audit 100% of conversations instead of a sample.
-- **Compliance / Legal** — auditable evidence for audits and disputes.
-- **CX / Operations** — risk score, sentiment and reason per conversation.
-- **BI / Data** — typed JSON ready for your database or analytics stack.
+- **Contact center / Quality** - audit 100% of conversations instead of a sample.
+- **Compliance / Legal** - auditable evidence for audits and disputes.
+- **CX / Operations** - risk score, sentiment and reason per conversation.
+- **Sales** - analyze sales calls and extract structured outcomes.
+- **BI / Data** - typed JSON ready for your database or analytics stack.
+
+## Why FalaAI
+
+- **Audit 100%, not a sample** - every conversation gets a score, not a random QA sample.
+- **Auditable by design** - a compliance risk score with detections/violations and an HTML report you can hand to an auditor.
+- **Credits, not tokens** - you know exactly what each call costs (per second of audio, per character of text, per conversation). Monthly plans + non-expiring top-up packs.
+- **Zero-storage** - audio/text/results are processed and discarded; only usage/audit records remain. TLS in transit + at rest, per-account isolation (multitenancy), LGPD (you are the controller; Action Tec is the processor).
+- **Multilingual** — transcription in **31 languages**, diagnosis in **21 locales**, risk audit and HTML reports in **3** (PT/EN/ES) · **start free** (no card).
+- **B2B ready** - one Enterprise plan serves N clients, no per-user fee (ideal for ISVs).
+
+## Integrations
+
+FalaAI is **language-independent** - integrate at **any point** of your pipeline (capture, transcription, analysis or audit). Common ecosystems:
+
+| Ecosystem | How |
+|---|---|
+| **PABX / telephony (3CX, Asterisk, Genesys)** | Send the recording to Transcribe, or the transcript to Diagnostic/Risk Audit. |
+| **CRM / ERP (Odoo, Salesforce, SAP Service Cloud, HubSpot)** | Attach the structured JSON (summary, reason, sentiment, risk score) to the record. |
+| **Contact center / QA (Zendesk, Twilio Flex, Take Blip)** | Batch-audit conversations and feed the score into your QA dashboard. |
+| **Chatbots / messaging (WhatsApp, Telegram, Microsoft Teams)** | Extract conversations from an export and analyze them. |
+| **BI / Data** | Typed JSON ready for your warehouse or analytics stack. |
+
+> These are **integration examples**, not certified native integrations. Any platform can integrate through **REST / cURL** - the standard, language-independent path. Native ingestion connectors are on the roadmap.
+
+## BYOT - Bring Your Own Transcription
+
+Already have speech-to-text (Whisper, Deepgram, AssemblyAI, your own)? **Skip Transcription** and send the text straight to **Diagnostic** and/or **Risk Audit**. You only pay for what you use.
 
 ## SDK surface (Ruby)
 
@@ -151,15 +162,16 @@ FalaAI API is an **AI conversation-intelligence API** for analyzing customer-ser
 | `HealthApi` | `FalaAI` | `health_check` |
 | `SpeechApi` | `FalaAI` | `create_transcription_v1_audio_transcriptions_post_with_http_info(...)` |
 | `AnalysisApi` | `FalaAI` | `create_diagnostic_v1_analyze_diagnostic_post_with_http_info(...)`, `create_risk_audit_v1_analyze_risk_audit_post_with_http_info(...)` |
+| `WhatsappApi` | `FalaAI` | `extract_conversations_v1_whatsapp_extract_conversations_post_with_http_info(...)` |
 | `UsageApi` / `WebhooksApi` / `EmailAlertsApi` / `VersionApi` | `FalaAI` | management |
-| Models | `FalaAI` | `DiagnosticRequest`, `RiskAuditRequest`, `Participant`, `DiagnosticAudioEvent` |
+| Models | `FalaAI` | `DiagnosticRequest`, `RiskAuditRequest`, `Participant`, `DiagnosticAudioEvent`, `WhatsappConversationsResponse` |
 | `ApiError` | `FalaAI` | HTTP errors |
 
 > Model IDs: `falaai-transcribe-1`, `falaai-diagnostic-1`, `falaai-risk-audit-1`.
 
 ## Examples
 
-Runnable examples in [`examples/`](./examples): `health.rb`, `transcribe.rb`, `diagnose.rb`, `audit.rb`.
+Runnable examples in [`examples/`](./examples): `health.rb`, `transcribe.rb`, `diagnose.rb`, `audit.rb`, `whatsapp.rb`.
 
 ## Authentication
 
@@ -180,19 +192,6 @@ rescue FalaAI::ApiError => e
 end
 ```
 
-## Where to integrate (this SDK)
-
-FalaAI is language-independent; this package targets **Ruby** backends.
-
-| Platform / environment (this SDK's language: **Ruby**) | Integration |
-|---|---|
-| **Ruby on Rails** apps | `falaai-api` (Ruby) |
-| Ruby workers / Sidekiq jobs | `falaai-api` (Ruby) |
-| Ruby data pipelines | `falaai-api` (Ruby) |
-| Other stacks (3CX, Salesforce, Genesys...) | REST / cURL — [API reference](https://api01-falaai.action.tec.br/docs) (or the SDK for that backend's language) |
-
-> These are **integration examples**, not certified native integrations. Any platform can integrate through **REST / cURL** — see the [API reference](https://api01-falaai.action.tec.br/docs). Authenticated calls use `Authorization: Bearer fai_<key>`.
-
 ## Production usage
 
 - Store API keys in environment variables or a secret manager — never hard-code.
@@ -204,7 +203,7 @@ FalaAI is language-independent; this package targets **Ruby** backends.
 | Requirement | Version |
 |---|---|
 | Ruby | 2.7+ |
-| API | v1.21.49 |
+| API | v1.21.54 |
 
 ## Documentation
 
@@ -217,7 +216,7 @@ FalaAI is language-independent; this package targets **Ruby** backends.
 
 ## Versioning
 
-Semantic versioning; the SDK version tracks the API version (`1.21.49`). See [CHANGELOG.md](CHANGELOG.md) and [Releases](https://github.com/ActionTecBr/falaai-api-ruby/releases).
+Semantic versioning; the SDK version tracks the API version (`1.21.54`). See [CHANGELOG.md](CHANGELOG.md) and [Releases](https://github.com/ActionTecBr/falaai-api-ruby/releases).
 
 ## Security
 

data/docs/AnalysisApi.md

@@ -26,7 +26,7 @@ FalaAI.configure do |config|
 end
 
 api_instance = FalaAI::AnalysisApi.new
-diagnostic_request = FalaAI::DiagnosticRequest.new({language: 'language_example', duration_seconds: 3.56}) # DiagnosticRequest | 
+diagnostic_request = FalaAI::DiagnosticRequest.new({language: 'language_example'}) # DiagnosticRequest | 
 
 begin
   # Analyze a call transcript — 5 parallel analyses
@@ -93,7 +93,7 @@ FalaAI.configure do |config|
 end
 
 api_instance = FalaAI::AnalysisApi.new
-risk_audit_request = FalaAI::RiskAuditRequest.new({duration_seconds: 3.56, language: 'language_example', response_language: 'response_language_example'}) # RiskAuditRequest | 
+risk_audit_request = FalaAI::RiskAuditRequest.new({dialog: 'dialog_example', duration_seconds: 3.56, language: 'language_example', response_language: 'response_language_example'}) # RiskAuditRequest | 
 
 begin
   # Compliance Risk Audit — conversation compliance analysis

data/docs/DiagnosticParticipant.md

@@ -6,7 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **interlocutor** | **String** | Exact speaker label from the dialog (e.g. 'Speaker 1') |  |
 | **name** | **String** | Participant name (optional) | [optional] |
-| **role** | **String** | agent | client | bot |  |
+| **role** | **String** | agent | client | bot (optional — omit/empty when unknown) | [optional] |
 
 ## Example
 

data/docs/DiagnosticRequest.md

@@ -10,8 +10,8 @@
 | **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 |  |
 | **response_language** | **String** | Language for the analysis results (labels, categories, levels). Can differ from 'language' (input). If omitted, uses 'language'. Accepted: en-US, es-ES, es-MX, pt-BR, 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. | [optional] |
-| **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] |
+| **duration_seconds** | **Float** | Total audio duration in seconds. Optional when using only 'text' (ignored — not read/used). Required when using 'dialog' (must be >= last turn end). Max 3h (10800s). | [optional] |
+| **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 60 chars. Not idempotency. | [optional] |
 | **call_direction** | **String** | Who originated the call. inbound=client called, outbound=company called. If omitted, the LLM infers from context. | [optional] |
 | **participants** | [**Array<DiagnosticParticipant>**](DiagnosticParticipant.md) | Explicit participant roles. If omitted, the LLM infers from the dialog. When provided, used as ground truth (no inference) and echoed in analysis.participants_identified. | [optional] |
 

data/docs/DiagnosticResponse.md

@@ -10,6 +10,7 @@
 | **analysis** | [**DiagnosticAnalysisMap**](DiagnosticAnalysisMap.md) | The 6 conversation analyses (5 + participants) |  |
 | **usage** | [**DiagnosticUsage**](DiagnosticUsage.md) | Usage and processing information |  |
 | **client_reference_id** | **String** | Client-supplied ID echoed verbatim (if provided in request) | [optional] |
+| **html_report** | **String** | Visual HTML report of the diagnosis (base64 gzip). Only present when 'dialog' is provided; null for text-only requests. | [optional] |
 
 ## Example
 
@@ -22,7 +23,8 @@ instance = FalaAI::DiagnosticResponse.new(
   object: null,
   analysis: null,
   usage: null,
-  client_reference_id: null
+  client_reference_id: null,
+  html_report: null
 )
 ```
 

data/docs/Participant.md

@@ -6,7 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **interlocutor** | **String** | Exact identifier as used in dialog (e.g. 'Interlocutor 1', 'Antonio') |  |
 | **name** | **String** | Participant name (humanizes report, does not affect logic) | [optional] |
-| **role** | **String** | Role: agent (human operator), client (customer), bot (IVR/AI) |  |
+| **role** | **String** | Role: agent (human operator), client (customer), bot (IVR/AI). Required for risk audit. |  |
 
 ## Example
 

data/docs/ParticipantDiagnostic.md

@@ -5,7 +5,7 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **interlocutor** | **String** | Exact speaker label from the dialog (e.g. 'Speaker 1') |  |
-| **role** | **String** | Role: agent | client | bot | agent_requester | agent_custodian |  |
+| **role** | **String** | Role: agent | client | bot | agent_requester | agent_custodian (null when not informed/inferred) | [optional] |
 | **name** | **String** | Participant name if mentioned in the dialogue | [optional] |
 | **confidence** | **String** | high | medium | low | [optional] |
 | **evidence** | **String** | Exact verbatim quote supporting the role (no timestamps) | [optional] |

data/docs/RiskAuditRequest.md

@@ -5,16 +5,15 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **model** | **String** | Analysis model. Always 'falaai-risk-audit-1' | [optional][default to 'falaai-risk-audit-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 ''] |
+| **dialog** | **String** | Diarized transcript with speaker turns. REQUIRED — risk audit only accepts diarized conversations; plain 'text' is not accepted. 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 |  |
 | **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). |  |
+| **duration_seconds** | **Float** | Total audio duration in seconds. Required. Must be >= last turn end. 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] |
+| **response_format** | **String** | Response format version. Only 'v2' (structured EN-US blocks) is available today. | [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 60 chars. Not idempotency. | [optional] |
 
 ## Example
 
@@ -23,7 +22,6 @@ require 'falaai-api'
 
 instance = FalaAI::RiskAuditRequest.new(
   model: null,
-  text: null,
   dialog: null,
   audio_events: null,
   duration_seconds: null,

data/docs/SpeechApi.md

@@ -29,7 +29,7 @@ file = File.new('/path/to/some/file') # File |
 opts = {
   model: 'model_example', # String | 
   language: 'language_example', # String | 
-  client_reference_id: 'client_reference_id_example' # String | Optional client-supplied ID echoed verbatim in the response. Use to correlate/sync with your system. Accepted charset: [A-Za-z0-9._:-]. Not idempotency.
+  client_reference_id: 'client_reference_id_example' # String | Optional client-supplied ID echoed verbatim in the response. Use to correlate/sync with your system. Accepted charset: [A-Za-z0-9 _/:.-], max 60 chars. Not idempotency.
 }
 
 begin
@@ -65,8 +65,8 @@ end
 | ---- | ---- | ----------- | ----- |
 | **file** | **File** |  |  |
 | **model** | **String** |  | [optional][default to 'falaai-transcribe-1'] |
-| **language** | **String** |  | [optional][default to 'pt'] |
-| **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._:-]. Not idempotency. | [optional] |
+| **language** | **String** |  | [optional] |
+| **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 60 chars. Not idempotency. | [optional] |
 
 ### Return type
 

data/docs/WhatsappApi.md

@@ -0,0 +1,95 @@
+# FalaAI::WhatsappApi
+
+All URIs are relative to *https://api01-falaai.action.tec.br*
+
+| Method | HTTP request | Description |
+| ------ | ------------ | ----------- |
+| [**extract_conversations_v1_whatsapp_extract_conversations_post**](WhatsappApi.md#extract_conversations_v1_whatsapp_extract_conversations_post) | **POST** /v1/whatsapp/extractConversations | Extract and segment WhatsApp conversations from an export |
+
+
+## extract_conversations_v1_whatsapp_extract_conversations_post
+
+> <WhatsappConversationsResponse> extract_conversations_v1_whatsapp_extract_conversations_post(file, start, _end, timezone, date_format, opts)
+
+Extract and segment WhatsApp conversations from an export
+
+### Examples
+
+```ruby
+require 'time'
+require 'falaai-api'
+# setup authorization
+FalaAI.configure do |config|
+  # Configure Bearer authorization (fai_xxx): ApiKeyAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = FalaAI::WhatsappApi.new
+file = File.new('/path/to/some/file') # File | 
+start = 'start_example' # String | 
+_end = '_end_example' # String | 
+timezone = 'timezone_example' # String | 
+date_format = 'date_format_example' # String | 
+opts = {
+  gap_minutes: 8.14, # Float | 
+  min_messages: 56, # Integer | 
+  voice_note: true, # Boolean | Transcrever mensagens de voz/video gravadas na hora?
+  expression: true, # Boolean | Descrever expressoes visuais (figurinha/GIF/imagem)?
+  client_reference_id: 'client_reference_id_example' # String | 
+}
+
+begin
+  # Extract and segment WhatsApp conversations from an export
+  result = api_instance.extract_conversations_v1_whatsapp_extract_conversations_post(file, start, _end, timezone, date_format, opts)
+  p result
+rescue FalaAI::ApiError => e
+  puts "Error when calling WhatsappApi->extract_conversations_v1_whatsapp_extract_conversations_post: #{e}"
+end
+```
+
+#### Using the extract_conversations_v1_whatsapp_extract_conversations_post_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<WhatsappConversationsResponse>, Integer, Hash)> extract_conversations_v1_whatsapp_extract_conversations_post_with_http_info(file, start, _end, timezone, date_format, opts)
+
+```ruby
+begin
+  # Extract and segment WhatsApp conversations from an export
+  data, status_code, headers = api_instance.extract_conversations_v1_whatsapp_extract_conversations_post_with_http_info(file, start, _end, timezone, date_format, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <WhatsappConversationsResponse>
+rescue FalaAI::ApiError => e
+  puts "Error when calling WhatsappApi->extract_conversations_v1_whatsapp_extract_conversations_post_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **file** | **File** |  |  |
+| **start** | **String** |  |  |
+| **_end** | **String** |  |  |
+| **timezone** | **String** |  |  |
+| **date_format** | **String** |  |  |
+| **gap_minutes** | **Float** |  | [optional][default to 720] |
+| **min_messages** | **Integer** |  | [optional][default to 2] |
+| **voice_note** | **Boolean** | Transcrever mensagens de voz/video gravadas na hora? | [optional][default to true] |
+| **expression** | **Boolean** | Descrever expressoes visuais (figurinha/GIF/imagem)? | [optional][default to true] |
+| **client_reference_id** | **String** |  | [optional] |
+
+### Return type
+
+[**WhatsappConversationsResponse**](WhatsappConversationsResponse.md)
+
+### Authorization
+
+[ApiKeyAuth](../README.md#ApiKeyAuth)
+
+### HTTP request headers
+
+- **Content-Type**: multipart/form-data
+- **Accept**: application/json
+

data/docs/WhatsappConversation.md

@@ -0,0 +1,32 @@
+# FalaAI::WhatsappConversation
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **conversation_id** | **String** | Conversation identifier in the batch |  |
+| **first_at** | **String** | Real start (wall-clock, ISO) |  |
+| **last_at** | **String** | Real end (wall-clock, ISO) |  |
+| **duration_seconds** | **Float** | (last - first) + last turn duration |  |
+| **speakers** | [**Array<WhatsappSpeaker>**](WhatsappSpeaker.md) | Speakers of THIS conversation (dynamic) |  |
+| **dialog** | **String** | Lines 'Speaker N: [HH:MM:SS.mmm - HH:MM:SS.mmm] text' (real offset) |  |
+| **message_count** | **Integer** | Number of messages |  |
+| **characters** | **Integer** | Total characters of the conversation |  |
+
+## Example
+
+```ruby
+require 'falaai-api'
+
+instance = FalaAI::WhatsappConversation.new(
+  conversation_id: null,
+  first_at: null,
+  last_at: null,
+  duration_seconds: null,
+  speakers: null,
+  dialog: null,
+  message_count: null,
+  characters: null
+)
+```
+

data/docs/WhatsappConversationsResponse.md

@@ -0,0 +1,28 @@
+# FalaAI::WhatsappConversationsResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** | Unique identifier. Prefix 'wc-' + UUID |  |
+| **object** | **String** | Object type. Always 'conversations' |  |
+| **usage** | [**WhatsappUsage**](WhatsappUsage.md) | Usage and processing information |  |
+| **conversations** | [**Array<WhatsappConversation>**](WhatsappConversation.md) | Segmented conversations |  |
+| **client_reference_id** | **String** | Client-supplied ID echoed verbatim (if provided) | [optional] |
+| **meta** | [**WhatsappMeta**](WhatsappMeta.md) | Segmentation parameters and counts |  |
+
+## Example
+
+```ruby
+require 'falaai-api'
+
+instance = FalaAI::WhatsappConversationsResponse.new(
+  id: null,
+  object: null,
+  usage: null,
+  conversations: null,
+  client_reference_id: null,
+  meta: null
+)
+```
+

data/docs/WhatsappMeta.md

@@ -0,0 +1,50 @@
+# FalaAI::WhatsappMeta
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **file** | **String** | Uploaded file name |  |
+| **chat_txt** | **String** | chat.txt entry name inside the export |  |
+| **format** | **String** | Detected format: Android | iOS |  |
+| **date_format** | **String** | Date order used |  |
+| **timezone** | **String** | Timezone informed |  |
+| **start** | **String** | Window start (ISO) |  |
+| **_end** | **String** | Window end (ISO) |  |
+| **gap_minutes** | **Float** | Gap used to split conversations |  |
+| **min_messages** | **Integer** | Minimum messages per conversation |  |
+| **turns** | **Integer** | Total parsed turns |  |
+| **system_lines** | **Integer** | System lines ignored |  |
+| **conversations_total** | **Integer** | Conversations before window filter |  |
+| **conversations_in_window** | **Integer** | Conversations overlapping the window |  |
+| **monologues_dropped** | **Integer** | Single-speaker conversations dropped |  |
+| **conversations_selected** | **Integer** | Final conversations returned |  |
+| **voice_note** | **Boolean** | Voice/video medias were transcribed |  |
+| **expression** | **Boolean** | Visual expressions were described |  |
+
+## Example
+
+```ruby
+require 'falaai-api'
+
+instance = FalaAI::WhatsappMeta.new(
+  file: null,
+  chat_txt: null,
+  format: null,
+  date_format: null,
+  timezone: null,
+  start: null,
+  _end: null,
+  gap_minutes: null,
+  min_messages: null,
+  turns: null,
+  system_lines: null,
+  conversations_total: null,
+  conversations_in_window: null,
+  monologues_dropped: null,
+  conversations_selected: null,
+  voice_note: null,
+  expression: null
+)
+```
+

data/docs/WhatsappSpeaker.md

@@ -0,0 +1,20 @@
+# FalaAI::WhatsappSpeaker
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **label** | **String** | Speaker label (e.g. 'Speaker 1') |  |
+| **name** | **String** | Participant name from the export |  |
+
+## Example
+
+```ruby
+require 'falaai-api'
+
+instance = FalaAI::WhatsappSpeaker.new(
+  label: null,
+  name: null
+)
+```
+

data/docs/WhatsappUsage.md

@@ -0,0 +1,34 @@
+# FalaAI::WhatsappUsage
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **conversations** | **Integer** | Number of conversations returned |  |
+| **characters** | **Integer** | Total characters across conversations |  |
+| **expressions** | **Integer** | Expression tokens across conversations (sticker/emoji/gif) |  |
+| **voice_notes** | **Integer** | Voice notes (PTT) resolved to text |  |
+| **conversation_credits** | **Integer** | Credits for conversations (2 each) |  |
+| **expression_credits** | **Float** | Credits for expressions (0.2 each) |  |
+| **audio_credits** | **Float** | Credits for audio duration (0.2 per second) |  |
+| **credits_consumed** | **Integer** | Total credits = ceil(conversation_credits + expression_credits + audio_credits) |  |
+| **processing_ms** | **Integer** | Total processing time in milliseconds |  |
+
+## Example
+
+```ruby
+require 'falaai-api'
+
+instance = FalaAI::WhatsappUsage.new(
+  conversations: null,
+  characters: null,
+  expressions: null,
+  voice_notes: null,
+  conversation_credits: null,
+  expression_credits: null,
+  audio_credits: null,
+  credits_consumed: null,
+  processing_ms: null
+)
+```
+