AIDA Zapier
Zapier è una Destinazione (beta) che invia a uno Zap ogni documento approvato in AIDA, così puoi inoltrare i suoi dati e il PDF a migliaia di applicazioni (Google Sheets, Slack, il tuo ERP e altre).
Collegare AIDA a Zapier
- In AIDA, apri il tipo di documento, aggiungi la destinazione Zapier e salva.
- Copia la chiave della destinazione.
- In Zapier, crea uno Zap con il trigger AIDA → Document Approved. Quando ti viene chiesto di collegarti, incolla la chiave. Il collegamento prende il nome del tipo di documento.
- Testa il trigger: Zapier carica come esempi i tre documenti elaborati più recenti di quel tipo. Prima approva almeno un documento.
- Aggiungi le azioni che ti servono, mappa i campi e pubblica lo Zap.
Da quel momento, ogni documento approvato con questa destinazione viene inviato allo Zap. Il pulsante Apri i tuoi Zap nella destinazione apre i tuoi Zap in Zapier.
note
Ogni destinazione Zapier alimenta un solo Zap: collegare un nuovo Zap con la stessa chiave sostituisce il precedente. Per alimentare più Zap, aggiungi più destinazioni Zapier. Rigenerare la chiave scollega lo Zap.
Se lo Zap viene spento o eliminato, la destinazione si scollega e le nuove approvazioni terminano con l'errore zapierNotConnected finché non colleghi di nuovo uno Zap.
Payload
Ogni documento approvato viene inviato come oggetto JSON. I record di esempio mostrati in Zapier hanno lo stesso formato.
| Campo | Tipo | Descrizione |
|---|---|---|
id | string | L'ID del documento in AIDA. |
documentName | string | Il nome del documento. |
documentConfigurationName | string | Il nome del tipo di documento. |
documentURL | string | Un link permanente per visualizzare il documento nell'applicazione web di AIDA. |
downloadURL | string | Un link temporaneo e sicuro per scaricare il PDF del documento. Scade dopo 7 giorni. |
Le proprietà estratte seguono le stesse regole della destinazione Webhook: la chiave è l'Output Mapping della proprietà o, se non impostato, la sua Etichetta, i valori sono convertiti nel loro tipo JSON e le tabelle diventano array. A differenza del webhook, le date sono stringhe ISO-8601 in UTC (per esempio 2025-10-14T00:00:00Z).
{
"Invoice number": "INV-2025-042",
"invoiceDate": "2025-10-14T00:00:00Z",
"total": 122.00,
"lines": [
{ "description": "Product A", "qty": 2, "unitPrice": 50.00 }
],
"id": "12345",
"documentName": "invoice-042.pdf",
"documentConfigurationName": "Invoice",
"documentURL": "https://www.aidacloud.com/app/web/archive/12345",
"downloadURL": "https://api.aidacloud.com/asset/document/generated-auth-token"
}
Riferimento API
L'app AIDA per Zapier usa i seguenti endpoint. L'URL di base è https://api.aidacloud.com/api/v1/zapier.
Autenticazione: ogni richiesta invia la chiave della destinazione nell'header X-API-Key. Una chiave mancante o sconosciuta restituisce 401 Unauthorized.
| Metodo | Percorso | Scopo | Body | Risposta |
|---|---|---|---|---|
GET | /me | Verifica il collegamento. | - | { "id", "documentConfigurationId", "documentConfigurationName", "username" } |
POST | /hooks | Iscrive lo Zap (REST hook). L'URL deve iniziare con https://hooks.zapier.com/, altrimenti 400. | { "hookUrl": "…" } | { "id" } |
DELETE | /hooks | Disiscrive lo Zap. Scollega la destinazione solo se hookUrl è quello attualmente collegato. | { "hookUrl": "…" } | vuota |
GET | /documents/sample | Restituisce fino a tre documenti elaborati di recente del tipo di documento, nel formato del payload. | - | array di payload |
Consegna: quando un documento viene approvato, AIDA invia un HTTP POST con il payload all'hook iscritto, con Content-Type: application/json. Se Zapier risponde 410 Gone, AIDA scollega la destinazione.