Start runs by hand or from a file, follow every step on the run page, approve or edit what the agent wants to do, and tell it what it needs to know.
A run is one mission working with one person, or with everyone at one company. Open a mission to see its runs.
The Runs tab
The cards at the top count open runs, runs that need you, goals reached, and credits used this month.Each row shows the person, the run’s status, its last and next step, how many messages it sent, and which day of the run it’s on. Test runs have a Test tag. You can search, or filter to open runs, runs that need you, goals reached, or stopped and failed runs.
Status
Meaning
Needs you
Waiting for your approval or answer.
Working
The agent is on it now.
Scheduled
The agent checks in again later.
Waiting on teammate
A Linear task it created is still open.
On hold
A rule held it. The reason shows under the status.
Paused
You paused it, or it ran out of credits.
Goal reached, Failed, Stopped
It ended.
Start runs by hand
Click Start a run on a live mission.
One person
Enter their email. Add a brief if the agent should do something first, like “Check their open tickets first”. Click Start run.
From a file
Upload a CSV or Excel file, up to 5 MB and 1,000 rows, with an email column. Name, phone, company, and attributes are optional. Download CSV template gives you an example.Match your columns, then click Start runs. A message tells you how many runs started and who was skipped and why, such as no email or already in a run.
A person can only be in one open run at a time, across all missions on the AI agent.
From Contacts
In Contacts, select people and click Start mission.
Pick a live mission and confirm. You can start up to 1,000 people at once.
The run page
Click a run to open it. The timeline lists every step, newest at the bottom. The Details panel on the right shows the person, the goal, the dates, and this week’s messages.
The timeline
Click any step to see more.
Step
Shows
Run started
How it started: a rule, by hand, or a test.
Email to…, WhatsApp to…, Call to…
The message, or the call summary with a link to the recording.
… replied by email
The reply, and whether it woke the agent and why.
Approval: …
An action waiting for you, or what you decided.
Question from the agent
Its question and your answer.
On hold: …
A message a guardrail held.
Reached: …
A milestone.
Agent worked · N steps
Background work, like reading conversations and updating the plan.
Run ended
Goal reached, failed, or stopped, with the reason.
When a run needs you
A bar above the message box shows what’s waiting. Click Review or Answer.
For an approval, you can approve it, Edit it first, or Skip it. Editing lets you change an email’s subject and message, or a WhatsApp message, then Save and send. If you skip, the agent picks another step.For a question, click an answer or type your own. After 3 days with no answer, the agent decides itself.
Tell the agent
Type in the box at the bottom to tell the agent something, like “She’s away until Monday”. It reads it right away.
Log an event
Click Log an event when something happened that Chatbase didn’t see.
Pick what happened, such as a booked call or a reply somewhere else, or write a custom event. Add details, then choose to wake the agent now, just add it to what the agent knows, or end the run as a success.
Pause, stop, or end a run
Pause run stops the agent on this run until you resume it. The ⋯ menu can also:
Stop run, so the agent never contacts them again in this mission. You can start a new run later.
Mark goal reached, with the outcome they reached.
Mark as failed, with a short reason.
The Details panel
The Run actions without approval switch here changes the whole mission, not just this run. Approvals explains it.
People lists everyone on the run and whether they’ve been contacted. You can pause missions for one person, or for their whole company. Replies still reach your AI agent.
Plan shows the steps the agent plans next.
Memory shows facts the agent saved about the account.
Failed steps
If a step fails, like an email that couldn’t send, the timeline shows the error and a Retry button. Some steps retry on their own.When a run ends, click Start a new run to try again with the same person.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Chatbase","colors":{"primary":"#18181b","light":"#f4f4f5","dark":"#18181b"},"logo":{"light":"https://mintcdn.com/chatbase/pJU9vM3D9oN_YQME/logo/light.svg?fit=max\u0026auto=format\u0026n=pJU9vM3D9oN_YQME\u0026q=85\u0026s=a45a73af7ac778cd0920dbb6ad1aaa93","dark":"https://mintcdn.com/chatbase/8k6_6eFSz4sj8EO0/logo/dark.svg?fit=max\u0026auto=format\u0026n=8k6_6eFSz4sj8EO0\u0026q=85\u0026s=c0c106d2f92f6a87f872a2be66706041","href":"https://chatbase.co"},"favicon":"https://mintcdn.com/chatbase/NsUPSmNqecm03uiz/favicon.ico?fit=max\u0026auto=format\u0026n=NsUPSmNqecm03uiz\u0026q=85\u0026s=b37388fc54cd76cfaf3efcb8ab4a4dc8","appearance":{},"navbar":{"links":[{"href":"https://chatbase.co/help","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://www.chatbase.co/dashboard"}},"footer":{"socials":{"x":"https://x.com/chatbase_co","linkedin":"https://linkedin.com/company/chatbase-co","youtube":"https://www.youtube.com/@chatbase_"}},"seo":{"metatags":{"canonical":"https://www.chatbase.co/docs"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"metadata":{"timestamp":false},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"chatbase","hasAudioNarration":false,"actualSubdomain":"chatbase","customDomains":["chatbase.co"],"gitSource":{"type":"github","owner":"chatbase-co","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afc9173fb29084f48a0a06c","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"default","tag":"User Guide","count":118},{"language":"default","tag":"API Reference","count":92},{"language":"default","tag":"Endpoints","count":78},{"language":"default","tag":"API v2","count":71},{"language":"default","tag":"Helpdesk","count":40},{"language":"default","tag":"Integrations","count":36},{"language":"default","tag":"Developer Guide","count":32},{"language":"default","tag":"AI Agent Management","count":32},{"language":"default","tag":"SDKs","count":26},{"language":"default","tag":"Actions","count":22}]},"assistantConfig":{},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".nav-dropdown-trigger{border-color:transparent!important;border-bottom-color:rgb(var(--gray-500) / 0.2)!important;border-radius:0!important;padding:0.5rem 0.875rem 0.875rem 1rem!important}.nav-dropdown-trigger .nav-dropdown-item-icon{display:none!important}.nav-dropdown-trigger .nav-dropdown-item-text-container{padding-left:0!important}.nav-dropdown-trigger .nav-dropdown-item-title{font-weight:600!important}.nav-dropdown-item-title::after{display:inline-block;margin-left:0.5rem;padding:0.125rem 0.5rem;border-radius:0.375rem;font-size:0.7rem;font-weight:600;line-height:1.2;vertical-align:middle}:is(.nav-dropdown-trigger,.nav-dropdown-item):has([style*=\"/code.svg\"]) .nav-dropdown-item-title::after{content:\"Current\";color:rgb(22 163 74);background:rgb(22 163 74 / 0.12)}:is(.nav-dropdown-trigger,.nav-dropdown-item):has([style*=\"/box-archive.svg\"]) .nav-dropdown-item-title::after{content:\"Deprecated\";color:rgb(217 119 6);background:rgb(217 119 6 / 0.12)}"}],"page":{"pagePath":"user-guides/missions/runs","slug":"/user-guides/missions/runs","pageMetadata":{"title":"How to start, follow, and approve mission runs","sidebarTitle":"Runs","description":"Start runs by hand or from a file, follow every step on the run page, approve or edit what the agent wants to do, and tell it what it needs to know.","icon":"list-check","href":"/user-guides/missions/runs"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Start runs by hand or from a file, follow every step on the run page, approve or edit what the agent wants to do, and tell it what it needs to know.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,li:`li`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Frame,Heading,Note,OptimizedImage,Table}=_components;if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`A run is one mission working with one person, or with everyone at one company. Open a mission to see its runs.`}),`\n`,_jsx(Heading,{level:`2`,id:`the-runs-tab`,children:`The Runs tab`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/runs-tab.png?fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=86f9ffb3b72163e35e4df4c09c2e4d42`,alt:`The Runs tab`,\"data-og-width\":`1422`,width:`1422`,\"data-og-height\":`840`,height:`840`,\"data-path\":`user-guides/missions/images/runs-tab.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/runs-tab.png?w=280\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=30f537eddd8c0d8466326cf78a9a400c 280w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/runs-tab.png?w=560\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=62632a2cd29a5f8e894f4bfe4c043851 560w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/runs-tab.png?w=840\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=12dc16ba13b7b97b9f541c02dae8fa69 840w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/runs-tab.png?w=1100\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=179c4b9229f0ab8658d37c9771f09fe0 1100w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/runs-tab.png?w=1650\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=2bf039154c61712fc76a1c68e6f20091 1650w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/runs-tab.png?w=2500\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=b8f349fabf6c2173e41d8a24477cdff9 2500w`})}),`\n`,_jsx(_components.p,{children:`The cards at the top count open runs, runs that need you, goals reached, and credits used this month.`}),`\n`,_jsxs(_components.p,{children:[`Each row shows the person, the run’s status, its last and next step, how many messages it sent, and which day of the run it’s on. Test runs have a `,_jsx(_components.strong,{children:`Test`}),` tag. You can search, or filter to open runs, runs that need you, goals reached, or stopped and failed runs.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Needs you`})}),_jsx(_components.td,{children:`Waiting for your approval or answer.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Working`})}),_jsx(_components.td,{children:`The agent is on it now.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Scheduled`})}),_jsx(_components.td,{children:`The agent checks in again later.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Waiting on teammate`})}),_jsx(_components.td,{children:`A Linear task it created is still open.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`On hold`})}),_jsx(_components.td,{children:`A rule held it. The reason shows under the status.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Paused`})}),_jsx(_components.td,{children:`You paused it, or it ran out of credits.`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Goal reached`}),`, `,_jsx(_components.strong,{children:`Failed`}),`, `,_jsx(_components.strong,{children:`Stopped`})]}),_jsx(_components.td,{children:`It ended.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`start-runs-by-hand`,children:`Start runs by hand`}),`\n`,_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Start a run`}),` on a live mission.`]}),`\n`,_jsx(Heading,{level:`3`,id:`one-person`,children:`One person`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/start-run-one-person.png?fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=afec37bd7cd31ba01ec5a2f77b1e86b9`,alt:`Start a run for one person`,\"data-og-width\":`1180`,width:`1180`,\"data-og-height\":`830`,height:`830`,\"data-path\":`user-guides/missions/images/start-run-one-person.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/start-run-one-person.png?w=280\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=5c33ae8a98192042902a9faf2c9bc31f 280w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/start-run-one-person.png?w=560\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=bff62e0243768dc66da53553c2062020 560w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/start-run-one-person.png?w=840\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=132016d8a8530f71368ad1d4d0371a85 840w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/start-run-one-person.png?w=1100\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=d7874ec55ccab48693d5553cf8d8743a 1100w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/start-run-one-person.png?w=1650\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=93a885d4379747f6b33e7b3f5ac76524 1650w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/start-run-one-person.png?w=2500\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=4368e876d9a877532b008f1e1917ebb4 2500w`})}),`\n`,_jsxs(_components.p,{children:[`Enter their email. Add a brief if the agent should do something first, like “Check their open tickets first”. Click `,_jsx(_components.strong,{children:`Start run`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`from-a-file`,children:`From a file`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/start-run-upload.png?fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=c5bcfa9f83f6d01ceb0cd8e044dd1266`,alt:`Start runs from a file`,\"data-og-width\":`1180`,width:`1180`,\"data-og-height\":`900`,height:`900`,\"data-path\":`user-guides/missions/images/start-run-upload.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/start-run-upload.png?w=280\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=17bcbe05131e86dcd0caa2a825a97dbd 280w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/start-run-upload.png?w=560\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=227888e1108fa04659f8c2774d30a628 560w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/start-run-upload.png?w=840\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=b24d1fe165d3109912710c1e75898697 840w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/start-run-upload.png?w=1100\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=a5a3c9ecc5fbceb3a716feb1a00f2ee9 1100w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/start-run-upload.png?w=1650\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=bb2710d95e99b0a74d00a9bfc26f82bb 1650w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/start-run-upload.png?w=2500\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=9fa7649d58b021deaafc75bae72d461e 2500w`})}),`\n`,_jsxs(_components.p,{children:[`Upload a CSV or Excel file, up to 5 MB and 1,000 rows, with an email column. Name, phone, company, and attributes are optional. `,_jsx(_components.strong,{children:`Download CSV template`}),` gives you an example.`]}),`\n`,_jsxs(_components.p,{children:[`Match your columns, then click `,_jsx(_components.strong,{children:`Start runs`}),`. A message tells you how many runs started and who was skipped and why, such as no email or already in a run.`]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`A person can only be in one open run at a time, across all missions on the AI agent.`})}),`\n`,_jsx(Heading,{level:`3`,id:`from-contacts`,children:`From Contacts`}),`\n`,_jsxs(_components.p,{children:[`In `,_jsx(_components.strong,{children:`Contacts`}),`, select people and click `,_jsx(_components.strong,{children:`Start mission`}),`.`]}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/contacts-start-mission.png?fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=3d242b75da111dd9578bf32f90b7180c`,alt:`Contacts selected, with Start mission`,\"data-og-width\":`1372`,width:`1372`,\"data-og-height\":`874`,height:`874`,\"data-path\":`user-guides/missions/images/contacts-start-mission.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/contacts-start-mission.png?w=280\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=4ab5adc5d59cd1aad4d591766e0fe808 280w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/contacts-start-mission.png?w=560\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=3decd5a912fe142fb10daf190d54dd05 560w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/contacts-start-mission.png?w=840\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=63f947a45f01f29099955eaa90c8020b 840w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/contacts-start-mission.png?w=1100\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=2f29c36d1eae362a5c0f8ee1b600bede 1100w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/contacts-start-mission.png?w=1650\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=c47b42ee8a8ecd723f08c90f12d013c2 1650w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/contacts-start-mission.png?w=2500\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=6f7cf3b0fc5be8fda91129e75720cb07 2500w`})}),`\n`,_jsx(_components.p,{children:`Pick a live mission and confirm. You can start up to 1,000 people at once.`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/start-mission-dialog.png?fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=43a7814a00821ed46327a8edd1a5f7ee`,alt:`The Start a mission dialog`,\"data-og-width\":`1480`,width:`1480`,\"data-og-height\":`700`,height:`700`,\"data-path\":`user-guides/missions/images/start-mission-dialog.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/start-mission-dialog.png?w=280\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=f2414f9bc71e55cd63e22fd4bd1d9eb1 280w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/start-mission-dialog.png?w=560\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=9a6080543eb425c58c483f6c1bb40950 560w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/start-mission-dialog.png?w=840\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=c9eeb53b2f8ac22388d3afefbb4dfd6c 840w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/start-mission-dialog.png?w=1100\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=3069507fa6e306f1354b2f656d0ad121 1100w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/start-mission-dialog.png?w=1650\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=e9fb2b509b5ee181a509aa1502a1859f 1650w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/start-mission-dialog.png?w=2500\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=255bffb464638ccf8666f8079827cb1e 2500w`})}),`\n`,_jsx(Heading,{level:`2`,id:`the-run-page`,children:`The run page`}),`\n`,_jsxs(_components.p,{children:[`Click a run to open it. The timeline lists every step, newest at the bottom. The `,_jsx(_components.strong,{children:`Details`}),` panel on the right shows the person, the goal, the dates, and this week’s messages.`]}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/run-page.png?fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=93e54d571835e898bb2925bb20f12118`,alt:`A run page`,\"data-og-width\":`1422`,width:`1422`,\"data-og-height\":`840`,height:`840`,\"data-path\":`user-guides/missions/images/run-page.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/run-page.png?w=280\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=4aba8749946acb86e2cec102185aa160 280w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/run-page.png?w=560\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=cf40422e1bf2395856501c08a8b305b9 560w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/run-page.png?w=840\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=24c528dd7cdaf7c242e77ae00c3077c1 840w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/run-page.png?w=1100\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=5b20e848a83010e2ba4a35069968d2e5 1100w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/run-page.png?w=1650\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=f0cd738cab8d399f817d82dd354e0b5d 1650w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/run-page.png?w=2500\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=dc074248a9fd0b32c1c5141b3abc9a12 2500w`})}),`\n`,_jsx(Heading,{level:`3`,id:`the-timeline`,children:`The timeline`}),`\n`,_jsx(_components.p,{children:`Click any step to see more.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Step`}),_jsx(_components.th,{children:`Shows`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Run started`})}),_jsx(_components.td,{children:`How it started: a rule, by hand, or a test.`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Email to…`}),`, `,_jsx(_components.strong,{children:`WhatsApp to…`}),`, `,_jsx(_components.strong,{children:`Call to…`})]}),_jsx(_components.td,{children:`The message, or the call summary with a link to the recording.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`… replied by email`})}),_jsx(_components.td,{children:`The reply, and whether it woke the agent and why.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Approval: …`})}),_jsx(_components.td,{children:`An action waiting for you, or what you decided.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Question from the agent`})}),_jsx(_components.td,{children:`Its question and your answer.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`On hold: …`})}),_jsx(_components.td,{children:`A message a guardrail held.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Reached: …`})}),_jsx(_components.td,{children:`A milestone.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Agent worked · N steps`})}),_jsx(_components.td,{children:`Background work, like reading conversations and updating the plan.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Run ended`})}),_jsx(_components.td,{children:`Goal reached, failed, or stopped, with the reason.`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`when-a-run-needs-you`,children:`When a run needs you`}),`\n`,_jsxs(_components.p,{children:[`A bar above the message box shows what’s waiting. Click `,_jsx(_components.strong,{children:`Review`}),` or `,_jsx(_components.strong,{children:`Answer`}),`.`]}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/run-needs-you.png?fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=54e518f85f0f0b29e84f4fc67d9ebf44`,alt:`A run waiting for an answer`,\"data-og-width\":`1422`,width:`1422`,\"data-og-height\":`840`,height:`840`,\"data-path\":`user-guides/missions/images/run-needs-you.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/run-needs-you.png?w=280\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=7f713d748b83e4ba893dcf21a84fbce7 280w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/run-needs-you.png?w=560\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=c72272e22c93abb2e9dc4b97ead872bc 560w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/run-needs-you.png?w=840\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=4f2c0523768a04403ed8dc8895732922 840w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/run-needs-you.png?w=1100\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=c6a3f9d81355fb5d0a7eef9d956f22e4 1100w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/run-needs-you.png?w=1650\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=06f56a2b432e0170bb12f7862db9f049 1650w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/run-needs-you.png?w=2500\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=f47976db4278acae7eafd9a02c833957 2500w`})}),`\n`,_jsxs(_components.p,{children:[`For an approval, you can approve it, `,_jsx(_components.strong,{children:`Edit`}),` it first, or `,_jsx(_components.strong,{children:`Skip`}),` it. Editing lets you change an email’s subject and message, or a WhatsApp message, then `,_jsx(_components.strong,{children:`Save and send`}),`. If you skip, the agent picks another step.`]}),`\n`,_jsx(_components.p,{children:`For a question, click an answer or type your own. After 3 days with no answer, the agent decides itself.`}),`\n`,_jsx(Heading,{level:`3`,id:`tell-the-agent`,children:`Tell the agent`}),`\n`,_jsx(_components.p,{children:`Type in the box at the bottom to tell the agent something, like “She’s away until Monday”. It reads it right away.`}),`\n`,_jsx(Heading,{level:`3`,id:`log-an-event`,children:`Log an event`}),`\n`,_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Log an event`}),` when something happened that Chatbase didn’t see.`]}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/log-event.png?fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=45e35189169f791e392112614ec778e9`,alt:`The Log an event dialog`,\"data-og-width\":`1160`,width:`1160`,\"data-og-height\":`870`,height:`870`,\"data-path\":`user-guides/missions/images/log-event.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/log-event.png?w=280\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=6d21633ba7670e02eca300b54e87b854 280w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/log-event.png?w=560\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=26d55edecc9be9e4f7c84e9a7ff9d0be 560w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/log-event.png?w=840\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=d8f619b4e232f0a00eb0ae3ec91aa4ac 840w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/log-event.png?w=1100\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=e5eb2176c46d72ff1521313a177046df 1100w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/log-event.png?w=1650\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=4b2ce17318716f3b3f04cfcd609261f7 1650w, https://mintcdn.com/chatbase/J9oopG46WMTX3-j2/user-guides/missions/images/log-event.png?w=2500\u0026fit=max\u0026auto=format\u0026n=J9oopG46WMTX3-j2\u0026q=85\u0026s=201bfca3773df1d7034f631ea65d1d5d 2500w`})}),`\n`,_jsx(_components.p,{children:`Pick what happened, such as a booked call or a reply somewhere else, or write a custom event. Add details, then choose to wake the agent now, just add it to what the agent knows, or end the run as a success.`}),`\n`,_jsx(Heading,{level:`3`,id:`pause-stop-or-end-a-run`,children:`Pause, stop, or end a run`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Pause run`}),` stops the agent on this run until you resume it. The `,_jsx(_components.strong,{children:`⋯`}),` menu can also:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Stop run`}),`, so the agent never contacts them again in this mission. You can start a new run later.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Mark goal reached`}),`, with the outcome they reached.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Mark as failed`}),`, with a short reason.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`the-details-panel`,children:`The Details panel`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`The `,_jsx(_components.strong,{children:`Run actions without approval`}),` switch here changes the whole mission, not just this run. `,_jsx(_components.a,{href:`/user-guides/missions/configure-a-mission#approvals`,children:`Approvals`}),` explains it.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`People`}),` lists everyone on the run and whether they’ve been contacted. You can pause missions for one person, or for their whole company. Replies still reach your AI agent.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Plan`}),` shows the steps the agent plans next.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Memory`}),` shows facts the agent saved about the account.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`failed-steps`,children:`Failed steps`}),`\n`,_jsxs(_components.p,{children:[`If a step fails, like an email that couldn’t send, the timeline shows the error and a `,_jsx(_components.strong,{children:`Retry`}),` button. Some steps retry on their own.`]}),`\n`,_jsxs(_components.p,{children:[`When a run ends, click `,_jsx(_components.strong,{children:`Start a new run`}),` to try again with the same person.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"How to start, follow, and approve mission runs","sidebarTitle":"Runs","description":"Start runs by hand or from a file, follow every step on the run page, approve or edit what the agent wants to do, and tell it what it needs to know.","icon":"list-check","href":"/user-guides/missions/runs"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"The Runs tab","slug":"the-runs-tab","depth":2,"children":[]},{"title":"Start runs by hand","slug":"start-runs-by-hand","depth":2,"children":[{"title":"One person","slug":"one-person","depth":3,"children":[]},{"title":"From a file","slug":"from-a-file","depth":3,"children":[]},{"title":"From Contacts","slug":"from-contacts","depth":3,"children":[]}]},{"title":"The run page","slug":"the-run-page","depth":2,"children":[{"title":"The timeline","slug":"the-timeline","depth":3,"children":[]},{"title":"When a run needs you","slug":"when-a-run-needs-you","depth":3,"children":[]},{"title":"Tell the agent","slug":"tell-the-agent","depth":3,"children":[]},{"title":"Log an event","slug":"log-an-event","depth":3,"children":[]},{"title":"Pause, stop, or end a run","slug":"pause-stop-or-end-a-run","depth":3,"children":[]},{"title":"The Details panel","slug":"the-details-panel","depth":3,"children":[]},{"title":"Failed steps","slug":"failed-steps","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":[],"subdomain":"chatbase","siteName":"Chatbase","title":"How to start, follow, and approve mission runs - Chatbase","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-17T17:40:12.887Z","originalFileLocation":"user-guides/missions/runs.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Start runs by hand or from a file, follow every step on the run page, approve or edit what the agent wants to do, and tell it what it needs to know.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Chatbase\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/chatbase/sZYcuOsK-Dv6V9lc/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/chatbase/sZYcuOsK-Dv6V9lc/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/chatbase/sZYcuOsK-Dv6V9lc/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/chatbase/sZYcuOsK-Dv6V9lc/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/chatbase/sZYcuOsK-Dv6V9lc/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/chatbase/sZYcuOsK-Dv6V9lc/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/chatbase/sZYcuOsK-Dv6V9lc/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/chatbase/sZYcuOsK-Dv6V9lc/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/chatbase/sZYcuOsK-Dv6V9lc/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"How to start, follow, and approve mission runs - Chatbase\">\u003cmeta data-mint-head property=\"og:description\" content=\"Start runs by hand or from a file, follow every step on the run page, approve or edit what the agent wants to do, and tell it what it needs to know.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Chatbase\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.chatbase.co/docs/user-guides/missions/runs\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://chatbase.mintlify.site/docs/_mintlify/api/og/v2?division=Missions\u0026amp;title=How+to+start%2C+follow%2C+and+approve+mission+runs\u0026amp;description=Start+runs+by+hand+or+from+a+file%2C+follow+every+step+on+the+run+page%2C+approve+or+edit+what+the+agent+wants+to+do%2C+and+tell+it+what+it+needs+to+know.\u0026amp;theme=430b654938fc40910c40f1cb\u0026amp;signature=178c241cd426087460977b7393a9135c1dee8b2c19f3d781b55120117d9abb55\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"How to start, follow, and approve mission runs - Chatbase\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Start runs by hand or from a file, follow every step on the run page, approve or edit what the agent wants to do, and tell it what it needs to know.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://chatbase.mintlify.site/docs/_mintlify/api/og/v2?division=Missions\u0026amp;title=How+to+start%2C+follow%2C+and+approve+mission+runs\u0026amp;description=Start+runs+by+hand+or+from+a+file%2C+follow+every+step+on+the+run+page%2C+approve+or+edit+what+the+agent+wants+to+do%2C+and+tell+it+what+it+needs+to+know.\u0026amp;theme=430b654938fc40910c40f1cb\u0026amp;signature=178c241cd426087460977b7393a9135c1dee8b2c19f3d781b55120117d9abb55\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/chatbase/sZYcuOsK-Dv6V9lc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Chatbase\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#18181b\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.chatbase.co/docs/user-guides/missions/runs\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/user-guides/missions/runs.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.chatbase.co/#organization\",\"name\":\"Chatbase\",\"url\":\"https://www.chatbase.co\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/chatbase/pJU9vM3D9oN_YQME/logo/light.svg?fit=max\u0026auto=format\u0026n=pJU9vM3D9oN_YQME\u0026q=85\u0026s=a45a73af7ac778cd0920dbb6ad1aaa93\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.chatbase.co/docs#website\",\"name\":\"Chatbase\",\"url\":\"https://www.chatbase.co/docs\",\"publisher\":{\"@id\":\"https://www.chatbase.co/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.chatbase.co/docs/user-guides/missions/runs#webpage\",\"url\":\"https://www.chatbase.co/docs/user-guides/missions/runs\",\"name\":\"How to start, follow, and approve mission runs\",\"description\":\"Start runs by hand or from a file, follow every step on the run page, approve or edit what the agent wants to do, and tell it what it needs to know.\",\"dateModified\":\"2026-11-17T17:40:12.887Z\",\"isPartOf\":{\"@id\":\"https://www.chatbase.co/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.chatbase.co/docs/user-guides/missions/runs#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.chatbase.co/docs/user-guides/missions/runs#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Missions\",\"item\":\"https://www.chatbase.co/docs/user-guides/missions/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"How to start, follow, and approve mission runs\",\"item\":\"https://www.chatbase.co/docs/user-guides/missions/runs\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://www.chatbase.co/docs/user-guides/missions/runs#article\",\"headline\":\"How to start, follow, and approve mission runs\",\"name\":\"How to start, follow, and approve mission runs\",\"description\":\"Start runs by hand or from a file, follow every step on the run page, approve or edit what the agent wants to do, and tell it what it needs to know.\",\"url\":\"https://www.chatbase.co/docs/user-guides/missions/runs\",\"mainEntityOfPage\":{\"@id\":\"https://www.chatbase.co/docs/user-guides/missions/runs#webpage\"},\"dateModified\":\"2026-11-17T17:40:12.887Z\",\"publisher\":{\"@id\":\"https://www.chatbase.co/#organization\"},\"isPartOf\":{\"@id\":\"https://www.chatbase.co/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Chatbase\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Chatbase\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/user-guides/missions/runs.md","siteName":"Chatbase","nav":{"global":null,"tabs":[{"tab":"User Guide","groups":[{"group":"Quick Start","pages":[{"title":"What is Chatbase? AI agents for customer support","sidebarTitle":"Welcome to Chatbase","icon":"sparkles","href":"/user-guides/quick-start/introduction"},{"title":"Build your first AI agent in minutes","sidebarTitle":"Build Your First AI Agent","icon":"rocket","href":"/user-guides/quick-start/your-first-agent"},{"title":"Best practices to improve your AI agent's answers","sidebarTitle":"Best Practices","icon":"star","href":"/user-guides/quick-start/best-practices"}]},{"group":"AI Agent Management","pages":[{"title":"Backstage: manage your AI agent with an AI assistant","sidebarTitle":"Backstage","icon":"sparkles","href":"/user-guides/chatbot/backstage"},{"title":"Preview and test your AI agent in the Playground","sidebarTitle":"Playground","icon":"play","href":"/user-guides/chatbot/playground"},{"title":"Write your AI agent's instructions and choose its model","sidebarTitle":"Build","icon":"wrench","href":"/user-guides/chatbot/build"},{"title":"Save drafts, publish changes, and restore versions of your AI agent","sidebarTitle":"Drafts and versions","icon":"clock-rotate-left","href":"/user-guides/chatbot/versions"},{"title":"Train your AI agent on your website, files, and data","sidebarTitle":"Data Sources","icon":"database","href":"/user-guides/chatbot/data-sources"},{"title":"Deploy your AI agent on your website, messaging apps, and phone","sidebarTitle":"Channels","icon":"signal-stream","href":"/user-guides/chatbot/channels"},{"group":"Actions","icon":"bolt","pages":[{"title":"AI agent Actions: let your agent take action for customers","sidebarTitle":"Overview","icon":"book","href":"/user-guides/chatbot/actions/actions-overview"},{"title":"Hand off AI agent conversations to a human","sidebarTitle":"Escalations","icon":"users","href":"/user-guides/chatbot/actions/escalate-to-human"},{"title":"Hand off conversations to live chat in Chatbase Helpdesk","sidebarTitle":"Chatbase Live Chat","icon":"circle-dot","href":"/user-guides/chatbot/actions/chatbase-live-chat"},{"title":"Hand off conversations to live chat in Freshchat","sidebarTitle":"Freshchat Live Chat","icon":"headset","href":"/user-guides/chatbot/actions/freshchat-live-chat"},{"title":"Custom Actions: connect your AI agent to any API","sidebarTitle":"Custom Action","icon":"sparkles","href":"/user-guides/chatbot/actions/custom-action"},{"title":"Stripe Actions: let customers manage subscriptions and billing in chat","sidebarTitle":"Stripe","icon":"stripe","href":"/user-guides/chatbot/actions/stripe-action"},{"title":"Custom Button: send customers a link button in chat","sidebarTitle":"Custom Button","icon":"command","href":"/user-guides/chatbot/actions/custom-button"},{"title":"Collect leads with your AI agent","sidebarTitle":"Collect Leads","icon":"person","href":"/user-guides/chatbot/actions/collect-leads"},{"title":"Collect custom details from customers in chat","sidebarTitle":"Collect Data","icon":"database","href":"/user-guides/chatbot/actions/collect-data"},{"title":"Suggested Messages: show clickable reply suggestions in chat","sidebarTitle":"Suggested Messages","icon":"message","href":"/user-guides/chatbot/actions/suggested-messages"},{"title":"Give your AI agent real-time web search","sidebarTitle":"Web Search","icon":"globe","href":"/user-guides/chatbot/actions/web-search"},{"title":"Book meetings on Cal.com from your AI agent","sidebarTitle":"Cal.com","icon":"calendar","href":"/user-guides/chatbot/actions/cal"},{"title":"Book meetings on Calendly from your AI agent","sidebarTitle":"Calendly","icon":"calendar","href":"/user-guides/chatbot/actions/calendly"},{"title":"Send Slack notifications from your AI agent","sidebarTitle":"Slack","icon":"slack","href":"/user-guides/chatbot/actions/slack"},{"title":"Salesforce Actions: create cases and hand off to live agents","sidebarTitle":"Salesforce","icon":"salesforce","href":"/user-guides/chatbot/actions/salesforce-actions"},{"title":"Shopify Actions: products, cart, orders, and returns in chat","sidebarTitle":"Shopify","icon":"shopify","href":"/user-guides/chatbot/actions/shopify-actions"},{"title":"Show Shopify products as WhatsApp product cards","sidebarTitle":"WhatsApp Catalog","icon":"whatsapp","href":"/user-guides/chatbot/actions/whatsapp-catalog"},{"title":"Transfer a voice call from your AI agent to a phone number","sidebarTitle":"Transfer to phone number","icon":"phone","href":"/user-guides/chatbot/actions/transfer-to-phone"}]},{"group":"Procedures","icon":"book","pages":[{"title":"Procedures: step-by-step workflows for your AI agent","sidebarTitle":"Overview","icon":"book","href":"/user-guides/chatbot/procedures/procedures-overview"},{"title":"How your AI agent chooses and runs Procedures","sidebarTitle":"How Procedures Run","icon":"route","href":"/user-guides/chatbot/procedures/how-procedures-run"}]},{"title":"Voice AI agent: set how your agent sounds and behaves on calls","sidebarTitle":"Voice","icon":"microphone","href":"/user-guides/chatbot/voice"},{"title":"Guardrails: protect your AI agent from spam and abuse","sidebarTitle":"Guardrails","icon":"shield-halved","href":"/user-guides/chatbot/guardrails"},{"group":"Contacts","icon":"book-user","pages":[{"title":"Contacts: personalize your AI agent for known users","sidebarTitle":"Contacts Overview","icon":"book","href":"/user-guides/chatbot/contacts/contacts-overview"},{"title":"Upload and manage contacts in Chatbase","sidebarTitle":"Uploading Contacts","icon":"upload","href":"/user-guides/chatbot/contacts/uploading-contacts"}]},{"title":"AI agent settings: general, email, Helpdesk, domains, and webhooks","sidebarTitle":"Settings","icon":"gear","href":"/user-guides/chatbot/settings"},{"title":"Set up your AI agent to answer email","sidebarTitle":"Email settings","icon":"envelope","href":"/user-guides/chatbot/email-settings"}]},{"group":"Analytics \u0026 Monitoring","pages":[{"title":"Review your AI agent's conversations, leads, and collected data","sidebarTitle":"Activity","icon":"chart-area","href":"/user-guides/chatbot/activity"},{"title":"AI agent analytics: chats, topics, sentiment, and Helpdesk metrics","sidebarTitle":"Analytics","icon":"chart-scatter","href":"/user-guides/chatbot/analytics"}]},{"group":"Outbound","pages":[{"title":"Outbound campaigns: message your contacts at scale","sidebarTitle":"Outbound Campaigns","icon":"bullhorn","href":"/user-guides/chatbot/outbound-campaigns"},{"title":"Send WhatsApp campaigns with approved message templates","sidebarTitle":"WhatsApp Campaigns","icon":"whatsapp","iconType":"brands","href":"/user-guides/chatbot/outbound-whatsapp"}]},{"group":"Missions","pages":[{"title":"What are Missions? AI follow-ups that work toward a goal","sidebarTitle":"Overview","icon":"flag","href":"/user-guides/missions/overview"},{"title":"How to create a mission in Chatbase","sidebarTitle":"Create a mission","icon":"plus","href":"/user-guides/missions/create-a-mission"},{"title":"How to configure a mission: goal, channels, and approvals","sidebarTitle":"Configure a mission","icon":"sliders","href":"/user-guides/missions/configure-a-mission"},{"title":"How to start and steer mission runs with events","sidebarTitle":"Signals and events","description":"Decide what starts a run, and what changes one while it's going.","icon":"bolt","href":"/user-guides/missions/signals-and-events"},{"title":"How to start, follow, and approve mission runs","sidebarTitle":"Runs","icon":"list-check","href":"/user-guides/missions/runs"},{"title":"How to test a mission before it goes live","sidebarTitle":"Test runs","description":"Watch days of mission work in a few minutes, before your customers see it.","icon":"flask","href":"/user-guides/missions/test-runs"},{"title":"How to measure mission results with outcomes","sidebarTitle":"Outcomes","icon":"chart-column","href":"/user-guides/missions/outcomes"},{"title":"See a contact's missions, consent, and conversations","sidebarTitle":"Contacts and Conversations","icon":"address-book","href":"/user-guides/missions/contacts-and-conversations"}]},{"group":"Workspace Management","pages":[{"title":"Manage workspaces, AI agents, and member permissions","sidebarTitle":"Manage","icon":"users-gear","href":"/user-guides/workspace/manage"},{"title":"Track message credit usage across your workspace","sidebarTitle":"Usage","icon":"chart-line","href":"/user-guides/workspace/usage"},{"title":"Workspace settings: members, plan, billing, and API keys","sidebarTitle":"Workspace settings","icon":"sliders","href":"/user-guides/workspace/settings"}]},{"group":"Security \u0026 Compliance","pages":[{"title":"Set up two-factor authentication (2FA) in Chatbase","sidebarTitle":"Two-factor authentication (2FA)","icon":"shield","href":"/user-guides/workspace/two-factor-auth"},{"title":"HIPAA compliance for AI agents on Chatbase","sidebarTitle":"HIPAA compliance","icon":"shield-check","href":"/user-guides/workspace/hipaa-compliance"}]},{"group":"Integrations","pages":[{"title":"Chatbase integrations: connect your AI agent to your tools","sidebarTitle":"Overview","icon":"puzzle-piece","href":"/user-guides/integrations/integrations-overview"},{"group":"Website Platforms","pages":[{"title":"Add an AI agent to your Webflow site","sidebarTitle":"Webflow","icon":"webflow","href":"/user-guides/integrations/webflow"},{"title":"Add an AI agent to your WordPress site","sidebarTitle":"WordPress","icon":"wordpress","href":"/user-guides/integrations/wordpress"},{"title":"Add an AI agent to your Wix site","sidebarTitle":"Wix","icon":"wix","href":"/user-guides/integrations/wix"},{"title":"Add an AI agent to your Weebly site","sidebarTitle":"Weebly","icon":"weebly","href":"/user-guides/integrations/weebly"},{"title":"Add an AI agent to your Framer site","sidebarTitle":"Framer","icon":"code","href":"/user-guides/integrations/framer"},{"title":"Add an AI agent to your Bubble app","sidebarTitle":"Bubble","icon":"code","href":"/user-guides/integrations/bubble"},{"title":"Install Chatbase on Vercel from the Vercel Marketplace","sidebarTitle":"Vercel","icon":"cloud-arrow-up","href":"/user-guides/integrations/vercel"}]},{"group":"Messaging Platforms","pages":[{"group":"WhatsApp","pages":[{"title":"Add an AI agent to WhatsApp","sidebarTitle":"WhatsApp","icon":"whatsapp","href":"/user-guides/integrations/whatsapp"},{"title":"Share your WhatsApp Business app number with your AI agent","sidebarTitle":"Business App Coexistence","icon":"mobile-screen","href":"/user-guides/integrations/whatsapp-coexistence"},{"title":"Create and send WhatsApp message templates","sidebarTitle":"WhatsApp Templates","icon":"whatsapp","href":"/user-guides/integrations/whatsapp-templates"},{"title":"WhatsApp Automations","sidebarTitle":"WhatsApp Automations","icon":"whatsapp","href":"/user-guides/integrations/whatsapp-automations"}]},{"title":"Add an AI agent to Facebook Messenger","sidebarTitle":"Messenger","icon":"facebook-messenger","href":"/user-guides/integrations/messenger"},{"title":"Add an AI agent to Instagram direct messages","sidebarTitle":"Instagram","icon":"instagram","href":"/user-guides/integrations/instagram"},{"title":"Answer phone calls with your AI agent using Twilio","sidebarTitle":"Twilio (Phone)","icon":"phone","href":"/user-guides/integrations/twilio"},{"title":"Answer phone calls with your AI agent using a SIP trunk","sidebarTitle":"SIP Trunk (Phone)","icon":"phone-volume","href":"/user-guides/integrations/sip-trunk"},{"title":"Add your AI agent to Slack","sidebarTitle":"Slack","icon":"slack","href":"/user-guides/integrations/slack"}]},{"group":"Business Tools","pages":[{"title":"Add an AI agent to your Shopify store","sidebarTitle":"Shopify","icon":"shopify","href":"/user-guides/integrations/shopify"},{"title":"Connect Stripe to your AI agent","sidebarTitle":"Stripe","icon":"stripe","href":"/user-guides/integrations/stripe"},{"group":"Zendesk","icon":"ticket","pages":[{"title":"Connect your AI agent to Zendesk tickets","sidebarTitle":"Zendesk Ticketing","icon":"ticket","href":"/user-guides/integrations/zendesk"},{"title":"Use your AI agent in Zendesk Messaging","sidebarTitle":"Zendesk Messaging","icon":"comments","href":"/user-guides/integrations/zendesk-messaging"},{"title":"Hand off to live Zendesk agents with Sunshine Conversations","sidebarTitle":"Sunshine","icon":"headset","href":"/user-guides/integrations/sunshine"}]},{"title":"Escalate AI agent conversations to Freshdesk","sidebarTitle":"Freshdesk","icon":"ticket","href":"/user-guides/integrations/freshdesk"},{"title":"Hand off AI agent conversations to Freshchat","sidebarTitle":"Freshchat","icon":"headset","href":"/user-guides/integrations/freshchat"},{"title":"Escalate AI agent conversations to Gorgias","sidebarTitle":"Gorgias","icon":"ticket","href":"/user-guides/integrations/gorgias"},{"title":"Escalate AI agent conversations to Zoho Desk","sidebarTitle":"Zoho Desk","icon":"ticket","href":"/user-guides/integrations/zohodesk"},{"title":"Escalate AI agent conversations to Intercom","sidebarTitle":"Intercom","icon":"ticket","href":"/user-guides/integrations/intercom"},{"title":"Escalate AI agent conversations to HubSpot","sidebarTitle":"HubSpot","icon":"hubspot","href":"/user-guides/integrations/hubspot"},{"title":"Connect your AI agent to Salesforce cases","sidebarTitle":"Salesforce","icon":"salesforce","href":"/user-guides/integrations/salesforce"},{"title":"Escalate AI agent conversations to Help Scout","sidebarTitle":"Help Scout","icon":"ticket","href":"/user-guides/integrations/helpscout"},{"title":"Escalate AI agent conversations to Odoo Helpdesk","sidebarTitle":"Odoo","icon":"ticket","href":"/user-guides/integrations/odoo"},{"title":"Answer customer emails with your AI agent","sidebarTitle":"Email","icon":"envelope","href":"/user-guides/integrations/email"},{"title":"Connect your AI agent to Zapier","sidebarTitle":"Zapier","icon":"bolt","href":"/user-guides/integrations/zapier"},{"title":"Connect your AI agent to viaSocket","sidebarTitle":"viaSocket","icon":"bolt","href":"/user-guides/integrations/viasocket"}]}]},{"group":"AI Performance \u0026 Quality","pages":[{"title":"Test your AI agent with simulated customers","sidebarTitle":"Tests","icon":"flask","href":"/user-guides/chatbot/tests"},{"title":"Which AI model should your agent use? Models and credits compared","sidebarTitle":"Models Comparison","icon":"scale-balanced","href":"/user-guides/chatbot/models-comparison"}]},{"group":"Helpdesk","pages":[{"title":"Chatbase Helpdesk: AI-powered ticketing and live chat","sidebarTitle":"Helpdesk Overview","icon":"headset","href":"/user-guides/chatbot/help-desk/help-desk-overview"},{"title":"How a Helpdesk ticket moves from start to finish","sidebarTitle":"Ticket lifecycle","icon":"arrows-spin","href":"/user-guides/chatbot/help-desk/ticket-lifecycle"},{"title":"Ticket statuses in the Helpdesk","sidebarTitle":"Ticket statuses","icon":"list-check","href":"/user-guides/chatbot/help-desk/ticket-statuses"},{"title":"Filter tickets in the Helpdesk inbox","sidebarTitle":"Filters","icon":"filter","href":"/user-guides/chatbot/help-desk/filters"},{"title":"Save custom inbox views in the Helpdesk","sidebarTitle":"Saved Views","icon":"bookmark","href":"/user-guides/chatbot/help-desk/saved-views"},{"title":"Export Helpdesk tickets to CSV","sidebarTitle":"Exporting tickets","icon":"file-export","href":"/user-guides/chatbot/help-desk/exporting-tickets"},{"title":"Set ticket priority in the Helpdesk","sidebarTitle":"Priority","icon":"signal","href":"/user-guides/chatbot/help-desk/priority"},{"title":"Tag tickets in the Helpdesk","sidebarTitle":"Tags","icon":"tag","href":"/user-guides/chatbot/help-desk/tags"},{"title":"Merge duplicate tickets in the Helpdesk","sidebarTitle":"Merging tickets","icon":"code-merge","href":"/user-guides/chatbot/help-desk/merging-tickets"},{"title":"Add follow-ups to a customer's open ticket","sidebarTitle":"Ticket reuse","icon":"rotate","href":"/user-guides/chatbot/help-desk/ticket-reuse"},{"title":"Helpdesk email settings: addresses, signatures, and display names","sidebarTitle":"Email Settings","icon":"envelope","href":"/user-guides/chatbot/help-desk/email-settings"},{"title":"Create support teams in the Helpdesk","sidebarTitle":"Teams","icon":"users-gear","href":"/user-guides/chatbot/help-desk/teams"},{"title":"Assign Helpdesk tickets automatically","sidebarTitle":"Ticket Assignment","icon":"users","href":"/user-guides/chatbot/help-desk/assignment-algorithm"},{"title":"Schedule agent shifts and time off in the Helpdesk","sidebarTitle":"Scheduling","icon":"calendar-clock","href":"/user-guides/chatbot/help-desk/scheduling"},{"title":"Track agent attendance in the Helpdesk","sidebarTitle":"Attendance","icon":"user-clock","href":"/user-guides/chatbot/help-desk/attendance"},{"title":"See each Helpdesk agent's daily activity","sidebarTitle":"Activity","icon":"chart-gantt","href":"/user-guides/chatbot/help-desk/activity"},{"title":"See what each Helpdesk agent is doing right now","sidebarTitle":"Live Status","icon":"signal","href":"/user-guides/chatbot/help-desk/live-status"},{"title":"Automate the Helpdesk with triggers","sidebarTitle":"Triggers","icon":"bolt","href":"/user-guides/chatbot/help-desk/triggers"},{"title":"Automations","icon":"clock","href":"/user-guides/chatbot/help-desk/automations"},{"title":"Reply to Helpdesk tickets from Slack threads","sidebarTitle":"Slack Ticket Threads","icon":"slack","href":"/user-guides/chatbot/help-desk/slack-ticket-threads"},{"title":"Collect custom ticket fields with your AI agent","sidebarTitle":"Custom Fields","icon":"tag","href":"/user-guides/chatbot/help-desk/custom-fields"},{"title":"Translate customer messages automatically in the Helpdesk","sidebarTitle":"Translation","icon":"language","href":"/user-guides/chatbot/help-desk/translation"},{"title":"Draft ticket replies with AI in the Helpdesk","sidebarTitle":"AI Draft Replies","icon":"robot","href":"/user-guides/chatbot/help-desk/ai-draft-replies"},{"title":"Save reply templates (macros) in the Helpdesk","sidebarTitle":"Macros","icon":"bolt","href":"/user-guides/chatbot/help-desk/macros"},{"title":"Helpdesk keyboard shortcuts","sidebarTitle":"Keyboard shortcuts","icon":"keyboard","href":"/user-guides/chatbot/help-desk/keyboard-shortcuts"},{"title":"Send customer satisfaction (CSAT) surveys after tickets close","sidebarTitle":"CSAT surveys","icon":"face-smile","href":"/user-guides/chatbot/help-desk/satisfaction-surveys"},{"title":"Take over AI agent conversations as a human","sidebarTitle":"Takeover","icon":"hand","href":"/user-guides/chatbot/help-desk/takeover"},{"group":"Integrations","icon":"puzzle-piece","pages":[{"title":"See Shopify orders inside Helpdesk tickets","sidebarTitle":"Shopify Orders","icon":"bag-shopping","href":"/user-guides/chatbot/help-desk/integrations/shopify"},{"title":"Create Linear issues from Helpdesk tickets","sidebarTitle":"Linear","icon":"list-check","href":"/user-guides/chatbot/help-desk/integrations/linear"}]}]},{"group":"Chatbase Experts","pages":[{"title":"Chatbase Experts Program for agencies and freelancers","sidebarTitle":"Chatbase Experts Program","href":"/user-guides/chatbase-experts/experts-program"}]}]},{"tab":"Developer Guide","pages":[{"title":"Developer Guide","href":"/developer-guides/overview"}]},{"tab":"API Reference","dropdowns":[{"dropdown":"API v2","icon":"code","groups":[{"group":"Getting Started","pages":[{"title":"API v2 Overview","sidebarTitle":"Overview","href":"/api-reference/v2/overview"},{"title":"Authentication","href":"/api-reference/v2/authentication"},{"title":"Streaming","href":"/api-reference/v2/streaming"},{"title":"Error Handling","href":"/api-reference/v2/error-handling"},{"title":"Pagination","href":"/api-reference/v2/pagination"}]},{"group":"Guides","pages":[{"title":"Agents","href":"/api-reference/v2/agents"},{"title":"User Conversations","href":"/api-reference/v2/user-conversations"},{"title":"Conversation Search","href":"/api-reference/v2/conversation-search"},{"title":"Sources","href":"/api-reference/v2/sources"},{"title":"Helpdesk","href":"/api-reference/v2/helpdesk"},{"title":"WhatsApp","href":"/api-reference/v2/whatsapp"},{"title":"Voice Sessions","href":"/api-reference/v2/voice"},{"title":"Client Actions","href":"/api-reference/v2/client-actions"}]},{"group":"Endpoints","pages":[{"group":"Health","pages":[{"title":"Health check","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json get /health","href":"/api-reference/v2/health/health-check"}]},{"group":"Agents","pages":[{"title":"List agents","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json get /agents","href":"/api-reference/v2/agents/list-agents"},{"title":"Create agent","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json post /agents","href":"/api-reference/v2/agents/create-agent"},{"title":"Get agent","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json get /agents/{agentId}","href":"/api-reference/v2/agents/get-agent"},{"title":"Update agent","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json put /agents/{agentId}","href":"/api-reference/v2/agents/update-agent"},{"title":"Delete agent","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json delete /agents/{agentId}","href":"/api-reference/v2/agents/delete-agent"},{"title":"Update agent styles","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json put /agents/{agentId}/styles","href":"/api-reference/v2/agents/update-agent-styles"},{"title":"Toggle auto-retrain","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json put /agents/{agentId}/auto-retrain","href":"/api-reference/v2/agents/toggle-auto-retrain"},{"title":"Clone agent","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json post /agents/{agentId}/clone","href":"/api-reference/v2/agents/clone-agent"},{"title":"Train agent (deprecated)","deprecated":true,"version":null,"openapi":"/api-v2-openapi.json post /agents/{agentId}/train","href":"/api-reference/v2/agents/train-agent-deprecated"},{"title":"Get agent analytics","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json get /agents/{agentId}/analytics","href":"/api-reference/v2/agents/get-agent-analytics"},{"title":"Chat with an agent","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json post /agents/{agentId}/chat","href":"/api-reference/v2/agents/chat-with-an-agent"},{"title":"Retry a message","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json post /agents/{agentId}/conversations/{conversationId}/retry","href":"/api-reference/v2/agents/retry-a-message"},{"title":"Start a voice session","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json post /agents/{agentId}/voice/sessions","href":"/api-reference/v2/agents/start-a-voice-session"},{"title":"Submit a tool result","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json post /agents/{agentId}/conversations/{conversationId}/tool-result","href":"/api-reference/v2/agents/submit-a-tool-result"}]},{"group":"Conversations","pages":[{"title":"List conversations","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json get /agents/{agentId}/conversations","href":"/api-reference/v2/conversations/list-conversations"},{"title":"Export conversations","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json get /agents/{agentId}/conversations/export","href":"/api-reference/v2/conversations/export-conversations"},{"title":"Search conversations","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json get /agents/{agentId}/conversations/search","href":"/api-reference/v2/conversations/search-conversations"},{"title":"Get a conversation","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json get /agents/{agentId}/conversations/{conversationId}","href":"/api-reference/v2/conversations/get-a-conversation"},{"title":"Delete conversation","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json delete /agents/{agentId}/conversations/{conversationId}","href":"/api-reference/v2/conversations/delete-conversation"},{"title":"Update conversation status","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json patch /agents/{agentId}/conversations/{conversationId}","href":"/api-reference/v2/conversations/update-conversation-status"},{"title":"List conversation messages","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json get /agents/{agentId}/conversations/{conversationId}/messages","href":"/api-reference/v2/conversations/list-conversation-messages"},{"title":"List conversations for a user","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json get /agents/{agentId}/users/{userId}/conversations","href":"/api-reference/v2/conversations/list-conversations-for-a-user"},{"title":"Delete all conversations for a user","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json delete /agents/{agentId}/users/{userId}/conversations","href":"/api-reference/v2/conversations/delete-all-conversations-for-a-user"},{"title":"Update message feedback","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json patch /agents/{agentId}/conversations/{conversationId}/messages/{messageId}/feedback","href":"/api-reference/v2/conversations/update-message-feedback"}]},{"group":"Collected Data","pages":[{"title":"List collected data","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json get /agents/{agentId}/collected-data","href":"/api-reference/v2/collected-data/list-collected-data"}]},{"group":"Sources","pages":[{"title":"Get sources summary","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json get /agents/{agentId}/sources/summary","href":"/api-reference/v2/sources/get-sources-summary"},{"title":"List sources","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json get /agents/{agentId}/sources","href":"/api-reference/v2/sources/list-sources"},{"title":"Create source","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json post /agents/{agentId}/sources","href":"/api-reference/v2/sources/create-source"},{"title":"Get source","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json get /agents/{agentId}/sources/{sourceId}","href":"/api-reference/v2/sources/get-source"},{"title":"Update source","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json put /agents/{agentId}/sources/{sourceId}","href":"/api-reference/v2/sources/update-source"},{"title":"Delete source","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json delete /agents/{agentId}/sources/{sourceId}","href":"/api-reference/v2/sources/delete-source"},{"title":"Restore source (deprecated)","deprecated":true,"version":null,"openapi":"/api-v2-openapi.json post /agents/{agentId}/sources/{sourceId}/restore","href":"/api-reference/v2/sources/restore-source-deprecated"},{"title":"Create file source","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json post /api/v2/agents/{agentId}/sources","href":"/api-reference/v2/sources/create-file-source"},{"title":"Update file source","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json put /api/v2/agents/{agentId}/sources/{sourceId}","href":"/api-reference/v2/sources/update-file-source"}]},{"group":"Actions","pages":[{"title":"List actions","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json get /agents/{agentId}/actions","href":"/api-reference/v2/actions/list-actions"},{"title":"Get an action","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json get /agents/{agentId}/actions/{actionId}","href":"/api-reference/v2/actions/get-an-action"},{"title":"Delete an action","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json delete /agents/{agentId}/actions/{actionId}","href":"/api-reference/v2/actions/delete-an-action"},{"title":"Update an action","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json patch /agents/{agentId}/actions/{actionId}","href":"/api-reference/v2/actions/update-an-action"}]},{"group":"Procedures","pages":[{"title":"List procedures","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json get /agents/{agentId}/procedures","href":"/api-reference/v2/procedures/list-procedures"},{"title":"Create a procedure","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json post /agents/{agentId}/procedures","href":"/api-reference/v2/procedures/create-a-procedure"},{"title":"Get a procedure","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json get /agents/{agentId}/procedures/{procedureId}","href":"/api-reference/v2/procedures/get-a-procedure"},{"title":"Delete a procedure","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json delete /agents/{agentId}/procedures/{procedureId}","href":"/api-reference/v2/procedures/delete-a-procedure"},{"title":"Update a procedure","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json patch /agents/{agentId}/procedures/{procedureId}","href":"/api-reference/v2/procedures/update-a-procedure"}]},{"group":"WhatsApp","pages":[{"title":"List WhatsApp templates","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json get /agents/{agentId}/whatsapp/templates","href":"/api-reference/v2/whatsapp/list-whatsapp-templates"},{"title":"Send a WhatsApp template message","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json post /agents/{agentId}/whatsapp/messages/template","href":"/api-reference/v2/whatsapp/send-a-whatsapp-template-message"}]},{"group":"Events","pages":[{"title":"Send an event","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json post /agents/{agentId}/missions/events","href":"/api-reference/v2/events/send-an-event"}]},{"group":"Helpdesk","pages":[{"title":"List ticket statuses","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json get /agents/{agentId}/helpdesk/ticket-statuses","href":"/api-reference/v2/helpdesk/list-ticket-statuses"},{"title":"List teams","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json get /agents/{agentId}/helpdesk/teams","href":"/api-reference/v2/helpdesk/list-teams"},{"title":"List attendance rows","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json get /agents/{agentId}/helpdesk/attendance","href":"/api-reference/v2/helpdesk/list-attendance-rows"},{"title":"List activity segments","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json get /agents/{agentId}/helpdesk/activity","href":"/api-reference/v2/helpdesk/list-activity-segments"},{"title":"List tickets","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json get /agents/{agentId}/helpdesk/tickets","href":"/api-reference/v2/helpdesk/list-tickets"},{"title":"Create a ticket","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json post /agents/{agentId}/helpdesk/tickets","href":"/api-reference/v2/helpdesk/create-a-ticket"},{"title":"Search tickets","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json post /agents/{agentId}/helpdesk/tickets/search","href":"/api-reference/v2/helpdesk/search-tickets"},{"title":"Get a ticket","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json get /agents/{agentId}/helpdesk/tickets/{ticketNumber}","href":"/api-reference/v2/helpdesk/get-a-ticket"},{"title":"Update a ticket","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json patch /agents/{agentId}/helpdesk/tickets/{ticketNumber}","href":"/api-reference/v2/helpdesk/update-a-ticket"},{"title":"List ticket messages","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json get /agents/{agentId}/helpdesk/tickets/{ticketNumber}/messages","href":"/api-reference/v2/helpdesk/list-ticket-messages"},{"title":"Add a message to a ticket","deprecated":null,"version":null,"openapi":"/api-v2-openapi.json post /agents/{agentId}/helpdesk/tickets/{ticketNumber}/messages","href":"/api-reference/v2/helpdesk/add-a-message-to-a-ticket"}]}]}]},{"dropdown":"API v1","icon":"box-archive","groups":[{"group":"Getting Started","pages":[{"title":"API v1 Overview","sidebarTitle":"Overview","href":"/api-reference/v1/overview"}]},{"group":"Endpoints","pages":[{"group":"Chat","pages":[{"title":"Chat with a chatbot","deprecated":null,"version":null,"openapi":"/openapi.yaml post /chat","href":"/api-reference/v1/chat/chat-with-a-chatbot"}]},{"group":"Chatbots","pages":[{"title":"Create a new chatbot","deprecated":null,"version":null,"openapi":"/openapi.yaml post /create-chatbot","href":"/api-reference/v1/chatbots/create-a-new-chatbot"},{"title":"Get all chatbots","deprecated":null,"version":null,"openapi":"/openapi.yaml get /get-chatbots","href":"/api-reference/v1/chatbots/get-all-chatbots"},{"title":"Delete a chatbot","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /delete-chatbot","href":"/api-reference/v1/chatbots/delete-a-chatbot"},{"title":"Update a chatbot","deprecated":null,"version":null,"openapi":"/openapi.yaml post /update-chatbot-data","href":"/api-reference/v1/chatbots/update-a-chatbot"},{"title":"Update chatbot settings","deprecated":null,"version":null,"openapi":"/openapi.yaml post /update-chatbot-settings","href":"/api-reference/v1/chatbots/update-chatbot-settings"}]},{"group":"Conversations","pages":[{"title":"Get conversations for a chatbot","deprecated":null,"version":null,"openapi":"/openapi.yaml get /get-conversations","href":"/api-reference/v1/conversations/get-conversations-for-a-chatbot"}]},{"group":"Leads","pages":[{"title":"Get leads for a chatbot","deprecated":null,"version":null,"openapi":"/openapi.yaml get /get-leads","href":"/api-reference/v1/leads/get-leads-for-a-chatbot"}]},{"group":"Assets","pages":[{"title":"Upload chatbot icon","deprecated":null,"version":null,"openapi":"/openapi.yaml post /upload-chatbot-icon","href":"/api-reference/v1/assets/upload-chatbot-icon"},{"title":"Upload chatbot profile picture","deprecated":null,"version":null,"openapi":"/openapi.yaml post /upload-chatbot-profile-picture","href":"/api-reference/v1/assets/upload-chatbot-profile-picture"},{"title":"Delete chatbot icon","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /delete-chatbot-icon","href":"/api-reference/v1/assets/delete-chatbot-icon"},{"title":"Delete chatbot profile picture","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /delete-chatbot-profile-picture","href":"/api-reference/v1/assets/delete-chatbot-profile-picture"}]},{"group":"Contacts","pages":[{"title":"Get contacts for a chatbot","deprecated":null,"version":null,"openapi":"/openapi.yaml get /chatbots/{chatbotId}/contacts","href":"/api-reference/v1/contacts/get-contacts-for-a-chatbot"},{"title":"Create contacts for a chatbot","deprecated":null,"version":null,"openapi":"/openapi.yaml post /chatbots/{chatbotId}/contacts","href":"/api-reference/v1/contacts/create-contacts-for-a-chatbot"},{"title":"Get a specific contact","deprecated":null,"version":null,"openapi":"/openapi.yaml get /chatbots/{chatbotId}/contacts/{contactId}","href":"/api-reference/v1/contacts/get-a-specific-contact"},{"title":"Delete a contact","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /chatbots/{chatbotId}/contacts/{contactId}","href":"/api-reference/v1/contacts/delete-a-contact"},{"title":"Update a contact","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /chatbots/{chatbotId}/contacts/{contactId}","href":"/api-reference/v1/contacts/update-a-contact"},{"title":"Get custom attributes schema","deprecated":null,"version":null,"openapi":"/openapi.yaml get /chatbots/{chatbotId}/custom-attributes","href":"/api-reference/v1/contacts/get-custom-attributes-schema"},{"title":"Create custom attribute","deprecated":null,"version":null,"openapi":"/openapi.yaml post /chatbots/{chatbotId}/custom-attributes","href":"/api-reference/v1/contacts/create-custom-attribute"},{"title":"Update custom attribute","deprecated":null,"version":null,"openapi":"/openapi.yaml put /chatbots/{chatbotId}/custom-attributes/{name}","href":"/api-reference/v1/contacts/update-custom-attribute"}]}]}]}]},{"tab":"CLI","pages":[{"title":"CLI","href":"/cli/overview"}]},{"tab":"SDKs","pages":[{"title":"SDKs","href":"/sdks/overview"}]},{"tab":"Help \u0026 Support","pages":[{"title":"Help \u0026 Support","href":"/faq/faq"}]}]},"basePath":"","title":"How to start, follow, and approve mission runs - Chatbase","buildId":"dpl_H5KQTnCewfWWvJxA7c3bCm7MFbb6","deploymentId":"dpl_H5KQTnCewfWWvJxA7c3bCm7MFbb6","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-DBf8HiS-.js","DynamicMarkdown-DcvJmTWC.js","zoom-image-lightbox-Dyw95Qy3.js","lightbox-handle-r17bVUz3.js"]}