AIDA Zapier
Zapier est une Destination (bêta) qui envoie à un Zap chaque document approuvé dans AIDA, pour transmettre ses données et son PDF à des milliers d'applications (Google Sheets, Slack, votre ERP et plus encore).
Connecter AIDA à Zapier
- Dans AIDA, ouvrez le type de document, ajoutez la destination Zapier et enregistrez.
- Copiez la clé de la destination.
- Dans Zapier, créez un Zap avec le déclencheur AIDA → Document Approved. Collez la clé lorsque la connexion est demandée. La connexion porte le nom du type de document.
- Testez le déclencheur : Zapier charge comme exemples les trois documents traités les plus récents de ce type. Approuvez d'abord au moins un document.
- Ajoutez les actions nécessaires, associez les champs et publiez le Zap.
Dès lors, chaque document approuvé avec cette destination est envoyé au Zap. Le bouton Ouvrir vos Zaps de la destination ouvre vos Zaps dans Zapier.
note
Chaque destination Zapier alimente un seul Zap : connecter un nouveau Zap avec la même clé remplace le précédent. Pour alimenter plusieurs Zaps, ajoutez plusieurs destinations Zapier. Régénérer la clé déconnecte le Zap.
Si le Zap est désactivé ou supprimé, la destination est déconnectée et les nouvelles approbations se terminent par l'erreur zapierNotConnected jusqu'à ce qu'un Zap soit de nouveau connecté.
Payload
Chaque document approuvé est envoyé sous forme d'objet JSON. Les exemples affichés dans Zapier ont le même format.
| Champ | Type | Description |
|---|---|---|
id | string | L'ID du document dans AIDA. |
documentName | string | Le nom du document. |
documentConfigurationName | string | Le nom du type de document. |
documentURL | string | Un lien permanent pour afficher le document dans l'application web AIDA. |
downloadURL | string | Un lien temporaire et sécurisé pour télécharger le PDF du document. Il expire après 7 jours. |
Les propriétés extraites suivent les mêmes règles que la destination Webhook : la clé est l'Output Mapping de la propriété ou, s'il n'est pas défini, son Libellé, les valeurs sont converties dans leur type JSON et les tableaux deviennent des arrays. Contrairement au webhook, les dates sont des chaînes ISO-8601 en UTC (par exemple 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"
}
Référence API
L'application AIDA pour Zapier utilise les endpoints suivants. L'URL de base est https://api.aidacloud.com/api/v1/zapier.
Authentification : chaque requête envoie la clé de la destination dans l'en-tête X-API-Key. Une clé absente ou inconnue renvoie 401 Unauthorized.
| Méthode | Chemin | Rôle | Body | Réponse |
|---|---|---|---|---|
GET | /me | Teste la connexion. | - | { "id", "documentConfigurationId", "documentConfigurationName", "username" } |
POST | /hooks | Abonne le Zap (REST hook). L'URL doit commencer par https://hooks.zapier.com/, sinon 400. | { "hookUrl": "…" } | { "id" } |
DELETE | /hooks | Désabonne le Zap. La destination n'est déconnectée que si hookUrl est celui actuellement connecté. | { "hookUrl": "…" } | vide |
GET | /documents/sample | Renvoie jusqu'à trois documents récemment traités du type de document, au format du payload. | - | tableau de payloads |
Livraison : lorsqu'un document est approuvé, AIDA envoie un HTTP POST avec le payload au hook abonné, avec Content-Type: application/json. Si Zapier répond 410 Gone, AIDA déconnecte la destination.