falaai-api 1.21.48 → 1.21.51
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/README.md +237 -339
- data/docs/AnalysisApi.md +33 -37
- data/docs/AudioEvent.md +5 -5
- data/docs/AudioInputMeta.md +5 -5
- data/docs/CreateEmailAlertRequest.md +3 -3
- data/docs/CreateWebhookRequest.md +4 -4
- data/docs/DiagnosticAudioEvent.md +5 -5
- data/docs/DiagnosticCategoricalAnalysis.md +3 -3
- data/docs/DiagnosticParticipant.md +22 -0
- data/docs/DiagnosticRequest.md +10 -4
- data/docs/DiagnosticResponse.md +4 -4
- data/docs/DiagnosticTextAnalysis.md +1 -1
- data/docs/DiagnosticUsage.md +3 -3
- data/docs/EmailAlertsApi.md +18 -18
- data/docs/HealthApi.md +3 -13
- data/docs/HealthResponse.md +6 -6
- data/docs/Participant.md +2 -2
- data/docs/ParticipantDiagnostic.md +5 -5
- data/docs/{AuditoriaRiscoAnalysisV2.md → RiskAuditAnalysisV2.md} +2 -2
- data/docs/{AuditoriaRiscoAppliedActionV2.md → RiskAuditAppliedActionV2.md} +2 -2
- data/docs/{AuditoriaRiscoAudioEventModelV2.md → RiskAuditAudioEventModelV2.md} +2 -2
- data/docs/{AuditoriaRiscoAuditDecisionsV2.md → RiskAuditAuditDecisionsV2.md} +2 -2
- data/docs/{AuditoriaRiscoConversationScoresV2.md → RiskAuditConversationScoresV2.md} +2 -2
- data/docs/{AuditoriaRiscoDetectionItemV2.md → RiskAuditDetectionItemV2.md} +2 -2
- data/docs/RiskAuditDetectionsV2.md +26 -0
- data/docs/{AuditoriaRiscoIndexerV2.md → RiskAuditIndexerV2.md} +2 -2
- data/docs/{AuditoriaRiscoMetaV2.md → RiskAuditMetaV2.md} +4 -4
- data/docs/{AuditoriaRiscoParticipantV2.md → RiskAuditParticipantV2.md} +2 -2
- data/docs/{AuditoriaRiscoParticipantsV2.md → RiskAuditParticipantsV2.md} +3 -3
- data/docs/{AuditoriaRiscoRequest.md → RiskAuditRequest.md} +13 -13
- data/docs/{AuditoriaRiscoScoresV2.md → RiskAuditScoresV2.md} +3 -3
- data/docs/{AuditoriaRiscoScoringExplanationV2.md → RiskAuditScoringExplanationV2.md} +2 -2
- data/docs/{AuditoriaRiscoSummaryV2.md → RiskAuditSummaryV2.md} +2 -2
- data/docs/{AuditoriaRiscoTimelineV2.md → RiskAuditTimelineV2.md} +2 -2
- data/docs/{AuditoriaRiscoUsageV2.md → RiskAuditUsageV2.md} +2 -2
- data/docs/RiskAuditV2.md +46 -0
- data/docs/RiskAuditV2Response.md +18 -0
- data/docs/{AuditoriaRiscoVerdictV2.md → RiskAuditVerdictV2.md} +3 -3
- data/docs/SpeechApi.md +1 -3
- data/docs/TranscriptionResponse.md +13 -14
- data/docs/TranscriptionUsage.md +3 -3
- data/docs/UpdateWebhookRequest.md +5 -5
- data/docs/UsageApi.md +1 -1
- data/docs/VersionApi.md +2 -7
- data/docs/VersionResponse.md +3 -3
- data/docs/WebhooksApi.md +22 -22
- data/docs/WhatsappApi.md +93 -0
- data/docs/WhatsappConversation.md +32 -0
- data/docs/WhatsappConversationsResponse.md +28 -0
- data/docs/WhatsappMeta.md +48 -0
- data/docs/WhatsappSpeaker.md +20 -0
- data/docs/WhatsappUsage.md +24 -0
- data/docs/index.html +761 -0
- data/docs/llms.txt +18 -0
- data/docs/robots.txt +4 -0
- data/docs/sitemap.xml +8 -0
- data/lib/falaai-api/api/analysis_api.rb +38 -42
- data/lib/falaai-api/api/email_alerts_api.rb +10 -10
- data/lib/falaai-api/api/health_api.rb +4 -4
- data/lib/falaai-api/api/speech_api.rb +2 -4
- data/lib/falaai-api/api/usage_api.rb +2 -2
- data/lib/falaai-api/api/version_api.rb +3 -3
- data/lib/falaai-api/api/webhooks_api.rb +18 -18
- data/lib/falaai-api/api/whatsapp_api.rb +129 -0
- data/lib/falaai-api/api_client.rb +2 -2
- data/lib/falaai-api/api_error.rb +2 -2
- data/lib/falaai-api/api_model_base.rb +2 -2
- data/lib/falaai-api/configuration.rb +6 -6
- data/lib/falaai-api/models/audio_event.rb +2 -2
- data/lib/falaai-api/models/audio_input_meta.rb +2 -2
- data/lib/falaai-api/models/create_email_alert_request.rb +2 -2
- data/lib/falaai-api/models/create_webhook_request.rb +2 -2
- data/lib/falaai-api/models/diagnostic_analysis_map.rb +2 -2
- data/lib/falaai-api/models/diagnostic_audio_event.rb +2 -2
- data/lib/falaai-api/models/diagnostic_categorical_analysis.rb +2 -2
- data/lib/falaai-api/models/diagnostic_participant.rb +226 -0
- data/lib/falaai-api/models/diagnostic_request.rb +91 -6
- data/lib/falaai-api/models/diagnostic_response.rb +2 -2
- data/lib/falaai-api/models/diagnostic_text_analysis.rb +2 -2
- data/lib/falaai-api/models/diagnostic_usage.rb +2 -2
- data/lib/falaai-api/models/email_alert_item.rb +2 -2
- data/lib/falaai-api/models/email_alert_list_response.rb +2 -2
- data/lib/falaai-api/models/email_alert_message_response.rb +2 -2
- data/lib/falaai-api/models/email_event.rb +2 -2
- data/lib/falaai-api/models/health_response.rb +2 -2
- data/lib/falaai-api/models/http_validation_error.rb +2 -2
- data/lib/falaai-api/models/location_inner.rb +2 -2
- data/lib/falaai-api/models/message_response.rb +2 -2
- data/lib/falaai-api/models/participant.rb +2 -2
- data/lib/falaai-api/models/participant_diagnostic.rb +2 -2
- data/lib/falaai-api/models/{auditoria_risco_analysis_v2.rb → risk_audit_analysis_v2.rb} +5 -5
- data/lib/falaai-api/models/{auditoria_risco_applied_action_v2.rb → risk_audit_applied_action_v2.rb} +5 -5
- data/lib/falaai-api/models/{auditoria_risco_audio_event_model_v2.rb → risk_audit_audio_event_model_v2.rb} +5 -5
- data/lib/falaai-api/models/{auditoria_risco_audit_decisions_v2.rb → risk_audit_audit_decisions_v2.rb} +5 -5
- data/lib/falaai-api/models/{auditoria_risco_conversation_scores_v2.rb → risk_audit_conversation_scores_v2.rb} +5 -5
- data/lib/falaai-api/models/{auditoria_risco_detection_item_v2.rb → risk_audit_detection_item_v2.rb} +5 -5
- data/lib/falaai-api/models/{auditoria_risco_detections_v2.rb → risk_audit_detections_v2.rb} +8 -8
- data/lib/falaai-api/models/{auditoria_risco_indexer_v2.rb → risk_audit_indexer_v2.rb} +5 -5
- data/lib/falaai-api/models/{auditoria_risco_meta_v2.rb → risk_audit_meta_v2.rb} +7 -7
- data/lib/falaai-api/models/{auditoria_risco_participant_v2.rb → risk_audit_participant_v2.rb} +5 -5
- data/lib/falaai-api/models/{auditoria_risco_participants_v2.rb → risk_audit_participants_v2.rb} +6 -6
- data/lib/falaai-api/models/{auditoria_risco_request.rb → risk_audit_request.rb} +16 -25
- data/lib/falaai-api/models/{auditoria_risco_scores_v2.rb → risk_audit_scores_v2.rb} +6 -6
- data/lib/falaai-api/models/{auditoria_risco_scoring_explanation_v2.rb → risk_audit_scoring_explanation_v2.rb} +5 -5
- data/lib/falaai-api/models/{auditoria_risco_summary_v2.rb → risk_audit_summary_v2.rb} +5 -5
- data/lib/falaai-api/models/{auditoria_risco_timeline_v2.rb → risk_audit_timeline_v2.rb} +5 -5
- data/lib/falaai-api/models/{auditoria_risco_usage_v2.rb → risk_audit_usage_v2.rb} +5 -5
- data/lib/falaai-api/models/{auditoria_risco_v2.rb → risk_audit_v2.rb} +35 -35
- data/lib/falaai-api/models/{auditoria_risco_v2_response.rb → risk_audit_v2_response.rb} +7 -7
- data/lib/falaai-api/models/{auditoria_risco_verdict_v2.rb → risk_audit_verdict_v2.rb} +6 -6
- data/lib/falaai-api/models/transcription_response.rb +2 -2
- data/lib/falaai-api/models/transcription_usage.rb +2 -2
- data/lib/falaai-api/models/update_email_alert_request.rb +2 -2
- data/lib/falaai-api/models/update_webhook_request.rb +2 -2
- data/lib/falaai-api/models/usage_by_key_item.rb +2 -2
- data/lib/falaai-api/models/usage_log_item.rb +2 -2
- data/lib/falaai-api/models/usage_log_response.rb +2 -2
- data/lib/falaai-api/models/validation_error.rb +2 -2
- data/lib/falaai-api/models/version_response.rb +2 -2
- data/lib/falaai-api/models/webhook_event.rb +2 -2
- data/lib/falaai-api/models/webhook_item.rb +2 -2
- data/lib/falaai-api/models/webhook_list_response.rb +2 -2
- data/lib/falaai-api/models/whatsapp_conversation.rb +356 -0
- data/lib/falaai-api/models/whatsapp_conversations_response.rb +285 -0
- data/lib/falaai-api/models/whatsapp_meta.rb +570 -0
- data/lib/falaai-api/models/whatsapp_speaker.rb +192 -0
- data/lib/falaai-api/models/whatsapp_usage.rb +246 -0
- data/lib/falaai-api/version.rb +3 -3
- data/lib/falaai-api.rb +29 -22
- metadata +60 -42
- data/docs/AuditoriaRiscoDetectionsV2.md +0 -26
- data/docs/AuditoriaRiscoV2.md +0 -46
- data/docs/AuditoriaRiscoV2Response.md +0 -18
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: d83d046b979cd6c1d09c21c3c76a82ea6b0d17131e1018b972a7fea0a3a50f3e
|
|
4
|
+
data.tar.gz: ba6256865b059b177181ce24f00cd857a2df99b0af69584fd8b4131b3a00d7df
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 74c598532ababe5e246b16f3e260886235f8b5e7f25df353b3d7cd2dc27ee392c90dbd8b1d0fac9ece144e7f04efa1209368c102c847e5008e476eecf1a8c8be
|
|
7
|
+
data.tar.gz: d3590c7c1c2e1e20bb4157f73125daae0c297dff4d44b985f3fcb7df100f4233a3672e9e200e2f68592fa61b0cf804c2099bfeb2f7b3fc815221bf738aea537a
|
data/README.md
CHANGED
|
@@ -1,339 +1,237 @@
|
|
|
1
|
-
#
|
|
2
|
-
|
|
3
|
-
[](https://rubygems.org/gems/falaai-api)
|
|
4
|
-
[![
|
|
5
|
-
[![
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
## Install
|
|
32
|
-
|
|
33
|
-
```bash
|
|
34
|
-
gem install falaai-api
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
"
|
|
76
|
-
"
|
|
77
|
-
"
|
|
78
|
-
"
|
|
79
|
-
"
|
|
80
|
-
"
|
|
81
|
-
}
|
|
82
|
-
```
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
```
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
**
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
{
|
|
239
|
-
"action_type": "nenhuma_acao",
|
|
240
|
-
"label": "Nenhuma Acao",
|
|
241
|
-
"description": "Nenhuma acao necessaria. A chamada nao apresentou deteccoes que exijam intervencao. Continuar monitoramento de rotina.",
|
|
242
|
-
"priority": "BAIXO",
|
|
243
|
-
"color": "#6B7280",
|
|
244
|
-
"icon": "mdi:check-circle-outline",
|
|
245
|
-
"condition": "sempre",
|
|
246
|
-
"reason": "condição=sempre"
|
|
247
|
-
}
|
|
248
|
-
],
|
|
249
|
-
... (truncated)
|
|
250
|
-
```
|
|
251
|
-
|
|
252
|
-
### The forensic HTML report
|
|
253
|
-
|
|
254
|
-
The audit response carries **`response.html_report`** - the complete **forensic report as HTML**, encoded as a **base64 gzip** string (~19 KB). Decode it and open in a browser (or convert to PDF) to get the auditable evidence: timeline, audio events (MAC/MVAD/MOD), violations against **COPC CX** and **ISO 18295-1**, and the executive verdict.
|
|
255
|
-
|
|
256
|
-
```python
|
|
257
|
-
import base64, gzip, json, httpx
|
|
258
|
-
|
|
259
|
-
res = httpx.post(
|
|
260
|
-
"https://api01-falaai.action.tec.br/v1/analyze/auditoriaRisco",
|
|
261
|
-
headers={"Authorization": "Bearer fai_xxxxxx"},
|
|
262
|
-
json={"dialog": dialog, "language": "pt-BR", "duration_seconds": 25.0, "response_format": "v2"},
|
|
263
|
-
timeout=900,
|
|
264
|
-
).json()
|
|
265
|
-
|
|
266
|
-
html = gzip.decompress(base64.b64decode(res["response"]["html_report"])).decode("utf-8")
|
|
267
|
-
open("report.html", "w", encoding="utf-8").write(html)
|
|
268
|
-
```
|
|
269
|
-
|
|
270
|
-
## Use cases
|
|
271
|
-
|
|
272
|
-
- Call and voice-note **transcription** with speaker separation
|
|
273
|
-
- **Contact center quality assurance (QA)** automation
|
|
274
|
-
- **Compliance auditing** against **COPC CX** and **ISO 18295-1**
|
|
275
|
-
- **Risk detection** - churn risk, legal threats, escalation
|
|
276
|
-
- **WhatsApp, Telegram and chat** conversation analysis
|
|
277
|
-
- **CRM and help desk** enrichment
|
|
278
|
-
- **Call analytics** and **speech-to-text** at scale - every call transcribed and scored
|
|
279
|
-
- **Conversation intelligence** - summary, reason, action, topic and **sentiment analysis** per conversation
|
|
280
|
-
- **Speaker diarization** (speaker separation) on stereo or mono audio
|
|
281
|
-
- **Quality monitoring** and **agent performance** - audit 100% instead of a sample
|
|
282
|
-
- Built from a single **OpenAPI** contract, so all SDKs stay in sync
|
|
283
|
-
- **LGPD**-aware handling of customer conversations
|
|
284
|
-
|
|
285
|
-
## Where it fits
|
|
286
|
-
|
|
287
|
-
Plugs into **omnichannel service platforms**, **help desks**, **chatbots** and **unified messaging** - anywhere a conversation becomes text.
|
|
288
|
-
|
|
289
|
-
Common Ruby stacks in contact center, CRM and help desk - if you build on any of these, the SDK drops in:
|
|
290
|
-
|
|
291
|
-
Chatwoot - Zendesk Support - Discourse - Fat Free CRM
|
|
292
|
-
|
|
293
|
-
> Product names are trademarks of their respective owners, listed as common stacks in this ecosystem. No partnership is implied.
|
|
294
|
-
|
|
295
|
-
## Endpoints
|
|
296
|
-
|
|
297
|
-
| Method | Path | Description |
|
|
298
|
-
| --- | --- | --- |
|
|
299
|
-
| `POST` | `/v1/audio/transcriptions` | Audio to text, with speaker separation |
|
|
300
|
-
| `POST` | `/v1/analyze/diagnostic` | Conversation analysis - summary, reason, action, topic, sentiment |
|
|
301
|
-
| `POST` | `/v1/analyze/auditoriaRisco` | Compliance audit - risk score and violations |
|
|
302
|
-
| `GET` | `/v1/health` | Service health check (public) |
|
|
303
|
-
|
|
304
|
-
All endpoints require `Authorization: Bearer fai_xxxxxx`.
|
|
305
|
-
Full reference: <https://api01-falaai.action.tec.br/docs>
|
|
306
|
-
Other operations: usage logs, webhooks and email alerts - see the full reference.
|
|
307
|
-
|
|
308
|
-
## Links
|
|
309
|
-
|
|
310
|
-
- **Product:** <https://falaai.action.tec.br/api>
|
|
311
|
-
- **API reference:** <https://api01-falaai.action.tec.br/docs>
|
|
312
|
-
- **Get an API key:** <https://falaai.action.tec.br/api/auth>
|
|
313
|
-
- **Package (RubyGems):** <https://rubygems.org/gems/falaai-api>
|
|
314
|
-
- **Source:** <https://github.com/ActionTecBr/falaai-api-ruby>
|
|
315
|
-
|
|
316
|
-
## Other official SDKs
|
|
317
|
-
|
|
318
|
-
| Language | Install | Package |
|
|
319
|
-
| --- | --- | --- |
|
|
320
|
-
| **Python** | `pip install falaai-api` | [PyPI](https://pypi.org/project/falaai-api/) |
|
|
321
|
-
| **Node.js / TypeScript** | `npm install falaai-api` | [npm](https://www.npmjs.com/package/falaai-api) |
|
|
322
|
-
| **PHP** | `composer require actiontecbr/falaai-api` | [Packagist](https://packagist.org/packages/actiontecbr/falaai-api) |
|
|
323
|
-
| **Go** | `go get github.com/actiontecbr/falaai-api` | [pkg.go.dev](https://pkg.go.dev/github.com/actiontecbr/falaai-api) |
|
|
324
|
-
| **Ruby** | `gem install falaai-api` | [RubyGems](https://rubygems.org/gems/falaai-api) |
|
|
325
|
-
| **Java** | `io.github.actiontecbr:falaai-api` | [Maven Central](https://central.sonatype.com/artifact/io.github.actiontecbr/falaai-api) |
|
|
326
|
-
| **.NET / C#** | `dotnet add package FalaAI.Api` | [NuGet](https://www.nuget.org/packages/FalaAI.Api) |
|
|
327
|
-
|
|
328
|
-
## Requirements, support and more
|
|
329
|
-
|
|
330
|
-
- **Requirements:** an API key (`fai_...`) and a runtime able to upload audio files.
|
|
331
|
-
- **Documentation:** <https://api01-falaai.action.tec.br/docs>
|
|
332
|
-
- **Support:** open an issue in this repository.
|
|
333
|
-
- **Security:** responsible disclosure policy in [SECURITY.md](SECURITY.md).
|
|
334
|
-
- **Contributing:** see [CONTRIBUTING.md](CONTRIBUTING.md) · [Code of Conduct](CODE_OF_CONDUCT.md).
|
|
335
|
-
- **Changelog:** see [CHANGELOG.md](CHANGELOG.md).
|
|
336
|
-
|
|
337
|
-
## License
|
|
338
|
-
|
|
339
|
-
MIT (c) 2026 Action Tec Br - see [LICENSE](LICENSE).
|
|
1
|
+
# falaai-api — Ruby SDK for Conversation Intelligence, Speech Analytics & Compliance
|
|
2
|
+
|
|
3
|
+
[](https://rubygems.org/gems/falaai-api)
|
|
4
|
+
[](LICENSE)
|
|
5
|
+
[](https://github.com/ActionTecBr/falaai-api-ruby/actions/workflows/ci.yml)
|
|
6
|
+
[](https://actiontecbr.github.io/falaai-api-ruby/)
|
|
7
|
+
|
|
8
|
+
Official **Ruby SDK** for the **FalaAI API** — transcribe audio, analyze conversations and audit compliance (COPC CX, ISO 18295-1). **Use each API independently or combine them into your own pipeline.**
|
|
9
|
+
|
|
10
|
+
> Analyze calls, contact-center recordings, voice notes, chat and email. Get speaker-separated transcripts, summaries, reasons, actions, sentiment and a **compliance risk score**.
|
|
11
|
+
|
|
12
|
+
## Use any FalaAI API independently
|
|
13
|
+
|
|
14
|
+
FalaAI is a set of **independent REST APIs**. You **do not** need FalaAI Transcription to use FalaAI analysis or compliance auditing. If your application already has a transcript, send that text straight to the analysis APIs.
|
|
15
|
+
|
|
16
|
+
| If you have... | Use |
|
|
17
|
+
|---|---|
|
|
18
|
+
| Audio but no transcript | `FalaAI::SpeechApi` — Transcription |
|
|
19
|
+
| An existing transcript | `FalaAI::AnalysisApi` — Diagnostic |
|
|
20
|
+
| A transcript needing compliance analysis | `FalaAI::AnalysisApi` — Risk Audit |
|
|
21
|
+
| An existing transcript needing both | Diagnostic + Risk Audit |
|
|
22
|
+
| Your own STT provider (Whisper, Deepgram...) | Skip FalaAI Transcription |
|
|
23
|
+
|
|
24
|
+
```text
|
|
25
|
+
Your STT -> FalaAI Diagnostic -> FalaAI Risk Audit
|
|
26
|
+
Telegram voice -> your STT -> FalaAI Risk Audit
|
|
27
|
+
3CX / Asterisk / Genesys transcript -> FalaAI Diagnostic -> FalaAI Risk Audit
|
|
28
|
+
CRM conversation -> FalaAI Risk Audit
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
## Install
|
|
32
|
+
|
|
33
|
+
```bash
|
|
34
|
+
gem install falaai-api
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
Requires **Ruby 2.7+**.
|
|
38
|
+
|
|
39
|
+
## Quickstart
|
|
40
|
+
|
|
41
|
+
### 1. Get an API key
|
|
42
|
+
Create a free account and copy your `fai_` key: <https://falaai.action.tec.br/api/auth> (or the [Dashboard](https://falaai.action.tec.br/api/dashboard)).
|
|
43
|
+
|
|
44
|
+
### 2. Set environment variables
|
|
45
|
+
|
|
46
|
+
```bash
|
|
47
|
+
FALAAI_BASE_URL=https://api01-falaai.action.tec.br
|
|
48
|
+
FALAAI_API_KEY=fai_xxxxxxxx
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
### 3. Transcribe a call (audio -> text)
|
|
52
|
+
|
|
53
|
+
```ruby
|
|
54
|
+
require 'falaai-api'
|
|
55
|
+
|
|
56
|
+
config = FalaAI::Configuration.new
|
|
57
|
+
config.host = ENV.fetch('FALAAI_BASE_URL', 'https://api01-falaai.action.tec.br')
|
|
58
|
+
config.access_token = ENV['FALAAI_API_KEY']
|
|
59
|
+
client = FalaAI::ApiClient.new(config)
|
|
60
|
+
|
|
61
|
+
transcription, _status = FalaAI::SpeechApi.new(client).create_transcription_v1_audio_transcriptions_post_with_http_info(
|
|
62
|
+
File.open('call.mp3'),
|
|
63
|
+
{ model: 'falaai-transcribe-1', language: 'pt', client_reference_id: 'call_202609271408' }
|
|
64
|
+
)
|
|
65
|
+
|
|
66
|
+
puts JSON.pretty_generate(transcription)
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
Expected response (abridged):
|
|
70
|
+
|
|
71
|
+
```json
|
|
72
|
+
{
|
|
73
|
+
"id": "tr-...",
|
|
74
|
+
"object": "transcription",
|
|
75
|
+
"model": "falaai-transcribe-1",
|
|
76
|
+
"language": "por",
|
|
77
|
+
"duration_seconds": 25.0,
|
|
78
|
+
"text": "...",
|
|
79
|
+
"dialog": "Speaker 1: [...] ...",
|
|
80
|
+
"usage": { "audio_seconds": 25.0, "credits_consumed": 25, "processing_ms": 951 }
|
|
81
|
+
}
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
> Only need analysis? **Skip step 3** and call `FalaAI::AnalysisApi` with your own transcript (use the `text` field for a plain transcript).
|
|
85
|
+
|
|
86
|
+
### 4. Analyze or audit an existing transcript (no transcription needed)
|
|
87
|
+
|
|
88
|
+
```ruby
|
|
89
|
+
require 'falaai-api'
|
|
90
|
+
|
|
91
|
+
config = FalaAI::Configuration.new
|
|
92
|
+
config.host = ENV['FALAAI_BASE_URL']
|
|
93
|
+
config.access_token = ENV['FALAAI_API_KEY']
|
|
94
|
+
client = FalaAI::ApiClient.new(config)
|
|
95
|
+
analysis = FalaAI::AnalysisApi.new(client)
|
|
96
|
+
|
|
97
|
+
transcript = 'Good morning, how can I help? I need to cancel my subscription.'
|
|
98
|
+
|
|
99
|
+
# 5 analyses in one call: summary, reason, action, topic, sentiment
|
|
100
|
+
diagnostic, _status = analysis.create_diagnostic_v1_analyze_diagnostic_post_with_http_info(
|
|
101
|
+
FalaAI::DiagnosticRequest.new(text: transcript, language: 'pt-BR', duration_seconds: 81.46)
|
|
102
|
+
)
|
|
103
|
+
|
|
104
|
+
# Compliance risk score + violations + auditable report
|
|
105
|
+
audit, _status = analysis.create_risk_audit_v1_analyze_risk_audit_post_with_http_info(
|
|
106
|
+
FalaAI::RiskAuditRequest.new(text: transcript, language: 'pt-BR', response_language: 'pt-BR', duration_seconds: 81.46)
|
|
107
|
+
)
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
## What is FalaAI API?
|
|
111
|
+
|
|
112
|
+
FalaAI API is an **AI conversation-intelligence API** for analyzing customer-service, contact-center, sales, messaging and other business conversations. It combines speech-to-text (with speaker diarization and audio-event detection), conversation analysis (summary, contact reason, action taken, topic classification, sentiment) and a **compliance/risk audit** against **COPC CX** and **ISO 18295-1**. Conversation content is processed and discarded (zero-storage).
|
|
113
|
+
|
|
114
|
+
## What can you do with FalaAI?
|
|
115
|
+
|
|
116
|
+
- **Transcribe** audio to text with speaker separation and audio events.
|
|
117
|
+
- **Diagnose** a conversation: summary, reason, action taken, topic and sentiment.
|
|
118
|
+
- **Audit** conversations: compliance risk score, detections/violations and an auditable HTML report.
|
|
119
|
+
- **Track usage**, **manage webhooks** and **email alerts**, and **health/version** checks.
|
|
120
|
+
|
|
121
|
+
## Use cases
|
|
122
|
+
|
|
123
|
+
- **Contact center / Quality** - audit 100% of conversations instead of a sample.
|
|
124
|
+
- **Compliance / Legal** - auditable evidence for audits and disputes.
|
|
125
|
+
- **CX / Operations** - risk score, sentiment and reason per conversation.
|
|
126
|
+
- **BI / Data** - typed JSON ready for your database or analytics stack.
|
|
127
|
+
|
|
128
|
+
## Why FalaAI
|
|
129
|
+
|
|
130
|
+
- **Audit 100%, not a sample** - every conversation gets a score, not a random QA sample.
|
|
131
|
+
- **Auditable by design** - a compliance risk score with detections/violations and an HTML report you can hand to an auditor.
|
|
132
|
+
- **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.
|
|
133
|
+
- **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).
|
|
134
|
+
- **3 native languages** (PT/EN/ES) · **start free** (no card).
|
|
135
|
+
- **B2B ready** - one Enterprise plan serves N clients, no per-user fee (ideal for ISVs).
|
|
136
|
+
|
|
137
|
+
## Integrations
|
|
138
|
+
|
|
139
|
+
FalaAI is **language-independent** - integrate at **any point** of your pipeline (capture, transcription, analysis or audit). Common ecosystems:
|
|
140
|
+
|
|
141
|
+
| Ecosystem | How |
|
|
142
|
+
|---|---|
|
|
143
|
+
| **PABX / telephony (3CX, Asterisk, Genesys)** | Send the recording to Transcribe, or the transcript to Diagnostic/Risk Audit. |
|
|
144
|
+
| **CRM / ERP (Odoo, Salesforce, SAP Service Cloud, HubSpot)** | Attach the structured JSON (summary, reason, sentiment, risk score) to the record. |
|
|
145
|
+
| **Contact center / QA (Zendesk, Twilio Flex, Take Blip)** | Batch-audit conversations and feed the score into your QA dashboard. |
|
|
146
|
+
| **Chatbots / messaging (WhatsApp, Telegram, Microsoft Teams)** | Extract conversations from an export and analyze them. |
|
|
147
|
+
| **BI / Data** | Typed JSON ready for your warehouse or analytics stack. |
|
|
148
|
+
|
|
149
|
+
> 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.
|
|
150
|
+
|
|
151
|
+
## BYOT - Bring Your Own Transcription
|
|
152
|
+
|
|
153
|
+
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.
|
|
154
|
+
|
|
155
|
+
## SDK surface (Ruby)
|
|
156
|
+
|
|
157
|
+
| Class | Namespace | Purpose |
|
|
158
|
+
|---|---|---|
|
|
159
|
+
| `Configuration` | `FalaAI` | `host`, `access_token` |
|
|
160
|
+
| `ApiClient` | `FalaAI` | `FalaAI::ApiClient.new(config)` |
|
|
161
|
+
| `HealthApi` | `FalaAI` | `health_check` |
|
|
162
|
+
| `SpeechApi` | `FalaAI` | `create_transcription_v1_audio_transcriptions_post_with_http_info(...)` |
|
|
163
|
+
| `AnalysisApi` | `FalaAI` | `create_diagnostic_v1_analyze_diagnostic_post_with_http_info(...)`, `create_risk_audit_v1_analyze_risk_audit_post_with_http_info(...)` |
|
|
164
|
+
| `WhatsappApi` | `FalaAI` | `extract_conversations_v1_whatsapp_extract_conversations_post_with_http_info(...)` |
|
|
165
|
+
| `UsageApi` / `WebhooksApi` / `EmailAlertsApi` / `VersionApi` | `FalaAI` | management |
|
|
166
|
+
| Models | `FalaAI` | `DiagnosticRequest`, `RiskAuditRequest`, `Participant`, `DiagnosticAudioEvent`, `WhatsappConversationsResponse` |
|
|
167
|
+
| `ApiError` | `FalaAI` | HTTP errors |
|
|
168
|
+
|
|
169
|
+
> Model IDs: `falaai-transcribe-1`, `falaai-diagnostic-1`, `falaai-risk-audit-1`.
|
|
170
|
+
|
|
171
|
+
## Examples
|
|
172
|
+
|
|
173
|
+
Runnable examples in [`examples/`](./examples): `health.rb`, `transcribe.rb`, `diagnose.rb`, `audit.rb`, `whatsapp.rb`.
|
|
174
|
+
|
|
175
|
+
## Authentication
|
|
176
|
+
|
|
177
|
+
Every request requires `Authorization: Bearer fai_<your_key>` — except the public endpoints (`GET/HEAD /v1/health`, `GET /api/version`). Set the key with `Configuration#access_token=` (or `FALAAI_API_KEY`).
|
|
178
|
+
|
|
179
|
+
## Error handling
|
|
180
|
+
|
|
181
|
+
Non-2xx responses raise `FalaAI::ApiError`.
|
|
182
|
+
|
|
183
|
+
```ruby
|
|
184
|
+
require 'falaai-api'
|
|
185
|
+
|
|
186
|
+
begin
|
|
187
|
+
health = FalaAI::HealthApi.new(client).health_check
|
|
188
|
+
puts health.status
|
|
189
|
+
rescue FalaAI::ApiError => e
|
|
190
|
+
warn "FalaAI API error: #{e.message}"
|
|
191
|
+
end
|
|
192
|
+
```
|
|
193
|
+
|
|
194
|
+
## Production usage
|
|
195
|
+
|
|
196
|
+
- Store API keys in environment variables or a secret manager — never hard-code.
|
|
197
|
+
- Reuse the `ApiClient` across requests.
|
|
198
|
+
- Handle `FalaAI::ApiError` explicitly.
|
|
199
|
+
|
|
200
|
+
## Compatibility
|
|
201
|
+
|
|
202
|
+
| Requirement | Version |
|
|
203
|
+
|---|---|
|
|
204
|
+
| Ruby | 2.7+ |
|
|
205
|
+
| API | v1.21.51 |
|
|
206
|
+
|
|
207
|
+
## Documentation
|
|
208
|
+
|
|
209
|
+
- **SDK docs (this language):** <https://actiontecbr.github.io/falaai-api-ruby/>
|
|
210
|
+
- **API reference (Swagger UI):** <https://api01-falaai.action.tec.br/docs>
|
|
211
|
+
- **OpenAPI contract:** <https://api01-falaai.action.tec.br/openapi.json>
|
|
212
|
+
- **Sandbox:** <https://falaai.action.tec.br/api#playground>
|
|
213
|
+
- **Quickstart:** <https://falaai.action.tec.br/api/quickstart>
|
|
214
|
+
- **Product page:** <https://falaai.action.tec.br/api>
|
|
215
|
+
|
|
216
|
+
## Versioning
|
|
217
|
+
|
|
218
|
+
Semantic versioning; the SDK version tracks the API version (`1.21.51`). See [CHANGELOG.md](CHANGELOG.md) and [Releases](https://github.com/ActionTecBr/falaai-api-ruby/releases).
|
|
219
|
+
|
|
220
|
+
## Security
|
|
221
|
+
|
|
222
|
+
See [SECURITY.md](SECURITY.md). Never commit real keys — use environment variables.
|
|
223
|
+
|
|
224
|
+
## Contributing
|
|
225
|
+
|
|
226
|
+
See [CONTRIBUTING.md](CONTRIBUTING.md).
|
|
227
|
+
|
|
228
|
+
## License
|
|
229
|
+
|
|
230
|
+
[MIT](LICENSE).
|
|
231
|
+
|
|
232
|
+
## Links
|
|
233
|
+
|
|
234
|
+
- Website: <https://falaai.action.tec.br>
|
|
235
|
+
- API base URL: <https://api01-falaai.action.tec.br>
|
|
236
|
+
- GitHub organization: <https://github.com/ActionTecBr>
|
|
237
|
+
- Other SDKs: Python, Node.js, PHP, Go, Java, .NET.
|