> ## Documentation Index
> Fetch the complete documentation index at: https://docs.periskope.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Activation

> Configure when your AI Agent responds, how long it waits, and the hours it operates in

The Activation page controls **when** the AI Agent responds. Access it through **AI** > **Activation**.

<Frame caption="Activation settings">
  <img className="block border rounded-xl shadow" src="https://mintcdn.com/bharatkumarramesh/0SloCkEgc23pVeuy/ai/images/new-agent-setup/settings-1.1.png?fit=max&auto=format&n=0SloCkEgc23pVeuy&q=85&s=e0971b3b5e17aa548eba1705f3e6bdd8" alt="Activation" width="1676" height="994" data-path="ai/images/new-agent-setup/settings-1.1.png" />
</Frame>

<Note>
  Turning the agent on or off is done from the [**Overview**](/ai/agent/overview) page, not here. The AI's name and personality live on [**Personalization**](/ai/agent/personalization).
</Note>

Changes on this page are staged. A save bar appears at the bottom showing how many unsaved changes you have — click **Save changes** to apply them, or **Discard** to revert.

## Customize Activation Rules

Fine-tune which messages should trigger the AI. Click **Activation prompt** to open the editor, which has two parts:

* **Base Activation Rules (Read-only)** — the built-in criteria the AI always evaluates:
  * Messages that raise an issue, complaint, technical problem, or concern
  * Messages that request an action, assistance, or support
  * Messages that appear to require business attention
* **Custom Activation Rules** — your own additions, for example:
  * "Do NOT activate if it's just a greeting without a question"
  * "Do NOT activate if the message is a simple acknowledgment like 'Ok', 'Thanks', 'Got it'"
  * "Activate if the customer mentions a specific product by name"

Custom rules are **additive** — they extend the base rules rather than replace them.

## Chat Activation Mode

Controls whether the AI is on or off by default across your chats:

| Mode | Behavior |
| - | - |
| **Auto-activate for all chats** | AI is ON for all conversations. You can manually disable it per chat. |
| **Manual activation per chat** | AI is OFF by default. You enable it only for specific chats where you want responses. |

<Tip>
  Start with **Manual activation** while you're testing, then switch to **Auto-activate** once you're confident in your configuration.
</Tip>

### AI Settings in a Chat

When you open the **Settings tab** of a chat, you'll find two AI-specific toggles that control how the AI behaves in that particular conversation.

<Frame caption="Settings tab">
  <img src="https://mintcdn.com/bharatkumarramesh/d8BrOFlshOw-WS0_/images/image-3.png?fit=max&auto=format&n=d8BrOFlshOw-WS0_&q=85&s=26a0ac9787389b4c8288e63d68e5e267" alt="Image" width="740" height="320" data-path="images/image-3.png" />
</Frame>

#### Allow AI Flagging

When enabled, the AI will automatically flag important or sensitive messages in this chat for your team's attention — so nothing critical gets missed in a busy conversation.

#### Allow AI Agent

When enabled, the AI Agent is active in this chat and can respond to customer messages automatically, based on your knowledge base and configured tools. Turn this off if you want a team member to handle the conversation manually.

> **Note:** These toggles are per-chat settings. Turning off Allow AI Agent in one chat does not affect other chats where it is enabled.

## Operational Settings

<Frame caption="Operational Settings">
  <img className="block border rounded-xl shadow" src="https://mintcdn.com/bharatkumarramesh/3ThqeAfioGUfE-9-/ai/images/new-agent-setup/settings-2.png?fit=max&auto=format&n=3ThqeAfioGUfE-9-&q=85&s=c3e10322dbd5884061147001099d97f4" alt="Operational Settings" width="2658" height="1652" data-path="ai/images/new-agent-setup/settings-2.png" />
</Frame>

### Allowed Phone Numbers

Restrict which phone numbers the AI Agent is active on. When set, the AI will only respond on conversations coming from or going to the listed numbers. Leave empty to allow all numbers.

### Response Delay

How long the AI waits after activation criteria is met before actually sending a response.

* **Default**: 3 seconds
* **Range**: 3–6000 seconds
* This gives your human agents a window to respond first. If a human replies within the delay window, the AI will stand down.

### Snooze Duration

How long the AI stays inactive after a human agent has responded or manually snoozed it.

* **Default**: 30 seconds
* **Range**: 0–6000 seconds
* During the snooze period, the AI will not respond to any new messages, allowing the human agent to fully handle the conversation.
* After the snooze period, the AI automatically returns to INACTIVE state and resumes monitoring for activation criteria.

### Operating Hours

Define specific hours and a timezone when the AI should be active. Outside these hours, the AI will not respond automatically, even if activation criteria are met. Useful if you only want AI coverage during office hours, off-hours, or weekends.

## Internal Contacts

The AI Agent automatically skips messages from contacts marked as internal team members. This ensures the AI only handles external customer conversations and never interferes with internal communications.

<Frame caption="Internal Contacts">
  <img className="block border rounded-xl shadow" src="https://mintcdn.com/bharatkumarramesh/3ThqeAfioGUfE-9-/ai/images/new-agent-setup/internal-contacts.png?fit=max&auto=format&n=3ThqeAfioGUfE-9-&q=85&s=cfe98d8f8b03b5da89367b1783590a17" alt="Internal Contacts" width="2652" height="1646" data-path="ai/images/new-agent-setup/internal-contacts.png" />
</Frame>

Go to **AI** > **Internal Contacts** to view, add, or remove contacts from the internal list. You can search by name or phone number.

<Note>
  When an internal contact replies in a conversation, the AI Agent is automatically snoozed for the configured snooze duration.
</Note>

## Next Steps

* **[Personalization](/ai/agent/personalization)** - Define the AI's name, role, instructions, and personality
* **[Knowledge Base](/ai/agent/training)** - Train the AI with FAQs, documents, and self-learned context
* **[Built-in Tools](/ai/agent/built-in-tools)** - Configure what actions the AI can take
* **[Custom Tools](/ai/agent/custom-tools)** - Connect the AI to your own APIs


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.