ChatNode Integration

What it does: Connect to ChatNode AI chatbots to leverage their document-based knowledge and conversational capabilities within your workflows.

When to Use This

Use ChatNode when you need:

• ✅ AI trained on your specific documents and knowledge base
• ✅ Persistent conversation threads with memory
• ✅ Pre-built, managed AI chatbots
• ✅ Document-based question answering
• ✅ Integration with existing ChatNode bots

Example: Train a ChatNode bot on your product documentation, then use it in your workflow to answer customer questions accurately based on your docs.

Key Features

• Document-Based Training: Upload docs, ChatNode handles the AI
• Thread Management: Maintain conversation context across messages
• Pre-Configured Bots: Use ChatNode's interface to setup your bot
• No Model Management: ChatNode handles the AI infrastructure
• Conversation Memory: Keep track of multi-turn conversations

Setup Guide

Step 1: Create a ChatNode Bot

On ChatNode Platform:

1. Go to chatnode.ai (opens in a new tab) and sign up
2. Create a new chatbot
3. Upload your documents:
   • PDFs
   • Text files
   • Website URLs
   • Knowledge base articles
4. Configure your bot's behavior and responses
5. Get your Bot ID from the bot's URL:
   • URL format: https://chatnode.ai/chatbots/68c052c5c3680f63
   • Bot ID: 68c052c5c3680f63 (last part of URL)

Step 2: Get API Key

1. In ChatNode dashboard, go to API section
2. Generate an API key
3. Copy and save it securely

Step 3: Configure the Block

Connection Settings:

1. Credentials: Select your ChatNode credentials or create new ones

   • API Key: Your ChatNode API key
   • Stored securely

2. Bot ID: Enter your chatbot ID

   • Found at the end of your ChatBot URL in dashboard
   • Example: 68c052c5c3680f63
   • This identifies which bot to query

3. Thread ID (Optional): For conversation continuity

   • Leave empty for new conversations
   • Provide a thread ID to continue existing conversation
   • Use variable like {{conversation_id}} to maintain context

4. Message: The question or message to send

   • Can be direct text: What are your business hours?
   • Use variables: {{user_question}}
   • Reference context: Based on {{previous_answer}}, {{follow_up_question}}

5. Save Response: Map response data to variables

   • Message: The AI's response text
   • Thread ID: The conversation thread ID (save for follow-ups)

How It Works

Single Message

1. User asks: "What's your return policy?"
2. ChatNode AI searches trained documents
3. Returns answer based on your documents
4. Response saved to {{ai_response}}

Multi-Turn Conversation

1. User: "What's your return policy?"
   → Thread ID: abc123, Response: "You have 30 days..."
   → Save Thread ID to {{conversation_id}}

2. User: "What about electronics?"
   → Use Thread ID: {{conversation_id}} (abc123)
   → Response: "Electronics have a 14-day return policy..."

3. User: "Do I need a receipt?"
   → Use Thread ID: {{conversation_id}} (abc123)
   → Response: "Yes, based on our earlier discussion about returns..."

Common Use Cases

Knowledge Base Assistant

Answer questions from your documentation:

ChatNode Setup:

• Upload all product documentation
• Add FAQs and help articles
• Configure bot personality

Workflow Configuration:

• Bot ID: Your docs bot ID
• Message: {{customer_question}}
• Thread ID: Empty (single question)
• Save Response:
  • Message → {{answer}}

Example:

• User: "How do I reset my password?"
• ChatNode searches your docs
• Returns: Step-by-step password reset instructions

Conversational Support

Multi-turn customer support:

Workflow Configuration:

• Bot ID: Your support bot ID
• Message: {{user_message}}
• Thread ID: {{session_id}} (maintains context)
• Save Response:
  • Message → {{support_response}}
  • Thread ID → {{session_id}}

Example Conversation:

User: "I can't log in"
Bot: "I can help with that. What error message do you see?"

User: "It says invalid password"
Bot: *Remembers context*
    "Let's reset your password. Click the 'Forgot Password' link..."

User: "Where is that link?"
Bot: *Still has context*
    "On the login page, below the password field..."

Product Information

Help customers find product details:

ChatNode Setup:

• Upload product catalogs
• Include specifications, pricing, availability
• Add comparison guides

Workflow Configuration:

