Workflow di Attio: come funziona l'automazione del CRM in Attio
Di Roman Zakharenko · Fatti verificati il · 6 min di lettura
Attio automatizza il lavoro sul CRM con i workflow. Un workflow parte da un blocco trigger ed esegue una catena di blocchi di azione, come aggiornare un record, creare un task, inviare un messaggio Slack o fare una richiesta HTTP. Le esecuzioni dei workflow consumano i crediti del workspace, e tutto il resto si collega tramite la REST API e i webhook di Attio.
In breve
- Un workflow di Attio è composto da un blocco trigger, che lo avvia, e da blocchi di azione, che svolgono il lavoro.
- I workflow consumano i crediti del workspace. La maggior parte dei blocchi consuma un credito, e un blocco che fallisce, insieme a tutti i blocchi successivi, non ne consuma nessuno.
- La REST API di Attio consente 100 richieste di lettura e 25 richieste di scrittura al secondo. Oltre il limite restituisce HTTP 429 con un header Retry-After.
- Attio firma i webhook con un HMAC-SHA256 del corpo della richiesta, inviato nell'header Attio-Signature.
Come si costruiscono i workflow di Attio
Un workflow si costruisce su un canvas. Il blocco trigger decide quando parte e i blocchi di azione che lo seguono decidono cosa succede. La libreria di blocchi di Attio raggruppa i trigger in quattro tipi:
- Trigger sui record, come 'Record created'.
- Trigger sulle liste, come 'Record added to list'.
- Trigger sui task, come 'Task created'.
- Trigger di utilità, come 'Manual run', una pianificazione o un webhook in entrata.
Il centro assistenza di Attio cita come esempi di blocchi di azione l'aggiornamento di un record, la creazione di un task, l'invio di un messaggio Slack, l'iscrizione di una persona a una sequenza e l'invio di una richiesta HTTP. Puoi anche descrivere un workflow in linguaggio naturale e lasciare che sia Ask Attio a costruirlo. Le app create con l'Attio SDK possono aggiungere blocchi propri, che poi compaiono nel selettore dei blocchi accanto a quelli integrati.
Per impostazione predefinita, un workflow non può scrivere su un oggetto. Prima un admin, o un membro con accesso completo a quell'oggetto, deve concedere l'accesso al workflow. Verificalo prima di testare un workflow che aggiorna dei record.
Come i workflow consumano i crediti
Le esecuzioni dei workflow e le funzioni AI attingono ai crediti condivisi del workspace. La documentazione di fatturazione di Attio descrive come vengono conteggiati:
- La maggior parte dei blocchi dei workflow consuma un credito a ogni esecuzione.
- I crediti vengono addebitati solo per i blocchi effettivamente eseguiti. Se un'esecuzione fallisce a metà, il blocco che ha fallito e tutti i blocchi successivi non consumano crediti.
- Anche il ricalcolo degli attributi AI consuma crediti.
- Gli admin possono vedere il consumo di crediti di ogni workflow in Workspace settings.
Il numero di crediti inclusi varia in base al piano, e Attio ha già cambiato i suoi piani in passato. Controlla la quota attuale sulla pagina dei prezzi di Attio e stima il consumo moltiplicando il numero di blocchi per esecuzione per le esecuzioni che prevedi ogni mese.
API e webhook di Attio
Per tutto ciò che un workflow non può fare da solo, Attio offre una REST API e webhook in uscita. Ecco cosa dice la documentazione per sviluppatori su ciascuno.
| Argomento | Cosa documenta Attio |
|---|---|
| Rate limit | 100 richieste al secondo per le letture e 25 al secondo per le scritture. Oltre il limite, HTTP 429 con un header Retry-After. |
| Endpoint di elenco | Anche List records e List entries hanno limiti basati su un punteggio, conteggiati su una finestra di 10 secondi per tutte le app e tutti i token. |
| Autenticazione | Una chiave API per un singolo workspace, oppure OAuth 2.0 per le app usate in più workspace. I token vengono inviati come Bearer token e gli scope si impostano per ogni token. |
| Eventi webhook | Tra gli eventi ci sono record.created, list-entry.created, note.created e task.created. |
| Firma del webhook | Un HMAC-SHA256 del corpo grezzo della richiesta, generato con il secret del webhook e codificato in esadecimale, nell'header Attio-Signature. |
| Nuovi tentativi | Ogni messaggio include un header Idempotency-Key che resta invariato quando Attio lo reinvia. |
Per verificare che un webhook provenga da Attio, ricalcola l'HMAC-SHA256 del corpo grezzo con il secret del webhook e confrontalo con l'header Attio-Signature. Attio invia lo stesso valore anche come X-Attio-Signature per i middleware più vecchi. Usa l'header Idempotency-Key per saltare i messaggi che hai già elaborato, così un nuovo tentativo non crea un secondo task o un secondo messaggio Slack.
Collegare Attio ai tuoi strumenti di assistenza
Attio ha un'app Slack per le notifiche e un'app Zapier ufficiale. Zapier elenca collegamenti già pronti tra Attio e helpdesk come Zendesk e Intercom. Per avere più controllo, collega un helpdesk all'API e ai webhook di Attio tramite n8n o Make. Ecco uno schema comune, descritto per passaggi. Mostra come si incastrano i vari pezzi. Non è un caso di studio di TascaLab.
- Trigger: il tuo helpdesk invia un webhook a n8n o Make quando un ticket viene creato o va in escalation.
- Ricerca: il workflow trova tramite l'API il record dell'azienda del cliente in Attio, restando entro il limite di 100 letture al secondo.
- Aggiornamento: scrive lo stato o la categoria del ticket in un attributo del record, oppure crea un task per il responsabile dell'account.
- Reazione in Attio: un workflow di Attio attivato da quell'aggiornamento del record invia un messaggio Slack al responsabile dell'account.
- Gestione degli errori: in caso di HTTP 429 attendi e riprova, e usa l'header Idempotency-Key per scartare le consegne duplicate dei webhook.
Come realizzarlo
TascaLab collega strumenti come Attio agli strumenti di helpdesk e di chat che usi già, tramite API, webhook, n8n e Make, senza cambiare piattaforma. I progetti Custom Automation costano da 1070 €. La maggior parte delle configurazioni richiede da 1 a 3 settimane e ogni progetto include documentazione di base e 30 giorni di supporto dopo il lancio. Puoi iniziare con una call di Health Check gratuita di 30 minuti.
Domande frequenti
Cosa sono i workflow di Attio?
Sono lo strumento di automazione di Attio. Un workflow parte da un blocco trigger, come la creazione di un record o un'esecuzione manuale, e poi esegue blocchi di azione, come aggiornare un record, creare un task, inviare un messaggio Slack o fare una richiesta HTTP.
I workflow di Attio consumano crediti?
Sì. Le esecuzioni dei workflow consumano i crediti condivisi del workspace. La maggior parte dei blocchi consuma un credito per esecuzione, e i blocchi che falliscono o non vengono mai eseguiti non ne consumano. Il numero di crediti inclusi dipende dal tuo piano.
Quali sono i rate limit dell'API di Attio?
100 richieste al secondo per le letture e 25 al secondo per le scritture. Oltre il limite, Attio restituisce HTTP 429 con un header Retry-After. Anche gli endpoint List records e List entries hanno limiti basati su un punteggio.
Come verifico un webhook di Attio?
Calcola un HMAC-SHA256 del corpo grezzo della richiesta con il secret del webhook, codificalo in esadecimale e confrontalo con l'header Attio-Signature.
Vuoi questa configurazione per il tuo team?
Prenota un Health Check gratuito: una call di 30 minuti e un report scritto con 2–3 consigli concreti, un prezzo fisso e i costi di esercizio stimati. Nessuna proposta commerciale.
Fonti
- Attio Help — Overview of workflows
- Attio Help — Workflows block library
- Attio Help — Create a workflow
- Attio Help — Automations billing
- Attio Docs — Rate limiting
- Attio Docs — Authentication
- Attio Docs — Webhooks
- Attio Docs — Workflow blocks (SDK)
- Attio Help — Communication apps (Slack)
- Attio Help — Zapier app
- Zapier — Attio and Zendesk integrations