Anrufe
Rufen Sie Anrufaufzeichnungs-URLs und Flow-Ausführungsdaten über die Talkturo API ab — greifen Sie auf vor-signierte Aufzeichnungslinks und TurboFlow-Ausführungsverlauf zu.
curl -X GET "https://app.talkturo.com/api/calls/{id}/recording-url" \
-H "Cookie: sb-access-token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example"
{
"url": "https://presigned-url...",
"expiresIn": 600
}
{
"error": "Invalid call ID"
}
{
"error": "Forbidden"
}
{
"error": "Call not found"
}
{
"error": "Internal server error"
}
curl -X GET "https://app.talkturo.com/api/calls/{id}/flow-runs" \
-H "Cookie: sb-access-token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example"
{
"runs": [
{
"id": "run_01hxy9v8m4k2p7q3r5s6t7u8",
"flowId": "flw_01hxy8n2c9d4e6f7g8h9j0k1",
"name": "Post-call qualification",
"status": "completed",
"startedAt": "2024-03-14T10:15:00.000Z",
"finishedAt": "2024-03-14T10:15:04.000Z",
"error": null,
"input": {
"callId": "cal_01hxy7m1b2c3d4e5f6g7h8j9"
}
}
]
}
{
"error": "Invalid call ID"
}
{
"error": "Forbidden"
}
{
"error": "Call not found"
}
{
"error": "Internal server error"
}
curl -X POST "https://app.talkturo.com/api/crm/calls" \
-H "Authorization: Bearer dkai_example_9xmk7q2r" \
-H "Content-Type: application/json" \
-d '{
"assistant_id": "ast_01hxy8n2c9d4e6f7g8h9j0k1",
"to_number": "+493012345678",
"from_number": "+493098765432",
"metadata": {
"leadId": "lead_01hxy7m1b2c3d4e5f6g7h8j9",
"source": "crm"
}
}'
curl -X POST "https://app.talkturo.com/api/crm/calls" \
-H "Cookie: sb-access-token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example" \
-H "Content-Type: application/json" \
-d '{
"assistant_id": "ast_01hxy8n2c9d4e6f7g8h9j0k1",
"to_number": "+493012345678"
}'
{
"success": true,
"roomName": "crm-call-01hxy9v8m4k2p7q3r5s6t7u8",
"sipCallId": "sip_01hxy7m1b2c3d4e5f6g7h8j9",
"to_number": "+493012345678"
}
Anrufdaten abrufen
Rufen Sie über die Calls API vor-signierte Aufzeichnungs-URLs und die zugehörigen TurboFlow-Ausführungen für einen einzelnen Anruf ab.
Basis-URL: https://app.talkturo.com
Authentifizierung: Session-Cookie. Der CRM-Anruf-Endpunkt unterstützt zusätzlich API-Key-Authentifizierung mit dem Scope calls:create.
Endpunkte auf einen Blick
| Methode | Pfad | Zweck |
|---|---|---|
GET | /api/calls/{id}/recording-url | Ruft eine vor-signierte URL für die Anrufaufzeichnung ab. |
GET | /api/calls/{id}/flow-runs | Ruft TurboFlow-Ausführungen ab, die mit einem Anruf verknüpft sind. |
GET | /api/transcripts | Ruft Anruf-Transkripte ab. |
GET | /api/summaries | Ruft Anruf-Zusammenfassungen ab. |
POST | /api/crm/calls | Startet einen ausgehenden CRM-Anruf. Auth: API-Key oder Session. |
Aufzeichnungs-URL abrufen
Rufen Sie eine kurzlebige, vor-signierte URL ab, um auf die Aufzeichnung eines Anrufs zuzugreifen.
Pfadparameter
Die UUID des Anrufs.
Antwortfelder
Die vor-signierte URL zur Anrufaufzeichnung.
Die Gültigkeitsdauer der URL in Sekunden.
Fehlercodes
| Status | Bedeutung |
|---|---|
400 | Die Anruf-ID ist ungültig oder fehlt. |
403 | Sie haben keinen Zugriff auf diesen Anruf. |
404 | Der Anruf wurde nicht gefunden. |
500 | Der Server konnte die Aufzeichnungs-URL nicht erzeugen. |
Flow-Ausführungen für einen Anruf abrufen
Rufen Sie TurboFlow-Ausführungen ab, die während oder im Zusammenhang mit einem bestimmten Anruf erstellt wurden.
Pfadparameter
Die UUID des Anrufs.
Antwortfelder
Eine Liste der TurboFlow-Ausführungen, die dem Anruf zugeordnet sind.
Die ID der Flow-Ausführung.
Die ID des zugehörigen TurboFlow.
Der Name der Flow-Ausführung.
Der Status der Ausführung.
Der Zeitstempel, zu dem die Ausführung gestartet wurde.
Der Zeitstempel, zu dem die Ausführung beendet wurde. Der Wert kann null sein, wenn die Ausführung noch läuft.
Fehlerdetails der Ausführung. Der Wert ist null, wenn die Ausführung erfolgreich war.
Die Eingabedaten, mit denen die Ausführung gestartet wurde.
Fehlercodes
| Status | Bedeutung |
|---|---|
400 | Die Anruf-ID ist ungültig oder fehlt. |
403 | Sie haben keinen Zugriff auf diesen Anruf oder seine Flow-Ausführungen. |
404 | Der Anruf wurde nicht gefunden. |
500 | Der Server konnte die Flow-Ausführungen nicht abrufen. |
Transkripte abrufen
Rufen Sie Anruf-Transkripte für den authentifizierten Workspace ab. Unterstützt optionale Filterung nach Anruf-ID oder Datumsbereich.
Endpunkt
GET /api/transcripts
Query-Parameter
Transkripte nach einer bestimmten Anruf-ID filtern.
Maximale Anzahl der zurückgegebenen Transkripte.
Anzahl der zu überspringenden Transkripte für Paginierung.
Antwortfelder
Array von Transkriptobjekten. Jedes Transkript enthält die Anruf-ID, Transkripttext, Segmente und Zeitstempel.
Gesamtzahl der Transkripte, die der Abfrage entsprechen.
Zusammenfassungen abrufen
Rufen Sie Anruf-Zusammenfassungen für den authentifizierten Workspace ab. Unterstützt optionale Filterung nach Anruf-ID oder Datumsbereich.
Endpunkt
GET /api/summaries
Query-Parameter
Zusammenfassungen nach einer bestimmten Anruf-ID filtern.
Maximale Anzahl der zurückgegebenen Zusammenfassungen.
Anzahl der zu überspringenden Zusammenfassungen für Paginierung.
Antwortfelder
Array von Zusammenfassungsobjekten. Jede Zusammenfassung enthält die Anruf-ID, Zusammenfassungstext, wichtige Ergebnisse und Metadaten.
Gesamtzahl der Zusammenfassungen, die der Abfrage entsprechen.
Ausgehenden CRM-Anruf starten
Starten Sie einen ausgehenden CRM-Anruf für einen Assistenten mit API-Key- oder Session-Cookie-Authentifizierung.
Body-Parameter
Die ID des Assistenten, der den Anruf führt.
Die Zieltelefonnummer. Der Wert muss mindestens vier Zeichen enthalten.
Die Absendertelefonnummer. Ohne Angabe verwendet die API die erste aktive Nummer des Assistenten.
Zusätzliche Metadaten für die Raum-Metadaten.
Antwortfelder
Gibt an, ob der CRM-Anruf erfolgreich gestartet wurde.
Der Name des Raums für den Anruf.
Die ID des gestarteten SIP-Anrufs.
Die Zieltelefonnummer des Anrufs.
Für die API-Key-Authentifizierung benötigen Sie den Scope calls:create. Bei Session-Cookie-Authentifizierung verwenden Sie eine aktive authentifizierte Sitzung.