Skip to content

[[email protected]] Hello, New Teammate! – Build a One-Click Onboarding Greeting in n8n #504

@CodelineAtyab

Description

@CodelineAtyab

📝 User Story

As a Product Owner,
I want my team to build an n8n workflow that automatically creates and posts a friendly welcome message whenever a new employee submits their onboarding form,
so that newcomers feel acknowledged immediately and the team saves time on manual greetings.


✅ Acceptance Criteria

# Criterion Details
1 Environment Setup • Clone the n8n-hosting repository.
• Run docker-compose up.
• n8n launches on localhost with PostgreSQL successfully.
2 Workflow Trigger • Trigger type: HTTP Webhook (or Google Form integration).
• Incoming JSON must contain at minimum:
fullName, role, startDate.
3 Date Formatting • A Function node converts startDate into a human-readable phrase  (e.g., “next Monday”).
4 LLM Personalization • A Claude 3.7/4 node is invoked with the form data.
• Returns a personalized, upbeat welcome message.
• If any field is missing, the LLM supplies a sensible default.
5 Channel Posting • The generated message is posted automatically to a designated Slack (or Microsoft Teams) channel.
• Uses an existing credential stored in n8n.
6 Error Handling • If the Claude call fails:
– Workflow logs the error.
– Sends an email alert to the admin address configured in n8n.
7 Performance • Running the workflow with sample input results in the formatted welcome message appearing in the channel within 30 seconds, with no manual intervention required.

🔧 Technical Notes & Recommendations

  • Security: Store API keys and credentials in n8n’s encrypted credential manager.
  • Testing: Include unit tests for the Function node’s date conversion logic.
  • Monitoring: Consider adding an additional logging node (e.g., DataDog, Loggly) for long-term observability.
  • Scalability: Use environment variables for Slack/Teams channel IDs to support multiple teams.

📂 Sample Payload

{
  "fullName": "Jamie Smith",
  "role": "Frontend Developer",
  "startDate": "2024-09-02"
}

🚀 Expected Output Example

🎉 Hey team, please welcome Jamie Smith, our new Frontend Developer, starting next Monday! We’re thrilled to have you on board and can’t wait to collaborate. 🤗

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions