Vai al contenuto principale
I webhook esposti permettono ad Arya di notificare sistemi esterni via HTTP quando succedono eventi nel workspace. Il contrario dei webhook in ingresso.
Diagramma Arya → HTTP POST → sistema esterno

​
Use case tipici

  • ETL: ogni modifica di un record viene replicata in un data warehouse esterno
  • Analytics: eventi Arya mandati a Segment, Mixpanel, Amplitude
  • ERP legacy: notifica al sistema contabile quando una fattura è emessa
  • Sistema interno custom: dashboard in tempo reale che consuma gli eventi Arya

​
Configurazione

​
Via workflow

Usi un normale workflow con azione HTTP Request:
1

Crea workflow

Trigger: evento che vuoi notificare (record creato/aggiornato, stato cambiato).
2

Azione HTTP Request

  • URL: endpoint del sistema esterno
  • Metodo: POST (tipico)
  • Headers: auth, content-type
  • Body: JSON con dati del record
3

Gestisci errori

Retry logic, fallback, notifica admin se fallisce ripetutamente.

​
Webhook esposti preconfigurati

Per use case comuni, Arya offre webhook pre-fatti da attivare con un click:
deal.created, deal.updated, deal.stage_changed, deal.won, deal.lost. Payload: dati completi del deal + before/after dei campi modificati.
invoice.issued, invoice.paid, invoice.overdue.
employee.hired, employee.terminated, leave.approved.
quote.sent, quote.viewed, quote.signed, quote.rejected.
task.assigned, task.completed, task.overdue.
Attivi da Impostazioni → Webhook esposti → + Nuovo.

​
Payload standard

Esempio payload deal.won: 
{
  "event": "deal.won",
  "timestamp": "2026-04-14T15:30:00Z",
  "workspace_id": "ws_abc123",
  "data": {
    "deal": {
      "id": "deal_xyz",
      "name": "Rinnovo Acme 2026",
      "value": 25000,
      "currency": "EUR",
      "stage": "Won",
      "closed_at": "2026-04-14T15:30:00Z",
      "owner": {
        "id": "user_def",
        "name": "Mario Rossi",
        "email": "mario@arya.so"
      },
      "company": {
        "id": "comp_ghi",
        "name": "Acme SpA",
        "vat": "IT12345678901"
      }
    }
  },
  "signature": "hmac-sha256-hash-of-body"
}

​
Sicurezza

Arya firma il body con chiave segreta condivisa. Il sistema ricevente verifica la firma per garantire autenticità.
Se il sistema esterno ha IP fissi, puoi whitelisting a livello di network.
Arya rifiuta URL HTTP non cifrati.
Default 10 secondi. Se il sistema esterno non risponde, Arya considera fallito e ritenta.

​
Retry e idempotenza

Arya ritenta automaticamente su failure (503, timeout, errori di rete) con backoff esponenziale (1, 2, 4, 8 min). Dopo 5 tentativi marca come fallito e notifica admin.Il tuo endpoint deve essere idempotente: potresti ricevere la stessa notifica più volte. Usa l’event ID per deduplicare.

​
Monitoraggio

In Impostazioni → Webhook esposti → Log vedi per ogni webhook:
  • Timestamp
  • URL chiamato
  • Payload inviato
  • Risposta ricevuta
  • Status (success, failed)
  • Numero tentativi
Puoi ritentare manualmente un webhook fallito.

​
Domande frequenti

Dipende dai campi. Per evitare di inviare dati confidenziali (es. stipendi, codici fiscali), configura filtri sui campi inclusi nel payload.
Sì, ogni webhook ha il suo URL + eventi sottoscritti.
Si ferma. I webhook già in coda vengono comunque consegnati prima dello stop.