Troupia API
Collega qualsiasi sistema alle tue automazioni, esecuzioni e conversazioni, con una sola chiave.
Prima di tutto: una chiave API
Un proprietario o un admin la crea in Impostazioni → Chiavi API e sceglie cosa può fare. Ogni richiesta la invia così:
Authorization: Bearer trp_live_…
Automazioni
/v1/automationsAll automations
Your workspace's automations, a page at a time.
automations:read/v1/automations/{automationId}One automation
Its steps, every way it starts and its version. Never a secret.
automations:readETag: "7.1a2b3c4d"
Conserva l’ETag. Una modifica lo rimanda indietro.
/v1/automations/{automationId}Rename
automations:writeIf-Match: "7.1a2b3c4d"
Se qualcuno ha cambiato l’automazione dopo la tua lettura: 412, e nulla viene sovrascritto. Rileggi e decidi.
/v1/automations/{automationId}/enableTurn on
The plan's schedule floor applies, as in the app.
automations:writeIf-Match: "7.1a2b3c4d"
Chiedere lo stato già in vigore restituisce 200 e non cambia nulla. Le esecuzioni pianificate restano.
/v1/automations/{automationId}/disableTurn off
automations:writeIf-Match: "7.1a2b3c4d"
Chiedere lo stato già in vigore restituisce 200 e non cambia nulla. Le esecuzioni pianificate restano.
/v1/automations/resolve-linkFrom a link
A Troupia link → the automation or run it names.
automations:readEsecuzioni
/v1/automations/{automationId}/runsAn automation's runs
A page at a time.
runs:read/v1/automations/{automationId}/analysisRuns analysed
How many succeeded, how many failed and why, over a window.
runs:read/v1/automations/runs/{runId}One run
With what went in and out of each step.
runs:read_payloads/v1/runs/{runId}A chat run
data:readConversazioni
/v1/conversationsConversations
data:read/v1/conversationsStart a conversation
chat:write/v1/conversations/{conversationId}/messagesSend a message
chat:write/v1/conversations/{conversationId}/exportExport a conversation
data:readWebhook
/v1/automations/{automationId}/webhookWebhook addresses and their secrets
webhooks:manageSolo la chiave di un proprietario o di un admin: verificata a ogni chiamata, ogni chiamata è registrata.
/v1/webhook-endpoints/{endpointId}/deliveriesFailed deliveries
To one outgoing endpoint: newest first, a page at a time.
webhooks:managePlugin
/v1/plugins/{slug}/openapi.jsonA plugin's API
Each plugin publishes its own OpenAPI document.
data:read/v1/plugins/{slug}/{entity}A plugin's records
data:read/v1/plugins/{slug}/{entity}Create a record
data:write/v1/plugins/{slug}/{entity}/{id}One record
data:read/v1/plugins/{slug}/{entity}/{id}Update a record
data:write/v1/plugins/crm/{path}Read from the CRM
crm:read/v1/plugins/crm/{path}Write to the CRM
crm:writeSull’API
/v1/openapi.jsonThis document
As OpenAPI 3.1, no key needed.
Nessuna chiaveQuando qualcosa non passa
| 401 | Nessuna chiave, oppure non è valida. |
| 403 | La chiave non ha questa autorizzazione. |
| 404 | Non trovato in questo spazio di lavoro. |
| 412 | L’automazione è cambiata dopo la tua lettura. |
| 428 | Manca If-Match. |
| 429 | Troppe richieste. Attendi e riprova. |