• Bot ID: Product catalog bot
• Message: {{product_query}}
• Thread ID: Empty
• Save Response:
  • Message → {{product_info}}

Examples:

• "Tell me about the ProX200 laptop"
• "Compare the basic and premium plans"
• "What colors does the SX100 come in?"

Training & Onboarding

Help new employees or users learn:

ChatNode Setup:

• Upload training materials
• Add company policies
• Include best practices guides

Workflow Configuration:

• Bot ID: Training bot
• Message: {{question}}
• Thread ID: {{employee_id}} (track by employee)
• Save Response:
  • Message → {{training_response}}
  • Thread ID → {{employee_id}}

Internal Q&A

Company knowledge base for employees:

ChatNode Setup:

• Upload internal docs
• Add HR policies
• Include technical documentation

Workflow Configuration:

• Bot ID: Internal knowledge bot
• Message: {{employee_question}}
• Thread ID: Optional
• Save Response:
  • Message → {{answer}}

Thread Management

When to Use Thread IDs

Use Thread ID when:

• Multi-turn conversations are needed
• Context must be maintained
• Follow-up questions expected
• Clarifications required

Skip Thread ID when:

• Single, independent questions
• No conversation context needed
• Each query is self-contained
• Different topics each time

Thread ID Patterns

User Session:

Thread ID: {{user_id}}_{{timestamp}}
Result: Each user has their own conversation

Topic-Based:

Thread ID: {{ticket_id}}
Result: All questions about ticket stay in one thread

Temporary Session:

Thread ID: {{session_id}}
Result: Conversation lasts for current session only

Persistent User:

Thread ID: {{user_id}}
Result: Ongoing conversation across all interactions

Best Practices for Threads

1. Save Thread IDs - Always save the returned Thread ID if you need context
2. Clear When Done - Start new threads for new topics
3. User-Specific - Use unique thread IDs per user
4. Expire Old Threads - Clear old threads after inactivity
5. Document Strategy - Note what each thread ID represents

Configuration Examples

Simple Q&A

Bot ID: 68c052c5c3680f63
Thread ID: (empty)
Message: {{user_question}}
Save Response:
  - Message → {{answer}}

Conversation with Memory

Bot ID: 68c052c5c3680f63
Thread ID: {{conv_thread}}
Message: {{user_input}}
Save Response:
  - Message → {{ai_reply}}
  - Thread ID → {{conv_thread}}

Contextual Follow-up

Bot ID: 68c052c5c3680f63
Thread ID: {{saved_thread}}
Message: More details about {{previous_topic}}
Save Response:
  - Message → {{detailed_answer}}

What You Get Back

Response includes:

• Message: The AI's answer based on your documents

  • Formatted text response
  • Based on trained knowledge
  • Contextually aware

• Thread ID: Conversation identifier

  • Use for follow-up questions
  • Maintains conversation context
  • String format (e.g., "abc123xyz")

Tips for Success

1. Train Your Bot Well - Upload comprehensive, relevant documents
2. Test Questions - Verify bot answers correctly in ChatNode first
3. Use Thread IDs Smart - Only when context matters
4. Clear Instructions - Ask clear, specific questions
5. Handle Empty Responses - Plan for when bot doesn't know
6. Update Documents - Keep ChatNode knowledge current
7. Monitor Quality - Review bot responses regularly
8. Provide Context - Include relevant info in messages

Troubleshooting

Best Practices

• Document Quality - Upload well-structured, clear documents
• Regular Updates - Keep training data current
• Test Thoroughly - Verify answers before deploying
• Use Variables - Dynamic messages adapt to context
• Error Handling - Handle cases where bot doesn't know answer
• User Experience - Provide fallbacks for unclear responses
• Monitor Performance - Track response quality and relevance
• Feedback Loop - Improve bot based on user interactions

ChatNode vs Building Your Own

Use ChatNode when:

• ✅ You want managed AI infrastructure
• ✅ You have documents to train on
• ✅ You need quick setup
• ✅ You want UI for bot management

Build Custom when:

• ❌ You need specific model control
• ❌ You want custom vector databases
• ❌ You need specialized embeddings
• ❌ You want full infrastructure control

Pricing

ChatNode pricing:

• Based on message volume
• Different tiers for features
• Free tier available for testing

Check chatnode.ai/pricing (opens in a new tab) for current rates.