All docs
Quickstart
This guide takes you from an empty workspace to a working agent on web chat. You'll need a Parley account and one policy document, like your returns policy.
Create a project
A project holds one agent: its playbooks, knowledge, actions and channels. From the workspace home choose New project, name it after the job it does (for example Returns), and pick the language customers write to you in most. Parley detects other languages automatically.
Prefer the terminal? Install the CLI and create the project from there:
npm install -g @parley/cli
parley login
parley projects create "Returns" --locale enAdd knowledge
Open Knowledge and add your first source. Upload a PDF, paste a help centre URL or connect Notion. The first sync usually takes under a minute. See Knowledge for every source type.
Write your first playbook
Open Playbooks and choose New playbook. Give it a goal, a few rules and the steps your team follows today. Keep sentences short; the agent follows them literally.
Goal: Help customers return or exchange an order in one conversation.
Rules:
- Follow @Returns policy for every decision.
- Offer an exchange before a refund.
- Never ask for card details.
Steps:
1. Ask for the order number, then use @Look up order.
2. Inside 30 days, offer an exchange or refund.
3. Send the return label and confirm when the money lands.Test in the preview
Use the preview panel on the right to talk to your agent. Every reply links to its trace, so you can see which rule, source or action it used. When something reads wrong, fix the playbook line and send the message again.
Go live on web chat
Open Channels, choose Web chat and copy the snippet into your site's <head>. The widget picks up your brand colour and greeting from the channel settings.
<script src="https://cdn.parley.ai/chat.js" data-project="prj_returns" async></script>Something unclear?Contact supportor browse thehelp centerAll guides