Skip to main content
Due modalità di avvio: schedulazione (periodica) e webhook in ingresso (da sistemi esterni).

​
Workflow schedulati

​
Cron expression

Arya supporta sintassi cron standard:

​
Scope

Uno scheduled workflow può operare su:
  • Il workspace (1 esecuzione per trigger, es. “invia report settimanale team”)
  • Un insieme di record (1 esecuzione per record, es. “per ogni fattura aperta da >30gg invia sollecito”)
1

Configura

Trigger tipo Scheduled → cron expression + timezone + scope.
2

Test

Click Esegui ora per testare senza aspettare il prossimo slot.
3

Attiva

Switch Attivo. Il workflow si esegue automaticamente.

​
Esempi pratici

Ogni lunedì 9:00 → query pipeline deal → genera grafico → email a manager.
Ogni domenica notte → trova contatti duplicati → notifica HR per merge.
Ogni giorno 8:00 → cerca contatti con compleanno oggi → invia email auguri personalizzata.
Ogni giorno → fatture scadute da 7/30/60gg → email sollecito di livello crescente.
Ogni settimana → certificazioni in scadenza entro 30gg → task a HR + email al dipendente.

​
Webhook in ingresso

Permettono a sistemi esterni di avviare workflow Arya chiamando un URL HTTP.

​
Configurazione

1

Crea trigger webhook

Trigger tipo Webhook in ingresso → Arya genera URL univoco:
2

Imposta autenticazione

  • None: chiunque con URL può triggerare (sconsigliato)
  • Token: header X-Webhook-Token: xxx
  • HMAC: firma del body con chiave segreta (più sicuro)
3

Definisci schema payload

Specifica la struttura JSON attesa. Arya valida ogni chiamata.
4

Test

Invia una chiamata di test (Arya fornisce esempio cURL).
5

Attiva e condividi URL

Passa URL + schema al sistema che deve chiamare (Zapier, Make, partner, sistema interno).

​
Use case webhook

Typeform invia submission → webhook Arya → crea contatto + aggiunge a lista.
Zapier connette N sistemi → triggera Arya come endpoint di uno step.
ERP nota nuovo ordine → chiama Arya → crea deal + aggiorna fattura.
Tool esterni di outreach chiamano Arya al rispondere di un lead → crea record + assegna a rep.

​
Gestione errori

Se il workflow fallisce, Arya risponde al webhook con:
  • 200 OK + body con errore se vuoi che il sistema esterno lo veda
  • 500 Error se vuoi che Zapier/Make ritentino
Configurabile da Avanzate → Error response.

​
Logging

Ogni chiamata webhook è loggata in Cronologia webhook:
  • Timestamp
  • IP sorgente
  • Payload ricevuto
  • Risposta inviata
  • Workflow innescato (se è scattato)

​
Differenza con webhook esposti

  • Webhook in ingresso (questa pagina): Arya riceve dall’esterno
  • Webhook esposti: Arya notifica l’esterno (outbound)

​
Domande frequenti

Sì, switch Attivo/Pausato. Riprende dal prossimo slot al riattivarlo.
Solo se autenti (token/HMAC). Senza autenticazione, è pubblico in rete e chiunque può triggerare.
Rate limit 100 req/sec per workspace, 500 req/sec per piani Enterprise. Oltre il limite Arya risponde 429 con header Retry-After.