Status Transitions
Status transitions automatically move a case from one status to another when conditions are met, eliminating manual status updates and ensuring consistent workflow progression. How status transitions work:- Monitor case data for changes
- Evaluate conditions when relevant data updates
- Automatically update case status when condition is true
- Log the transition in case timeline
- Can trigger additional automations
- Watch: Document upload fields
- Condition: All required documents have values
- Action: Change status to “Ready for Review”
- Watch: Quote approval field
- Condition: Approval equals “approved”
- Action: Change status to “Awaiting Payment”
- Watch: Signature field
- Condition: Signature is defined
- Action: Change status to “Closed - Completed”
Step Visibility Rules
Step visibility rules hide or reveal steps based on case evolution, showing team members only the actions that are relevant to the current case state. How step visibility works:- Steps can be hidden by default
- Conditions determine when steps become visible
- Based on case data, status, or other factors
- Steps appear in the case when conditions are met
- Condition: Review status equals “incomplete”
- Effect: Step appears for case manager to request more documents
- Condition: Annual revenue greater than threshold
- Effect: Step appears to offer premium services
- Condition: Industry in regulated list
- Effect: Step appears for compliance workflow
- Condition: Number of signers greater than 1
- Effect: Multi-signature step appears
Step visibility rules keep case workflows clean by showing only relevant actions, reducing confusion and ensuring team members focus on what matters.
Automatic Step Execution
Automatic step execution triggers a step when specific conditions are met, enabling fully automated workflows that respond to case data changes. How automatic execution works:- Monitor case data for changes
- Evaluate conditions when data updates
- Automatically execute the step (send email, SMS, form) when condition is true
- Step appears in timeline as executed
- Contact receives communication automatically
- Watch: Form sent date, form response status
- Condition: 3 days elapsed and no response received
- Action: Execute “Reminder Email” step
- Watch: Document fields
- Condition: All required documents uploaded
- Action: Execute “Send Approval Form” step
- Watch: Case status
- Condition: Status equals “Active”
- Action: Execute “Welcome Email” step
- Watch: Risk assessment field
- Condition: Risk level equals “high”
- Action: Execute “Compliance Review Form” step
Post-Automations
Post-automations send data to external systems via API or n8n when conditions are met, enabling seamless integration between Penbox and back-office systems. How post-automations work:- Monitor case data for changes
- Evaluate conditions when data updates
- Send HTTP request to external system when condition is true
- Log request and response in timeline
- Can retry on failure
- Watch: Case status
- Condition: Status equals “Closed”
- Action: POST to CRM API with case data
- Payload: Case ID, customer data, outcome
- Watch: Signature field
- Condition: Signature defined
- Action: POST to n8n webhook
- Payload: Signed document, case details
- Watch: Invoice approval field
- Condition: Approval equals “approved”
- Action: POST to accounting API
- Payload: Invoice details, amounts, dates
- Watch: Case status
- Condition: Status equals “Closed”
- Action: POST documents to DMS
- Payload: All case documents and metadata
AI-Specific Automations
Penbox Intelligence enables AI-powered automations for email drafting and data extraction.Email Drafting Prompts
Configure an email drafting prompt so Intelligence prepares draft responses to incoming emails automatically. How it works:- Define a prompt that tells Intelligence how to draft responses
- When emails arrive, Intelligence analyzes the content
- Draft response is prepared based on your prompt
- Draft appears in case timeline for review before sending
- Be specific about tone and style
- Define what information should be included
- Specify any compliance requirements
- Mention if certain phrases should be avoided
Automation Execution
When automations run:- Automations evaluate whenever case data changes
- Watched fields (if specified) trigger evaluation when they change
- Conditions are evaluated against current case data
- Actions execute when condition evaluates to true
- All automation executions appear in case timeline
- Shows automation name, timestamp, and outcome
- Success or failure status displayed
- Full execution details available on click
- Can retry failed automations
- Watch specific fields to reduce unnecessary evaluations
- Use execute_once for one-time transitions
- Test conditions before deploying to production
Common Patterns
Sequential Workflow
Combine status transitions and step execution to create sequential workflows:- Form completed → Status: “Under Review”
- Status “Under Review” → Execute “Request Documents” step
- Documents uploaded → Status: “Ready for Approval”
- Status “Ready for Approval” → Execute “Send Approval Form” step
- Approval received → Status: “Closed - Approved”
Conditional Branching
Use step visibility and execution for different paths: If customer type is “Enterprise”:- Show “Enterprise Onboarding” steps
- Execute “Assign Account Manager” step
- Send to enterprise CRM endpoint
- Show “Standard Onboarding” steps
- Execute “Send Welcome Email” step
- Send to standard CRM endpoint
Integration Workflow
Combine multiple automation types for complete integration:- Data collected → Post to validation API
- Validation passes → Status: “Validated”
- Status “Validated” → Execute “Send Contract” step
- Contract signed → Post to accounting system
- Accounting updated → Status: “Closed - Complete”
Next Steps
Case Templates
Configure automations in templates
Statuses & Lifecycle
Understand status transitions
Steps
Learn about automatic step execution
Data Schema
Define data for automation conditions