Workflowy w Attio: jak działa automatyzacja CRM w Attio
Autor: Roman Zakharenko · Fakty sprawdzone · 5 min czytania
Attio automatyzuje pracę w CRM za pomocą workflowów. Workflow zaczyna się od bloku triggera i uruchamia łańcuch bloków akcji, np. aktualizację rekordu, utworzenie zadania, wysłanie wiadomości na Slacku lub wykonanie żądania HTTP. Uruchomienia workflowów zużywają kredyty przestrzeni roboczej (workspace), a wszystko inne łączy się przez REST API i webhooki Attio.
W skrócie
- Workflow w Attio składa się z bloku triggera, który go uruchamia, i bloków akcji, które wykonują pracę.
- Workflowy zużywają kredyty przestrzeni roboczej. Większość bloków zużywa jeden kredyt, a blok, który zakończy się błędem, oraz każdy blok po nim nie zużywają żadnego.
- REST API Attio pozwala na 100 żądań odczytu i 25 żądań zapisu na sekundę. Po przekroczeniu limitu zwraca HTTP 429 z nagłówkiem Retry-After.
- Attio podpisuje webhooki za pomocą HMAC-SHA256 treści żądania, przesyłanego w nagłówku Attio-Signature.
Jak zbudowane są workflowy w Attio
Workflow budujesz na kanwie. Blok triggera decyduje, kiedy workflow się uruchamia, a bloki akcji po nim – co się dzieje. Biblioteka bloków Attio dzieli triggery na cztery rodzaje:
- Triggery rekordów, np. 'Record created'.
- Triggery list, np. 'Record added to list'.
- Triggery zadań, np. 'Task created'.
- Triggery narzędziowe (utility), np. 'Manual run', harmonogram lub przychodzący webhook.
Centrum pomocy Attio jako przykłady bloków akcji podaje aktualizację rekordu, utworzenie zadania, wysłanie wiadomości na Slacku, zapisanie kogoś do sekwencji i wykonanie żądania HTTP. Możesz też opisać workflow zwykłym językiem i pozwolić, by zbudował go Ask Attio. Aplikacje zbudowane za pomocą Attio SDK mogą dodawać własne bloki, które pojawiają się wtedy w selektorze bloków obok wbudowanych.
Domyślnie workflow nie może zapisywać danych w obiekcie. Administrator lub członek z pełnym dostępem do tego obiektu musi najpierw nadać workflow dostęp. Sprawdź to, zanim zaczniesz testować workflow, który aktualizuje rekordy.
Jak workflowy zużywają kredyty
Uruchomienia workflowów i funkcje AI korzystają ze wspólnej puli kredytów przestrzeni roboczej. Dokumentacja rozliczeń Attio opisuje, jak są one liczone:
- Większość bloków workflow zużywa jeden kredyt przy każdym uruchomieniu.
- Kredyty są naliczane tylko za bloki, które faktycznie się wykonały. Jeśli uruchomienie zakończy się błędem w połowie, blok, który zawiódł, i każdy blok po nim nie zużywają kredytów.
- Ponowne przeliczanie atrybutów AI również zużywa kredyty.
- Administratorzy widzą zużycie kredytów dla każdego workflow w Workspace settings.
Liczba kredytów w pakiecie zależy od planu, a Attio już wcześniej zmieniało swoje plany. Sprawdź aktualny limit na stronie cennika Attio i oszacuj zużycie, mnożąc liczbę bloków na uruchomienie przez spodziewaną liczbę uruchomień w miesiącu.
API i webhooki Attio
Do wszystkiego, czego workflow nie zrobi sam, Attio udostępnia REST API i wychodzące webhooki. Oto co mówi o nich dokumentacja dla deweloperów.
| Temat | Co dokumentuje Attio |
|---|---|
| Limity zapytań (rate limits) | 100 żądań na sekundę dla odczytów i 25 na sekundę dla zapisów. Po przekroczeniu limitu HTTP 429 z nagłówkiem Retry-After. |
| Endpointy listujące | List records i List entries mają też limity oparte na punktach (score), liczone w 10-sekundowym oknie łącznie dla wszystkich aplikacji i tokenów. |
| Uwierzytelnianie | Klucz API dla jednej przestrzeni roboczej albo OAuth 2.0 dla aplikacji używanych w kilku przestrzeniach roboczych. Tokeny są wysyłane jako tokeny Bearer, a zakresy (scopes) ustawia się dla każdego tokena. |
| Zdarzenia webhooków | Wśród zdarzeń są record.created, list-entry.created, note.created i task.created. |
| Podpis webhooka | HMAC-SHA256 surowej treści żądania, utworzony z sekretem webhooka i zakodowany szesnastkowo (hex), w nagłówku Attio-Signature. |
| Ponowienia | Każda wiadomość zawiera nagłówek Idempotency-Key, który pozostaje taki sam, gdy Attio ponawia jej wysłanie. |
Aby sprawdzić, czy webhook pochodzi od Attio, oblicz ponownie HMAC-SHA256 surowej treści z sekretem webhooka i porównaj wynik z nagłówkiem Attio-Signature. Attio wysyła tę samą wartość także jako X-Attio-Signature na potrzeby starszego middleware. Używaj nagłówka Idempotency-Key, aby pomijać wiadomości, które już przetworzyłeś, tak by ponowienie nie utworzyło drugiego zadania ani drugiej wiadomości na Slacku.
Łączenie Attio z narzędziami wsparcia
Attio ma aplikację Slack do powiadomień i oficjalną aplikację Zapier. Zapier wymienia gotowe połączenia między Attio a helpdeskami takimi jak Zendesk i Intercom. Jeśli potrzebujesz większej kontroli, połącz helpdesk z API i webhookami Attio przez n8n lub Make. Poniżej typowy schemat rozpisany na kroki. Pokazuje, jak elementy do siebie pasują. To nie jest studium przypadku TascaLab.
- Trigger: Twój helpdesk wysyła webhook do n8n lub Make, gdy zgłoszenie zostaje utworzone lub eskalowane.
- Wyszukanie: workflow znajduje w Attio rekord firmy klienta przez API, mieszcząc się w limicie 100 odczytów na sekundę.
- Aktualizacja: zapisuje status lub kategorię zgłoszenia w atrybucie rekordu albo tworzy zadanie dla opiekuna konta.
- Reakcja w Attio: workflow Attio uruchamiany tą aktualizacją rekordu wysyła wiadomość na Slacku do opiekuna konta.
- Obsługa błędów: przy HTTP 429 odczekaj i ponów żądanie, a nagłówek Idempotency-Key wykorzystaj do odrzucania zduplikowanych dostaw webhooków.
Wdrożenie
TascaLab łączy narzędzia takie jak Attio z helpdeskiem i narzędziami czatu, których już używasz, przez API, webhooki, n8n i Make, bez zmiany platformy. Projekty Custom Automation kosztują od 4650 zł. Większość wdrożeń trwa od 1 do 3 tygodni, a każdy projekt obejmuje podstawową dokumentację i 30 dni wsparcia po uruchomieniu. Możesz zacząć od bezpłatnej 30-minutowej rozmowy Health Check.
Najczęściej zadawane pytania
Czym są workflowy w Attio?
To narzędzie do automatyzacji w Attio. Workflow zaczyna się od bloku triggera, np. utworzenia rekordu lub ręcznego uruchomienia, a następnie wykonuje bloki akcji, np. aktualizację rekordu, utworzenie zadania, wysłanie wiadomości na Slacku lub wykonanie żądania HTTP.
Czy workflowy w Attio zużywają kredyty?
Tak. Uruchomienia workflowów zużywają wspólne kredyty przestrzeni roboczej. Większość bloków zużywa jeden kredyt na uruchomienie, a bloki, które zakończą się błędem lub w ogóle się nie wykonają, nie zużywają żadnego. Liczba kredytów w pakiecie zależy od Twojego planu.
Jakie są limity zapytań API Attio?
100 żądań na sekundę dla odczytów i 25 na sekundę dla zapisów. Po przekroczeniu limitu Attio zwraca HTTP 429 z nagłówkiem Retry-After. Endpointy List records i List entries mają też limity oparte na punktach (score).
Jak zweryfikować webhook z Attio?
Oblicz HMAC-SHA256 surowej treści żądania z sekretem webhooka, zakoduj go szesnastkowo (hex) i porównaj z nagłówkiem Attio-Signature.
Chcesz takie rozwiązanie dla swojego zespołu?
Umów bezpłatny Health Check: 30-minutowa rozmowa i pisemny raport z 2–3 konkretnymi rekomendacjami, stałą ceną i szacowanymi kosztami bieżącymi. Bez nachalnej sprzedaży.
Źródła
- 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