# 🛠️ Custom Tools
Source: https://docs.neuraltalk.ai/addons/custom-tools
Complete guide to create and manage custom API tools for your chatbot
🎥 Refer to the setup video for a step-by-step visual guide:
## Overview
The **Custom Tools** feature allows you to create and manage API-based tools that extend your chatbot's functionality. With custom tools, your chatbot can interact with external services, fetch data from APIs, and perform advanced operations beyond built-in capabilities.
This guide explains how to create a custom tool, manage existing tools, and choose the right creation method for your use case.
## Accessing Custom Tools
* Log in to your NeuralTalk AI dashboard
* Select the chatbot you want to connect
* Navigate to **Addons and Design** from the main menu
* Click on **Custom Tools**
* The Custom Tools page displays all configured tools
* You can see the total number of tools and manage existing ones
* If no tools are configured, the page will prompt you to create your first tool
![Custom Tools Dashboard]()
## Creating a New Custom Tool
Click **Create New API Tool** to start adding a custom tool. You can choose from three creation methods:
* **Manual Filling**\
Fill out a form step by step with all API details including endpoint, parameters, headers, and authentication.
* **cURL Parser**\
Paste your cURL command, and the system automatically extracts all API configuration details for you.
* **AI Generation (Beta)**\
Describe your API in natural language, and AI will generate the tool configuration automatically.
For each method, guidance and examples are provided to make tool creation fast and accurate.
### Managing Tools
Once a tool is created:
* A **Edit** button becomes available for editing and configuring the tool
* Tools can be **disabled** or **deleted** at any time without affecting other tools
* You can test your tool directly from the dashboard to ensure correct functionality
## Best Practices
* Start by creating a single tool and testing it thoroughly
* Use AI Generation or cURL Parser for faster setup when available
* Keep your API keys and credentials secure
* Provide clear naming and descriptions for each tool to avoid confusion
# 🎨 Design
Source: https://docs.neuraltalk.ai/addons/design
Complete guide to Customize your chatbot's appearance and layout
🎥 Refer to the setup video for a step-by-step visual guide:
## Overview
The **Design Settings** feature allows you to fully customize the appearance and layout of your chatbot. Adjust colors, typography, chat window size, header design, input fields, and widget positioning to match your brand identity and provide an optimal user experience.
All changes are reflected instantly in the preview. Click **Save Changes** in the header to save your configuration.
## Accessing Design Settings
* Log in to your NeuralTalk AI dashboard
* Select the chatbot you want to connect
* Navigate to **Addons and Design** from the main menu
* Click on **Design**
* Adjust settings and see live changes in the chat widget preview
* Once satisfied, click **Save Changes** to apply them
![Design Settings Dashboard]()
## Layout & Position
* **Chat Window Position**: Choose where the chat appears on the page (e.g., Bottom Right)
* **Window Size**: Small, Medium, or Large
* **Border Radius**: Adjust the roundness of the chat window corners
## Header Design
* **Header Background Color**: Customize header background
* **Header Text Color**: Choose header text color
* **Show Avatar**: Enable or disable the chatbot avatar in the header
## Chat Bubbles
* **User Message Color**: Customize the color of user messages
* **Bot Message Color**: Customize the color of bot messages
* **Enable Bubble Message**: Show messages inside chat bubbles for better readability
## Typography
* **Font Family**: Choose your preferred font (e.g., Inter)
* **Font Size**: Set font size for messages and headers
## Input Field
* **Background Color**
* **Text Color**
* **Border Color**
* **Placeholder Text**: Customize placeholder message
* **Send Button**:
* Button Color
* Hover Color
* Disabled Color
## Widget Configuration
* **Widget Size**: Small, Medium, or Large
* **Button Size**: Normal, Small, or Large
* **Desktop & Mobile Offsets**: Adjust spacing from page edges
* **Movable Widget**: Allow users to drag the widget
* **Initially Open**: Open chat widget by default
* **Widget Logo**: Show or hide branding
### Bubble Preview & Greetings
* **Preview Toast**: Show a toast near the chat bubble after page load (per session)
* **Greeting Message**: Display a custom greeting (max 100 characters)
## Branding
* Free plan users always show **Powered by NeuralTalk**
* Paid plans can choose to hide branding
## Best Practices
* Use brand colors and fonts consistently for better UX
* Preview changes in multiple screen sizes (desktop & mobile)
* Keep greeting messages concise for maximum impact
* Enable bubble messages for improved readability
* Save changes regularly to avoid losing configuration
# 🔌 Integrations
Source: https://docs.neuraltalk.ai/addons/integrations
Complete guide to connect platforms and enable tools to extend your chatbot capabilities
🎥 Refer to the setup video for a step-by-step visual guide:
## Overview
The **Integrations & Tools** feature allows you to enhance your chatbot by connecting it with external platforms, messaging channels, business tools, and AI-powered services. These integrations help automate workflows, improve customer communication, and extend your chatbot’s reach across multiple platforms.
This guide explains the available integrations, how they work, how to manage connected integrations, and where to find detailed setup documentation.
## Accessing Integrations
* Log in to your NeuralTalk AI dashboard
* Select the chatbot you want to connect
* Navigate to **Addons and Design** from the main menu
* Click on **Integrations**
* The Integrations page displays all supported platform integrations and AI tools
* Each integration shows its current connection status
![Integrations Dashboard]()
## Platform Integrations
Platform integrations allow your chatbot to communicate with users and systems outside the dashboard.
The following platform integrations are available:
* **WhatsApp**
* **Slack**
* **Discord**
* **Telegram**
* **Calendly**
* **HubSpot**
* **Zendesk**
Each integration can be connected independently based on your business needs.
### Managing Integrations
Once an integration is connected:
* A **Settings** button becomes available to configure integration-specific options
* You can **disconnect** the integration at any time
* Disconnecting an integration does not affect your chatbot’s core configuration
📘 Detailed documentation for **each integration**, including prerequisites, setup steps, configuration options, and usage examples, is already available.\
Please refer to the **Integration Guides** section for complete information on how to connect and manage each integration.
## AI Tools
AI tools enhance your chatbot’s intelligence by enabling real-time data access and dynamic responses.
The available AI tools include:
* **Web Search**
* **Weather Search**
AI tools can be enabled or disabled individually depending on your chatbot’s requirements.
### How AI Tools Help
AI tools allow your chatbot to:
* Fetch real-time information
* Provide more accurate and up-to-date responses
* Improve overall conversation quality and user satisfaction
## Best Practices
* Enable only the integrations required for your use case
* Review integration settings after connecting to ensure correct behavior
* Disconnect unused integrations to keep configurations clean
* Refer to integration guides before enabling production messaging or CRM sync
# 🔌 Plugin & Deploy
Source: https://docs.neuraltalk.ai/addons/plugin-&-deploy
Complete guide to Install your chatbot as a widget popup, iframe embed, or integrate with popular platforms.
🎥 Refer to the setup video for a step-by-step visual guide:
## Overview
The **Plugin & Design** feature allows you to install and customize your chatbot on your website or platform. You can integrate it as a popup widget, iframe, or use platform-specific instructions for Webflow, Wix, Framer, WordPress, and Shopify. This guide explains installation, embedding, and design best practices.
## Accessing Plugin & Design settings
* Log in to your NeuralTalk AI dashboard
* Select the chatbot you want to connect
* Navigate to **Addons and Design** from the main menu
* Click on **Plugin & Design**
* Select between **Popup Widget** or **Iframe Embed**
* Follow platform-specific instructions if needed
![plugin and deploy Dashboard]()
## Install Chatbot
* Copy the following code snippet
* Paste it inside your website's `` section
```html theme={null}
```
* Open your website in a browser
* The chatbot popup should appear and be interactive
## Platform Integrations
The following platform integrations are available:
* **Webflow**
* **Wix**
* **Framer**
* **WordPress**
* **Shopify**
* **HubSpot**
* **Zendesk**
Each integration can be connected independently based on your business needs.
## Best Practices
* Ensure the chatbot is visible but non-intrusive
* Test on desktop and mobile for responsiveness
* Match chatbot theme and colors to your website design
* Follow platform-specific steps for optimal integration
# Changelog
Source: https://docs.neuraltalk.ai/changelog
Product updates, new features, and announcements for NeuralTalk
Stay up to date with the latest NeuralTalk updates, new features, bug fixes, and improvements. Subscribe to our RSS feed to never miss an update.
### 🚀 New Features
* **Advanced AI Model Selection**: Choose from multiple AI models (GPT-4, Claude, Gemini) for different use cases
* **Custom Knowledge Base**: Upload and manage your own documents, PDFs, and data sources
* **Real-time Analytics Dashboard**: Track conversation metrics, user engagement, and performance insights
* **Multi-language Support**: Deploy assistants in 25+ languages with automatic translation
### 🔗 New Integrations
* **Zapier Integration**: Connect NeuralTalk with 5000+ apps through Zapier workflows
* **Custom API Endpoints**: Build custom integrations with our RESTful API
* **Webhook Support**: Receive real-time notifications for conversation events
### 🎨 Enhancements
* **Improved Chat Interface**: Redesigned chat widget with better mobile responsiveness
* **Enhanced Training**: Smarter context understanding and more accurate responses
* **Performance Optimizations**: 40% faster response times and reduced latency
### 🐛 Bug Fixes
* Fixed issue where chat widget would not load on some mobile devices
* Resolved timeout errors during long conversations
* Fixed knowledge base synchronization issues
### 🚀 New Features
* **Slack Integration**: Deploy AI assistants directly in your Slack workspace
* **Discord Bot**: Create Discord bots for your community servers
* **WhatsApp Business API**: Connect with customers through WhatsApp messaging
* **Telegram Bot**: Deploy assistants on Telegram for global reach
### 🎨 Enhancements
* **Improved Assistant Training**: Better context understanding and more natural responses
* **Enhanced Dashboard**: New analytics and conversation management tools
* **Mobile Optimization**: Improved mobile experience for both users and administrators
### 🔧 Technical Improvements
* **API Rate Limiting**: Implemented intelligent rate limiting to prevent abuse
* **Database Optimization**: Improved query performance and reduced response times
* **Security Enhancements**: Added additional security measures for data protection
### 🎉 Initial Release
* **AI Assistant Creation**: Build and customize AI assistants with our intuitive interface
* **Website Integration**: Easy-to-install chat widget for websites
* **Knowledge Base Management**: Upload and manage training data for your assistants
* **Basic Analytics**: Track conversations and user interactions
### 🔗 Core Integrations
* **Calendly Integration**: Schedule meetings directly through chat
* **HubSpot CRM**: Sync leads and customer data automatically
* **Facebook Messenger**: Deploy assistants on Facebook pages
### 🛠️ Platform Features
* **User-friendly Dashboard**: Intuitive interface for managing assistants
* **Custom Styling**: Brand your chat widget to match your website
* **Human Handover**: Seamless transition to human agents when needed
* **Lead Collection**: Capture and manage leads through conversations
### 🧪 Beta Release
* **Core AI Functionality**: Basic AI assistant creation and deployment
* **Website Widget**: Initial chat widget implementation
* **Documentation Site**: Comprehensive guides and API documentation
* **User Testing**: Limited beta access for early adopters
### 🔧 Development Features
* **API Development**: RESTful API for custom integrations
* **Testing Framework**: Comprehensive testing for all features
* **Performance Monitoring**: Real-time monitoring and analytics
### 🏗️ Infrastructure Setup
* **Cloud Infrastructure**: Scalable cloud infrastructure on AWS
* **Database Setup**: Secure and reliable data storage
* **Security Implementation**: End-to-end encryption and data protection
* **Monitoring Systems**: Comprehensive logging and error tracking
### 🔒 Security & Compliance
* **GDPR Compliance**: Full compliance with European data protection regulations
* **SOC 2 Type II**: Security and compliance certification
* **Data Encryption**: All data encrypted in transit and at rest
***
## 📬 Stay Updated
Subscribe to our changelog RSS feed to get notified about new updates: `/changelog/rss.xml`
## 🏷️ Update Categories
* **🚀 Feature**: New functionality and capabilities
* **🔗 Integration**: New third-party service connections
* **🎨 Enhancement**: Improvements to existing features
* **🐛 Bug Fix**: Issues resolved and fixes applied
* **🔧 Technical**: Infrastructure and technical improvements
* **🔒 Security**: Security updates and compliance
* **📚 Documentation**: Updates to guides and documentation
* **🧪 Beta**: Beta features and experimental functionality
## 📞 Feedback
Have feedback on our updates? We'd love to hear from you! Contact us at [support@neuraltalk.ai](mailto:support@neuraltalk.ai) or join our [Discord community](https://discord.com/invite/tHpggadDAk) for quick resolution and community support.
# 🛠️ Corrections
Source: https://docs.neuraltalk.ai/data-source/corrections
Complete guide to review, create, and manage chatbot response corrections
🎥 Refer to the setup video for a step-by-step visual guide:
## Overview
The **Corrections** feature allows you to review, fix, and improve chatbot responses. It ensures your chatbot gives accurate, friendly, and high-quality answers by letting you approve, reject, or refine responses raised during conversations.
This guide explains correction statuses, actions, and how to create and manage corrections.
## Accessing Corrections
* Log in to your dashboard
* Navigate to **Data Source** from the main menu
* Click on **Corrections** in the left sidebar
* Switch between **Pending**, **Corrected**, and **Rejected** tabs
* See total pages and results per page
![Corrections Dashboard]()
## Corrections Dashboard
The Corrections page is divided into multiple tabs for better management.
### Correction Tabs
* **Pending**: Corrections awaiting review
* **Corrected**: Approved and applied corrections
* **Rejected**: Corrections that were dismissed
## Actions Menu
The **Actions** dropdown provides bulk and management options.
* **Create Correction**: Manually add a correction to improve chatbot answers.
* **Export Approved Corrections**: Download all corrected entries.
* **Export Pending Corrections**: Export pending corrections for review.
* **Mark Selected as Corrected**: Approve the selected corrections.
* **Mark Selected as Rejected**: Reject the selected corrections.
* **Import Corrections**: Upload multiple corrections in bulk.
* **Download Template**: Download a template for bulk correction import.
## Creating a Correction
Click **Create Correction** to manually add or fix a chatbot response.
### Correction Form Fields
* **Question**: Enter the user question that needs correction.
* **Original Chatbot Answer**: Displays the response originally given by the chatbot.
* **Model Answer**: Write the correct answer to the question raised.
### Answer Enhancement Options
* **More Friendly & Detailed**: Improves tone and clarity
* **Enhance with AI**: Automatically refines your answer
### Optional Fields
* **Source URL**: Add a reference link
* **Image URL**: Attach an image
* **Extra Info**: Additional instructions like tone or style
* **Tags**: Add tags for easy filtering
## Best Practices
* Review pending corrections regularly
* Use friendly, clear, and accurate model answers
* Add sources for credibility
* Tag corrections for easier management
* Export data for audits or training purposes
# 📚 Knowledge Sources
Source: https://docs.neuraltalk.ai/data-source/knowledge-sources
Complete guide to manage and configure knowledge sources for your chatbot
🎥 Refer to the setup video for a step-by-step visual guide:
## Overview
The **Knowledge Sources** feature allows you to connect external content to your chatbot so it can deliver accurate, contextual, and up-to-date responses. You can add URLs, documents, images, and third-party integrations as sources of knowledge.
This guide explains how to add sources, configure recrawling, and manage indexed URLs.
## Accessing Knowledge Sources
* Log in to your dashboard
* Navigate to **Data Source** from the main menu
* Click on **Knowledge** in the left sidebar
* The Knowledge page loads with Webpage sources that have been crawled and indexed for your chatbot
* If no sources are added, you’ll see **No data sources found for this chatbot**
![Knowledge Dashboard]()
## Adding a Knowledge Source
Click **Add Source** to begin adding content to your chatbot.
Add public webpages to train your chatbot using live website content.
Upload PDFs, text documents, or images as knowledge sources.
Connect files directly from your Google Drive.
Sync selected Notion pages as structured knowledge.
## URL Configuration
When adding a URL source, you must configure how content is crawled.
* **URL**: Required
* **Scope Options**: This page only, Entire site, Subdirectory only, Sitemap
### Auto-Recrawl Settings
* Keeps your sources up to date
* Sources are refreshed on a regular schedule
Ensures your chatbot always responds using the latest content from your website.
Once added, your URLs are crawled and indexed for the chatbot.
In the **Actions** column, you have the following options:
* **Edit**: Open **Edit URL Settings** to manage source behavior.
* **Auto-Recrawl**: Enable automatic recrawling of this source on a schedule.
* **Cancel**: Discard changes.
* **Save**: Apply the updated settings.
* **Recrawl**: Re-index the URL to fetch the latest content.
* **Delete**: Remove the URL and all associated data from the chatbot.
## Best Practices
* Add high-quality, relevant sources for better answers
* Enable auto-recrawl for frequently updated websites
* Remove outdated or low-value sources
* Monitor total character usage regularly
# 🎯 Getting Started
Source: https://docs.neuraltalk.ai/getting-started
Complete guide to setting up your first AI assistant with NeuralTalk
🎥 Refer to the setup video for a step-by-step visual guide:
## Prerequisites
Before you begin, make sure you have:
* A NeuralTalk account ([Sign up here](https://neuraltalk.ai))
* Your business information and content ready for training
* A website or platform where you want to deploy your assistant
## Step 1: Create Your Account
1. Visit [neuraltalk.ai](https://neuraltalk.ai)
2. Click "Sign Up" and create your account
3. Verify your email address
4. Complete your profile setup
![NeuralTalk Dashboard - Account Creation]()
You can start with our free plan, which includes **1,000 conversations** per month and basic features.
It also comes with **1M training characters**.
## Step 2: Create Your First Assistant
1. **Navigate to the Dashboard**
* Once logged in, you'll see the main dashboard
* Click "Create New Assistant" to begin
![Create Assistant - Basic Details]()
2. **Basic Information**
* **Assistant Name**: Choose a name that represents your business (e.g., "Acme Support Bot")
* **Description**: Briefly describe what your assistant will help with
* **Language**: Select the primary language for your assistant
![Language Selection]()
3. **Personality & Behavior**
* **Tone**: Choose between Professional, Friendly, or Casual
* **Response Style**: Select how detailed you want responses to be
* **Greeting Message**: Customize the first message users will see
![Greeting Message Configuration]()
Keep your assistant's personality consistent with your brand voice. This helps create a cohesive customer experience.
## Step 3: Train Your Assistant
Training is crucial for creating an effective AI assistant. Here's how to do it:
![Knowledge Base Training Interface]()
### Upload Your Knowledge Base
1. **Navigate to Training**
* Go to the "Knowledge Base" section in your assistant settings
* Click "Add Content" to upload your documents
![Add Content to Knowledge Base]()
2. **Supported File Types**
* PDF documents
* Word documents (.docx)
* Text files (.txt)
* CSV files
* Web pages (via URL)
3. **Manual Content Entry**
* Add frequently asked questions
* Include product information
* Add company policies and procedures
* Include contact information and hours
### Content Best Practices
Structure your content logically with clear headings and sections. This helps the AI understand context better.
Provide specific examples of questions and answers. This helps the AI learn your preferred response style.
Regularly update your knowledge base with new information, product updates, and policy changes.
Review conversations and add content based on questions your assistant couldn't answer well.
## Step 4: Customize Appearance
Make your assistant match your brand:
1. **Visual Styling**
* Choose colors that match your brand
* Upload your logo
* Select a chat widget style
2. **Conversation Settings**
* Set response length preferences
* Configure fallback messages
* Set up human handover triggers
3. **Advanced Features**
* Enable typing indicators
* Add suggested responses
* Configure conversation starters
## Step 5: Deploy Your Assistant
![Deploy Assistant - Integration Options]()
### Website Integration
1. **Get Your Code**
* Go to the "Deploy" section
* Copy the provided JavaScript code snippet
2. **Add to Your Website**
* Paste the code before the closing `` tag
* Save and publish your website
3. **Test the Integration**
* Visit your website
* Look for the chat widget
* Test a conversation
### Other Platforms
Connect to WhatsApp Business API for customer support
Deploy in your Slack workspace for team support
Add to your Discord server for community support
Build custom integrations with our API
## Step 6: Monitor and Optimize
![Analytics Dashboard - Monitor Conversations]()
### Review Conversations
1. **Check the Analytics Dashboard**
* View conversation metrics
* Identify common questions
* Monitor user satisfaction
2. **Improve Responses**
* Add content for unanswered questions
* Refine existing answers
* Update outdated information
3. **Test Regularly**
* Try different question phrasings
* Test edge cases
* Verify accuracy of responses
## Next Steps
Congratulations! You've successfully created your first AI assistant. Here's what to do next:
Learn about advanced features like tools and workflows
Customize your assistant's appearance and behavior
Connect to more platforms and services
Build custom integrations with our API
## Need Help?
If you run into any issues or have questions:
* **Documentation**: Browse our comprehensive guides
* **Support**: Contact us at [support@neuraltalk.ai](mailto:support@neuraltalk.ai)
* **Community**: Join our [Discord community](https://discord.gg/tHpggadDAk)
* **Video Tutorials**: Check out our [tutorial videos](https://youtu.be/uClV5GfzDEY?si=Fpw6nHyYTmddyFqk)
**Pro Tip**: Start simple and gradually add more features as you become comfortable with the platform. You can always enhance your assistant later!
# AI Assistant Technical FAQ
Source: https://docs.neuraltalk.ai/help/ai-assistant-faq
Frequently asked questions about AI assistant functionality and technical issues
## General Questions
### How does the AI assistant work?
Our AI assistant uses advanced language models trained on your specific knowledge base to provide accurate, contextual responses to user questions.
### What languages are supported?
Currently, we support English, Spanish, French, German, Italian, Portuguese, and more. Additional languages can be added upon request.
### How accurate are the responses?
Response accuracy depends on the quality and completeness of your knowledge base. We typically see 85-95% accuracy with well-trained assistants.
## Technical Issues
### Why isn't my assistant responding?
* Check your API key configuration
* Verify your assistant is active and published
* Ensure your knowledge base is properly trained
* Check for any error messages in the dashboard
### How do I improve response quality?
* Add more comprehensive content to your knowledge base
* Review and update existing content regularly
* Test with different question phrasings
* Use the feedback system to identify issues
### Can I customize the AI model?
Yes, you can adjust various parameters including response length, tone, and behavior through the assistant settings.
## Next Steps
* [Billing & Subscription FAQ](/help/billing-faq)
* [Troubleshooting Guide](/help/troubleshooting)
* [Support Resources](/help/support-resources)
# Billing & Subscription FAQ
Source: https://docs.neuraltalk.ai/help/billing-faq
Frequently asked questions about billing, subscriptions, pricing, and payment for NeuralTalk AI services.
# Billing & Subscription FAQ
Frequently asked questions about billing, subscriptions, pricing, and payment for NeuralTalk AI services.
## General Billing Questions
### How does NeuralTalk AI pricing work?
NeuralTalk AI uses a tiered pricing model based on your usage and needs:
* **Free Plan**: 100 conversations per month, basic features
* **Pro Plan**: 1,000 conversations per month, advanced features
* **Enterprise Plan**: Unlimited conversations, premium features
Pricing is based on the number of conversations your AI assistant handles each month. A conversation is counted when a user starts chatting with your assistant, regardless of how many messages are exchanged.
### What counts as a conversation?
A conversation is counted when:
* A user starts a new chat session with your AI assistant
* The conversation is active (user sends at least one message)
* The conversation ends (user closes chat or session times out)
Multiple messages within the same conversation count as one conversation.
### How is billing calculated?
Billing is calculated monthly based on:
* **Conversation Volume**: Number of conversations in the billing period
* **Plan Features**: Features included in your selected plan
* **Overage Charges**: Additional charges for usage above plan limits
* **Add-ons**: Any additional services or integrations
### When will I be charged?
* **New Customers**: Charged immediately upon subscription
* **Existing Customers**: Charged on your monthly anniversary date
* **Upgrades**: Prorated charges for plan upgrades
* **Downgrades**: Effective at next billing cycle
## Payment Methods
### What payment methods do you accept?
We accept:
* **Credit Cards**: Visa, Mastercard, American Express, Discover
* **Debit Cards**: All major debit card networks
* **PayPal**: PayPal account payments
* **Bank Transfer**: Wire transfers for Enterprise plans
* **Cryptocurrency**: Bitcoin, Ethereum (Enterprise plans only)
### Is my payment information secure?
Yes, we use industry-standard security measures:
* **PCI DSS Compliance**: Certified payment card industry standards
* **Encryption**: All payment data encrypted in transit and at rest
* **Tokenization**: Payment details tokenized for security
* **No Storage**: We don't store your full payment details
### Can I change my payment method?
Yes, you can update your payment method anytime:
1. Go to your account settings
2. Navigate to "Billing & Payment"
3. Click "Update Payment Method"
4. Enter your new payment details
5. Save changes
## Subscription Management
### How do I upgrade my plan?
To upgrade your plan:
1. Go to your account dashboard
2. Click "Upgrade Plan" or "Billing"
3. Select your desired plan
4. Confirm the upgrade
5. You'll be charged the prorated amount immediately
### How do I downgrade my plan?
To downgrade your plan:
1. Go to your account settings
2. Navigate to "Billing & Payment"
3. Click "Change Plan"
4. Select your desired plan
5. Changes take effect at your next billing cycle
### Can I cancel my subscription?
Yes, you can cancel your subscription anytime:
1. Go to your account settings
2. Navigate to "Billing & Payment"
3. Click "Cancel Subscription"
4. Confirm cancellation
5. Your service continues until the end of your billing period
### What happens when I cancel?
When you cancel:
* **Immediate**: No further charges
* **Service**: Access continues until billing period ends
* **Data**: Your data is retained for 30 days
* **Export**: You can export your data before deletion
## Billing Issues
### I was charged incorrectly. What should I do?
If you believe you were charged incorrectly:
1. Check your usage in the dashboard
2. Review your billing history
3. Contact our support team
4. Provide details of the discrepancy
5. We'll investigate and resolve within 24 hours
### Why was I charged more than expected?
Common reasons for higher charges:
* **Overage Usage**: Exceeded your plan's conversation limit
* **Plan Upgrade**: Upgraded to a higher tier
* **Add-ons**: Purchased additional services
* **Taxes**: Applicable taxes in your region
### How do I dispute a charge?
To dispute a charge:
1. Contact our support team immediately
2. Provide your account details
3. Explain the issue clearly
4. We'll investigate and respond within 24 hours
5. If valid, we'll issue a refund
### I didn't receive my invoice. What should I do?
If you didn't receive your invoice:
1. Check your spam/junk folder
2. Verify your email address in account settings
3. Contact support to resend the invoice
4. Update your email if necessary
## Refunds and Credits
### Do you offer refunds?
We offer refunds in specific circumstances:
* **Service Issues**: If our service doesn't work as advertised
* **Billing Errors**: If you were charged incorrectly
* **Cancellation**: Within 30 days of initial purchase
* **Technical Problems**: If we can't resolve technical issues
### How do I request a refund?
To request a refund:
1. Contact our support team
2. Explain the reason for the refund
3. Provide your account details
4. We'll review and respond within 48 hours
5. If approved, refunds are processed within 5-7 business days
### Do you offer credits?
Yes, we offer credits for:
* **Service Downtime**: Credits for significant outages
* **Billing Errors**: Credits for overcharges
* **Promotional**: Special promotional credits
* **Goodwill**: Customer satisfaction credits
### How long do refunds take?
Refund processing times:
* **Credit Cards**: 5-7 business days
* **PayPal**: 3-5 business days
* **Bank Transfer**: 7-10 business days
* **Cryptocurrency**: 1-3 business days
## Enterprise Billing
### Do you offer custom pricing for Enterprise?
Yes, we offer custom pricing for Enterprise customers:
* **Volume Discounts**: Discounts for high usage
* **Custom Features**: Tailored feature sets
* **Dedicated Support**: Priority support and account management
* **Flexible Terms**: Custom billing cycles and payment terms
### How do I get Enterprise pricing?
To get Enterprise pricing:
1. Contact our sales team
2. Provide your requirements
3. Schedule a consultation
4. Receive a custom quote
5. Sign a custom agreement
### What's included in Enterprise billing?
Enterprise billing includes:
* **Unlimited Usage**: No conversation limits
* **Custom Features**: Tailored functionality
* **Dedicated Support**: Priority support
* **SLA Guarantees**: Service level agreements
* **Custom Integrations**: Specialized integrations
## International Billing
### Do you support international billing?
Yes, we support international billing:
* **Multiple Currencies**: Support for major currencies
* **Local Payment Methods**: Region-specific payment options
* **Tax Compliance**: Automatic tax calculation
* **Multi-language**: Billing in your preferred language
### What currencies do you accept?
We accept payments in:
* **USD**: US Dollar
* **EUR**: Euro
* **GBP**: British Pound
* **CAD**: Canadian Dollar
* **AUD**: Australian Dollar
* **JPY**: Japanese Yen
* **And more**: Contact us for your currency
### How are taxes handled?
Tax handling:
* **Automatic Calculation**: Taxes calculated automatically
* **VAT Compliance**: EU VAT compliance
* **Sales Tax**: US sales tax where applicable
* **Local Taxes**: Region-specific tax requirements
## Usage and Limits
### How do I check my usage?
To check your usage:
1. Go to your account dashboard
2. Navigate to "Usage & Analytics"
3. View current month's usage
4. Check historical usage data
5. Monitor usage trends
### What happens if I exceed my plan limits?
If you exceed your plan limits:
* **Overage Charges**: Additional charges per conversation
* **Notifications**: Email alerts when approaching limits
* **Upgrade Prompt**: Suggestions to upgrade your plan
* **Service Continuation**: Service continues with overage charges
### Can I set usage alerts?
Yes, you can set usage alerts:
1. Go to account settings
2. Navigate to "Usage & Analytics"
3. Set alert thresholds
4. Choose notification methods
5. Receive alerts when approaching limits
## Account Management
### How do I update my billing information?
To update billing information:
1. Go to account settings
2. Navigate to "Billing & Payment"
3. Click "Edit Billing Information"
4. Update your details
5. Save changes
### How do I change my billing address?
To change your billing address:
1. Go to account settings
2. Navigate to "Billing & Payment"
3. Click "Update Billing Address"
4. Enter new address
5. Save changes
### How do I add additional users to my account?
To add additional users:
1. Go to account settings
2. Navigate to "Team Management"
3. Click "Invite User"
4. Enter user details
5. Send invitation
## Support and Contact
### How do I contact billing support?
You can contact billing support:
* **Email**: [billing@neuraltalk.ai](mailto:billing@neuraltalk.ai)
* **Phone**: +1 (555) 123-4567
* **Live Chat**: Available in your dashboard
* **Support Ticket**: Create a ticket in your account
### What information should I include in billing support requests?
Include the following information:
* **Account Email**: Your account email address
* **Issue Description**: Clear description of the issue
* **Screenshots**: Screenshots if applicable
* **Transaction ID**: If available
* **Date/Time**: When the issue occurred
### What are your billing support hours?
Billing support hours:
* **Monday-Friday**: 9 AM - 6 PM EST
* **Saturday**: 10 AM - 4 PM EST
* **Sunday**: Closed
* **Holidays**: Limited support
## Still Have Questions?
If you have additional billing questions:
* 📧 **Email Support**: [billing@neuraltalk.ai](mailto:billing@neuraltalk.ai)
* 📞 **Phone Support**: +1 (555) 123-4567
* 💬 **Live Chat**: Available in your dashboard
* 📖 **Documentation**: [neuraltalk.ai](https://neuraltalk.ai)
* 🎥 **Video Tutorials**: Check our YouTube channel
***
*Need help with billing? Contact our support team for personalized assistance!*
# Support Resources
Source: https://docs.neuraltalk.ai/help/support-resources
Comprehensive support resources for NeuralTalk AI, including documentation, community forums, video tutorials, and direct support channels.
# Support Resources
Comprehensive support resources for NeuralTalk AI, including documentation, community forums, video tutorials, and direct support channels.
## Documentation
### Getting Started
* **Quick Start Guide**: [Get started in 5 minutes](/getting-started)
* **Platform Overview**: [Learn about NeuralTalk AI](/platform-overview)
* **Setup Guides**: [Step-by-step setup instructions](/setup/ai-assistant-setup)
### API Reference
* **API Overview**: [Complete API documentation](/api-reference/introduction)
* **Authentication**: [API key and authentication setup](/api-reference/authentication)
* **Endpoints**: [All available API endpoints](/api-reference/endpoints)
* **SDKs**: [Client SDKs for popular languages](/api-reference/client-sdk)
### Integration Guides
* **Slack Integration**: [Connect to Slack](/integrations/slack)
* **Discord Integration**: [Connect to Discord](/integrations/discord)
* **WhatsApp Integration**: [Connect to WhatsApp](/integrations/whatsapp)
* **HubSpot Integration**: [Connect to HubSpot](/integrations/hubspot)
* **Custom API**: [Build custom integrations](/integrations/custom-api)
### Advanced Topics
* **Customization**: [Customize your AI assistant](/setup/styling-assistant)
* **Analytics**: [Track performance and insights](/api-reference/analytics)
* **Security**: [Security best practices](/security)
* **Compliance**: [GDPR, CCPA, and other regulations](/compliance)
## Community Support
### Discord Community
Join our active Discord community for:
* **Peer Support**: Get help from other users
* **Feature Requests**: Suggest new features
* **Bug Reports**: Report issues and bugs
* **Best Practices**: Share tips and tricks
* **Announcements**: Stay updated on new features
**Join Discord**: [discord.gg/tHpggadDAk](https://discord.gg/tHpggadDAk)
### GitHub Community
* **Open Source**: Contribute to our open source projects
* **Issues**: Report bugs and request features
* **Discussions**: Technical discussions and Q\&A
* **Code Examples**: Share code snippets and examples
**GitHub**: [github.com/neuraltalk](https://github.com/neuraltalk)
### Stack Overflow
Ask technical questions on Stack Overflow:
* **Tag**: Use `neuraltalk-ai` tag
* **Search**: Find existing answers
* **Vote**: Help others with upvotes
* **Answer**: Share your knowledge
**Stack Overflow**: [stackoverflow.com/questions/tagged/neuraltalk-ai](https://stackoverflow.com/questions/tagged/neuraltalk-ai)
## Video Tutorials
### Getting Started Series
1. **Introduction to NeuralTalk AI** (5 min)
* Overview of features and capabilities
* How to create your first assistant
* Basic configuration and setup
2. **Setting Up Your AI Assistant** (15 min)
* Detailed setup process
* Training your assistant
* Testing and optimization
3. **Integrating with Your Website** (10 min)
* Adding chatbot to your website
* Customizing appearance
* Advanced configuration options
### Integration Tutorials
1. **Slack Integration** (12 min)
* Setting up Slack app
* Configuring webhooks
* Testing the integration
2. **Discord Integration** (10 min)
* Creating Discord bot
* Setting up permissions
* Deploying to server
3. **HubSpot Integration** (18 min)
* CRM setup and configuration
* Contact synchronization
* Lead management
### Advanced Topics
1. **Custom API Development** (25 min)
* Building custom integrations
* Webhook implementation
* Error handling and debugging
2. **Analytics and Reporting** (15 min)
* Setting up analytics
* Creating custom reports
* Performance optimization
3. **Security and Compliance** (20 min)
* Security best practices
* Data protection measures
* Compliance requirements
**YouTube Channel**: [youtube.com/neuraltalk](https://youtube.com/neuraltalk)
## Direct Support
### Email Support
**General Support**: [support@neuraltalk.ai](mailto:support@neuraltalk.ai)
**Response Times:**
* **Free Plan**: 48-72 hours
* **Pro Plan**: 24-48 hours
* **Enterprise Plan**: 4-8 hours
**What to Include:**
* Your account email
* Detailed description of the issue
* Steps to reproduce the problem
* Screenshots or error messages
* Browser and operating system information
### Live Chat Support
**Availability:**
* **Monday-Friday**: 9 AM - 6 PM EST
* **Saturday**: 10 AM - 4 PM EST
* **Sunday**: Closed
**Access:**
* Available in your dashboard
* Click "Support" in the sidebar
* Start a new chat session
### Phone Support
**Enterprise Customers Only**
**Phone Number**: +1 (555) 123-4567
**Hours:**
* **Monday-Friday**: 9 AM - 6 PM EST
* **Saturday**: 10 AM - 4 PM EST
* **Sunday**: Closed
**What to Have Ready:**
* Your account information
* Description of the issue
* Any error messages or codes
* Steps you've already tried
### Priority Support
**Available for:**
* Enterprise customers
* Pro customers with urgent issues
* Critical system outages
**Features:**
* Dedicated support representative
* Faster response times
* Priority issue resolution
* Direct access to engineering team
## Self-Service Tools
### Knowledge Base
**Searchable Knowledge Base:**
* Comprehensive articles and guides
* Step-by-step instructions
* Troubleshooting guides
* Best practices and tips
**Categories:**
* Getting Started
* Setup and Configuration
* Integrations
* API Reference
* Troubleshooting
* Billing and Account
### Interactive Troubleshooting
**Smart Troubleshooting Tool:**
* Answer questions about your issue
* Get personalized solutions
* Step-by-step guidance
* Escalate to human support if needed
**Access**: Available in your dashboard under "Help & Support"
### Status Page
**Real-Time Status Updates:**
* System status and uptime
* Planned maintenance windows
* Incident reports and updates
* Performance metrics
**Status Page**: [status.neuraltalk.ai](https://status.neuraltalk.ai)
## Training and Certification
### Free Training Courses
1. **NeuralTalk AI Fundamentals** (2 hours)
* Basic concepts and features
* Hands-on exercises
* Certificate of completion
2. **Advanced Integration** (3 hours)
* Custom API development
* Webhook implementation
* Error handling and debugging
3. **Analytics and Optimization** (2 hours)
* Performance monitoring
* Data analysis
* Optimization techniques
### Certification Program
**NeuralTalk AI Certified Professional**
**Requirements:**
* Complete all training courses
* Pass certification exam
* Submit practical project
* Maintain certification annually
**Benefits:**
* Official certification badge
* Priority support access
* Exclusive community features
* Career advancement opportunities
**Register**: [training.neuraltalk.ai](https://training.neuraltalk.ai)
## Developer Resources
### API Documentation
**Interactive API Explorer:**
* Test API endpoints directly
* View request/response examples
* Generate code snippets
* Download SDKs
**API Explorer**: [api.neuraltalk.ai/docs](https://api.neuraltalk.ai/docs)
### Code Examples
**GitHub Repository:**
* Sample integrations
* Code snippets and examples
* Best practices
* Community contributions
**Repository**: [github.com/neuraltalk/examples](https://github.com/neuraltalk/examples)
### SDK Downloads
**Official SDKs:**
* JavaScript/Node.js
* Python
* PHP
* Java
* C#
* Go
* Ruby
**Download**: [sdk.neuraltalk.ai](https://sdk.neuraltalk.ai)
## Feedback and Feature Requests
### Feature Requests
**Submit Ideas:**
* Use our feedback form
* Vote on existing requests
* Discuss with the community
* Track implementation status
**Feedback Form**: [feedback.neuraltalk.ai](https://feedback.neuraltalk.ai)
### Bug Reports
**Report Issues:**
* Detailed bug reports
* Steps to reproduce
* Expected vs actual behavior
* System information
**Bug Tracker**: [bugs.neuraltalk.ai](https://bugs.neuraltalk.ai)
### User Research
**Participate in Research:**
* User interviews
* Beta testing programs
* Usability studies
* Feedback sessions
**Sign Up**: [research.neuraltalk.ai](https://research.neuraltalk.ai)
## Emergency Support
### Critical Issues
**For Critical Issues:**
* System outages
* Security incidents
* Data loss
* Service disruptions
**Emergency Contact:**
* **Email**: [emergency@neuraltalk.ai](mailto:emergency@neuraltalk.ai)
* **Phone**: +1 (555) 911-HELP
* **Status Page**: [status.neuraltalk.ai](https://status.neuraltalk.ai)
### Escalation Process
1. **Level 1**: General support team
2. **Level 2**: Technical specialists
3. **Level 3**: Engineering team
4. **Level 4**: Product management
## Contact Information
### General Support
* **Email**: [support@neuraltalk.ai](mailto:support@neuraltalk.ai)
* **Live Chat**: Available in dashboard
* **Discord**: [discord.gg/tHpggadDAk](https://discord.gg/tHpggadDAk)
* **GitHub**: [github.com/neuraltalk](https://github.com/neuraltalk)
### Business Inquiries
* **Sales**: [sales@neuraltalk.ai](mailto:sales@neuraltalk.ai)
* **Partnerships**: [partnerships@neuraltalk.ai](mailto:partnerships@neuraltalk.ai)
* **Media**: [media@neuraltalk.ai](mailto:media@neuraltalk.ai)
### Legal and Compliance
* **Legal**: [legal@neuraltalk.ai](mailto:legal@neuraltalk.ai)
* **Privacy**: [privacy@neuraltalk.ai](mailto:privacy@neuraltalk.ai)
* **Security**: [security@neuraltalk.ai](mailto:security@neuraltalk.ai)
## Office Hours
### Support Hours
* **Monday-Friday**: 9 AM - 6 PM EST
* **Saturday**: 10 AM - 4 PM EST
* **Sunday**: Closed
* **Holidays**: Limited support
### Time Zones
* **EST**: Eastern Standard Time
* **PST**: Pacific Standard Time
* **GMT**: Greenwich Mean Time
* **CET**: Central European Time
## Still Need Help?
If you can't find what you're looking for:
1. **Search Documentation**: Use the search function
2. **Check Community**: Ask in Discord or GitHub
3. **Contact Support**: Use email or live chat
4. **Schedule Call**: Book a consultation call
**Quick Links:**
* 📖 **Documentation**: [neuraltalk.ai](https://neuraltalk.ai)
* 💬 **Discord**: [discord.gg/tHpggadDAk](https://discord.gg/tHpggadDAk)
* 📧 **Email**: [support@neuraltalk.ai](mailto:support@neuraltalk.ai)
* 📞 **Phone**: +1 (555) 123-4567
***
*We're here to help you succeed with NeuralTalk AI! Don't hesitate to reach out if you need assistance.*
# Troubleshooting Guide
Source: https://docs.neuraltalk.ai/help/troubleshooting
Common issues and solutions for NeuralTalk AI, including technical problems, integration issues, and performance optimization.
# Troubleshooting Guide
Common issues and solutions for NeuralTalk AI, including technical problems, integration issues, and performance optimization.
## Common Issues
### Chatbot Not Responding
**Symptoms:**
* Chatbot doesn't respond to messages
* Messages appear to be sent but no reply
* Error messages in chat interface
**Solutions:**
1. **Check Assistant Status**
* Go to your dashboard
* Verify assistant is active and running
* Check for any error messages or warnings
2. **Verify API Configuration**
* Check API key is correct and active
* Verify assistant ID is correct
* Ensure proper authentication headers
3. **Check Network Connectivity**
* Test internet connection
* Verify firewall settings
* Check for proxy or VPN issues
4. **Review Logs**
* Check error logs in dashboard
* Look for specific error messages
* Contact support with log details
### Poor Response Quality
**Symptoms:**
* Responses are irrelevant or inaccurate
* AI gives generic answers
* Responses don't match your content
**Solutions:**
1. **Improve Training Data**
* Add more relevant content to knowledge base
* Update existing content with current information
* Remove outdated or incorrect information
2. **Optimize Prompts**
* Review and refine your prompts
* Add context and examples
* Test different prompt variations
3. **Check Content Quality**
* Ensure content is well-structured
* Use clear and concise language
* Add relevant keywords and phrases
4. **Monitor Performance**
* Track response quality metrics
* Collect user feedback
* Continuously improve based on data
### Integration Problems
**Symptoms:**
* Integration not working properly
* Data not syncing between systems
* Authentication errors
**Solutions:**
1. **Verify Integration Settings**
* Check integration configuration
* Verify API credentials
* Test connection status
2. **Review Permissions**
* Ensure proper permissions are granted
* Check API key permissions
* Verify user access rights
3. **Check API Limits**
* Monitor API usage and limits
* Implement rate limiting
* Upgrade plan if needed
4. **Test Integration**
* Use test data to verify functionality
* Check error logs for specific issues
* Contact integration provider if needed
### Performance Issues
**Symptoms:**
* Slow response times
* High latency
* Timeout errors
**Solutions:**
1. **Optimize Content**
* Reduce content size and complexity
* Use efficient data structures
* Remove unnecessary data
2. **Implement Caching**
* Cache frequently accessed data
* Use CDN for static content
* Implement response caching
3. **Monitor Resources**
* Check server resources
* Monitor API usage
* Optimize database queries
4. **Scale Resources**
* Upgrade to higher plan
* Add more processing power
* Implement load balancing
## Technical Issues
### API Errors
**Common API Error Codes:**
| Code | Description | Solution |
| ----- | ------------ | --------------------------------------- |
| `400` | Bad Request | Check request format and parameters |
| `401` | Unauthorized | Verify API key and authentication |
| `403` | Forbidden | Check permissions and access rights |
| `404` | Not Found | Verify resource IDs and endpoints |
| `429` | Rate Limited | Implement rate limiting and retry logic |
| `500` | Server Error | Contact support for server issues |
**Debugging Steps:**
1. **Check Request Format**
```javascript theme={null}
// Verify request structure
const request = {
method: 'POST',
headers: {
'Authorization': `Bearer ${API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
message: 'Hello',
user_id: 'user_123'
})
};
```
2. **Validate API Key**
```javascript theme={null}
// Test API key validity
const testKey = async (apiKey) => {
try {
const response = await fetch('https://api.neuraltalk.ai/api/v1/auth/verify', {
headers: { 'Authorization': `Bearer ${apiKey}` }
});
return response.ok;
} catch (error) {
return false;
}
};
```
3. **Check Rate Limits**
```javascript theme={null}
// Implement rate limiting
const rateLimiter = {
requests: 0,
resetTime: Date.now() + 60000, // 1 minute
canMakeRequest() {
if (Date.now() > this.resetTime) {
this.requests = 0;
this.resetTime = Date.now() + 60000;
}
return this.requests < 100; // 100 requests per minute
},
makeRequest() {
if (this.canMakeRequest()) {
this.requests++;
return true;
}
return false;
}
};
```
### Authentication Problems
**Common Authentication Issues:**
1. **Invalid API Key**
* Verify key is correct
* Check for typos or extra spaces
* Ensure key is active and not expired
2. **Missing Authentication Header**
* Include proper Authorization header
* Use correct format: `Bearer YOUR_API_KEY`
* Check header name and value
3. **Expired Token**
* Refresh authentication token
* Implement token refresh logic
* Handle token expiration gracefully
**Authentication Debugging:**
```javascript theme={null}
// Debug authentication
const debugAuth = async (apiKey) => {
console.log('API Key:', apiKey ? 'Present' : 'Missing');
console.log('Key Length:', apiKey ? apiKey.length : 0);
try {
const response = await fetch('https://api.neuraltalk.ai/api/v1/auth/verify', {
headers: {
'Authorization': `Bearer ${apiKey}`,
'Content-Type': 'application/json'
}
});
console.log('Status:', response.status);
console.log('Headers:', response.headers);
if (response.ok) {
const data = await response.json();
console.log('Auth Data:', data);
} else {
const error = await response.text();
console.log('Auth Error:', error);
}
} catch (error) {
console.log('Network Error:', error);
}
};
```
### Data Synchronization Issues
**Common Sync Problems:**
1. **Data Not Updating**
* Check sync frequency settings
* Verify data source connectivity
* Review sync logs for errors
2. **Duplicate Data**
* Implement deduplication logic
* Check for duplicate identifiers
* Use unique keys for data mapping
3. **Data Format Issues**
* Validate data format before sync
* Implement data transformation
* Handle different data types
**Sync Debugging:**
```javascript theme={null}
// Debug data synchronization
const debugSync = async (syncId) => {
try {
const response = await fetch(`https://api.neuraltalk.ai/api/v1/sync/${syncId}/status`);
const status = await response.json();
console.log('Sync Status:', status);
if (status.last_sync) {
console.log('Last Sync:', new Date(status.last_sync));
}
if (status.errors && status.errors.length > 0) {
console.log('Sync Errors:', status.errors);
}
return status;
} catch (error) {
console.error('Sync Debug Error:', error);
throw error;
}
};
```
## Integration Troubleshooting
### Webhook Issues
**Common Webhook Problems:**
1. **Webhook Not Receiving Data**
* Verify webhook URL is accessible
* Check webhook endpoint is working
* Test webhook with sample data
2. **Webhook Authentication Failures**
* Verify webhook secret is correct
* Check signature validation logic
* Ensure proper header format
3. **Webhook Timeout Errors**
* Optimize webhook processing time
* Implement async processing
* Add retry logic for failed webhooks
**Webhook Debugging:**
```javascript theme={null}
// Debug webhook
const debugWebhook = (webhookUrl, secret) => {
return async (req, res) => {
console.log('Webhook Received:', {
method: req.method,
headers: req.headers,
body: req.body
});
// Verify signature
const signature = req.headers['x-neuraltalk-signature'];
const expectedSignature = crypto
.createHmac('sha256', secret)
.update(JSON.stringify(req.body))
.digest('hex');
if (signature !== expectedSignature) {
console.log('Invalid signature');
return res.status(401).send('Unauthorized');
}
console.log('Webhook verified successfully');
res.status(200).send('OK');
};
};
```
### CRM Integration Issues
**Common CRM Problems:**
1. **Contact Not Syncing**
* Check CRM API credentials
* Verify field mappings
* Review sync rules and filters
2. **Duplicate Contacts**
* Implement deduplication logic
* Use unique identifiers
* Check for existing contacts before creating
3. **Field Mapping Errors**
* Verify field names and types
* Check required field validation
* Test field transformations
**CRM Debugging:**
```javascript theme={null}
// Debug CRM integration
const debugCRM = async (contactData) => {
console.log('Contact Data:', contactData);
// Validate required fields
const requiredFields = ['email', 'name'];
const missingFields = requiredFields.filter(field => !contactData[field]);
if (missingFields.length > 0) {
console.log('Missing required fields:', missingFields);
return false;
}
// Check for duplicates
const existingContact = await crm.findContact(contactData.email);
if (existingContact) {
console.log('Contact already exists:', existingContact.id);
return false;
}
// Test field mapping
const mappedData = mapContactFields(contactData);
console.log('Mapped Data:', mappedData);
return true;
};
```
## Performance Optimization
### Response Time Optimization
**Optimization Strategies:**
1. **Content Optimization**
* Reduce content size and complexity
* Use efficient data structures
* Remove unnecessary information
2. **Caching Implementation**
* Cache frequently accessed data
* Implement response caching
* Use CDN for static content
3. **Database Optimization**
* Optimize database queries
* Use proper indexing
* Implement query caching
**Performance Monitoring:**
```javascript theme={null}
// Monitor response times
const monitorPerformance = (fn) => {
return async (...args) => {
const start = Date.now();
try {
const result = await fn(...args);
const duration = Date.now() - start;
console.log(`Function ${fn.name} took ${duration}ms`);
if (duration > 5000) {
console.warn('Slow response detected');
}
return result;
} catch (error) {
const duration = Date.now() - start;
console.error(`Function ${fn.name} failed after ${duration}ms:`, error);
throw error;
}
};
};
```
### Memory Usage Optimization
**Memory Optimization Tips:**
1. **Data Cleanup**
* Remove unused data and variables
* Implement garbage collection
* Use efficient data structures
2. **Resource Management**
* Close connections properly
* Release memory when done
* Monitor memory usage
3. **Caching Strategy**
* Implement smart caching
* Use memory-efficient cache
* Set appropriate cache limits
**Memory Monitoring:**
```javascript theme={null}
// Monitor memory usage
const monitorMemory = () => {
const usage = process.memoryUsage();
console.log('Memory Usage:', {
rss: `${Math.round(usage.rss / 1024 / 1024)} MB`,
heapTotal: `${Math.round(usage.heapTotal / 1024 / 1024)} MB`,
heapUsed: `${Math.round(usage.heapUsed / 1024 / 1024)} MB`,
external: `${Math.round(usage.external / 1024 / 1024)} MB`
});
if (usage.heapUsed > 100 * 1024 * 1024) { // 100MB
console.warn('High memory usage detected');
}
};
```
## Getting Help
### Self-Service Resources
1. **Documentation**
* Check our comprehensive documentation
* Search for specific topics
* Review API reference guides
2. **Community Forums**
* Join our [Discord community](https://discord.gg/tHpggadDAk)
* Ask questions and get help
* Share solutions and tips
3. **Video Tutorials**
* Watch setup and troubleshooting videos
* Learn best practices
* See real-world examples
### Contact Support
**When to Contact Support:**
* Critical issues affecting your service
* Problems not covered in documentation
* Integration issues with third-party services
* Billing or account problems
**How to Contact Support:**
1. **Email Support**
* Send detailed description of the issue
* Include relevant logs and screenshots
* Provide account information
2. **Live Chat**
* Available in your dashboard
* Real-time assistance
* Quick problem resolution
3. **Phone Support**
* Available for Enterprise customers
* Priority support
* Direct access to technical team
**Information to Include:**
* **Account Details**: Email and account ID
* **Issue Description**: Clear description of the problem
* **Steps to Reproduce**: How to reproduce the issue
* **Error Messages**: Any error messages or codes
* **Logs**: Relevant log files or screenshots
* **Environment**: Browser, operating system, etc.
### Escalation Process
1. **Level 1**: General support and basic troubleshooting
2. **Level 2**: Technical issues and advanced troubleshooting
3. **Level 3**: Engineering team for complex issues
4. **Level 4**: Product team for feature requests and bugs
## Prevention Tips
### Regular Maintenance
1. **Monitor Performance**
* Check response times regularly
* Monitor error rates
* Review usage patterns
2. **Update Content**
* Keep knowledge base current
* Remove outdated information
* Add new relevant content
3. **Test Integrations**
* Regular integration testing
* Verify data synchronization
* Check for API changes
### Best Practices
1. **Error Handling**
* Implement proper error handling
* Use try-catch blocks
* Provide meaningful error messages
2. **Logging**
* Implement comprehensive logging
* Log important events
* Monitor log files regularly
3. **Testing**
* Test changes before deployment
* Use staging environments
* Implement automated testing
## Still Need Help?
If you're still experiencing issues:
* 📧 **Email Support**: [support@neuraltalk.ai](mailto:support@neuraltalk.ai)
* 💬 **Live Chat**: Available in your dashboard
* 📞 **Phone Support**: +1 (555) 123-4567
* 📖 **Documentation**: [neuraltalk.ai](https://neuraltalk.ai)
* 🎥 **Video Tutorials**: Check our YouTube channel
* 💬 **Community Discord**: Join our [Discord](https://discord.gg/tHpggadDAk) for peer support
***
*Having trouble? Our support team is here to help you resolve any issues quickly and efficiently!*
# 📅 Calendly Integration
Source: https://docs.neuraltalk.ai/integrations/calendly
Integrate your AI assistant with Calendly for automated scheduling and appointment management and provide seamless calendar integration for your business.
🎥 Refer to the setup video for a step-by-step visual guide:
## Setup Process
### Step 1: Create Calendly Account
1. Go to [calendly.com](https://calendly.com)
2. Sign up for a Calendly account
3. Choose your plan (Free, Premium, or Pro)
4. Complete your profile setup
![Calendly Account Setup]()
### Step 2: Configure Calendly Settings
1. **Event Types**: Create different types of meetings
2. **Availability**: Set your working hours and time zones
3. **Booking Rules**: Configure buffer times and limits
4. **Customization**: Brand your booking pages
![Calendly Configuration]()
### Step 3: Generate API Credentials
1. Go to Calendly Settings → Integrations
2. Navigate to "API & Webhooks"
3. Generate your Personal Access Token
4. Copy the token for NeuralTalk integration
![Calendly API Setup]()
### Step 4: Connect to NeuralTalk
1. Go to your NeuralTalk dashboard
2. Navigate to "Integrations" → "Calendly"
3. Enter your Calendly API token
4. Configure webhook settings
5. Test the connection
![Calendly Integration Complete]()
## Features
* **Automated scheduling** through AI conversations
* **Calendar synchronization** with major calendar apps
* **Meeting reminders** and notifications
* **Rescheduling and cancellation** handling
* **Multi-timezone support** for global teams
* **Custom booking flows** for different services
## Configuration
### API Permissions
* **Read events** and availability
* **Create bookings** on behalf of users
* **Update appointments** and schedules
* **Access user information** for personalization
* **Manage webhooks** for real-time updates
### Event Types
* **One-on-one meetings** for personal consultations
* **Group sessions** for team meetings
* **Webinars** and online events
* **Phone calls** and video conferences
* **In-person meetings** with location details
### Booking Rules
* **Buffer times** between meetings
* **Advance notice** requirements
* **Maximum bookings** per day
* **Working hours** and availability
* **Holiday and break** management
## AI Assistant Capabilities
### Scheduling Commands
* **"Schedule a meeting"** - Book appointments directly
* **"Check availability"** - View open time slots
* **"Reschedule meeting"** - Modify existing bookings
* **"Cancel appointment"** - Remove scheduled meetings
* **"Show my calendar"** - Display upcoming events
### Smart Responses
* **Availability checking** before suggesting times
* **Conflict resolution** for double bookings
* **Time zone handling** for international users
* **Follow-up reminders** and confirmations
* **Custom meeting preparation** instructions
### Integration Features
* **Calendar sync** with Google, Outlook, Apple
* **Email notifications** for all parties
* **SMS reminders** for important meetings
* **Video conferencing** links (Zoom, Teams, etc.)
* **Document sharing** for meeting materials
## Use Cases
### Sales Teams
* **Lead qualification** calls
* **Product demos** and presentations
* **Follow-up meetings** with prospects
* **Discovery calls** for new opportunities
* **Contract discussions** and negotiations
### Customer Support
* **Technical support** sessions
* **Onboarding calls** for new customers
* **Training sessions** and tutorials
* **Feedback collection** meetings
* **Issue resolution** discussions
### Professional Services
* **Consultation calls** with clients
* **Project kickoff** meetings
* **Progress reviews** and updates
* **Strategy sessions** and planning
* **Client check-ins** and updates
### Healthcare
* **Patient consultations** and appointments
* **Follow-up visits** and check-ups
* **Telemedicine** sessions
* **Therapy sessions** and counseling
* **Medical consultations** and advice
## Advanced Configuration
### Webhook Setup
1. **Event notifications** for new bookings
2. **Cancellation alerts** for changes
3. **Reminder triggers** before meetings
4. **Completion confirmations** after events
5. **Custom data** for business logic
### Custom Fields
* **Contact information** collection
* **Meeting preferences** and requirements
* **Special instructions** and notes
* **Document uploads** and attachments
* **Payment processing** for paid services
### Automation Rules
* **Auto-confirm** certain meeting types
* **Send reminders** at specific intervals
* **Follow-up emails** after meetings
* **Reschedule logic** for conflicts
* **Escalation procedures** for issues
## Troubleshooting
### Common Issues
* **API rate limits**: Check your Calendly plan limits
* **Webhook failures**: Verify URL and authentication
* **Calendar sync issues**: Check calendar permissions
* **Timezone problems**: Verify timezone settings
* **Booking conflicts**: Review availability rules
### Best Practices
* **Test thoroughly** with different scenarios
* **Monitor webhook logs** for errors
* **Keep API tokens secure** and rotate regularly
* **Set appropriate buffer times** between meetings
* **Provide clear instructions** to users
### Support Resources
* [Calendly API Documentation](https://developer.calendly.com/)
* [Webhook Configuration Guide](https://calendly.com/api-docs)
* [Integration Best Practices](https://calendly.com/help)
* [Troubleshooting Guide](https://calendly.com/support)
## Next Steps
* [Slack Integration](/integrations/slack)
* [Discord Integration](/integrations/discord)
* [WhatsApp Integration](/integrations/whatsapp)
* [HubSpot Integration](/integrations/hubspot)
# 🎮 Discord Integration
Source: https://docs.neuraltalk.ai/integrations/discord
Connect your NeuralTalk AI chatbot to Discord and provide intelligent responses to your community members directly in your server.
🎥 Refer to the setup video for a step-by-step visual guide:
## Overview
The Discord integration allows your NeuralTalk AI chatbot to:
* **Interact with users** in Discord servers and channels
* **Answer questions** and provide assistance automatically
* **Handle direct messages** from community members
* **Support slash commands** for specific functionalities
* **Scale your community support** with AI-powered responses
## Prerequisites
Before setting up your Discord integration, you need:
* ✅ An active NeuralTalk AI account
* 🤖 A created and trained chatbot on the NeuralTalk AI platform
* 🔑 Admin or "Manage Server" permissions on the Discord server
## Setup Process
### Step 1: Access NeuralTalk AI Integration Settings
1. Log in to your NeuralTalk AI dashboard
2. Select the chatbot you want to connect to Discord
3. Navigate to **Settings** in the left sidebar
4. Click on **Chatbot Settings** from the expanded menu
![Chatbot Settings Navigation]()
5. Find the Discord integration card in the integrations section
6. Click the **Connect** button to start the integration process
### Step 2: Authorize Discord Integration
When you click **Connect** in NeuralTalk AI, you'll be redirected to Discord's authorization page:
![Discord Authorization Step 1]()
**Review Application Permissions**: You'll see a screen asking for permission to access your Discord account
The application will request permission to:
* Add a bot to a server
* Access your username, avatar, and banner
* Know what servers you're in
* Create commands
* Have an existential crisis (this is a joke permission Discord shows)
1. Select your Discord server from the dropdown menu where you want to add the bot
2. Click **Continue** to proceed to the next authorization step
### Step 3: Grant Bot Permissions
In the next screen, you'll need to authorize specific permissions for your bot:
![Discord Authorization Step 2]()
The bot will request the following permissions:
* ✅ **Administrator** (for full server access)
* ✅ **Manage Roles** (to assign roles if needed)
* ✅ **Manage Nicknames** (to change user nicknames)
* ✅ **Change Nickname** (to change the bot's own nickname)
* ✅ **Manage Expressions** (to manage server emojis and stickers)
* And other necessary permissions for proper functioning
1. Review all the permissions listed
2. Click **Authorize** to grant these permissions to your NeuralTalk AI bot
3. Complete any CAPTCHA verification if prompted
### Step 4: Verify Successful Connection
After successful authorization, you'll be redirected back to your NeuralTalk AI dashboard where you should see:
![Successful Discord Connection]()
The connection status will show:
* ✅ **Discord Connected**
* **Connected to server**: \[Your server name]
* **Server ID**: Your Discord server ID number
* **Connected Channels**: Number of channels the bot has access to
* **Last Connected**: Date of connection
* **Token Expiry**: Current status of your bot token
You'll also see a red **Disconnect** button if you need to remove the integration later.
## How It Works
Once connected, your NeuralTalk AI Discord bot will:
* **In channels**: Respond when mentioned (@YourBot) or when using configured slash commands
* **In direct messages**: Respond to all messages sent directly to the bot
* **Process messages** through your NeuralTalk AI chatbot backend
* **Use your trained knowledge base** to provide relevant responses
## Usage Examples
### Channel Usage
Users can interact with your bot in a Discord channel by:
* Mentioning the bot with a question (e.g., `@YourBot How do I reset my password?`)
* The bot will respond in the same channel
* Follow-up questions can be asked by mentioning the bot again
### Direct Message Usage
Users can get private assistance by:
* Right-clicking on the bot's name in the server member list
* Selecting "Message"
* Asking questions directly to the bot in the DM channel
* Continuing the conversation naturally without needing to mention the bot
### Slash Commands
If you've configured slash commands, users can:
* Type `/` in any channel where the bot has access
* Select from available commands (e.g., `/help`, `/faq`, etc.)
* Complete any required parameters
* Submit the command to receive a response
💡 **Pro Tip**: Set up custom slash commands for frequently asked questions or specific functions to make your bot more user-friendly.
## Advanced Configuration
### Configuring Slash Commands
To set up custom slash commands:
1. In your NeuralTalk AI dashboard, go to **Settings > Chatbot Settings**
2. Scroll to the Discord integration section
3. Click **Configure** next to your connected Discord integration
4. Navigate to the "Slash Commands" section
5. Click **Add Command** and configure:
* Command name (without the / prefix)
* Description
* Response template or function
### Channel Restrictions
You can limit which channels your bot responds in:
1. Go to **Settings > Chatbot Settings**
2. Find your Discord integration and click **Configure**
3. Navigate to "Channel Settings"
4. Choose between:
* **All Channels**: Bot responds in any channel it has access to
* **Specific Channels**: Select which channels the bot should respond in
5. Save your changes
### Monitoring Performance
Track your Discord integration performance:
1. Navigate to **Analytics** in your dashboard
2. Select the **Channels** or **Messages** tab
3. Filter by Discord integration
4. View metrics such as:
* Number of interactions
* Response time
* Most active channels
* Popular topics
* User satisfaction ratings
## Troubleshooting
### Bot Not Responding
If your bot isn't responding to messages:
* **Check Connection Status**: Ensure the bot shows as "Discord Connected" in your NeuralTalk AI dashboard
* **Verify Bot Status**: Check if the bot appears online in your Discord server
* **Check Permissions**: Ensure the bot has the correct permissions in the server and specific channels
* **Message Content Intent**: Verify that Message Content Intent is enabled in the Discord Developer Portal
* **Re-authorize if needed**: If issues persist, try disconnecting and reconnecting the integration
### Integration Disconnected
If your Discord connection is lost:
1. Go to **Settings > Chatbot Settings**
2. Check if the Discord integration shows "Disconnected"
3. Click **Connect** and go through the authorization process again
4. If issues persist, you may need to reset your Discord bot token and update it
### Permission Issues
If users report the bot cannot perform certain actions:
* Check that the bot has Administrator permissions or the specific permissions it needs
* Ensure the bot's role is positioned high enough in the server's role hierarchy
* Verify channel-specific permissions haven't been restricted
## Best Practices
* **Set Clear Expectations**: Use a bot description or welcome message to help users understand what your bot can help with
* **Monitor Conversations**: Regularly review bot interactions to identify areas for improvement
* **Update Knowledge Base**: Keep your NeuralTalk AI chatbot trained with current information
* **Use Rate Limiting**: Configure appropriate rate limits to prevent spam and abuse
* **Test Thoroughly**: Test the bot in a private channel before making it available server-wide
## Security Considerations
* Always keep your Discord bot token secure
* NeuralTalk AI encrypts your token and all communication with the Discord API
* Consider restricting the bot to specific channels for sensitive communities
* Be mindful of what information your bot is trained to share in public channels
* Regularly review and update bot permissions as needed
## Disconnecting Your Bot
To disconnect your Discord integration from NeuralTalk AI:
1. Go to **Settings > Chatbot Settings**
2. Find the Discord integration card
3. Click the red **Disconnect** button
4. Confirm the disconnection when prompted
This will stop the bot from processing messages but will not remove the bot from your Discord server. To completely remove the bot:
**In Discord**:
1. Go to your Server Settings
2. Navigate to **Members**
3. Find your NeuralTalk AI bot and click **Kick** or **Ban**
**Alternatively**:
1. Right-click on the bot's name in any channel
2. Select **Kick from server**
## Need Help?
If you encounter any issues while setting up or using your Discord integration:
* Check our troubleshooting guide above
* Visit our documentation for more detailed guides
* Contact our support team at [support@neuraltalk.ai](mailto:support@neuraltalk.ai)
* Join our Discord community for peer support and tips
## Next Steps
* [Telegram Integration](/integrations/telegram)
* [Slack Integration](/integrations/slack)
* [WhatsApp Integration](/integrations/whatsapp)
* [HubSpot Integration](/integrations/hubspot)
# 🎯 HubSpot Integration
Source: https://docs.neuraltalk.ai/integrations/hubspot
Connect your NeuralTalk AI chatbot to HubSpot CRM and automatically turn conversations into actionable leads while providing your sales team with complete conversation context for better follow-ups.
Connect your NeuralTalk AI chatbot to HubSpot CRM and automatically turn conversations into actionable leads while providing your sales team with complete conversation context for better follow-ups.
![HubSpot Integration Overview]()
## Overview
The HubSpot integration enables your NeuralTalk AI chatbot to:
* 🎯 **Automatically sync chat contacts with HubSpot CRM**
* 📊 **Track customer interactions and conversation history**
* 🔄 **Create and update contact properties automatically**
* 📞 **Capture human support requests as contacts in HubSpot**
* 📈 **Streamline your sales pipeline with qualified leads**
* 💼 **Provide complete conversation context for your sales team**
## Benefits of HubSpot Integration
* ✅ **Automatic Lead Capture**: Convert chat users into HubSpot contacts with zero manual effort
* 📋 **Human Support Request Tracking**: All human support requests are automatically logged in HubSpot with conversation history
* 📄 **Detailed Conversation Context**: Chat transcripts are attached to contacts, providing full context for your sales team
* 🏷️ **Lead Status Tracking**: New contacts are marked with "NEW" lead status for easy follow-up
* 🔄 **Seamless Customer Journey**: Track the path from initial chat interaction through your sales pipeline
* 🔗 **Data Synchronization**: Real-time sync between your chatbot and HubSpot CRM
You'll need a HubSpot account to enable CRM integration with your chatbot conversations.
## Prerequisites
Before setting up your HubSpot integration, you need:
1. ✅ An active NeuralTalk AI account
2. 🤖 A created and trained chatbot on the NeuralTalk AI platform
3. 🏢 A HubSpot account (any tier - Free, Starter, Professional, or Enterprise)
4. 🔑 Admin access to your HubSpot account for authorization
## Setup Process
### Step 1: Access NeuralTalk AI Integration Settings
1. Log in to your [NeuralTalk AI dashboard](https://neuraltalk.ai)
2. Select the chatbot you want to connect to HubSpot
3. Navigate to **Settings** in the left sidebar
4. Click on **Chatbot Settings** from the expanded menu
5. Navigate to the **Integrations** tab at the top of the page
![HubSpot Integration Settings]()
6. Find the **HubSpot Integration** card
7. Review the benefits of HubSpot integration:
* Automatically sync chat contacts with HubSpot CRM
* Track customer interactions and conversation history
* Create and update contact properties automatically
* Capture human support requests as contacts in HubSpot
8. Click the **Connect** button to start the integration process
### Step 2: Connect Your HubSpot Account
When you click **Connect**, you'll be redirected to the HubSpot authorization page:
![Connecting NeuralTalk AI to HubSpot]()
**Connecting your NeuralTalk AI account to HubSpot**
You'll see two options to proceed:
1. **Create a new HubSpot account** - If you don't have a HubSpot account yet
2. **Sign in to your HubSpot account** - If you already have an existing HubSpot account
Choose the appropriate option based on your situation. Most users will select **"Sign in to your HubSpot account"** to connect their existing CRM.
### Step 3: Choose Your HubSpot Account
After signing in, you'll see the account selection screen:
![Choose HubSpot Account]()
**Connecting NeuralTalk AI to HubSpot**
The integration app by **neuraltalk.ai** will display your available HubSpot accounts:
1. **Choose an account** from the list of available accounts
2. **Account Details** will show:
* **NAME**: Your HubSpot account name (e.g., NeuralTalk.ai)
* **DETAILS**: Your HubSpot domain and Portal ID
3. Select your desired account by clicking the radio button
4. Click **Choose Account** to proceed with the authorization
### Step 4: Verify Successful Connection
After successful authorization, you'll be redirected back to your NeuralTalk AI dashboard:
![Successful HubSpot Connection]()
The connection status will show:
* ✅ **HubSpot Connected**
* **Connected Portal**: Your HubSpot account details
* **Portal ID**: Your unique HubSpot Portal ID (e.g., 242947308)
* **Last Connected**: Date and time of connection
* **Token Expiry**: Current status of your access token
**Additional Information Displayed**:
* **Custom HubSpot Fields Created**: Expandable section showing the custom fields that were automatically created in your HubSpot account for storing chatbot data
You'll also see a red **Disconnect** button if you need to remove the integration later.
## How It Works
Once connected, your NeuralTalk AI-HubSpot integration will:
### 🎯 **Lead Capture Process**
1. **User Interaction**: When users engage with your chatbot and provide contact information
2. **Automatic Sync**: Contact details are instantly synced to your HubSpot CRM
3. **Lead Classification**: New contacts are automatically tagged with "NEW" lead status
4. **Context Preservation**: Complete conversation history is attached to each contact
### 📞 **Human Support Workflow**
1. **Support Request**: User requests human assistance through the chatbot
2. **Contact Creation**: A new contact (or update existing) is created in HubSpot
3. **Context Transfer**: Full conversation transcript is attached as a note
4. **Follow-up Ready**: Your team has complete context for immediate follow-up
### 🔄 **Data Synchronization**
* **Real-time Updates**: Contact information syncs instantly between platforms
* **Custom Fields**: Specialized fields store chatbot-specific information
* **Activity Timeline**: All interactions are recorded in HubSpot's timeline
* **Lead Scoring**: Integrate with HubSpot's lead scoring system
## Custom Fields Created
The integration automatically creates the following custom fields in your HubSpot contacts:
| Field Name | Description | Purpose |
| -------------------------- | -------------------------------------------- | -------------------------------------- |
| `chatbot_session_id` | Unique ID of the chat session | Track individual chat sessions |
| `chatbot_source` | Name of the chatbot that generated the lead | Identify which bot created the contact |
| `last_chatbot_interaction` | Timestamp of the last interaction | Track engagement recency |
| `human_support_requested` | Whether human support was requested | Flag contacts needing follow-up |
| `human_support_message` | The support request message from the user | Context for support teams |
| `conversation_history` | Complete chat transcript | Full conversation context |
| `platform` | Platform identifier (always "NeuralTalk AI") | Source identification |
**Additional Contact Properties**:
* **Lead Status**: Automatically set to "NEW" for all chatbot-generated contacts
* **Contact Notes**: Complete conversation history attached as detailed notes
* **Source**: Tagged as originating from NeuralTalk AI chatbot
* **Activity Timeline**: All interactions logged with timestamps
## Usage Examples
### Lead Generation Scenario
**Marketing Website Lead Capture**:
```
Visitor: "I'm interested in your premium plan"
Chatbot: "I'd be happy to help! May I get your email to send you detailed information?"
Visitor: "Sure, it's john@company.com"
Result in HubSpot:
✅ Contact created: John @ company.com
✅ Lead Status: NEW
✅ Source: NeuralTalk AI Chatbot
✅ Notes: Complete conversation attached
✅ Custom Fields: All chatbot data populated
```
### Customer Support Scenario
**Human Support Request**:
```
Customer: "I need help with my billing issue"
Chatbot: "I'll connect you with our support team. Please provide your email."
Customer: "sarah@business.com - My subscription isn't showing the right features"
Result in HubSpot:
✅ Contact created/updated: Sarah @ business.com
✅ Support Message: "My subscription isn't showing the right features"
✅ Human Support Requested: True
✅ Priority: High (for immediate follow-up)
✅ Full Context: Complete conversation history
```
### Sales Qualification Scenario
**Product Demo Request**:
```
Prospect: "Can you show me how your AI chatbot works?"
Chatbot: "Absolutely! I can schedule a demo. What's your email?"
Prospect: "mike@startup.com"
Chatbot: "What's your company size?"
Prospect: "We're a 50-person startup"
Result in HubSpot:
✅ Qualified Lead: Mike @ startup.com
✅ Company Size: 50 employees
✅ Interest Level: High (demo requested)
✅ Sales Stage: Demo Requested
✅ Follow-up: Automatic task created
```
## Advanced Configuration
### HubSpot Workflow Integration
**Automatic Lead Assignment**:
1. Create HubSpot workflows triggered by "Source = NeuralTalk AI"
2. Automatically assign leads to appropriate sales reps
3. Set up email notifications for high-priority leads
4. Create tasks for immediate follow-up
**Lead Scoring Enhancement**:
1. Assign points for chatbot engagement
2. Higher scores for human support requests
3. Bonus points for detailed conversations
4. Integration with existing lead scoring models
### Custom Field Mapping
**Additional Field Customization**:
1. **Industry Detection**: Map conversation topics to industry fields
2. **Company Size**: Extract company information from conversations
3. **Pain Points**: Identify and categorize customer challenges
4. **Product Interest**: Track which products/services were discussed
### Automation Rules
**Follow-up Automation**:
1. **Immediate**: Human support requests get instant notification
2. **Same Day**: High-intent leads assigned within 2 hours
3. **Weekly**: Regular lead nurturing sequences
4. **Monthly**: Re-engagement campaigns for inactive contacts
## Monitoring & Analytics
### HubSpot CRM Integration Analytics
**Contact Creation Metrics**:
* 📊 **Daily Contacts Created**: Track new contacts from chatbot interactions
* 📈 **Conversion Rates**: Percentage of chatbot users becoming leads
* 🎯 **Lead Quality Scores**: Average lead scores for chatbot-generated contacts
* 📞 **Support Request Volume**: Number of human support escalations
**Sales Pipeline Impact**:
* 💰 **Revenue Attribution**: Track deals originating from chatbot interactions
* ⏱️ **Sales Cycle Speed**: Compare chatbot leads vs other sources
* 🏆 **Win Rates**: Success rates for chatbot-generated opportunities
* 📊 **ROI Analysis**: Return on investment for chatbot integration
### Custom Reporting
**HubSpot Dashboard Setup**:
1. **Chatbot Lead Performance**: Custom report showing all NeuralTalk AI leads
2. **Conversation Quality**: Analysis of conversation length and engagement
3. **Support Escalation Trends**: Track human support request patterns
4. **Revenue Attribution**: Connect chatbot interactions to closed deals
## Troubleshooting
### Common Issues & Solutions
**🚫 Contacts Not Syncing**
1. **Check Connection**: Verify HubSpot integration shows "Connected"
2. **Token Validation**: Ensure access token hasn't expired
3. **Permissions**: Confirm account has proper HubSpot permissions
4. **API Limits**: Check if HubSpot API limits have been reached
**📊 Missing Custom Fields**
1. **Field Creation**: Custom fields are created automatically on first use
2. **Permission Check**: Ensure integration has field creation permissions
3. **Manual Creation**: Fields can be manually created in HubSpot if needed
4. **Field Mapping**: Verify field names match expected values
**⚠️ Duplicate Contacts**
1. **Email Matching**: HubSpot uses email as primary identifier
2. **Deduplication**: Enable HubSpot's automatic deduplication rules
3. **Data Cleanup**: Use HubSpot tools to merge duplicate contacts
4. **Prevention**: Set up proper matching rules in HubSpot
**🔄 Connection Issues**
1. **Token Refresh**: Disconnect and reconnect the integration
2. **Account Access**: Verify HubSpot account is active and accessible
3. **Network Issues**: Check for connectivity problems
4. **Service Status**: Check both HubSpot and NeuralTalk AI service status
### Getting Help
If you need assistance:
1. 📖 **Documentation**: Review this guide and troubleshooting section
2. 🧪 **Test Integration**: Try creating a test contact through the chatbot
3. 📧 **Support Team**: Contact [support@neuraltalk.ai](mailto:support@neuraltalk.ai)
4. 🎯 **HubSpot Support**: For HubSpot-specific issues, contact HubSpot support
## Best Practices
### CRM Organization
* 🏷️ **Lead Tagging**: Use consistent tags for chatbot-generated leads
* 📋 **Custom Views**: Create HubSpot views specifically for chatbot contacts
* 🎯 **Lead Scoring**: Incorporate chatbot engagement into lead scoring
* 📊 **Regular Cleanup**: Maintain data quality with regular contact audits
### Sales Process Optimization
* ⚡ **Quick Follow-up**: Respond to human support requests within 1 hour
* 📝 **Context Review**: Always check conversation history before contacting leads
* 🎯 **Personalization**: Use conversation context to personalize outreach
* 📈 **Performance Tracking**: Monitor conversion rates and optimize accordingly
### Data Management
* 🔄 **Regular Sync**: Monitor sync status and resolve issues quickly
* 📊 **Quality Control**: Review and improve chatbot responses based on lead quality
* 🎯 **Segmentation**: Use chatbot data for better contact segmentation
* 📈 **Reporting**: Create regular reports on chatbot lead performance
### Team Training
* 👥 **Sales Training**: Train sales team on using chatbot context
* 📚 **CRM Usage**: Ensure team understands custom fields and their purpose
* 🎯 **Follow-up Protocols**: Establish clear procedures for chatbot leads
* 📊 **Performance Reviews**: Regular assessment of chatbot-to-sale conversion
## Security Considerations
### Data Protection
* 🔐 **Encryption**: All data transmission encrypted using industry standards
* 🛡️ **Token Security**: HubSpot access tokens securely stored and managed
* 📋 **Compliance**: GDPR, CCPA, and SOX compliance maintained
* 🔍 **Audit Logs**: Complete audit trail of all data synchronization
### Access Control
* 🔑 **Permission Management**: Integration respects HubSpot's permission model
* 👤 **User Authentication**: Secure OAuth authentication with HubSpot
* 🏢 **Account Isolation**: Complete data isolation between different accounts
* ⏰ **Token Management**: Automatic token refresh and expiration handling
### Privacy Protection
* 👁️ **Data Minimization**: Only necessary contact data is synchronized
* 🗑️ **Data Retention**: Configurable data retention policies
* 📊 **Consent Management**: Integration with HubSpot's consent management
* 🔒 **PII Protection**: Special handling of personally identifiable information
## Pricing & Limits
### HubSpot API Limits
* 📊 **Daily Limits**: Standard HubSpot API limits apply (varies by plan)
* 👥 **Contact Limits**: No additional limits beyond your HubSpot plan
* 📁 **Storage**: Contact data counts toward HubSpot storage limits
* 📈 **Scaling**: Integration scales with your HubSpot plan tier
### NeuralTalk AI Integration
* ✅ **Included**: HubSpot integration included in all paid plans
* 💬 **Contact Sync**: No additional fees for contact synchronization
* 💰 **No Hidden Costs**: No setup fees or monthly integration charges
* 📊 **Full Analytics**: Complete integration analytics included
## Disconnecting Your Integration
To disconnect your HubSpot integration:
### From NeuralTalk AI Dashboard
1. **Navigate**: Go to **Settings > Chatbot Settings > Integrations**
2. **Find HubSpot**: Locate the HubSpot integration card
3. **Disconnect**: Click the red **Disconnect** button
4. **Confirm**: Confirm the disconnection when prompted
### What Happens When You Disconnect
* ✋ **Stops Syncing**: New chatbot interactions won't sync to HubSpot
* 📊 **Data Retained**: Existing contacts and data remain in HubSpot
* 🔄 **Reconnection**: You can reconnect anytime with the same account
* 🏷️ **Field Preservation**: Custom fields remain in your HubSpot account
### Data Cleanup (Optional)
If you want to remove chatbot-related data from HubSpot:
1. **Export Data**: Export chatbot contacts for backup
2. **Remove Contacts**: Delete contacts created by NeuralTalk AI (optional)
3. **Custom Fields**: Remove custom fields if no longer needed
4. **Workflows**: Update any workflows that reference NeuralTalk AI data
Disconnecting the integration doesn't automatically remove data from HubSpot. This gives you flexibility to reconnect without losing historical data.
## Use Cases by Industry
### **SaaS Companies**
* **Lead Qualification**: Pre-qualify leads before sales calls
* **Product Demos**: Capture demo requests with context
* **Feature Requests**: Track product feedback in CRM
* **Churn Prevention**: Identify at-risk customers early
### **E-commerce**
* **Customer Support**: Escalate complex issues with full context
* **Product Inquiries**: Capture interest in specific products
* **Return Requests**: Process returns with conversation history
* **Upsell Opportunities**: Identify expansion opportunities
### **Professional Services**
* **Consultation Requests**: Capture leads with specific needs
* **Project Inquiries**: Track potential projects and requirements
* **Client Onboarding**: Streamline new client intake process
* **Expertise Matching**: Connect clients with right specialists
### **Healthcare**
* **Appointment Scheduling**: Capture appointment requests
* **Insurance Verification**: Collect insurance information
* **Symptom Tracking**: Record patient concerns and symptoms
* **Follow-up Care**: Coordinate post-treatment communication
## Next Steps
After successful integration:
1. **🧪 Test the Integration**:
* Create test contacts through your chatbot
* Verify data appears correctly in HubSpot
* Test human support request workflow
* Check custom field population
2. **📊 Set Up HubSpot Workflows**:
* Create automated lead assignment rules
* Set up notification workflows for support requests
* Configure lead scoring for chatbot interactions
* Establish follow-up task automation
3. **👥 Train Your Team**:
* Educate sales team on chatbot lead context
* Establish follow-up procedures for different lead types
* Create guidelines for using conversation history
* Set up performance tracking and KPIs
4. **📈 Optimize Performance**:
* Monitor lead quality and conversion rates
* Analyze conversation patterns for improvements
* Adjust chatbot responses based on HubSpot data
* Continuously refine lead qualification process
5. **🔄 Scale Your Process**:
* Expand chatbot to more pages/channels
* Integrate additional HubSpot features
* Consider advanced automation opportunities
* Explore other NeuralTalk AI integrations
## Need Help?
For additional support with your HubSpot integration:
* 📧 **Email Support**: [support@neuraltalk.ai](mailto:support@neuraltalk.ai)
* 📖 **Documentation**: [neuraltalk.ai](https://neuraltalk.ai)
* 💬 **Community Discord**: Join our [Discord](https://discord.gg/tHpggadDAk) for peer support and tips
* 🎥 **Video Tutorials**: Check our YouTube channel for setup guides
* 🏢 **HubSpot Support**: [HubSpot's help documentation](https://knowledge.hubspot.com/) for CRM-specific questions
* 📚 **API Documentation**: [HubSpot API docs](https://developers.hubspot.com/) for advanced customization
***
*Ready to connect your HubSpot CRM? Click the **Connect** button in your NeuralTalk AI dashboard to get started and begin turning conversations into qualified leads!*
# 🛍️ Shopify Integration
Source: https://docs.neuraltalk.ai/integrations/shopify
Learn how to generate your Shopify Admin API Access Token — the key to securely connecting your store with external apps, automations, or integrations.
🎥 Refer to the setup video for a step-by-step visual guide:
## **⚙️ Prerequisites**
Before you begin, make sure you have:
* A **Shopify store** (any plan)
* Access to your **Shopify admin panel**
* Enable **Custom app development** (if first time)
## **🔧 Step 1: Enable Custom App Development**
To begin, allow custom app development for your store.
1. Log in to your **Shopify admin panel**
2. In the left sidebar, click on **Settings**
3. Under Settings, select **Apps and sales channels**
4. Click on **Develop apps** at the top-right corner of the page.
![shopifyaccesstoken1.png]( "shopifyaccesstoken1.png")
## **🧩 Step 2: Create a Custom App**
Once custom app development is enabled:
1. Click **Create an app** and give it a suitable name
2. Go to the **Configuration** tab
3. Under **Admin API integration**, choose the required **API scopes**
* Examples: read\_products, write\_orders, read\_customers, read\_product\_listings, read\_product\_feeds, read\_orders, read\_payment\_terms
4. Click **Save** to apply your settings
![shopifyaccesstoken2.png]( "shopifyaccesstoken2.png")
## **🔐 Step 3: Generate Your Admin API Access Token**
1. Navigate to the **API credentials** tab
2. Click **Install app** to activate it for your store
3. After installation, your **Admin API Access Token** will appear
4. **Copy and save it securely** — it will only be visible once
![shopifyaccesstoken3.png]( "shopifyaccesstoken3.png")
![shopifyaccesstoken4.png]( "shopifyaccesstoken4.png")
## **🔗 Step 4: Connect Your Shopify Store to NeuralTalk**
Once you’ve generated your **Admin API Access Token**, you can connect your Shopify store to your NeuralTalk dashboard.
1. Open your **NeuralTalk Dashboard**
2. Navigate to **Integrations → Shopify Integration**
3. Click **Connect Store** to open the connection popup
4. In the popup window:
* Enter your **Shopify Store URL**
* Paste your **Admin API Access Token** into the **Access Token** field
5. Click **Connect Store** to complete the integration
✅ Your Shopify store is now securely linked with NeuralTalk! You can start enabling product search, order tracking, and AI-powered chat features instantly
![shopifyaccesstoken5.png]( "shopifyaccesstoken5.png")
## **💡 Best Practices**
* 🔒 **Keep your token confidential** – never expose it publicly or commit it to GitHub
* ⚙️ **Use environment variables** to store the token in your project safely
* 🎯 **Grant minimal permissions** – only select the scopes your app actually needs
* 🧾 **Rotate tokens periodically** for better security
## **🧰 Troubleshooting**
**Token Not Visible**
* Make sure the app is fully installed
* Ensure you have the necessary admin permissions
**Permission or Access Errors**
* Revisit the **Configuration** tab and verify selected API scopes
* Reinstall the app after updating permissions
## **🚀 Next Steps**
Once you have your **Admin API Access Token**, you can:
* Connect your store with third-party applications
* Automate product, order, and customer data sync
Integrate AI assistants, analytics tools, or custom dashboards
Need help with your Shopify integration? Contact our [support team](mailto:support@neuraltalk.ai) for personalized assistance. For quick resolution and community support, join our [Discord community](https://discord.com/invite/tHpggadDAk).
# 💬 Slack Integration
Source: https://docs.neuraltalk.ai/integrations/slack
Connect your NeuralTalk AI chatbot to Slack and provide intelligent assistance to your team and customers directly in your workspace.
🎥 **Watch the setup video for a step-by-step visual guide:**
## Overview
The Slack integration enables your NeuralTalk AI chatbot to:
* 💼 **Assist team members** with internal knowledge and workflows
* 🎯 **Respond to customer inquiries** in shared channels
* 📨 **Provide instant support** in direct messages
* 🔔 **Answer questions** when mentioned in channels
* ⚡ **Enhance productivity** by automating routine queries
* 🤝 **Support team collaboration** and customer service
## Prerequisites
Before setting up your Slack integration, you need:
* ✅ An active NeuralTalk AI account
* 🤖 A created and trained chatbot on the NeuralTalk AI platform
* 🔑 Admin privileges in a Slack workspace
* 🏢 Access to your Slack workspace URL
## Setup Process
### Step 1: Access NeuralTalk AI Integration Settings
1. Log in to your NeuralTalk AI dashboard
2. Select the chatbot you want to connect to Slack
3. Navigate to **Settings** in the left sidebar
4. Click on **Chatbot Settings** from the expanded menu
5. Navigate to the **Integrations** tab at the top of the page
![Slack Integration Settings]()
6. Find the **Slack Integration** card
7. Click the **Connect** button to start the integration process
💡 **Note**: You'll need admin access to your Slack workspace to authorize the integration.
### Step 2: Enter Your Slack Workspace URL
When you click **Connect**, you'll be redirected to Slack's sign-in page:
![Slack Workspace Sign-in]()
1. **Enter Your Workspace URL**: Type your Slack workspace URL in the format `your-workspace.slack.com`
2. Click **Continue** to proceed to the next step
**Alternative Options**:
* Don't know your workspace URL? Click **Find your workspaces**
* Trying to sign in to a GovSlack Workspace? Click the **GovSlack** link
* Need to create a workspace? Click **Create a new workspace**
🔍 **Finding Your Workspace**: If you're unsure of your workspace URL, you can find it in your Slack app or by checking your browser URL when you're logged into Slack.
### Step 3: Authorize NeuralTalk AI Access
After entering your workspace URL, you'll see the OAuth permission screen:
![Slack OAuth Authorization]()
**Review the Permissions Request**:
The NeuralTalk\_Oauth\_test app is requesting permission to access your Slack workspace. You'll see what the app will be able to view and do:
**What will NeuralTalk be able to view?**
* 💬 Content and info about channels & conversations
* 🏢 Content and info about your workspace
**What will NeuralTalk be able to do?**
* ✍️ Perform actions in channels & conversations
* ⚙️ Perform actions in your workspace
1. **Review Permissions**: Carefully review the requested permissions
2. Click **Allow** to grant these permissions to NeuralTalk AI
3. Click **Cancel** if you want to abort the integration
⚠️ **Security Note**: NeuralTalk AI only requests the minimum permissions necessary to function and follows Slack's security best practices.
### Step 4: Verify Successful Connection
After successful authorization, you'll be redirected back to your NeuralTalk AI dashboard where you should see:
![Successful Slack Connection]()
The connection status will show:
* ✅ **Slack Connected**
* **Connected to workspace**: \[Your workspace name]
* **Team ID**: Your Slack workspace team ID
* **Connected Channels**: Number of channels the bot has access to
* **Last Connected**: Date of connection
* **Token Expiry**: Current status of your bot token
You'll also see a red **Disconnect** button if you need to remove the integration later.
## How It Works
Once connected, your NeuralTalk AI bot will:
### 📱 Direct Message Interactions
* **Instant Responses**: Responds to all messages sent directly to the bot
* **Private Support**: Handles confidential inquiries privately
* **Personal Assistant**: Acts as a personal AI assistant for team members
### 🏢 Channel Interactions
* **Mention-Based**: Only responds when explicitly mentioned (e.g., @NeuralTalk)
* **Thread Support**: Can participate in threaded conversations
* **Public Knowledge**: Shares knowledge accessible to all channel members
### 🧠 AI Processing
* **Context Aware**: Understands conversation context and history
* **Knowledge Base**: Leverages your trained knowledge base
* **Natural Language**: Processes and responds in natural language
## Usage Examples
### Team Collaboration Scenarios
**HR Inquiries**:
```
Team Member: "@NeuralTalk What's our PTO policy?"
Bot: "Our PTO policy allows 15 days of paid time off annually, accruing at 1.25 days per month. You can check your current balance in the HR portal. Need help accessing it?"
```
**Technical Support**:
```
Developer: "@NeuralTalk How do I deploy to staging?"
Bot: "To deploy to staging: 1) Create a PR to the staging branch 2) Get approval from a senior dev 3) Merge and the CI/CD pipeline will auto-deploy. Check the #deployments channel for status updates."
```
**Customer Support**:
```
Support Agent: "@NeuralTalk Customer asking about refund process"
Bot: "Our refund process: Customers can request refunds within 30 days of purchase. Process through the admin panel > Refunds section. Automatic approval for amounts under $50, manual review for higher amounts."
```
### Interactive Features
**Quick Commands**:
* `@NeuralTalk help` - Show available commands
* `@NeuralTalk status` - Check system status
* `@NeuralTalk docs [topic]` - Find documentation
**Smart Suggestions**: When team members ask questions, the bot can suggest:
* 📄 Relevant documentation links
* 👥 Subject matter experts to contact
* 🔗 Related tools or resources
💡 **Pro Tip**: For the best experience in busy channels, train your bot to give concise answers to common questions, and suggest private DMs for more detailed discussions.
## Troubleshooting
### Common Issues & Solutions
#### 🚫 Bot Not Responding in Channels
* **Check Mentions**: Ensure you're using @BotName to mention the bot
* **Channel Access**: Verify the bot has been added to the channel
* **Permissions**: Confirm the bot has necessary channel permissions
* **Connection Status**: Check integration status in NeuralTalk dashboard
#### 📱 Bot Not Responding in DMs
* **Direct Message**: Make sure you're in a direct message with the bot
* **Bot Online Status**: Verify the bot appears online in Slack
* **Token Validation**: Check if the access token is still valid
* **Workspace Access**: Confirm the bot hasn't been removed from the workspace
#### ⚠️ Permission Errors
* **Admin Rights**: Ensure you have admin rights to authorize the bot
* **Workspace Policies**: Check if your workspace has app restrictions
* **Re-authorization**: Try disconnecting and reconnecting the integration
* **IT Approval**: Some enterprises require IT approval for new apps
#### 🔄 Connection Issues
* **Token Expiry**: Slack tokens may expire and need renewal
* **Network Issues**: Check for network connectivity problems
* **API Limits**: Verify you haven't exceeded Slack's API rate limits
* **Service Status**: Check both Slack and NeuralTalk service status
## Best Practices
### Team Onboarding
* 📢 **Announce the Bot**: Let your team know about the new AI assistant
* 📚 **Create Guidelines**: Establish when and how to use the bot
* 🎯 **Set Expectations**: Explain what the bot can and cannot do
* 👥 **Train Champions**: Have power users help others learn
### Knowledge Management
* 🔄 **Keep Updated**: Regularly update your bot's knowledge base
* 🎯 **Focus Content**: Train on your team's most common questions
* 📊 **Analyze Usage**: Use analytics to identify knowledge gaps
* 🔍 **Quality Control**: Regularly review and improve responses
### Channel Strategy
* 🎯 **Strategic Placement**: Only add the bot to relevant channels
* 🤫 **Reduce Noise**: Configure quiet hours and response triggers
* 🧵 **Use Threads**: Encourage threaded conversations for detailed discussions
* 📋 **Clear Purpose**: Communicate each channel's bot usage purpose
### Security & Privacy
* 🔒 **Data Protection**: Understand what data the bot accesses
* 👥 **Access Control**: Regularly review who can interact with the bot
* 📋 **Audit Logs**: Monitor bot interactions for security
* 🔄 **Regular Reviews**: Periodically review permissions and access
## Disconnecting Your Integration
To disconnect your Slack integration:
### From NeuralTalk AI Dashboard
1. **Navigate**: Go to Settings > Chatbot Settings > Integrations
2. **Find Slack**: Locate the Slack integration card
3. **Disconnect**: Click the red Disconnect button
4. **Confirm**: Confirm the disconnection when prompted
### From Slack Workspace
1. **Workspace Settings**: Go to your Slack workspace settings
2. **Manage Apps**: Navigate to Apps > Manage
3. **Find NeuralTalk**: Locate the NeuralTalk AI app
4. **Remove**: Click Remove App to completely uninstall
## Need Help?
For additional support with your Slack integration:
* 📧 **Email Support**: [support@neuraltalk.ai](mailto:support@neuraltalk.ai)
* 📖 **Documentation**: docs.neuraltalk.ai
* 💬 **Community**: Join our Discord for peer support and tips
* 🎥 **Video Tutorials**: Check our YouTube channel for setup guides
* 📱 **Slack Support**: Slack's API documentation for platform-specific issues
## Next Steps
* [Discord Integration](/integrations/discord)
* [Telegram Integration](/integrations/telegram)
* [WhatsApp Integration](/integrations/whatsapp)
* [HubSpot Integration](/integrations/hubspot)
# ✈️ Telegram Integration
Source: https://docs.neuraltalk.ai/integrations/telegram
Connect your NeuralTalk AI chatbot to Telegram and provide instant AI-powered responses to your users or community members through this popular messaging platform.
🎥 Refer to the setup video for a step-by-step visual guide:
## Overview
The Telegram integration enables your NeuralTalk AI chatbot to:
* 🚀 **Reach customers** on one of the world's most popular messaging platforms
* ⚡ **Provide instant support** through automated responses
* 📱 **Share rich media content** including images, files, and links
* 👥 **Create group chats** for community engagement
* 🤖 **Handle both private conversations** and group interactions
* 🔧 **Process commands** with the "/" prefix for enhanced functionality
## Prerequisites
Before setting up your Telegram integration, you need:
* ✅ An active NeuralTalk AI account
* 🤖 A created and trained chatbot on the NeuralTalk AI platform
* 📱 A Telegram account
* 🔑 Access to create bots through BotFather
💡 **Note**: You'll need to create a Telegram bot through @BotFather first before connecting it to NeuralTalk AI.
## Setup Process
### Step 1: Access NeuralTalk AI Integration Settings
1. Log in to your NeuralTalk AI dashboard
2. Select the chatbot you want to connect to Telegram
3. Navigate to **Settings** in the left sidebar
4. Click on **Chatbot Settings** from the expanded menu
5. Navigate to the **Integrations** tab at the top of the page
![Telegram Integration Settings]()
6. Find the **Telegram Integration** card
7. Click the **Connect** button to start the integration process
### Step 2: Create Your Telegram Bot
When you click **Connect**, you'll see the bot creation modal:
![Connect Your Telegram Bot - Step 1]()
Follow these steps to create your Telegram bot through the official BotFather:
**Create your own Telegram bot through the official BotFather:**
1. **Open Telegram** and search for **@BotFather**
2. **Start a conversation** with BotFather by clicking "Start" or sending `/start`
3. **Start a chat** with BotFather and send the command `/newbot`
4. **BotFather will guide you** through the bot creation process
5. **Follow the instructions** to choose a name and username for your bot:
* **Bot Name**: Choose a descriptive name that represents your business or service
* **Username**: Must end with "bot" (e.g., my\_company\_bot)
* **Requirements**: The username must be unique across all Telegram bots
6. **After completion**, BotFather will provide a token for your bot. Copy this token for the next step
The token will look like: `123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ`
⚠️ **Important**: Keep this token secure and don't share it publicly
💡 **Tips**:
* Choose a descriptive name that represents your business or service
* The username must end with "bot" (e.g., my\_company\_bot)
* Keep your token secure and don't share it publicly
Once you have your token, click **Next** to proceed to the connection step.
### Step 3: Connect Your Bot to NeuralTalk AI
After creating your bot and obtaining the token, you'll proceed to the connection step:
![Connect Your Telegram Bot - Step 2]()
Enter your bot's details to connect it to NeuralTalk AI:
**Bot Token**:
* Paste the token provided by BotFather when you created your bot
* This token is required for NeuralTalk AI to communicate with your Telegram bot
**Bot Username**:
* Enter the username of your bot (without the @ symbol)
* This should match the username you set when creating the bot
![Connect Your Telegram Bot - Final Step]()
**What happens next**:
* ✅ We'll verify your bot token and set up a webhook
* 🤖 Your bot will be configured to receive and respond to messages
* 👥 Users can start chatting with your bot immediately
Click **Connect Bot** to complete the integration
### Step 4: Verify Successful Connection
After successful connection, you'll see the integration status updated:
The connection status will show:
* ✅ **Telegram Integration Connected**
* **Connected Bot**: Your bot's username
* **Bot Status**: Active/Connected
* **Last Connected**: Date and time of connection
* **Webhook Status**: Verified and active
You'll also see a red **Disconnect** button if you need to remove the integration later.
## How It Works
Once connected, your NeuralTalk AI Telegram bot will:
### 📱 Private Chat Interactions
* **Direct Messages**: Responds to all messages sent directly to the bot
* **Instant Support**: Provides immediate assistance to users
* **Personal Assistant**: Acts as a 24/7 AI assistant for your customers
### 👥 Group Chat Interactions
* **Mention-Based**: Responds when explicitly mentioned (e.g., @your\_bot\_name)
* **Command Support**: Processes commands with the "/" prefix
* **Community Engagement**: Facilitates group discussions and support
### 🧠 AI Processing
* **Context Aware**: Understands conversation context and history
* **Knowledge Base**: Leverages your trained knowledge base
* **Natural Language**: Processes and responds in natural language
* **Rich Media**: Can share images, documents, and formatted messages
## Usage Examples
### Private Chat Scenarios
**Customer Support**:
```
Customer: "What are your business hours?"
Bot: "We're open Monday-Friday 9 AM to 6 PM EST. For urgent matters outside these hours, please describe your issue and we'll respond first thing in the morning!"
```
**Product Information**:
```
Customer: "Tell me about your premium plan"
Bot: "Our Premium plan includes: ✅ Unlimited chatbot interactions ✅ Advanced analytics ✅ Priority support ✅ Custom integrations. Would you like me to help you upgrade?"
```
### Group Chat Scenarios
**Community Support**:
```
User: "@your_bot How do I reset my password?"
Bot: "To reset your password: 1) Go to the login page 2) Click 'Forgot Password' 3) Enter your email 4) Check your inbox for reset instructions. Need more help? DM me!"
```
**FAQ Responses**:
```
User: "@your_bot /help"
Bot: "Here are some things I can help with:
🔧 Technical support
💰 Billing questions
📋 Account management
💬 General inquiries
Just mention me or send me a DM!"
```
## Bot Commands
Set up helpful commands for easy interaction:
* `/start` - Welcome message and bot introduction
* `/help` - List of available commands and capabilities
* `/support` - Direct link to human support
* `/status` - Check service status
* `/contact` - Contact information
## Advanced Configuration
### Bot Commands Setup
Configure custom commands through BotFather:
1. Open chat with **@BotFather**
2. Send `/setcommands`
3. Select your bot
4. Enter commands in this format:
```
start - Get started with the bot
help - Show available commands
support - Contact human support
status - Check service status
contact - Get contact information
```
### Group Chat Settings
Configure your bot's behavior in groups:
**Privacy Mode**:
* **Enabled**: Bot only sees messages that mention it or are replies to it
* **Disabled**: Bot sees all messages in the group
* Configure via BotFather: `/mybots > Select Bot > Bot Settings > Privacy Mode`
**Group Admin Rights**:
* Add your bot as an admin for enhanced functionality
* Allows bot to manage messages, users, and group settings
### Message Formatting
Your bot supports rich Telegram formatting:
* **Bold text**: `*bold*`
* **Italic text**: `_italic_`
* **Inline code**: `` `code` ``
* **Links**: `[text](URL)`
* **Mentions**: `@username`
## Monitoring & Analytics
Track your Telegram integration performance:
### Key Metrics Dashboard
**Message Volume**:
* Daily/weekly message counts
* Private vs group chat distribution
* Peak usage hours
**User Engagement**:
* New users joining daily
* Most active users
* Popular commands and queries
**Response Performance**:
* Average response time
* Success rate
* User satisfaction scores
**Growth Metrics**:
* User acquisition trends
* Retention rates
* Conversation completion rates
### Detailed Analytics
Access comprehensive analytics in your NeuralTalk AI dashboard:
1. Go to **Analytics > Channels**
2. Select the **Telegram** tab
3. View detailed metrics and trends
4. Export data for further analysis
## Troubleshooting
### Common Issues & Solutions
#### 🚫 Bot Not Responding
* **Check Connection Status**: Verify integration shows "Connected" in dashboard
* **Test Commands**: Try sending `/start` in a private chat
* **Webhook Issues**: Disconnect and reconnect the integration
* **Token Validation**: Ensure the bot token is correct and active
#### 👥 Group Chat Issues
* **Privacy Mode**: Check if privacy mode is affecting message visibility
* **Bot Permissions**: Ensure bot has permission to send messages
* **Mention Format**: Use proper @botname format for mentions
* **Admin Rights**: Consider making the bot an admin for better functionality
#### 🔑 Token Problems
* **Invalid Token**: Regenerate token via BotFather (`/token` command)
* **Expired Token**: Tokens don't expire but can be revoked
* **Wrong Token**: Double-check you're using the correct bot's token
* **Security**: Never share your token publicly
#### ⚡ Performance Issues
* **Response Delays**: Check your plan's message limits
* **Rate Limiting**: Telegram has API rate limits that may affect high-volume bots
* **Knowledge Base**: Ensure your bot's knowledge base is optimized
* **Server Status**: Check NeuralTalk AI service status
### Getting Help
If you need assistance:
* 📖 **Documentation**: Review this guide and troubleshooting section
* 🧪 **Test Environment**: Try the bot in a private chat first
* 📧 **Support Team**: Contact [support@neuraltalk.ai](mailto:support@neuraltalk.ai)
* 💬 **Community**: Join our Discord community for peer support
## Best Practices
### Bot Setup
* 🎯 **Clear Purpose**: Define what your bot can and cannot do
* 📝 **Welcome Message**: Create a helpful `/start` command response
* 🔤 **Consistent Naming**: Use a clear, professional bot name and username
* 📱 **Profile Setup**: Add a profile picture and description via BotFather
### User Experience
* ⚡ **Quick Responses**: Keep initial responses concise and helpful
* 🎯 **Clear Commands**: Set up intuitive commands with descriptions
* 🔄 **Fallback Options**: Provide alternatives when the bot can't help
* 👤 **Human Escalation**: Include options to contact human support
### Content Strategy
* 📚 **Knowledge Base**: Keep your bot's training data current and comprehensive
* 🎯 **Targeted Responses**: Tailor responses to common user intents
* 🌍 **Multi-language**: Consider supporting multiple languages if needed
* 📊 **Analytics-Driven**: Use conversation data to improve responses
### Security & Privacy
* 🔒 **Token Security**: Never share your bot token publicly
* 👥 **User Privacy**: Respect user privacy and data protection laws
* 🛡️ **Content Filtering**: Implement appropriate content moderation
* 📋 **Terms of Service**: Include clear terms for bot usage
## Security Considerations
### Data Protection
* 🔐 **Encryption**: All messages are encrypted in transit
* 🛡️ **Secure Storage**: Bot tokens are securely encrypted and stored
* 📋 **Compliance**: GDPR and other privacy regulations supported
* 🔍 **Audit Logs**: Complete conversation logging for security reviews
### Access Control
* 🔑 **Bot Permissions**: Minimal required permissions for functionality
* 👤 **User Authentication**: Integration with Telegram's user system
* 🏢 **Organization Control**: Admin controls for bot management
* ⏰ **Session Management**: Secure session handling and token refresh
### Privacy Protection
* 👁️ **Data Minimization**: Only processes necessary message data
* 🗑️ **Data Retention**: Configurable message retention policies
* 📊 **Analytics Privacy**: Option to disable usage analytics
* 🔒 **Private Groups**: Respects private group confidentiality
## Pricing & Limits
### Telegram API Limits
* 📊 **Rate Limits**: Standard Telegram Bot API limits apply
* 💬 **Message Limits**: 30 messages per second per bot
* 👥 **Group Limits**: Up to 200,000 members per group
* 📁 **File Sharing**: Up to 50MB file uploads supported
### NeuralTalk AI Integration
* ✅ **Included**: Telegram integration included in all paid plans
* 💬 **Message Processing**: Counted toward your plan's message limits
* 💰 **No Hidden Fees**: No additional setup or monthly fees
* 📊 **Full Analytics**: Complete analytics included in all plans
## Disconnecting Your Integration
To disconnect your Telegram integration:
### From NeuralTalk AI Dashboard
1. **Navigate**: Go to Settings > Chatbot Settings > Integrations
2. **Find Telegram**: Locate the Telegram integration card
3. **Disconnect**: Click the red Disconnect button
4. **Confirm**: Confirm the disconnection when prompted
### What Happens When You Disconnect
* ✋ **Stops Processing**: NeuralTalk AI stops processing new messages
* 🤖 **Bot Remains**: Your Telegram bot still exists but becomes inactive
* 📊 **Data Retained**: Previous conversation data remains in analytics
* 🔄 **Reconnection**: You can reconnect anytime with the same bot token
### Complete Bot Removal
To completely remove your bot from Telegram:
1. Contact **@BotFather**
2. Send `/deletebot`
3. Select your bot to permanently delete it
4. Confirm deletion when prompted
⚠️ **Warning**: Deleting your bot through BotFather is permanent and cannot be undone.
## Integration Showcase
💬 **WhatsApp** - Business messaging and customer support
💬 **Discord** - Community engagement and server management
💼 **Slack** - Team collaboration and workplace automation
🔄 **More Coming** - Continuously expanding integration ecosystem
## Next Steps
After successful integration:
### 🧪 Test Your Bot:
* Send test messages in private chat
* Test group functionality if applicable
* Verify all commands work correctly
* Check response accuracy and timing
### 📚 Optimize Your Knowledge Base:
* Add Telegram-specific information
* Include common user questions and scenarios
* Update with platform-specific features and limitations
* Train on conversation patterns
### 📢 Launch & Promote:
* Share your bot with your community
* Add bot link to your website and social media
* Create promotional content explaining bot capabilities
* Encourage user feedback and engagement
### 📊 Monitor & Improve:
* Track usage analytics and user satisfaction
* Identify common questions and pain points
* Regularly update and improve responses
* Scale based on user adoption
### 🔄 Expand Features:
* Set up advanced commands and workflows
* Integrate with other business systems
* Consider premium features for power users
* Explore automation opportunities
## Need Help?
For additional support with your Telegram integration:
* 📧 **Email Support**: [support@neuraltalk.ai](mailto:support@neuraltalk.ai)
* 📖 **Documentation**: docs.neuraltalk.ai
* 💬 **Community Discord**: Join our Discord for peer support and tips
* 🎥 **Video Tutorials**: Check our YouTube channel for setup guides
* 📱 **Telegram Support**: Telegram Bot API documentation for platform-specific questions
* 🤖 **BotFather Help**: Use `/help` command with @BotFather for bot management questions
# 📱 WhatsApp Integration
Source: https://docs.neuraltalk.ai/integrations/whatsapp
Connect your NeuralTalk AI chatbot to WhatsApp and provide intelligent responses to your customers directly through the world's most popular messaging platform.
Connect your NeuralTalk AI chatbot to WhatsApp and provide intelligent responses to your customers directly through the world's most popular messaging platform.
![WhatsApp Integration]()
## Overview
The WhatsApp integration allows your NeuralTalk AI chatbot to:
* **Respond to customers** via WhatsApp Business messages
* **Handle customer support** inquiries automatically
* **Process orders** and provide product information
* **Send automated notifications** and updates
* **Scale your customer service** with AI-powered responses
* **Support multimedia messages** (text, images, documents)
## Prerequisites
Before setting up your WhatsApp integration, you need:
* An active NeuralTalk AI account
* A created and trained chatbot on the NeuralTalk AI platform
* A Facebook account (for Meta Business integration)
* A WhatsApp Business account
* Access to WhatsApp Business API (Meta Business account)
* A verified business phone number
## Setup Process
### Step 1: Access NeuralTalk AI Integration Settings
1. Log in to your NeuralTalk AI dashboard
2. Select the chatbot you want to connect to WhatsApp
3. Navigate to **Settings** in the left sidebar
4. Click on **Chatbot Settings** from the expanded menu
5. Navigate to the **Integrations** tab at the top of the page
![WhatsApp Integration Settings]()
6. Find the **WhatsApp Integration** card
7. Click the **Connect** button to start the integration process
💡 **Note**: You'll need a WhatsApp Business Account to connect. The integration requires Facebook/Meta authentication as WhatsApp Business API is managed through Meta Business.
### Step 2: Facebook Authentication for WhatsApp Business
When you click **Connect**, you'll be redirected to Facebook's login page to authenticate your account:
**Enter Facebook Credentials**:
* Email address or phone number associated with your Facebook account
* Password for your Facebook account
* Click **Log in** to proceed
* If you don't have a Facebook account, click **Create New Account** to set one up
* Complete any two-factor authentication if enabled on your account
⚠️ **Important**: You must use a Facebook account that has access to your WhatsApp Business account or Meta Business Manager.
### Step 3: Set Up WhatsApp Business API
After successful Facebook authentication, you'll need to configure your WhatsApp Business API:
**Meta Business Account Setup**:
1. Go to Meta Business Manager
2. Create or select your business account
3. Add your WhatsApp Business account to the business manager
**WhatsApp Business API Configuration**:
1. Navigate to WhatsApp Manager in your Meta Business account
2. Add and verify your business phone number
3. Complete the business verification process
4. Generate API access credentials
**API Credentials**:
* Save your Phone Number ID
* Copy your Access Token
* Note your Business Account ID
🔐 **Security**: Keep your access token secure. This token allows access to your WhatsApp Business API and should never be shared publicly.
### Step 4: Complete NeuralTalk AI Integration
Back in your NeuralTalk AI dashboard:
**Enter WhatsApp Business API Credentials**:
* Phone Number ID from Meta Business
* Access Token from WhatsApp Business API
* Business Account ID
* Webhook verification token (if required)
**Configure Integration Settings**:
* Set up welcome messages
* Configure business hours
* Define auto-response settings
* Set up escalation rules
**Test Connection**:
* Send a test message to verify the integration
* Check that responses are working correctly
* Verify webhook connectivity
* Click **Save** to establish the connection
### Step 5: Configure Webhook and Permissions
**Webhook Setup**:
1. In Meta Developer Portal, configure webhook URL provided by NeuralTalk AI
2. Subscribe to webhook events:
* `messages`
* `message_deliveries`
* `message_reads`
* `message_status`
**App Permissions**:
* Ensure your app has necessary WhatsApp permissions
* Submit for app review if required for production use
* Configure message templates for automated responses
## How It Works
Once connected, your NeuralTalk AI WhatsApp bot will:
* **Incoming Messages**: Automatically respond to messages sent to your WhatsApp Business number
* **Media Support**: Handle text messages, images, documents, and voice messages
* **Template Messages**: Send structured notifications and updates
* **Interactive Messages**: Support buttons and quick replies for better user experience
* **Session Management**: Maintain conversation context for natural interactions
## Usage Examples
### Customer Support Scenarios
**Product Inquiries**:
```
Customer: "Do you have iPhone 15 in stock?"
Bot: "Yes! We have iPhone 15 available in all colors. Current price is $799. Would you like me to reserve one for you or provide more details about specifications?"
```
**Order Status**:
```
Customer: "Where is my order #12345?"
Bot: "Let me check that for you! Order #12345 was shipped yesterday and is currently in transit. Expected delivery: Tomorrow by 3 PM. Track your package: [tracking link]"
```
**Business Hours**:
```
Customer: "Are you open now?"
Bot: "We're currently open! Our hours are Monday-Friday 9 AM to 6 PM, Saturday 10 AM to 4 PM. How can I help you today?"
```
### Interactive Features
**Quick Replies**:
* "Check Order Status"
* "Browse Products"
* "Contact Support"
* "Store Locations"
**Button Actions**:
* \[View Catalog] \[Track Order] \[Get Support]
💡 **Pro Tip**: Use WhatsApp's interactive message features like buttons and quick replies to create a more engaging customer experience and reduce response time.
## Advanced Configuration
### Message Templates
Set up approved message templates for business-initiated conversations:
**Order Confirmations**:
```
Hi {{customer_name}}! Your order #{{order_number}} has been confirmed.
Total: ${{amount}}. Estimated delivery: {{delivery_date}}.
```
**Shipping Notifications**:
```
Good news! Your order #{{order_number}} has shipped.
Track it here: {{tracking_link}}
```
**Appointment Reminders**:
```
Reminder: You have an appointment tomorrow at {{time}}.
Reply CONFIRM to confirm or RESCHEDULE to change.
```
### Interactive Elements Configuration
**Quick Reply Setup**:
1. Navigate to **Chatbot Settings > Integrations > WhatsApp**
2. Go to "Quick Replies" section
3. Add common responses like:
* "Yes" / "No"
* "More Info"
* "Speak to Agent"
* "Check Hours"
**Button Messages**:
Create action buttons for:
* "View Products"
* "Track Order"
* "Get Support"
* "Find Store"
### Business Hours & Auto-Responses
Configure automated responses for different scenarios:
**Business Hours**:
* Set operating hours for immediate responses
* Configure after-hours auto-replies
* Set up weekend/holiday messages
**Auto-Escalation**:
* Define keywords that trigger human handoff
* Set up escalation rules for complex queries
* Configure VIP customer routing
## Media & File Handling
Your WhatsApp bot can process various media types:
### Supported Media Types
* 📷 **Images**: Product photos, receipts, screenshots (up to 5MB)
* 📄 **Documents**: PDFs, invoices, manuals (up to 100MB)
* 🎵 **Audio**: Voice messages, audio files (up to 16MB)
* 🎥 **Video**: Product demos, tutorials (up to 16MB)
* 📍 **Location**: Store locations, delivery addresses
### Media Response Examples
**Customer sends product image** →
```
Bot: "I can see you're interested in our wireless headphones!
These are currently $199 with free shipping.
Would you like to know more about features or place an order?"
```
## Monitoring & Analytics
Track your WhatsApp integration performance through your NeuralTalk AI dashboard:
### Key Metrics to Monitor
**Message Volume**:
* Daily/weekly message counts
* Peak usage hours
* Response time averages
**Engagement Rates**:
* Response rates to interactive messages
* Button click-through rates
* Quick reply usage
**Customer Satisfaction**:
* Conversation resolution rates
* Escalation frequency
* Customer feedback scores
**Popular Topics**:
* Most asked questions
* Product inquiry trends
* Support ticket categories
## Compliance & Best Practices
### WhatsApp Business Policy Compliance
**✅ Required Practices**:
* Only message customers who have opted in
* Respect the 24-hour messaging window for promotional content
* Use approved message templates for notifications
* Handle opt-out requests immediately
* Maintain professional communication standards
**❌ Avoid These**:
* Sending unsolicited promotional messages
* Using non-approved message templates
* Ignoring customer opt-out requests
* Sharing customer data inappropriately
### Message Quality Guidelines
**Best Practices**:
* Keep responses relevant and helpful
* Use clear, concise language
* Provide accurate, up-to-date information
* Include helpful links or resources when appropriate
* Maintain consistent brand voice across all interactions
* Respond promptly (within business hours)
## Troubleshooting
### Common Issues & Solutions
#### 🚫 Bot Not Responding
* **Check Connection Status**: Verify integration shows "Connected" in dashboard
* **Verify Phone Number**: Confirm WhatsApp Business number is active and verified
* **API Access**: Check if access token is valid and hasn't expired
* **Webhook Status**: Ensure webhook URL is receiving events properly
#### 📱 Message Delivery Issues
* **Rate Limits**: Check if you've exceeded WhatsApp API rate limits
* **Template Approval**: Verify message templates are approved by Meta
* **Policy Compliance**: Ensure messages comply with WhatsApp's policies
* **API Errors**: Review integration logs for error messages
#### ⭐ Quality Rating Problems
* **Customer Feedback**: Review and address customer complaints promptly
* **Message Relevance**: Ensure all messages are relevant and not spam
* **Opt-out Compliance**: Honor opt-out requests immediately
* **Quality Guidelines**: Follow WhatsApp's messaging best practices
### Getting Support
If you need help:
* Check the troubleshooting section above
* Review Meta's WhatsApp Business API documentation
* Contact NeuralTalk AI support at [support@neuraltalk.ai](mailto:support@neuraltalk.ai)
* Join our community Discord for peer support
## Security & Privacy
### Data Protection
* 🔒 All communication encrypted end-to-end
* 🛡️ Secure API token storage and handling
* 📋 GDPR and privacy regulation compliance
* 🔐 Regular security audits and monitoring
### Best Security Practices
* Keep API credentials secure and never share publicly
* Use webhook URLs with proper authentication
* Monitor for unusual activity or abuse
* Implement proper data retention policies
* Regular access token rotation
## Pricing & Limits
### WhatsApp Business API Costs
* 💬 **Business-initiated conversations**: Charged per conversation
* 🆓 **Customer-initiated conversations**: Free for 24 hours
* 📨 **Template messages**: Required for business-initiated messages
* 📊 **Rate limits**: Based on business verification status
### NeuralTalk AI Integration
* WhatsApp integration included in all paid plans
* Message processing counted toward your plan limits
* No additional setup fees or hidden costs
## Disconnecting Your Integration
To disconnect your WhatsApp integration:
### In NeuralTalk AI Dashboard:
1. Go to **Settings > Chatbot Settings > Integrations**
2. Find WhatsApp card and click **Disconnect**
3. Confirm disconnection when prompted
### In Meta Business Manager:
1. Remove webhook configuration
2. Revoke API access tokens if no longer needed
3. Update app permissions as necessary
### Clean Up:
* Export any important conversation data
* Notify customers of service changes if needed
* Update your business contact information
## Next Steps
After successful integration:
### 🧪 Test Thoroughly:
Send test messages and verify all features work
### 📚 Train Your Bot:
Update knowledge base with WhatsApp-specific information
### 📢 Announce to Customers:
Let customers know about your new WhatsApp support
### 📊 Monitor Performance:
Track metrics and optimize based on usage patterns
### 🔄 Iterate and Improve:
Regularly update responses and add new features
## Need Help?
For additional support with your WhatsApp integration:
* 📧 **Email Support**: [support@neuraltalk.ai](mailto:support@neuraltalk.ai)
* 📖 **Documentation**: docs.neuraltalk.ai
* 💬 **Community**: Join our Discord for peer support
* 🎥 **Video Tutorials**: Check our YouTube channel for setup guides
# 📊 Analytics
Source: https://docs.neuraltalk.ai/logs/analytics
Complete guide to monitoring and analyzing your chatbot performance
🎥 Refer to the setup video for a step-by-step visual guide:
## Overview
The **Analytics** feature provides powerful insights into how your chatbot is performing. It helps you track conversations, measure engagement, analyze chat quality, and understand user behavior through interactive graphs and key performance metrics.
This guide explains how to view analytics data, apply date filters, export reports, and interpret analytics sections.
## Accessing Analytics
* Log in to your dashboard
* Navigate to **Logs and Tracking** from the main menu
* Click on **Analytics** in the left sidebar
* The Analytics page loads with charts and performance metrics
* By default, data is shown for **Today**
![Analytics Dashboard]()
## Analytics Interface Overview
The Analytics dashboard is organized into multiple sections to give a complete view of chatbot performance.
### Date Range Filters
Use the date selector at the top of the page to filter analytics data.
* **Quick Date Filters**
* **Custom Range**
## Exporting Analytics Data
You can export analytics data for reporting or further analysis.
Download analytics data in CSV format for spreadsheets and reports.
Export raw analytics data in JSON format for technical analysis or integrations.
***
## Analytics Sections
### Overview Metrics
The **Overview** section displays key performance indicators at a glance.
* **Total Sessions**: Total number of chat conversations during the selected time period.
* **Total Messages**: Total number of messages exchanged between users and the chatbot.
* **Message Credits Used**: Number of message credits consumed in the selected time range.
* **Avg. Messages per Session**: Average number of messages in each chat session.
### Message Activity
The **Message Activity** graph shows message volume over time.
* Message count trends
* Peak usage times
* Daily or hourly activity patterns
Helps you understand user engagement and chatbot usage patterns.
### Session Activity
The **Session Activity** graph tracks chatbot sessions over time.
* Number of chat sessions
* Growth or decline in usage
* Engagement trends
Indicates how often users start conversations with your chatbot.
### Chat Quality Distribution
This section classifies conversations based on quality.
Conversations with positive engagement or successful outcomes.
Conversations with average or mixed engagement.
Conversations where the chatbot may not have met user expectations.
## Best Practices
* Monitor analytics regularly to track chatbot performance
* Use message and session trends to identify peak usage
* Review chat quality to improve responses and training
* Export data for deeper analysis and reporting
## Next Steps
View and manage human support requests
Manage live chat sessions and provide real-time support
# 🧾 Chatlogs
Source: https://docs.neuraltalk.ai/logs/chatlogs
Complete guide to viewing, searching, and managing your chatbot conversation history
🎥 Refer to the setup video for a step-by-step visual guide:
## Overview
The **Chatlogs** feature lets you view and manage all conversations handled by your chatbot. It helps you monitor interactions, investigate user issues, and analyze chatbot performance by providing detailed conversation history with powerful search and filtering options.
This guide walks you through how to access Chatlogs, search conversations, and apply date based filters.
## Accessing Chatlogs
* Log in to your dashboard
* Navigate to **Logs and Tracking** from the main menu
* Click on **Chatlogs** in the left sidebar
* The Chatlogs screen opens with available conversation history
* If no data is available, you’ll see **No chat history found**
![Chatlogs Dashboard]()
## Chatlogs Interface
The Chatlogs interface is divided into three main sections for easier navigation and analysis.
### Search & Filters
Use the top search bar and filters to quickly locate conversations.
* **Search by Lead Data**: Find conversations using user-related information such as name, email, or other lead fields (if enabled).
* **Search by Session ID**: Locate a specific conversation by entering its unique session ID. This is especially useful for debugging or customer support cases.
* **Search by Message**: Use the **Search message** field to find specific keywords or phrases inside chat conversations.
### Chat List
The left panel displays conversations based on applied filters.
* **All Chats**: Displays every conversation associated with the chatbot.
* **Active Chats**: Shows currently ongoing or open conversations.
* **Closed Chats**: Displays completed or ended conversations.
If no conversations match your criteria, the system will display:\
**No chat history found**
### Chat Details
The right panel shows detailed information for the selected chat.
* **Conversation Messages**: View the full conversation between the user and the chatbot in chronological order.
* **Chat Metadata**: View additional chat details and session information.
## Filtering Chats by Date
You can narrow down conversations using predefined or custom date filters.
### Quick Date Filters
View conversations from the current day.
View conversations from the previous day.
View conversations from the current week.
View conversations from the current month.
### Custom Date Range
Choose **Custom Range** from the date filter options.
* Select a **Start Date**
* Select an **End Date**
* Click **Apply** to filter chats
* Click **Clear** to reset the filters
## No Chat History Found
You may see **No chat history found** when:
* No conversations occurred during the selected time range
* Applied filters are too restrictive
* The chatbot has not received any user messages yet
## Best Practices
* Review Chatlogs regularly to improve chatbot responses
* Use session ID search for faster issue resolution
* Filter chats by date to analyze trends over time
* Monitor closed chats to identify recurring user queries
## Next Steps
Analyze chatbot performance and engagement metrics
View and manage human support requests
# 🤝 Human Support
Source: https://docs.neuraltalk.ai/logs/human-support
Complete guide to viewing and managing human support requests from chatbot conversations
🎥 Refer to the setup video for a step-by-step visual guide:
## Overview
The **Human Support** feature allows you to view and manage conversations where users request assistance from a human agent. This helps teams step in at the right time, resolve complex queries, and ensure a better support experience when automation alone is not enough.
This guide explains how to access human support requests, search conversations, apply filters, and view request details.
## Accessing Human Support
* Log in to your dashboard
* Navigate to **Human Support** from the main menu
* The Human Support page loads with available requests
* If no requests exist, you’ll see **No human support requests found**
![Human Support Dashboard]()
## Human Support Overview
The Human Support is designed to help you quickly find and manage support requests.
### Search & Filters
Use the top search bar and filters to locate specific support requests.
* **Search in Messages**: Search for keywords or phrases within support request conversations using the **Search message** field.
* **Request Status Filters**: Filter support requests by status: All Requests, Open, In Progress, Resolved, Closed
### Date Range Filters
Narrow down support requests by selecting a time range.
* **Quick Date Filters**
* **Custom Range**
## Support Requests List
The left panel displays all support requests based on selected filters.
* **All Requests**: Displays every human support request.
* **Open**: Requests that are newly created and awaiting action.
* **In Progress**: Requests currently being handled by a human agent.
* **Resolved**: Requests that have been successfully addressed.
* **Closed**: Requests that are completed and archived.
If no requests match the selected filters, the system displays:\
**No human support requests found**
## Support Request Details
The right panel shows detailed information for the selected support request.
* **Conversation Messages**: View the full conversation between the user, chatbot, and human agent.
* **Support Details**: View request-related information and current status.
## When Support Requests Appear
Support requests are created when:
* A user explicitly requests human assistance
* The chatbot escalates the conversation to a human agent
* Automated responses are insufficient for the user’s needs
## Best Practices
* Regularly monitor open requests to reduce response time
* Use message search to quickly locate specific issues
* Update request status as it progresses
* Review resolved requests to improve chatbot training
# 💬 Live Chat
Source: https://docs.neuraltalk.ai/logs/live-chat
Complete guide to managing live chat sessions and providing real-time human support
🎥 Refer to the setup video for a step-by-step visual guide:
## Overview
The **Live Chat** feature enables your team to manage real-time chat sessions and provide instant human support to users. It allows agents to monitor chat status, filter sessions, and actively respond to users when immediate assistance is required.
This guide explains how to access live chats, filter sessions, and manage live conversations effectively.
## Accessing Live Chat
* Log in to your dashboard
* Navigate to **Live Chat** from the main menu
* The Live Chat page loads with available chat sessions
* Sessions are listed based on selected filters and date range
![Live Chat Dashboard]()
## Live Chat Overview
The Live Chat is divided into multiple sections to help you manage conversations efficiently.
### Search & Controls
Use the top controls to refresh and search chat sessions.
* **Refresh**: Click **Refresh** to reload the latest live chat sessions and statuses.
* **Search by Session ID**: Quickly locate a specific live chat by entering its unique session ID.
### Status Filters
Filter live chat sessions based on their current status.
* **All Status**: Displays all live chat sessions regardless of state.
* **Pending**: Chats waiting for a human agent to join.
* **Active**: Chats currently being handled by a human agent.
* **Ended**: Chats that have been completed.
* **Cancelled**: Chats that were cancelled before completion.
### Chatbot Filters
If multiple chatbots are enabled, you can filter sessions by chatbot.
* **All Chatbots**: View live chats from all chatbots.
* **Specific Chatbot**: Filter chats by selecting a specific chatbot.
## Date Range Filtering
Filter live chat sessions by time period.
### Quick Date Filters
View chats from today.
View chats from yesterday.
View chats from the current week.
View chats from the current month.
### Custom Date Range
* **Select Date Range**: Choose **Start Date** and **End Date**.
* **Apply or Clear**:
* Click **Apply** to filter sessions
* Click **Clear** to reset filters
## Live Chat Sessions List
The left panel displays all chat sessions based on applied filters.
Each session shows:
* Message preview
* Date and time
* Current status (Pending, Active, Ended, Cancelled)
## Starting a Live Chat
To begin responding to a user:
1. Select a chat session from the list
2. Click on the session to open messaging
If no chat is selected, you’ll see:\
**Select a chat to start messaging**
## Chat Details
The right panel displays chat-related information.
* **Live Messages**: View and respond to messages in real time.
* **Chat Details**: View session details such as status, timestamps, and chatbot information.
## Best Practices
* Regularly refresh to view new pending chats
* Prioritize **Pending** chats to reduce response time
* Use chatbot filters in multi-bot environments
* Review ended chats for training and quality improvement
# ⚙️ Basic Details
Source: https://docs.neuraltalk.ai/menu/basic-details
Guide to configure your chatbot’s identity, behavior, and branding
🎥 Refer to the setup video for a step-by-step visual guide:
## Overview
The **Basic Details** page defines your chatbot’s identity including its name, language, personality role, and branding.\
These settings shape how your chatbot appears to users and how it behaves during conversations.
This guide explains how to configure chatbot information, update role behavior, and manage visual branding.
## Accessing Basic Details
* Log in to your dashboard
* Navigate to **Settings**
* Select **Chatbot Settings**
* Click on **Basic Details**
* The page displays editable sections for chatbot info, role settings, and branding
![Basic Details Page]()
## Basic Details Sections
### Basic Information
This section controls the primary identity of the chatbot.
* **Chatbot Name** – The display name users will see
* **Language** – Default language for conversations
* **Role** – Core behavior profile (e.g., `general_assistant`)
* **Role Description** – Explains the role purpose
### AI Behavior
The **Enhance with AI** area lets you refine how the chatbot responds.
* Adjust tone to be more friendly or detailed
* Customize instructions to guide chatbot behavior
* Edit role description anytime
Clear behavior instructions help produce consistent, reliable responses.
## Branding
Branding helps align the chatbot visually with your product or organization.
### 🖼️ Chatbot Logo
* Upload a logo users will see in chat windows
* **Recommended size:** 100×100px
* **Max size:** 1MB
* **Formats:** JPG, PNG, SVG
### ✍️ Tagline
* Add a short descriptive line under your chatbot name
* **Example:** *Your AI Assistant*
* You can also choose **Use default tagline**
## Best Practices
* Choose a clear, memorable chatbot name
* Keep role descriptions simple but meaningful
* Use a clean square logo for best display
* Update branding to match your company identity
* Periodically refine AI instructions as your chatbot evolves
# 🧪 Chatbot Evaluation
Source: https://docs.neuraltalk.ai/menu/chatbot-evaluation
Test and compare chatbot prompts across multiple AI models
🎥 Refer to the setup video for a step-by-step visual guide:
## Overview
The **Chatbot Evaluation** tool allows you to test your prompts across multiple AI models, all at once.
You can compare responses side-by-side, analyze quality, and decide which model works best for your chatbot before deploying changes.
This helps improve accuracy, tone, and user experience without guesswork.
## Accessing Chatbot Evaluation
* Log in to your dashboard
* Go to **Settings**
* Select **Chatbot Settings**
* Click on **Chatbot Evaluation**
* Pick **Single Prompt** or **Multi Prompt** depending on your testing needs
![Chatbot Evaluation Page]()
## Evaluation Modes
### Single Prompt
Test one prompt at a time and compare responses instantly.
### Multi Prompt
Run multiple prompts in sequence to analyze consistency across AI models.
> Use **Multi Prompt** when testing workflows, FAQs, or repetitive scenarios.
## Selected Chatbot
You can evaluate prompts using your existing chatbot configuration.
Example: **ABC**
Example default: **gpt-4o-mini**
The chatbot’s greeting and behavior settings are applied automatically during testing.
## Comparing AI Models
The evaluation area displays each selected AI model with its response.
Each response panel includes a **Create Correction** option.
### Create Correction
Use this to:
* Suggest improvements
* Fix tone or clarity
* Adjust formatting or accuracy
Corrections help refine how the chatbot learns and responds over time.
## Selecting AI Models
### Select AI Models
Choose which models to include in the comparison.
Click **+ Add Model** to include additional AI engines.
Mix different providers or versions for deeper evaluation.
## Saving Changes
When you're satisfied with your testing results:
Apply updated model selections or evaluation settings.
## Best Practices
* Test prompts for both short and long responses
* Compare tone, accuracy, and consistency across models
* Use corrections regularly to fine-tune results
* Re-evaluate after major chatbot updates
* Document findings for your team
# 💬 Communication
Source: https://docs.neuraltalk.ai/menu/communication
Guide to manage live chat, voice chat, and human handover settings
🎥 Refer to the setup video for a step-by-step visual guide:
## Overview
The **Communication** settings help you connect users with real human support when needed.\
Here you can enable live chat, voice chat, and configure human handover rules.
These tools improve trust, reduce unresolved queries, and ensure complex issues get handled by your team.
## Accessing Communication Settings
* Log in to your dashboard
* Navigate to **Settings**
* Select **Chatbot Settings**
* Click on **Communication**
* Options to Turn on live chat, voice chat, or human handover
* Customize messages and handling methods
![Communication Settings Page]()
## Live Chat Support
### Live Chat Status
Toggle live chat so users can connect with your support team in real-time.
### 💬 Enable Live Chat
* Allow users to request **live chat support** directly from the chatbot
### ✅ Live Chat Active
* When enabled, admins are **notified of new chat requests**
* Users can start real-time conversations with your team
### How Live Chat Works
### 🔄 Process Overview
* Users request live chat through the chatbot
* Requests appear in the **admin dashboard**
* Admins can accept and reply instantly
* Entire chat history is automatically saved
* Sessions can be ended by either the user or the admin
### 🎯 Why Use Live Chat
* Ideal for **billing questions**
* Helpful for **account issues**
* Useful for **urgent support** where AI alone may not be enough
## Voice Chat Support
### Voice Chat Status
Enable voice-based conversations between users and your team.
Allow users to request **voice chat support** directly from the chatbot.
> Great for users who prefer speaking rather than typing especially in support and onboarding scenarios.
## Human Handover Settings
Configure when conversations should shift from AI to a human agent.
### Enable Human Handover
Turn on human handover to give users the option to talk to a real person.
Users can request to speak with a human at any time.
Conversations can be routed to support staff based on your workflow.
### Handover Message
This is the message shown when a conversation is transferred.
> **Default Message:**\
> *Your request has been transferred to a human agent. They will get back to you soon.*
You can:
* Make the message **more friendly & detailed**
* Use AI to refine the tone
* Or **keep the default message**
### Handover Method
Choose how handovers are handled.
Transfers the user directly into a live chat session with your team.
> Future options may include ticket creation or email routing (depending on setup).
## Best Practices
* Keep handover messages polite and reassuring
* Enable live chat during business hours for faster resolutions
* Use voice chat for premium or complex queries
* Review saved transcripts to improve training and automation
* Start with manual handover, then automate as workflows mature
# ⚙️ General Settings
Source: https://docs.neuraltalk.ai/menu/general-settings
Guide to configure chatbot responses, rules, and behavior
🎥 Refer to the setup video for a step-by-step visual guide:
## Overview
The **General Settings** page controls how your chatbot thinks, writes, and interacts with users.\
Here you define conversation context, tone, creativity, greetings, suggested questions, and model options.
These settings help you balance performance, accuracy, cost, and user experience.
## Accessing General Settings
* Log in to your dashboard
* Go to **Settings**
* Select **Chatbot Settings**
* Click on **General Settings**
* Adjust response preferences, rules, and messages
* Changes are saved via Save button
![General Settings Page]()
## Conversation Behavior
### ⏳ Normal
* Balanced memory
* Optimized for **speed** and **cost**
### 📏 Extended
* Remembers **longer conversations**
* Provides better continuity across chats
### 🧠 Comprehensive
* **Deep context retention**
* Ideal for **complex workflows** and detailed tasks
> Based on your selection, the chatbot consumes **1 credit per message**.\
> Click **View Calculation** to understand usage.
### Chatbot Role & Rules
#### Chatbot Role
Define the primary purpose and tone of your bot.
> **General Assistant**\
> Act as a versatile helper. Optimize for clarity and speed. Summarize and provide practical, user-first solutions.
#### Rules
Create guidelines that the chatbot must always follow.
### ✅ Examples of Useful Rules
* Avoid sharing internal or restricted information
* Keep answers short unless the user asks for details
* Always greet new users politely
### 💡 Tip
* Rules help enforce brand voice
* They also reduce incorrect or off-brand responses
## Response Style
### 🌍 Language
* Select the **default language** your chatbot will respond in
### 📏 Response Length
* Choose how long replies should be:
* **Concise**
* **Normal**
* **Detailed**
### Creativity (Temperature)
Control how creative or strict the chatbot should be.
* **0** → predictable and precise
* **0.5** → balanced (recommended)
* **1** → highly creative and exploratory
## General Messages
### Greeting Message
The first message users see when they open the chatbot.
> *Example:* **Hello! How can I assist you today?**
You can:
* Make it **more friendly & detailed**
* Enhance with AI suggestions
* Or **Use default greeting message**
### Fallback Message
Used when the chatbot cannot answer a question.
You can customize tone or rely on the default fallback.
## AI Model & Knowledge Settings
### 🧠 LLM Model
* Select the AI model that powers your chatbot
* Example: **gpt-4o**
### 🔗 Cite Sources
* Enable this to include **citation links**
* Citations appear when information comes from your **knowledge base**
## Best Practices
* Start with **Normal** context length, then scale if needed
* Keep rules simple and specific
* Use concise greetings and friendly tone
* Add 4–6 suggested questions for better engagement
* Enable citations when accuracy matters (docs, help centers)
# 📥 Lead Collection
Source: https://docs.neuraltalk.ai/menu/lead-collection
Guide to collect visitor information and generate leads through your chatbot
🎥 Refer to the setup video for a step-by-step visual guide:
## Overview
The **Lead Collection** feature lets your chatbot capture valuable visitor information such as name, email, phone number, and feedback.
You can choose when to ask for details and where the collected leads should be stored or sent.
This helps convert conversations into real opportunities for follow-ups, marketing, and sales.
## Accessing Lead Collection
* Log in to your dashboard
* Go to **Settings**
* Select **Chatbot Settings**
* Click on **Lead Collection**
* Enable lead collection
* Choose what information to collect and where it should go
![Lead Collection Page]()
## Lead Collection Controls
### Enable Lead Collection
Toggle lead collection to start asking visitors for their details.
### 🔔 Enable Lead Collection
* Ask visitors for their contact information
* Can be triggered **before** or **during** the conversation
### 👥 Generate More Leads
* Capture interested users for **follow-ups**
* Useful for **product demos** and **marketing campaigns**
## Information You Can Collect
Select the specific fields you want the chatbot to request.
### 🪪 Collect Name
* Identify who is interacting with your chatbot
### ✉️ Collect Email
* Great for **follow-ups**, newsletters, and onboarding emails
### 📞 Collect Phone Number
* Helpful for **sales callbacks** and high-priority leads
### 💬 Collect Feedback
* Gather insights about **user experience**
* Improve chatbot performance over time
> Only enable fields that are relevant to your workflow to avoid overwhelming users.
## Collection Timing
Decide **when** to request user information.
Ask users for details upfront — great for sales-driven chatbots.
> Future options may include asking **during conversation** based on triggers or actions.
## Lead Notifications
### Send Leads To
Choose where collected leads should go.
Leads are saved inside your chatbot’s conversation logs.
Some setups allow sending leads to CRM tools or email services (requires integrations).
> You can customize routing based on your workflow and sales pipelines.
## Important Notes
### ⚖️ Compliance Reminder
* Always follow **data protection and privacy regulations**
* Examples include **GDPR** or local equivalents
## Best Practices
* Clearly explain why you're asking for user details
* Keep forms short to increase completion rates
* Notify your team when new leads arrive
* Regularly export or sync leads to your CRM
* Respect consent and privacy requirements
# 🔒 Security
Source: https://docs.neuraltalk.ai/menu/security
Guide to control where your chatbot is allowed or blocked from operating
🎥 Refer to the setup video for a step-by-step visual guide:
## Overview
The **Security** settings help you control exactly where your chatbot can be used.
You can allow specific domains, block unwanted websites, and ensure your chatbot only appears in trusted environments.
This prevents unauthorized embedding and protects your chatbot from misuse.
***
## Accessing Security Settings
* Log in to your dashboard
* Go to **Settings**
* Select **Chatbot Settings**
* Click on **Security**
* Choose which domains are allowed
* Block domains you want to restrict
![Security Settings Page]()
## Allowed Domains (Allowlist)
Use the allowlist to specify where your chatbot **is permitted** to run.
### Enable Domain Allowlist
The chatbot will only work on domains you explicitly approve.
Add domains where the chatbot should be active.
## Restricted Domains (Blocklist)
Block your chatbot from appearing on specific websites even if it is embedded.
### Enable Domain Blocklist
Prevent the chatbot from loading on specific domains.
Add domains to restrict chatbot access.
If no domains are added:
> **No restricted domains configured**\
> The chatbot won’t automatically block any sites.
## When to Use Each Option
* You only want the chatbot available on **your owned domains**
* You’re concerned about unauthorized embedding
* Security and control are top priorities
* Your chatbot is broadly embedded, but some domains must be blocked
* You want flexibility without strict restrictions
## Best Practices
* Prefer **allowlists** for maximum control and security
* Review domain lists regularly
* Add staging/test domains during development
* Remove unused or outdated domains to avoid confusion
# 📪 Setting up your AI Assistant
Source: https://docs.neuraltalk.ai/setup/ai-assistant-setup
Complete guide to creating and configuring your AI assistant from scratch
## Overview
This guide will walk you through the complete process of setting up your AI assistant, from initial creation to advanced configuration. Whether you're building a customer support bot, sales assistant, or internal knowledge base, this guide covers everything you need to know.
## Creating Your Assistant
### Step 1: Initial Setup
1. **Access the Dashboard**
* Log in to [neuraltalk.ai](https://neuraltalk.ai)
* Click "Create New Assistant" or the "+" button
![Go to Dashboard]()
2. **Basic Information**
* **Assistant Name**: Choose a descriptive name (e.g., "Acme Customer Support")
* **Description**: Brief description of your assistant's purpose
* **Category**: Select the primary use case (Support, Sales, General, etc.)
![Create Bot Basic Details]()
3. **Language Configuration**
* **Primary Language**: Select the main language for conversations
* **Additional Languages**: Add support for multiple languages if needed
* **Regional Settings**: Configure date, time, and number formats
![Language Setup]()
### Step 2: Personality Configuration
Choose how your assistant should communicate:
* **Professional**: Formal, business-appropriate language
* **Friendly**: Warm, approachable, and conversational
* **Casual**: Relaxed, informal communication style
* **Custom**: Define your own personality traits
Configure how detailed responses should be:
* **Concise**: Short, direct answers
* **Detailed**: Comprehensive, thorough responses
* **Adaptive**: Adjusts based on question complexity
Set the interaction pattern:
* **Question-Answer**: Direct responses to specific questions
* **Conversational**: Engages in back-and-forth dialogue
* **Guided**: Leads users through structured flows
## Advanced Configuration
### Greeting and Fallback Messages
1. **Welcome Message**
```text theme={null}
Hi! I'm your AI assistant. How can I help you today?
```
2. **Fallback Messages**
* Configure what to say when the AI doesn't understand
* Set up escalation to human agents
* Define when to ask for clarification
3. **Conversation Starters**
* Add suggested questions or topics
* Help users understand what they can ask
* Guide new users to common use cases
### Knowledge Base Setup
Add your existing content:
* PDF files (manuals, guides, policies)
* Word documents (FAQs, procedures)
* Text files (knowledge articles)
* Web pages (via URL)
Add specific information:
* Frequently asked questions
* Product specifications
* Company policies
* Contact information
Structure your knowledge:
* Create categories and tags
* Set content priorities
* Define access permissions
### AI Model Configuration
Choose the AI model that best fits your needs:
* **GPT-4**: Most capable, best for complex tasks
* **GPT-3.5**: Fast and cost-effective
* **Claude**: Excellent for analysis and reasoning
Provide specific instructions for your assistant:
* Response format preferences
* Brand voice guidelines
* Specific behaviors to avoid
## Integration Settings
### Website Widget Configuration
1. **Visual Customization**
* Choose widget position and size
* Match your brand colors
* Upload your logo
* Select animation preferences
2. **Behavior Settings**
* Set when the widget appears
* Configure auto-open triggers
* Set conversation persistence
* Enable typing indicators
### Platform-Specific Settings
* Configure business profile
* Set up message templates
* Configure webhook endpoints
* Test message delivery
* Set up bot permissions
* Configure slash commands
* Set up channel monitoring
* Configure user authentication
* Generate API keys
* Configure webhooks
* Set up authentication
* Test API endpoints
## Testing and Validation
### Pre-Launch Testing
1. **Conversation Testing**
* Test common questions
* Try edge cases and unusual inputs
* Verify response accuracy
* Check conversation flow
2. **Integration Testing**
* Test on all target platforms
* Verify message delivery
* Check error handling
* Test user authentication
3. **Performance Testing**
* Monitor response times
* Test under load
* Verify scalability
* Check resource usage
### Quality Assurance
* Verify all information is accurate
* Check for outdated content
* Ensure brand consistency
* Validate contact information
* Test from user perspective
* Check mobile responsiveness
* Verify accessibility features
* Test different browsers
* Configure tracking
* Set up conversion goals
* Enable conversation logging
* Set up alerts and notifications
## Launch Checklist
Before going live, ensure you've completed:
* [ ] Assistant name and description configured
* [ ] Personality and tone settings applied
* [ ] Knowledge base populated and organized
* [ ] Greeting and fallback messages set
* [ ] Visual styling matches brand guidelines
* [ ] All integrations tested and working
* [ ] Analytics and tracking configured
* [ ] Team trained on monitoring and management
* [ ] Support processes defined
* [ ] Backup and recovery procedures in place
## Post-Launch Monitoring
### Key Metrics to Track
* Conversation volume
* User satisfaction scores
* Response completion rates
* Time to resolution
* Response accuracy
* Escalation rates
* Error rates
* System uptime
### Continuous Improvement
1. **Regular Reviews**
* Weekly conversation analysis
* Monthly performance reports
* Quarterly strategy reviews
* Annual platform updates
2. **Content Updates**
* Add new FAQs based on user questions
* Update product information
* Refresh policies and procedures
* Remove outdated content
3. **Feature Enhancements**
* Add new integrations
* Implement advanced features
* Optimize conversation flows
* Enhance user experience
## Troubleshooting Common Issues
* Check API key configuration
* Verify model selection
* Review rate limits
* Check network connectivity
* Review knowledge base content
* Check training data quality
* Adjust model parameters
* Add more specific examples
* Verify webhook URLs
* Check authentication tokens
* Review platform permissions
* Test API endpoints
## Next Steps
Now that your assistant is set up, explore these advanced features:
Learn how to effectively train your AI with your knowledge base
Add your assistant to your website with our easy integration
Customize the appearance and behavior of your assistant
Add powerful tools and workflows to extend capabilities
# 🔋 Using Assistant Tools
Source: https://docs.neuraltalk.ai/setup/assistant-tools
Learn how to add and configure tools to extend your AI assistant's capabilities
## Assistant Tools Overview
Tools allow your AI assistant to perform specific actions beyond just answering questions. This guide covers how to add and configure various tools to enhance your assistant's functionality.
## Available Tools
### Calendar Integration
* **Schedule meetings** and appointments
* **Check availability** for team members
* **Send calendar invites** automatically
* **Reschedule or cancel** appointments
### Email Tools
* **Send emails** to users or team members
* **Email templates** for common responses
* **Follow-up reminders** and notifications
* **Email tracking** and analytics
### Database Tools
* **Query databases** for information
* **Update records** based on conversations
* **Search customer data** and history
* **Generate reports** and insights
### API Integration
* **Connect to external services** and APIs
* **Fetch real-time data** from various sources
* **Update external systems** based on conversations
* **Sync data** across platforms
## Configuration
### Adding Tools
1. **Navigate to Tools Section**
* Go to your assistant dashboard
* Click on "Tools" or "Integrations"
* Select "Add New Tool"
2. **Choose Tool Type**
* Select from available tool categories
* Configure tool-specific settings
* Test tool functionality
3. **Set Permissions**
* Define what the tool can access
* Set user permission levels
* Configure security settings
### Tool Management
* **Enable/Disable** tools as needed
* **Monitor usage** and performance
* **Update configurations** and settings
* **Remove unused** tools
## Next Steps
* [Assistant Workflows](/setup/assistant-workflows)
* [Website Integration](/setup/website-integration)
* [API Documentation](/api-reference/introduction)
# ⚙️ Adding Assistant Workflows
Source: https://docs.neuraltalk.ai/setup/assistant-workflows
Create automated workflows to streamline complex processes and improve efficiency
## Workflow Overview
Workflows allow you to automate complex processes and create structured conversation flows that guide users through specific tasks or procedures.
## Workflow Types
### Linear Workflows
* **Step-by-step processes** with clear progression
* **Conditional branching** based on user responses
* **Data collection** at each step
* **Validation and error handling**
### Decision Trees
* **Multiple choice** questions and responses
* **Dynamic routing** based on user selections
* **Conditional logic** for different paths
* **Loop back** to previous steps when needed
### Integration Workflows
* **Connect multiple tools** and services
* **Automate data transfer** between systems
* **Trigger external actions** based on conversations
* **Sync information** across platforms
## Creating Workflows
### Step 1: Plan Your Workflow
* **Define the goal** and desired outcome
* **Map out the steps** and decision points
* **Identify data** to be collected
* **Plan error handling** and fallbacks
### Step 2: Build the Workflow
* **Use the visual editor** to create flow
* **Add decision points** and conditions
* **Configure data collection** fields
* **Set up integrations** and tools
### Step 3: Test and Deploy
* **Test with sample data** and scenarios
* **Validate all paths** and outcomes
* **Deploy to production** environment
* **Monitor performance** and usage
## Workflow Examples
### Customer Onboarding
1. **Welcome message** and introduction
2. **Collect basic information** (name, company, role)
3. **Assess needs** and requirements
4. **Provide relevant resources** and next steps
5. **Schedule follow-up** or demo
### Support Ticket Creation
1. **Identify the issue** type and category
2. **Collect detailed information** about the problem
3. **Check knowledge base** for solutions
4. **Create support ticket** if needed
5. **Provide ticket number** and next steps
### Lead Qualification
1. **Assess company size** and industry
2. **Identify decision makers** and timeline
3. **Understand current solutions** and pain points
4. **Score and categorize** the lead
5. **Route to appropriate** sales team member
## Best Practices
### Design Principles
* **Keep it simple** and easy to follow
* **Provide clear instructions** at each step
* **Include help and support** options
* **Test thoroughly** before deployment
### User Experience
* **Make it conversational** and natural
* **Allow users to go back** and modify answers
* **Provide progress indicators** and status updates
* **Handle errors gracefully** with helpful messages
## Next Steps
* [Assistant Tools](/setup/assistant-tools)
* [Integration Guides](/integrations/slack)
* [API Documentation](/api-reference/introduction)
# ✍️ Improving your AI Assistant
Source: https://docs.neuraltalk.ai/setup/correcting-assistant
Learn how to improve and correct your AI assistant's responses
## Improving Assistant Performance
This guide covers how to monitor, correct, and improve your AI assistant's responses to ensure optimal performance.
## Monitoring Conversations
### Review Conversation Logs
1. **Access Analytics Dashboard**
* Navigate to your assistant dashboard
* Click on "Analytics" or "Conversations"
* Review recent conversations and user interactions
2. **Identify Issues**
* Look for conversations that didn't resolve user questions
* Note responses that were inaccurate or unhelpful
* Check for escalations to human agents
## Correcting Responses
### Manual Corrections
1. **Direct Feedback**
* Use the feedback system in conversation logs
* Mark responses as helpful or unhelpful
* Provide specific corrections for inaccurate responses
2. **Knowledge Base Updates**
* Add missing information to your knowledge base
* Update outdated content
* Clarify ambiguous information
### Training Improvements
1. **Add Examples**
* Include specific examples of correct responses
* Add context for better understanding
* Provide multiple ways to ask the same question
2. **Refine Instructions**
* Update assistant personality settings
* Adjust response length preferences
* Modify conversation behavior
## Continuous Improvement
### Regular Reviews
* **Weekly**: Review conversation logs and user feedback
* **Monthly**: Analyze performance metrics and trends
* **Quarterly**: Comprehensive knowledge base audit
### Best Practices
* Keep content current and accurate
* Test new responses before deploying
* Monitor user satisfaction scores
* Update based on common questions
## Next Steps
* [Styling your Assistant](/setup/styling-assistant)
* [Human Handover Setup](/setup/human-handover)
* [Advanced Tools](/setup/assistant-tools)
# 💁♂️ Human Handover Configuration
Source: https://docs.neuraltalk.ai/setup/human-handover
Set up seamless escalation from AI assistant to human agents
Configure when and how your AI assistant should transfer conversations to human agents for complex issues that require human intervention.
## When to Escalate
### Automatic Triggers
* **Complex technical issues** that require human expertise
* **Billing and account problems** that need verification
* **Complaints or negative feedback** that require personal attention
* **Requests for human assistance** from users
### Manual Triggers
* **User explicitly asks** for a human agent
* **Assistant reaches confidence threshold** for escalation
* **Specific keywords** detected in conversation
* **Time-based escalation** for unresolved issues
## Configuration Steps
### 1. Set Escalation Rules
Define the conditions that trigger handover:
* **Confidence levels** for different topics
* **Keyword detection** for specific issues
* **Conversation length** thresholds
* **User sentiment** analysis
### 2. Configure Handover Message
Create a smooth transition message:
```text theme={null}
"I understand you need additional help. Let me connect you with one of our human specialists who can assist you better."
```
### 3. Set Up Agent Notifications
* **Email notifications** to support team
* **Slack/Discord alerts** for immediate response
* **Dashboard notifications** for monitoring
* **Escalation queue** management
## Integration Options
### CRM Integration
* **HubSpot**: Automatic ticket creation
* **Salesforce**: Lead and case management
* **Zendesk**: Support ticket escalation
* **Custom CRM**: API integration
### Communication Channels
* **Live Chat**: Direct handover to live chat
* **Phone**: Schedule callback or provide number
* **Email**: Send conversation summary
* **Video Call**: Schedule video consultation
## Next Steps
* [Lead Collection Setup](/setup/lead-collection)
* [Sharing Assistant](/setup/sharing-assistant)
* [Assistant Tools](/setup/assistant-tools)
# 👥 Lead Collection Setup
Source: https://docs.neuraltalk.ai/setup/lead-collection
Configure lead capture and qualification through your AI assistant
Set up your AI assistant to automatically capture, qualify, and manage leads from website visitors and conversations.
## Lead Capture Methods
### Form Collection
* **Contact forms** with validation
* **Email capture** with opt-in
* **Phone number** collection
* **Company information** gathering
### Conversation-Based
* **Natural conversation** lead capture
* **Qualification questions** during chat
* **Interest assessment** through dialogue
* **Follow-up scheduling** for prospects
## Qualification Process
### Lead Scoring
1. **Demographic Information**
* Company size and industry
* Job title and decision-making authority
* Budget and timeline
* Geographic location
2. **Behavioral Indicators**
* Pages visited on website
* Questions asked during chat
* Time spent in conversation
* Engagement level
### Qualification Questions
* **Pain points** and challenges
* **Current solutions** being used
* **Decision timeline** and urgency
* **Budget range** and approval process
## Integration with CRM
### Automatic Lead Creation
* **Real-time sync** with CRM systems
* **Lead scoring** and categorization
* **Follow-up task** creation
* **Pipeline management** integration
### Data Enrichment
* **Company information** lookup
* **Contact verification** and validation
* **Social media** profile matching
* **Email verification** and deliverability
## Next Steps
* [Sharing Assistant](/setup/sharing-assistant)
* [Assistant Tools](/setup/assistant-tools)
* [Assistant Workflows](/setup/assistant-workflows)
# 🤝 Sharing your AI Assistant
Source: https://docs.neuraltalk.ai/setup/sharing-assistant
Learn how to share and distribute your AI assistant across different platforms
## Sharing Options
This guide covers the various ways to share and distribute your AI assistant to reach your audience effectively.
## Direct Sharing
### Share Links
* **Public sharing** with custom URLs
* **Embed codes** for websites
* **QR codes** for offline sharing
* **Social media** integration
### Access Control
* **Public access** for anyone
* **Password protection** for restricted access
* **Email verification** for lead capture
* **Domain restrictions** for security
## Platform Integration
### Website Integration
* **Embedded widget** on your website
* **Full-page** chat interface
* **Popup modal** for engagement
* **Sidebar integration** for support
### Social Media
* **Facebook Messenger** bot
* **WhatsApp Business** integration
* **Telegram** bot deployment
* **Twitter** direct messages
## Team Collaboration
### Internal Sharing
* **Team access** for testing
* **Stakeholder review** links
* **Feedback collection** system
* **Version control** and updates
### External Sharing
* **Client demos** and presentations
* **Partner integration** options
* **Public showcase** for marketing
* **API access** for developers
## Next Steps
* [Assistant Tools](/setup/assistant-tools)
* [Assistant Workflows](/setup/assistant-workflows)
* [Integration Guides](/integrations/slack)
# 💅 Styling your AI Assistant
Source: https://docs.neuraltalk.ai/setup/styling-assistant
Customize the appearance and behavior of your AI assistant
## Visual Customization
This guide covers how to customize your AI assistant's appearance to match your brand and create the perfect user experience.
## Brand Customization
### Colors and Theme
1. **Primary Colors**
* Choose colors that match your brand
* Set primary, secondary, and accent colors
* Ensure good contrast for accessibility
2. **Theme Options**
* Light theme for professional appearance
* Dark theme for modern look
* Auto theme that adapts to user preference
### Logo and Branding
1. **Logo Upload**
* Upload your company logo
* Choose logo placement and size
* Ensure logo is visible and clear
2. **Brand Elements**
* Add your company name
* Include tagline or description
* Match your website's design language
## Chat Widget Styling
### Widget Appearance
* Bottom right (default)
* Bottom left
* Top right
* Top left
* Custom positioning
* Compact mode
* Standard size
* Large widget
* Custom dimensions
### Animation and Behavior
1. **Entrance Animation**
* Slide in from side
* Fade in effect
* Bounce animation
* Custom animations
2. **Typing Indicators**
* Enable/disable typing animation
* Customize typing speed
* Add typing sound effects
## Conversation Styling
### Message Appearance
1. **Message Bubbles**
* User message styling
* Assistant response styling
* Different colors for each type
* Rounded or square corners
2. **Text Formatting**
* Font family and size
* Text color and weight
* Line spacing and alignment
* Link and button styling
### Interactive Elements
1. **Buttons and Cards**
* Suggested response buttons
* Quick action buttons
* Product cards
* Image galleries
2. **Input Field**
* Placeholder text
* Send button styling
* Character limits
* Auto-complete suggestions
## Advanced Customization
### CSS Customization
For advanced users, you can add custom CSS:
```css theme={null}
/* Custom chat widget styling */
.neuraltalk-widget {
border-radius: 12px;
box-shadow: 0 4px 12px rgba(0,0,0,0.15);
}
/* Custom message styling */
.neuraltalk-message {
font-family: 'Your Font', sans-serif;
}
```
### JavaScript Customization
Add custom behavior with JavaScript:
```javascript theme={null}
// Custom event handlers
window.addEventListener('neuraltalk:message', function(event) {
console.log('New message:', event.detail);
});
```
## Mobile Responsiveness
### Mobile Optimization
* **Touch-friendly buttons**: Ensure buttons are large enough for touch
* **Responsive design**: Adapts to different screen sizes
* **Mobile-specific features**: Swipe gestures, mobile keyboards
* **Performance**: Optimized for mobile networks
### Testing on Devices
1. **Test on Multiple Devices**
* iPhone and Android phones
* Tablets and iPads
* Different screen sizes
* Various browsers
2. **User Experience Testing**
* Easy to use on mobile
* Fast loading times
* Clear visual hierarchy
* Accessible design
## Accessibility
### WCAG Compliance
* **Color Contrast**: Ensure sufficient contrast ratios
* **Keyboard Navigation**: Support keyboard-only navigation
* **Screen Readers**: Compatible with assistive technologies
* **Focus Indicators**: Clear focus states for navigation
### Inclusive Design
* **Font Sizes**: Readable text sizes
* **Color Blindness**: Don't rely solely on color
* **Motor Impairments**: Large touch targets
* **Cognitive Load**: Clear, simple interface
## Preview and Testing
### Live Preview
1. **Real-time Preview**
* See changes instantly
* Test on different devices
* Preview with sample conversations
2. **A/B Testing**
* Test different designs
* Compare user engagement
* Optimize based on data
### Quality Assurance
* **Cross-browser Testing**: Chrome, Firefox, Safari, Edge
* **Device Testing**: Desktop, tablet, mobile
* **Performance Testing**: Load times and responsiveness
* **User Testing**: Get feedback from real users
## Best Practices
### Design Principles
1. **Consistency**
* Match your website's design
* Use consistent colors and fonts
* Maintain brand identity
2. **Simplicity**
* Clean, uncluttered interface
* Easy to understand navigation
* Clear call-to-action buttons
3. **Professionalism**
* High-quality visuals
* Polished animations
* Error-free implementation
## Next Steps
* [Human Handover Setup](/setup/human-handover)
* [Lead Collection](/setup/lead-collection)
* [Sharing Assistant](/setup/sharing-assistant)
# 🤖 Training your AI Assistant
Source: https://docs.neuraltalk.ai/setup/training-assistant
Complete guide to training your AI assistant with knowledge sources and content
## Overview
Training your AI assistant is the most crucial step in creating an effective conversational AI. This guide covers everything you need to know about building a comprehensive knowledge base that will enable your assistant to provide accurate, helpful responses to your users.
## Knowledge Sources Overview
Knowledge sources are the foundation of your AI assistant's intelligence. They provide the specific information, data, and context that your assistant uses to generate accurate and helpful responses. Our platform supports multiple source types and advanced retrieval methods to ensure optimal performance.
## Supported Knowledge Source Types
### 📄 Document Sources
Upload and process various file formats:
Research papers, manuals, reports, and technical documentation
Policies, procedures, guides, and business documents (.docx, .doc)
Plain text knowledge bases, FAQs, and simple content (.txt, .md)
Structured Q\&A pairs and data (.csv, .json, .html)
### 🔗 Link-Based Sources
Add knowledge directly from web sources:
* **Website URLs**: Company pages, product information
* **Documentation Links**: Technical docs, API references
* **Knowledge Base Articles**: Help center content
* **Blog Posts**: Industry insights and updates
* **FAQ Pages**: Common questions and answers
### 🌐 Google Integration
Leverage Google's vast information network:
* **Google Search Results**: Real-time web information
* **Google Docs**: Collaborative documents
* **Google Drive Files**: Shared knowledge repositories
* **Google Sites**: Internal company wikis
## Getting Started with Training
### Step 1: Access the Knowledge Section
1. **Navigate to Knowledge Sources**
* Log in to [neuraltalk.ai](https://neuraltalk.ai)
* Select your assistant from the dashboard
* Click "Knowledge" in the left sidebar
2. **View Your Knowledge Base**
* See total character count and usage
* View all existing knowledge sources
* Monitor last crawled dates and status
![Knowledge Sources Interface]()
### Step 2: Add Your First Knowledge Source
1. **Click "Add Source"**
* Located in the top-right area of the Knowledge Sources page
* Choose from multiple upload options
![Add Source Button]()
2. **Select Upload Method**
* **Documents and Images**: Upload files directly
* **URLs**: Add web-based content
* **Google Drive**: Connect cloud-stored documents
## Document Upload Training
### Supported File Formats
* **PDF Files** (.pdf) - Manuals, guides, reports
* **Microsoft Office**: Word (.docx, .doc), PowerPoint (.pptx), Excel (.xlsx, .xls)
* **Text Files** (.txt, .md) - Plain text and markdown
* **Data Files** (.json, .csv, .html) - Structured content
* **Common Formats**: JPG, PNG, BMP, TIFF
* **Modern Formats**: HEIC (iPhone photos)
* **Use Cases**: Screenshots, diagrams, infographics
### Upload Process
![Document Upload Interface]()
* Organize files with clear, descriptive names
* Ensure documents are up-to-date and accurate
* Use text-searchable PDFs (not scanned images)
* Include complete context and background information
* Drag and drop files into the upload area
* Or click to browse and select files
* Upload multiple documents at once
* Monitor character count usage
* Enable auto-recrawl for frequently updated content
* Set appropriate source categories
* Add descriptive tags for organization
* Wait for documents to be processed and indexed
* Test your assistant with questions about the new content
* Verify accuracy and completeness of responses
## Advanced Training Strategies
### Content Organization
* Group related documents together
* Use consistent naming conventions
* Create logical hierarchies
* Apply relevant tags
* Review content for accuracy
* Remove outdated information
* Ensure brand consistency
* Validate contact information
### Training Best Practices
Begin with your most important documents and gradually add more content. This allows you to:
* Test the assistant's responses early
* Identify knowledge gaps
* Refine your training approach
* Monitor performance improvements
Mix different types of content for comprehensive coverage:
* Official documentation and policies
* Frequently asked questions
* Product specifications and features
* Troubleshooting guides and procedures
* Company information and contact details
Keep your knowledge base current:
* Enable auto-recrawl for dynamic content
* Schedule regular content reviews
* Update information based on user feedback
* Remove outdated or incorrect content
## Advanced Retrieval System
### Smart Retrieval Options
Our intelligent retrieval system optimizes responses by:
#### Contextual Retrieval
* Analyzes user query context and intent
* Selects the most relevant knowledge sources
* Prioritizes recent and frequently accessed content
* Considers user conversation history
#### Multi-Source Synthesis
* Combines information from multiple sources
* Provides comprehensive answers
* Eliminates contradictory information
* Ensures response consistency
### Retrieval Modes
Target specific knowledge sources for focused, fast responses
Query across all sources for comprehensive information
Choose specific source combinations for custom strategies
## Knowledge Base Management
### Content Quality Control
* Content accuracy checks
* Duplicate detection and merging
* Freshness monitoring
* Quality scoring based on performance
* Regular content audits
* User feedback integration
* Performance analysis
* Continuous improvement
### Performance Analytics
Track your knowledge base effectiveness:
* Source utilization rates
* Most accessed content
* User engagement metrics
* Response success rates
* Response accuracy scores
* User satisfaction ratings
* Escalation rates
* Resolution times
## Training for Specific Use Cases
### Customer Support Assistant
* Product documentation and manuals
* Troubleshooting guides
* FAQ documents
* Contact information and hours
* Return and refund policies
* Escalation procedures
* Technical specifications
* Known issues and workarounds
* Account management procedures
* Billing and subscription information
### Sales Assistant
* Feature descriptions and benefits
* Pricing and packages
* Comparison charts
* Use cases and examples
* Qualification questions
* Objection handling
* Next steps and follow-up
* Contact and demo scheduling
### Internal Knowledge Base
* Policies and procedures
* HR information
* IT support guides
* Project documentation
* Role-specific procedures
* Tool and system guides
* Best practices
* Training materials
## Troubleshooting Training Issues
### Common Problems and Solutions
* Check if documents were processed successfully
* Verify content is relevant to user questions
* Review retrieval settings and priorities
* Test with specific questions about the content
* Review source content for accuracy
* Check for conflicting information across sources
* Add more specific examples and context
* Adjust model parameters and instructions
* Ensure content is well-structured and clear
* Add more comprehensive information
* Include examples and use cases
* Review and improve source organization
## Monitoring and Optimization
### Regular Maintenance
1. **Weekly Reviews**
* Check conversation logs for unanswered questions
* Identify knowledge gaps
* Review user feedback and ratings
* Update content based on new information
2. **Monthly Analysis**
* Analyze performance metrics
* Review source utilization
* Identify high-value content
* Plan content expansion
3. **Quarterly Audits**
* Comprehensive content review
* Update outdated information
* Reorganize knowledge structure
* Evaluate training effectiveness
### Continuous Improvement
* Collect and analyze user ratings
* Review conversation transcripts
* Identify improvement opportunities
* Implement feedback-based changes
* Monitor response accuracy
* Track resolution rates
* Measure user satisfaction
* Optimize based on data
## Next Steps
Now that your assistant is trained, explore these advanced features:
Add your trained assistant to your website
Customize the appearance and behavior
Set up seamless escalation to human agents
Add powerful tools and workflows
# Add Chatbot to Your Website
Source: https://docs.neuraltalk.ai/website-integration/index
Learn how to deploy your NeuralTalk AI chatbot to various website platforms
Deploy your NeuralTalk AI chatbot to your website and provide instant customer support across all platforms.
## Choose Your Platform
Deploy your AI chatbot to your Shopify store for enhanced customer support and sales.
Add your chatbot to WordPress websites with easy integration options.
Integrate your AI assistant with Wix websites for seamless user experience.
## Quick Start Guide
### 1. Prepare Your Chatbot
* Create and train your AI assistant in the NeuralTalk dashboard
* Configure responses and knowledge base
* Test conversations to ensure quality
### 2. Get Integration Code
* Navigate to **Website Integration** in your dashboard
* Copy the provided embed code
* Customize appearance and behavior
### 3. Deploy to Your Platform
* Follow platform-specific instructions
* Test the integration
* Monitor performance and optimize
## Benefits of Website Integration
Provide instant answers to customer questions around the clock
Guide visitors through your sales funnel with intelligent conversations
Handle common queries automatically, freeing up your team
## Platform Comparison
| Platform | Difficulty | Features | Best For |
| ------------- | ---------- | ------------------- | ----------------- |
| **Shopify** | Easy | E-commerce focused | Online stores |
| **WordPress** | Medium | Highly customizable | Business websites |
| **Wix** | Easy | Drag-and-drop | Small businesses |
## Need Help?
Get personalized help with your website integration. For quick resolution and community support, join our [Discord community](https://discord.com/invite/tHpggadDAk).
# 🛒 Deploy to Shopify
Source: https://docs.neuraltalk.ai/website-integration/shopify
Learn how to add your NeuralTalk AI chatbot to your Shopify store
Add your NeuralTalk AI chatbot to your Shopify store to provide instant customer support and boost sales.
🎥 Refer to the setup video for a step-by-step visual guide:
## Prerequisites
* A Shopify store (any plan)
* Your NeuralTalk AI assistant created and configured
* Access to your Shopify admin panel
## Step 1: Get Your Chatbot Code
1. Log in to your [NeuralTalk Dashboard](https://neuraltalk.ai)
2. Navigate to your AI assistant
3. Go to the **Website Integration** section
4. Copy the provided embed code
## Step 2: Add to Shopify Theme
### Method 1: Using Theme Editor (Recommended)
1. In your Shopify admin, go to **Online Store** > **Themes**
2. Click **Actions** > **Edit code** on your active theme
3. Open the `theme.liquid` file
4. Find the ` ` tag
5. Paste your chatbot code just before the closing `` tag
6. Save the file
### Method 2: Using Shopify Script Tag API
For advanced users, you can use the Shopify Script Tag API to add the chatbot programmatically.
## Step 3: Customize Appearance
1. Return to your NeuralTalk dashboard
2. Go to **Styling** settings
3. Customize colors, position, and behavior to match your store
4. Preview changes in real-time
## Step 4: Test Your Integration
1. Visit your Shopify store
2. Look for the chatbot widget (usually bottom-right corner)
3. Test the conversation flow
4. Verify that responses match your training
## Best Practices for Shopify