Vai al contenuto principale
Due modalità di avvio: schedulazione (periodica) e webhook in ingresso (da sistemi esterni).

​
Workflow schedulati

​
Cron expression

Arya supporta sintassi cron standard: 
minuto ora giorno mese giorno-settimana

0 9 * * 1      → Ogni lunedì alle 9:00
0 */4 * * *    → Ogni 4 ore
30 18 * * 1-5  → Feriali alle 18:30
0 0 1 * *      → Primo del mese a mezzanotte

​
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:
https://api.arya.so/webhooks/wh_abc123xyz
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.
{
  "contact": {
    "first_name": "string",
    "last_name": "string",
    "email": "string"
  },
  "source": "string"
}
4

Test

Invia una chiamata di test (Arya fornisce esempio cURL).
curl -X POST https://api.arya.so/webhooks/wh_abc123xyz \
  -H "X-Webhook-Token: xxx" \
  -H "Content-Type: application/json" \
  -d '{"contact": {"first_name": "Mario", ...}}'
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.