Workflow Note Task¶
Overview¶
The Workflow Note Task creates or retrieves CRM tasks, activities, and communications in your system. Use it to schedule follow-ups, log activities, assign tasks to team members, and manage your workflow pipeline.
When to use this task:
- Create follow-up tasks automatically
- Schedule callbacks and meetings
- Log phone calls and communications
- Assign tasks to team members
- Set due dates and priorities
- Tag users for notifications
- Track activity history
- Retrieve existing workflow notes
Key Features:
- Create or fetch workflow notes
- Multiple note types (calls, emails, meetings, tasks)
- Intelligent due date scheduling
- Timezone support
- User tagging and notifications
- Priority levels
- Automatic grouping of similar notes
- Sensitive information flagging
- Link to emails and calls
Quick Start¶
Create Workflow Note:
1. Add Workflow Note task
2. Select Action: Create
3. Set note type
4. Enter client ID
5. Set due date option
6. Add note content
7. Save
Fetch Workflow Note:
Configuration¶
Builder fields¶
The Field column is the label as it appears in the task builder; Key is the name the value is stored under and referenced by.
| Field | Key | Type | Default | Notes |
|---|---|---|---|---|
| Action | action |
select | – | Options: Create Note · Fetch Note · Edit Note |
| Workflow Note ID | Workflow Note ID |
text | – | Only shown when action is fetch, edit |
| Message | message |
richtext | – | Only shown when action is edit |
| Priority | priority |
select | __keep__ |
Options: — Leave unchanged — · Low · Medium · High. Only shown when action is edit |
| Direction | direction |
select | __keep__ |
Options: — Leave unchanged — · None · ← Incoming · → Outgoing. Only shown when action is edit |
| Due Date | due_date |
select | __keep__ |
Options: — Leave unchanged — · Now · Tomorrow (8AM) · In Two Days (8AM) · In Three Days (8AM) · In Four Days (8AM) · In Five Days (8AM) · In One Week (8AM) · In One Month (8AM). Only shown when action is edit |
| Sensitive | sensitive |
select | __keep__ |
Options: — Leave unchanged — · No · Yes. Only shown when action is edit |
| Add Tagged Users | add_user_ids |
select | – | Only shown when action is edit |
| Mark above users as | user_tag_done |
select | __keep__ |
Options: — Leave unchanged — · Not Done · Done. Only shown when action is edit |
| Remove Tagged Users | remove_user_ids |
select | – | Only shown when action is edit |
| Client ID | client_id |
text | – | Only shown when action is create |
| Note Type | type |
select | 1 |
Options: Note · Email · Text · Form · WhatsApp · Error · Edit · Payment · Call. Only shown when action is create |
| Email ID | email_id |
text | – | |
| Call ID | call_id |
text | – | |
| Direction | direction |
select | 0 |
Options: None · ← Incoming · → Outgoing |
| Priority | priority |
select | low |
Options: Low · Medium · High |
| Due Date | due_date |
select | today |
Options: Now · Tomorrow (8AM) · In Two Days (8AM) · In Three Days (8AM) · In Four Days (8AM) · In Five Days (8AM) · In One Week (8AM) · In One Month (8AM) |
| Tag Users | user_id_tag |
select | – | |
| Mark Tagged Users Done | user_tag_done |
select | 0 |
Options: Not Done (users must tick to complete) · Done (automatically marked complete) |
| Sensitive | sensitive |
select | no |
Options: No · Yes. Only shown when action is create |
| Message | message |
richtext | – |
Action Selection¶
Create Note:
Action: Create
Type: Call
Client ID: {{task_15001_client_id}}
Due: Tomorrow
Note: Follow up on pricing inquiry
Fetch Note:
Note Types¶
Common types:
- Call - Phone call task
- Email - Email communication
- Meeting - Scheduled meeting
- To-Do - General task
- Follow-up - Follow-up action
- Custom - Any custom type configured in your CRM
Client ID (Required for Create)¶
Must be valid client ID from your CRM.
Due Date Options¶
Predefined options:
Due: today
Due: tomorrow
Due: two_days
Due: three_days
Due: four_days
Due: five_days
Due: one_week
Due: one_month
How scheduling works:
- today - Due at 8:00 AM today (or now if past 8 AM)
- tomorrow - Due at 8:00 AM tomorrow
- two_days - Due at 8:00 AM in 2 days
- one_week - Due at 8:00 AM in 7 days
- one_month - Due at 8:00 AM in 30 days
All times calculated in specified timezone (default: Africa/Johannesburg).
Timezone¶
Default: Africa/Johannesburg
Common timezones:
- America/New_York
- America/Los_Angeles
- America/Chicago
- Europe/London
- Europe/Paris
- Asia/Tokyo
- Australia/Sydney
Note Content¶
Note: Follow up with {{task_15001_full_name}} about pricing.
Budget: ${{task_55001_budget}}
Products interested: {{task_55001_products}}
Best time to call: {{task_55001_preferred_time}}
Multi-line content supported. Use variables for dynamic content.
Direction Flag¶
Optional. Indicates communication direction.
Priority¶
Sets task importance level.
Sensitive Flag¶
Marks note as containing sensitive information. Limited visibility.
User Tagging¶
Comma or semicolon separated. Tagged users get notifications.
Link to Email/Call¶
Links note to specific email or call record.
Output Fields¶
| Field | Description | Example |
|---|---|---|
task_14001_wfn_id |
Workflow note ID | 12345 |
task_14001_client_id |
Linked client ID | 67890 |
task_14001_type |
Note type | Call |
task_14001_due_date |
Due date/time | 2026-02-09 08:00:00 |
task_14001_note |
Note content | Follow up on inquiry |
task_14001_priority |
Priority level | High |
task_14001_created |
Creation timestamp | 2026-02-08 14:30:00 |
task_14001_tagged_users |
Tagged user emails | user@company.com |
Real-World Examples¶
Log an inbound call against the client¶
Call Tracking Trigger
└─ Match to Client contact_cell_number: {{task_51001_caller_number}}
└─ Workflow Note log the call and its duration
Schedule a follow-up¶
Form Submission
└─ Match to Client look the client up
└─ Workflow Note create a follow-up task for the account manager
Record an AI summary¶
Email Trigger
└─ AI Prompt summarise the message
└─ Workflow Note log the summary against the client
Best Practices¶
Due Date Selection¶
- Hot leads - today or tomorrow
- Warm leads - two_days to one_week
- Cold leads - one_week to one_month
- Follow-ups - Based on initial conversation
- Check-ins - Regular intervals (one_week)
User Tagging¶
- Tag responsible person - Primary assignee
- Include manager for high-priority - Oversight
- Tag relevant team members - Collaboration
- Don't over-tag - Only those who need to know
Note Content¶
- Include context - What, why, when
- Add contact info - Phone, email
- Reference source - Form, call, email
- List action items - Clear next steps
- Include relevant data - Budget, timeline, products
Priority Levels¶
- High - Urgent, hot leads, escalations
- Medium - Standard follow-ups, routine tasks
- Low - Nice-to-have, future planning
Troubleshooting¶
Task Not Created¶
Check:
- Valid client ID?
- Valid due date option?
- Valid note type?
- User tags are valid emails?
- Timezone format correct?
Debug: Check workflow logs for errors
Wrong Due Date/Time¶
Issue: Task due at wrong time or timezone
Cause: Timezone mismatch or incorrect calculation
Solution:
- Verify timezone setting
- Check due date option (today vs tomorrow)
- Remember: All times default to 8:00 AM except "today"
User Not Notified¶
Issue: Tagged user didn't receive notification
Causes:
- Invalid email address
- User doesn't exist in system
- Notification settings disabled
Solution: Verify user email is exact match in CRM
Duplicate Tasks Created¶
Issue: Multiple identical tasks for same client
Cause: Workflow runs multiple times or grouping fails
Solution:
- Check workflow trigger conditions
- Review workflow execution logs
- System automatically groups similar notes within 5 minutes
Cannot Fetch Workflow Note¶
Issue: Fetch action returns no data
Causes:
- Invalid workflow note ID
- Note doesn't exist
- Access permissions
Solution: Verify WFN ID exists and accessible
Frequently Asked Questions¶
Can I create past-due tasks?¶
No. "today" creates task due now or 8 AM today (whichever is later). Cannot create overdue tasks.
Can I specify exact time?¶
No. Times are fixed (8:00 AM) based on due date option. Use "today" for immediate tasks.
Can I edit existing workflow notes?¶
No. This task creates or fetches only. Edit manually in CRM.
What happens to grouped notes?¶
System automatically groups similar notes (same client, type, user) created within 5 minutes into single note.
Can I assign to multiple users?¶
Yes, use User Tags field with comma-separated emails. All tagged users get the task.
Does it work across timezones?¶
Yes, specify timezone for accurate due date calculation.
Can I link multiple emails/calls?¶
No, only one email ID and one call ID per note.
How do I create recurring tasks?¶
Use Schedule Trigger with Workflow Note task to create tasks on schedule.
Related Tasks¶
- Match to Client - Get client ID for task creation
- New Client - Create client before creating tasks
- AI Prompt - Generate task content intelligently
- Code Task - Complex task assignment logic
- If Task - Conditional task creation
- Loop - Create multiple tasks in batch
- Email - Send notifications with tasks
- Schedule Trigger - Recurring task generation