Skip to content

Commit 212330c

Browse files
datfridmandatfridman
committed
Initial release: Rypl documentation
0 parents  commit 212330c

35 files changed

Lines changed: 4068 additions & 0 deletions

‎.gitignore‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
.DS_Store
2+
_site/
3+
.jekyll-cache/
4+
.sass-cache/
5+
*.swp
6+
.idea/
7+
.vscode/

‎README.md‎

Lines changed: 78 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,78 @@
1+
---
2+
layout: default
3+
title: Rypl Documentation
4+
description: Official documentation for Rypl — the AI-powered Facebook ad comment management platform that turns ad comments into sales automatically.
5+
---
6+
7+
# Rypl Documentation
8+
9+
Welcome to the official documentation for **[Rypl](https://www.rypl.is)** — the AI-powered platform that manages your Facebook ad comments automatically. Rypl detects spam, replies to real customers, and converts conversations into sales, all without lifting a finger. **[Sign up for a free 7-day trial](https://app.rypl.is/signup)** and see results in your first 24 hours.
10+
11+
---
12+
13+
## Quick Start
14+
15+
Getting started with Rypl takes just a few minutes:
16+
17+
1. **[Create your account](getting-started/sign-up.md)** — Start your 7-day free trial, no credit card hassles.
18+
2. **[Connect your Facebook Page](getting-started/connect-facebook.md)** — Securely link your pages via Meta's Official Graph API.
19+
3. **[Create an AI agent](getting-started/create-ai-agent.md)** — Set your brand voice, upload your knowledge base, define moderation rules.
20+
4. **[Go live](getting-started/go-live.md)** — Activate your agent and start converting comments into customers.
21+
22+
---
23+
24+
## Documentation Sections
25+
26+
### [Getting Started](getting-started/)
27+
28+
Everything you need to go from signup to your first AI-managed comment. Covers account creation, Facebook connection, agent setup, and activation.
29+
30+
### [Configuration](configuration/)
31+
32+
Deep-dive into every configuration option available in Rypl. Learn how to fine-tune your brand voice, build a comprehensive knowledge base, configure intent detection, set moderation rules, and manage multiple accounts.
33+
34+
### [Best Practices](best-practices/)
35+
36+
Proven strategies to get the most out of Rypl. Includes moderation playbooks, reply optimization techniques, and our step-by-step guide to improving ROAS by 10% or more.
37+
38+
### [Use Cases](use-cases/)
39+
40+
See how different business types use Rypl. Detailed guides for e-commerce stores, marketing agencies managing multiple clients, and B2B service providers.
41+
42+
### [Reference](reference/)
43+
44+
Technical reference documentation including detailed pricing plan comparisons, the complete FAQ, all supported intent types, and AI model specifications per plan.
45+
46+
### [Troubleshooting](troubleshooting/)
47+
48+
Solutions to common issues with Facebook connections, agents not replying, and billing questions.
49+
50+
### [Changelog](changelog.md)
51+
52+
Release notes and version history.
53+
54+
---
55+
56+
## Key Platform Metrics
57+
58+
| Metric | Value |
59+
|--------|-------|
60+
| Average moderation speed | ~1.7 seconds |
61+
| AI reply time | Under 60 seconds |
62+
| ROAS improvement (first month) | +10% |
63+
| Conversations converted to sales | 28% more |
64+
| Availability | 24/7 automated |
65+
| Language support | All languages |
66+
67+
---
68+
69+
## Resources
70+
71+
- **Website:** [www.rypl.is](https://www.rypl.is)
72+
- **Application:** [app.rypl.is](https://app.rypl.is)
73+
- **Blog:** [blog.rypl.is](https://blog.rypl.is)
74+
- **Contact:** [hey@rypl.is](mailto:hey@rypl.is)
75+
76+
---
77+
78+
Need help? Browse the sections above or [contact our team](mailto:hey@rypl.is) directly.

‎_config.yml‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
title: Rypl Documentation
2+
description: Official documentation for Rypl — AI-powered Facebook ad comment management platform
3+
url: https://rypl-ai.github.io
4+
theme: jekyll-theme-cayman
5+
plugins:
6+
- jekyll-seo-tag
7+
- jekyll-sitemap

‎assets/logo.svg‎

Lines changed: 22 additions & 0 deletions
Loading

‎best-practices/auto-reply-optimization.md‎

Lines changed: 169 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,169 @@
1+
---
2+
layout: default
3+
title: Auto-Reply Optimization — Rypl Documentation
4+
description: How to optimize your Rypl AI auto-replies for higher engagement, accuracy, and conversion through knowledge base and brand voice refinement.
5+
---
6+
7+
# Auto-Reply Optimization
8+
9+
Your AI agent's replies are the primary way Rypl drives sales. Every reply is an opportunity to convert a commenter into a customer. This guide covers techniques for making every response count.
10+
11+
---
12+
13+
## The Reply Quality Framework
14+
15+
Great AI replies share four qualities:
16+
17+
1. **Accurate** — Information is correct (prices, specs, policies)
18+
2. **Relevant** — The reply addresses the specific question or comment
19+
3. **On-brand** — Tone and style match your brand identity
20+
4. **Action-oriented** — The reply guides the commenter toward a next step (purchase, DM, website visit)
21+
22+
If any of these qualities are missing, there is room for improvement.
23+
24+
---
25+
26+
## Knowledge Base Optimization
27+
28+
The single biggest factor in reply quality is the information available to your AI agent. Here is how to optimize your knowledge base:
29+
30+
### Prioritize High-Impact Information
31+
32+
Focus on information that directly impacts sales:
33+
34+
1. **Product pricing** — The most common question on Facebook ads. Make sure your knowledge base has up-to-date prices for every product you advertise.
35+
2. **Shipping details** — Costs, delivery times, international availability. These are purchase blockers.
36+
3. **Return policy** — Buyers hesitate when they are unsure about returns. Clear return information reduces friction.
37+
4. **Size and compatibility** — "Does this fit?", "Is this compatible with...?" are purchase-intent signals.
38+
5. **Current promotions** — Active discount codes, bundle deals, limited-time offers.
39+
40+
### Structure for Clarity
41+
42+
The AI performs better with well-structured information:
43+
44+
**Good knowledge base entry:**
45+
```
46+
Product: Classic Running Shoes
47+
Price: $89.99
48+
Sale Price: $69.99 (code RUN20)
49+
Sizes: 6-13 (US Men's), 7-14 (US Women's)
50+
Colors: Black, White, Navy Blue, Red
51+
Shipping: Free over $50, otherwise $5.99
52+
Delivery: 3-5 business days (US), 7-14 business days (international)
53+
Returns: 30-day free returns, unworn condition
54+
```
55+
56+
**Weak knowledge base entry:**
57+
```
58+
We sell shoes. They cost around $70-90. We ship everywhere.
59+
```
60+
61+
### Fill Knowledge Gaps
62+
63+
Monitor your dashboard for questions the AI could not answer well:
64+
65+
1. Review replies where the AI gave generic responses
66+
2. Identify the missing information
67+
3. Add it to your knowledge base
68+
4. The next time a similar question comes in, the reply will be specific and helpful
69+
70+
Common gaps to watch for:
71+
- Questions about product variants not in the catalog
72+
- Policy questions not documented in the knowledge base
73+
- Competitor comparison questions
74+
- Technical specifications
75+
76+
---
77+
78+
## Brand Voice Refinement
79+
80+
### Iterative Improvement
81+
82+
Brand voice optimization is an ongoing process:
83+
84+
1. **Week 1:** Set initial brand voice with basic tone and 5-10 example replies
85+
2. **Week 2:** Review real AI replies, identify where the tone is off, add more specific guidelines
86+
3. **Week 3:** Add examples for edge cases (complaints, comparison questions, out-of-stock items)
87+
4. **Week 4:** Fine-tune based on engagement data — which reply styles get the most positive reactions?
88+
89+
### Specificity Wins
90+
91+
Replace vague instructions with specific ones:
92+
93+
| Instead of... | Write this... |
94+
|---------------|---------------|
95+
| "Be friendly" | "Start replies with the commenter's first name. Use a warm greeting." |
96+
| "Be helpful" | "Always answer the specific question asked. Include a link to the product page." |
97+
| "Be professional" | "Use complete sentences. Avoid slang and excessive emojis. Maintain a knowledgeable tone." |
98+
| "Be concise" | "Keep replies under 3 sentences. One idea per sentence." |
99+
100+
### Reply Templates for Common Scenarios
101+
102+
Give your AI agent guidance for the most frequent comment types:
103+
104+
- **Pricing questions** — Include the exact price, any active discounts, and a link to buy
105+
- **Availability questions** — Confirm availability, mention popular variants, create urgency if appropriate
106+
- **Shipping questions** — Provide delivery time and cost, mention free shipping thresholds
107+
- **Negative comments** — Acknowledge the concern, offer a solution, invite them to DMs
108+
- **Positive comments** — Thank them, encourage sharing, ask for a review
109+
110+
---
111+
112+
## Measuring Reply Quality
113+
114+
### Key Metrics
115+
116+
- **Reply engagement rate** — How often do commenters respond positively to AI replies?
117+
- **Click-through rate** — When replies include links, how often are they clicked?
118+
- **Escalation rate** — How often does a conversation need human intervention?
119+
- **Conversion rate** — What percentage of replied-to comments lead to a purchase?
120+
121+
### Spot-Check Process
122+
123+
Spend 10 minutes daily reviewing AI replies:
124+
125+
1. Open your Rypl dashboard
126+
2. Sort replies by most recent
127+
3. Read 10-15 replies across different comment types
128+
4. Rate each reply: Excellent / Good / Needs improvement
129+
5. Note patterns in "Needs improvement" replies
130+
6. Update knowledge base or brand voice to address the patterns
131+
132+
### A/B Testing Brand Voice
133+
134+
If you manage multiple Pages or run similar campaigns, test different brand voice configurations:
135+
136+
- Try a more casual voice on one Page and professional on another
137+
- Compare engagement rates and conversion metrics
138+
- Adopt the higher-performing voice across your accounts
139+
140+
---
141+
142+
## Advanced Techniques
143+
144+
### Seasonal Updates
145+
146+
Update your knowledge base for seasonal campaigns:
147+
148+
- Holiday shipping deadlines
149+
- Seasonal product availability
150+
- Limited-time promotional offers
151+
- Gift-giving suggestions and bundles
152+
153+
### Post Content Analysis (Pro and Ultra)
154+
155+
Rypl's post content analysis reads your actual ad creative and copy, giving the AI additional context for replies. This means the agent can reference specific claims, images, or offers from the ad itself.
156+
157+
### Conversational Memory (Ultra)
158+
159+
On the Ultra plan, your agent maintains full conversational memory. This means it remembers previous interactions with the same commenter, creating a more personal and coherent experience.
160+
161+
---
162+
163+
## Next Steps
164+
165+
Apply these optimization techniques alongside the [ROAS Improvement Playbook](roas-improvement.md) for maximum business impact.
166+
167+
---
168+
169+
[Back to Best Practices](index.md) | [Back to Documentation](../index.md) | [Visit Rypl](https://www.rypl.is)

0 commit comments

Comments
 (0)