Popcorn Documentation home page
Search...
⌘K
Support
Dashboard
Dashboard
Search...
Navigation
AI Agents
Tools and Integrations
Documentation
API Reference
Get Started
Popcorn Documentation
Quickstart
AI Agents
Agent overview
Agent Capabilities and Configuration
Creating AI Agents
Managing Existing Agents
Agent Best Practices
Tools and Integrations
Troubleshooting AI Agents
AI Tools
AI Tools
AI Tool Creator
Tool Configuration
Using Tools with Agents
Knowledge Base
Knowledge Base Overview
Creating and Managing Collections
Content Management
Agent Integration with Knowledge Base
Knowledge Base Troubleshooting
Channels
Channels Overview
WhatsApp Business Setup
Website Chat Widget
Channels Troubleshooting
Inbox
Inbox Overview
Managing Conversations
Inbox Troubleshooting
Mass Marketing
Mass Marketing Overview
Regular Campaigns
Automated Campaigns
Marketing Templates
Mass Marketing Troubleshooting
Integrations
Integrations Overview
Integration Setup Guide
Integration Troubleshooting
Settings
Settings Overview
Account and Team Management
Business Operations Settings
WhatsApp Templates
Dynamic URL Buttons
On this page
Tools and Integrations
Overview
Types of Integrations
1. Custom Tools
2. Knowledge Collections
3. WhatsApp Channels
Managing Custom Tools
Accessing Tools Marketplace
Tool Connection Process
Tool Management
Knowledge Collections Management
What are Knowledge Collections?
Types of Collections
Creating New Collections
Connecting Existing Collections
Editing Collections
WhatsApp Channel Integration
WABA Setup Requirements
Connecting WhatsApp Numbers
Channel Configuration
Integration Troubleshooting
Common Tool Issues
Knowledge Collection Issues
WhatsApp Channel Issues
AI Agents
Tools and Integrations
Connect your AI agents with external tools and integrations
Tools and Integrations
Overview
Tools and integrations extend your AI agent’s capabilities beyond basic conversation handling. They allow agents to perform specific actions, access external services, and provide enhanced functionality to customers.
Types of Integrations
1. Custom Tools
Purpose
: Extend agent capabilities with external tools and services
Management
:
Connect/disconnect tools from marketplace
Configure tool-specific parameters
Monitor tool performance
Update tool settings
Examples
:
CRM integrations
Payment processors
Inventory management systems
Third-party APIs
Custom business logic
2. Knowledge Collections
Purpose
: Provide agents with access to information databases
Features
:
Knowledge base access
Document search and retrieval
FAQ handling
Product information lookup
Company policy information
3. WhatsApp Channels
Purpose
: Connect agents to messaging platforms
Requirements
:
Valid WhatsApp Business Account (WABA)
Verified phone numbers
Proper permissions and setup
Managing Custom Tools
Accessing Tools Marketplace
Navigation
: Agent details → Tools tab → Browse available tools
Tool Connection Process
Browse Available Tools
View tool descriptions and capabilities
Read integration requirements
Check compatibility with your setup
Connect Tools
Click “Connect” for desired tools
Provide required configuration parameters
Set up authentication if needed
Test tool functionality
Configure Settings
Adjust tool-specific parameters
Set usage limits or restrictions
Configure trigger conditions
Save configuration
Test Integration
Verify tool responds correctly
Test various scenarios
Monitor for errors or issues
Confirm expected behavior
Tool Management
Monitoring Tools
:
Check tool status regularly
Monitor usage statistics
Review error logs
Track performance metrics
Updating Tools
:
Apply tool updates when available
Modify configurations as needed
Test after updates
Document changes
Disconnecting Tools
:
Remove unused tools
Clean up configurations
Verify removal doesn’t break functionality
Update agent instructions if necessary
Knowledge Collections Management
What are Knowledge Collections?
Knowledge collections are curated sets of information that agents can access to answer customer questions. They contain:
Product information
Company policies
FAQ content
Technical documentation
Process guides
Types of Collections
Regular Knowledge Collections
:
General information and FAQs
Company policies and procedures
Product documentation
Support guides
Product Collections
:
Product catalogs
Pricing information
Specifications
Availability data
(Excluded from regular knowledge collection lists)
Creating New Collections
Process
:
Navigate to Collections tab in agent settings
Click “New Collection” button
Provide collection name and description
Add content to the collection
Save and connect to agent
Best Practices for Collection Creation
:
Use descriptive names
Organize information logically
Keep content up-to-date
Include relevant keywords
Test agent responses after adding
Connecting Existing Collections
Steps
:
Go to Collections tab
View available collections
Toggle switch to connect/disconnect
Save changes
Test agent with new collections
Editing Collections
Navigation
: Collections tab → Click “Edit Collections” → Select collection
Content Management
:
Add new information
Update existing content
Remove outdated information
Reorganize content structure
Improve searchability
Content Guidelines
:
Use clear, concise language
Include relevant keywords
Structure information logically
Provide complete answers
Regular updates and maintenance
WhatsApp Channel Integration
WABA Setup Requirements
Prerequisites
:
Valid WhatsApp Business Account
Verified business profile
Approved phone numbers
Proper permissions and access
Connecting WhatsApp Numbers
Process
:
Navigate to Channels tab
View available phone numbers
Select numbers to connect
Confirm connection
Test connectivity
Managing Connections
:
Monitor active connections
Disconnect unused numbers
Test message delivery
Verify two-way communication
Channel Configuration
Settings
:
Message templates
Business hours
Auto-responses
Delivery preferences
Integration Troubleshooting
Common Tool Issues
Tool Not Responding
:
Check tool status and availability
Verify configuration settings
Review authentication credentials
Test network connectivity
Authentication Failures
:
Verify API keys and tokens
Check expiration dates
Update credentials if needed
Test authentication separately
Performance Issues
:
Monitor response times
Check rate limits
Optimize configurations
Contact tool provider if needed
Knowledge Collection Issues
Agent Can’t Find Information
:
Verify collection is connected
Check content organization
Improve search keywords
Update collection content
Outdated Information
:
Regular content audits
Update procedures
Version control
Content validation
WhatsApp Channel Issues
Messages Not Delivering
:
Check WABA status
Verify phone number connection
Test with different message types
Review delivery reports
Two-way Communication Problems
:
Verify webhook configuration
Check message routing
Test response handling
Monitor error logs
Agent Best Practices
Troubleshooting AI Agents
Assistant
Responses are generated using AI and may contain mistakes.