What Are Actions?
Actions are predefined tasks your agent can execute during conversations:- Data Collection: Gather information from users
- Human Handoff: Transfer to a live agent
- Integration Actions: Connect to Calendly, Shopify, etc.
- Custom Actions: Build your own via API
Prerequisites
- An active agent
- Appropriate plan (some actions require Pro or Business)
Action Types
Human Handoff
Transfer conversations to human agents when needed
Data Collection
Collect structured information from users
Calendly
Schedule meetings directly in conversations
Shopify
Look up orders, products, and customer info
Step-by-Step: Create an Action
1
Navigate to Actions
Go to your agent’s Actions tab.
2
Click Create Action
Click the Create Action button.
3
Select Action Type
Choose from available action types:
- Human Handoff
- Data Collection
- Integration (Calendly, Shopify)
4
Configure Action
Fill in the action settings (varies by type).
5
Save
Click Save to create the action.
Human Handoff Action
Transfer conversations to human support when the AI cannot help.Configuration
| Setting | Description |
|---|---|
| Name | Action name (e.g., “Transfer to Support”) |
| When to Use | Describe when the agent should trigger this |
| Notification Emails | Email addresses to notify |
| Message | Message shown to user during handoff |
| Schedule | Business hours for handoff availability |
Example Configuration
Data Collection Action
Collect structured information from users during conversations.Configuration
| Setting | Description |
|---|---|
| Name | Action name (e.g., “Collect Lead Info”) |
| When to Use | When to trigger data collection |
| Fields | Information to collect |
| Required Fields | Which fields are mandatory |
Example Fields
- Name (required)
- Email (required)
- Phone
- Company
- Budget range
Integration Actions
Calendly
Schedule meetings directly from conversations. Capabilities:- Show available time slots
- Book appointments
- Send confirmations
Shopify
Access store data during conversations. Capabilities:- Look up orders
- Check product availability
- Get tracking information
- Search customers
Managing Actions
Enable/Disable Actions
Toggle actions on or off without deleting them:- Find the action in your list
- Click the toggle switch
- Disabled actions won’t trigger during conversations
Edit Actions
- Click on the action card
- Modify settings
- Click Save
Delete Actions
- Click the action card
- Click Delete
- Confirm deletion
Action Limits
| Plan | Actions |
|---|---|
| Free | 1 |
| Pro | 5 |
| Business | Unlimited |
Best Practices
Write clear 'When to Use' descriptions
Write clear 'When to Use' descriptions
Be specific about when the agent should trigger each action. This helps the AI make better decisions.
Test actions in Playground
Test actions in Playground
Always test new actions in the Playground before deploying to production.
Keep data collection minimal
Keep data collection minimal
Only collect information you actually need. Long forms reduce completion rates.
Set up human handoff for complex issues
Set up human handoff for complex issues
Always have a human handoff option for issues the AI cannot resolve.
Troubleshooting
Action not triggering
Action not triggering
- Check that the action is enabled
- Review the “When to Use” description
- Test with explicit trigger phrases
- Ensure the integration is connected (for integration actions)
Cannot create more actions
Cannot create more actions
- Check your plan’s action limit
- Upgrade to add more actions
- Delete unused actions to free up slots
Integration action failing
Integration action failing
- Verify the integration is connected
- Check integration credentials are valid
- Review integration-specific settings