Docs/AI Actions/AI Actions Overview

AI Actions Overview

AI Actions let your agent automatically trigger real-world workflows mid-conversation — sending emails, calling APIs, or sharing booking links — without any human hand-off. Each action is scoped to a single agent and fires based on trigger keywords you define.

Three action types

TypeWhat it doesBest for
EmailSends an HTML email to a specified address with conversation data in the subject and bodyLead notifications, support alerts, internal escalations
API / WebhookMakes an HTTP request (GET, POST, PUT, PATCH) to any URL with a JSON body you defineCRM updates, ticket creation, Slack alerts, custom integrations
CalendarReturns a Calendly or Cal.com booking link in the chat so the visitor can self-scheduleDemo bookings, support calls, consultation requests

How triggering works

Each action has a Trigger keywords field (comma-separated phrases) and a When to use description. The system checks the visitor's latest message against your trigger phrases in two ways:

  • Single-word triggers — matched as a whole word using word-boundary rules (e.g. "book" won't match "Facebook").
  • Multi-word triggers — matched as a substring anywhere in the message (e.g. "schedule demo" matches "I'd like to schedule a demo call").
  • The AI also uses the "When to use" description to intelligently decide when to fire the action, even without an exact keyword match.
  • Trigger phrases must be at least 3 characters. Matching is case-insensitive.

Execution tracking

Every time an action fires, the system records an execution entry with:

  • Status — pending, success, or failed.
  • Payload — the data that was sent.
  • Response — the server response (HTTP body, truncated).
  • Error message — populated on failure.
  • Timestamp — when it fired.

The action card in your dashboard shows the total execution_count and last_executed_at so you can see how active each action is at a glance.

AI Actions vs Zapier

FeatureAI ActionsZapier Integration
ScopePer agentOrganization-wide (all agents)
TriggerConversation keyword / AI intent detectionSystem events (lead captured, conversation started/ended, message received)
SetupSettings → AI Actions tab of each agentSettings → Integrations → Zapier
Use caseMid-conversation workflows (email alerts, booking links, CRM webhooks)Post-event automation (add to Google Sheets, notify Slack on new lead)

Plan limits

The number of AI Actions you can create per agent is determined by your plan. Your current limit is shown at the top of the AI Actions tab. Upgrade your plan to increase the limit.

Creating your first action

1

Open your agent

Go to Agents, click your agent, then open the Settings tab.
2

Click AI Actions

Scroll to the AI Actions section and click Add Action.
3

Choose an action type

Select Email, Calendar, or API / Webhook.
4

Fill in the form

Give the action a name, describe when the agent should use it, then configure the type-specific settings.
5

Add trigger keywords (optional)

Enter comma-separated phrases like book demo, schedule call, set up meeting.
6

Save and test

Click Save, then open the Preview chat and type one of your trigger phrases to verify the action fires.

Was this page helpful?