Probleme comune și soluții
Flux de lucru care nu se declanșează
Simptome: Fluxul de lucru nu rulează atunci când vă așteptați.
Cauze posibile:
- Flux de lucru neactivat: Asigurați-vă că fluxul de lucru este setat pe “Active”, nu pe “Draft”
- Condițiile declanșatorului nu sunt îndeplinite: Verificați că declanșatorul corespunde evenimentului așteptat
- Câmp nemonitorizat: Pentru declanșatoarele “Record is Updated”, asigurați-vă că acel câmp specific este urmărit
- Permisiuni: Verificați că aveți permisiunea de a rula fluxuri de lucru
Soluții:
- Verificați starea fluxului de lucru în lista fluxurilor de lucru
- Testați cu acțiunea specifică despre care considerați că îl declanșează
- Revizuiți configurarea declanșatorului
- Contactați administratorul dvs. despre permisiuni
Declanșarea fluxului de lucru prea devreme (câmpuri goale)
Simptome: Când creați manual o înregistrare în UI, fluxul de lucru se declanșează înainte de a avea timp să completați toate câmpurile. Fluxul de lucru rulează cu valori ale câmpurilor în mare parte goale.
De ce se întâmplă asta: Twenty salvează totul în timp real — nu există moduri separate “edit” vs “read”. Când creați o înregistrare, aceasta este salvată imediat, declanșând evenimentul “Record is created” înainte să puteți completa câmpuri suplimentare.
Când “Record is created” funcționează bine:
- Înregistrări create prin apeluri API (câmpurile sunt populate într-o singură cerere)
- Înregistrări create prin import
- Crearea automată de înregistrări din alte fluxuri de lucru
Soluție: Pentru înregistrările create manual în UI, folosiți “Record is created or updated” ca declanșator. Astfel:
- Fluxul de lucru se declanșează după ce utilizatorul a terminat de completat și salvat câmpurile
- Obțineți date complete în loc de valori goale
Dacă doriți ca fluxul de lucru să ruleze doar o singură dată per înregistrare, adăugați o acțiune Filter pentru a verifica un câmp precum createdAt equals updatedAt (prima salvare) sau folosiți un câmp checkbox personalizat pentru a urmări dacă fluxul de lucru a rulat deja.
Acțiuni eșuate
Simptome: Fluxul de lucru rulează, dar unele acțiuni eșuează.
Cauze posibile:
- Date lipsă: Câmpurile obligatorii sunt goale
- Referințe nevalide: Variabilele din pașii anteriori nu există
- Erori API: Serviciile externe returnează erori
- Probleme de permisiuni: Acțiunea necesită permisiuni pe care nu le aveți
Soluții:
- Verificați detaliile rulării fluxului de lucru pentru mesaje de eroare
- Verificați că toate câmpurile obligatorii au valori
- Testați conexiunile API independent
- Revizuiți permisiunile rolurilor
Erori ale cererilor HTTP
Simptome: Acțiunile HTTP Request eșuează sau returnează rezultate neașteptate.
Coduri de eroare comune:
- 400: Cerere incorectă - verificați formatul corpului cererii
- 401: Neautorizat - verificați cheia API
- 403: Interzis - verificați permisiunile API
- 404: Nu a fost găsit - verificați URL-ul punctului final
- 429: Prea multe cereri - implementați limitarea ratei
- 500: Eroare de server - problemă a serviciului extern
Soluții:
- Verificați URL-ul punctului final API
- Verificați antetele de autentificare
- Testați mai întâi apelul API în afara Twenty
- Adăugați tratare a erorilor în acțiunile Code
Erori în acțiunile Code
Simptome: Codul JavaScript nu reușește să se execute.
Probleme comune:
- Erori de sintaxă: Greșeli de tastare sau JavaScript invalid
- Variabile nedefinite: Referire la variabile care nu există
- Erori de tip: Operații pe tipuri de date greșite
- Depășiri de timp: Codul durează prea mult să se execute
Soluții:
- Utilizați validarea integrată a editorului de cod
- Testați mai întâi logica codului într-o consolă JavaScript
- Adăugați instrucțiuni console.log pentru depanare
- Simplificați operațiunile complexe
Emailul nu se trimite
Simptome: Acțiunea Send Email nu livrează emailuri.
Cauze posibile:
- Niciun cont de email conectat: Verificați Settings → Accounts
- Adresă de email invalidă: Emailul destinatarului are un format incorect
- Limite de trimitere: S-au atins limitele de rată ale furnizorului de email
- Filtre de spam: Emailurile sunt blocate
Soluții:
- Verificați conexiunea contului de email
- Validați adresele de email ale destinatarilor
- Verificați limitele furnizorului de email
- Revizuiți conținutul emailului pentru posibile declanșatoare de spam
Depanarea fluxurilor de lucru
Utilizarea rulărilor fluxurilor de lucru
- Accesați editorul de fluxuri de lucru
- Deschideți panoul Runs
- Găsiți rularea eșuată
- Faceți clic pentru a vedea detalii pas cu pas
- Revizuiți mesajele de eroare și datele de ieșire
Testarea pașilor individuali
- Pentru acțiunile Code, folosiți butonul Test
- Pentru cererile HTTP, testați endpoint-ul separat
- Creați înregistrări de test pentru a declanșa fluxuri de lucru
- Folosiți declanșatoare manuale pentru testare controlată
Tipare comune de depanare
Adăugați jurnalizare:
Folosiți acțiuni Code pentru a înregistra valori intermediare pentru depanare.
Izolați pașii:
Testați fiecare pas independent pentru a identifica eșecurile.
Verificați fluxul de date:
Verificați că fiecare pas primește datele de intrare așteptate.
Cele mai bune practici pentru a evita problemele
Înainte de activare
- Testați temeinic în modul draft
- Validați toate conexiunile API
- Revizuiți cu atenție condițiile declanșatorului
- Documentați comportamentul așteptat
În timpul dezvoltării
- Folosiți nume descriptive pentru pași
- Adăugați comentarii în acțiunile Code
- Testați cu date realiste
- Planificați pentru cazuri limită
După activare
- Monitorizați îndeaproape rulările inițiale
- Configurați alerte pentru eșecuri
- Revizuiți în mod regulat istoricul rulărilor
- Mențineți fluxurile de lucru simple atunci când este posibil
