# Flyby Docs: full text > Flyby (فلايباي) is an AI travel agent and lead qualifier for travel agencies in Egypt and the Gulf. English pages first, then the same pages in Arabic. App: https://flyby.world --- # English # How the AI agent works URL: https://docs.flyby.world/en/ai-agent > What it does with a customer from the first message until it hands them to your team, and what it won't do. The AI agent is your agency's first salesperson: it picks up every message, replies in seconds, recommends the right packages, and collects the trip details until the customer is ready for your team. All its settings live on the **AI agent** page in the sidebar. Open the AI agent page Only the **Owner** and **Managers**. The agent is available on every plan, and every conversation it replies in counts toward your monthly [AI conversations](/en/billing/ai-conversations). ## A customer's journey with the agent [#a-customers-journey-with-the-agent] ### The customer sends a first message [#the-customer-sends-a-first-message] The conversation appears in **Conversations** with the status **AI agent**. The agent opens with your [greeting message](/en/ai-agent/persona) and asks what they're looking for. ### It understands and recommends [#it-understands-and-recommends] It replies in the dialect you chose (or mirrors the customer if you picked **Match the customer**), and understands Franco-Arabic like "3ayez a7gez 3omra". It searches your active packages and services, recommends what fits at the real price, works out the price by room type and number of travellers, and shows the calculation. ### It collects the qualification details [#it-collects-the-qualification-details] It asks one or two questions per message, naturally, never like an interrogation, and saves each detail as soon as it learns it. Once it knows anything, the customer appears in **Leads** at the **Qualifying** stage. [Qualification fields](/en/ai-agent/qualification) ### It qualifies and hands over [#it-qualifies-and-hands-over] When it has every required detail (or the customer clearly wants to book), the agent moves the lead to **Qualified**, scores it **Hot**, **Warm** or **Cold**, writes a summary for your team, and tells the customer a travel consultant will contact them. Your whole team (lead moderators included) gets a notification. ### Your team takes it from there [#your-team-takes-it-from-there] The conversation shows up under **Needs you**. The agent keeps answering any extra questions until someone on your team clicks **Take over**. [Taking over](/en/conversations/handoff) ## When it hands over right away [#when-it-hands-over-right-away] The agent stops replying in that conversation and moves it to **Needs you**, with a short summary and a notification to owners and managers, when: * The customer asks to talk to someone on your team. * There's a complaint, or a payment, refund or existing-booking issue. * The question can't be answered from your packages, services or FAQs. * One of your own [handoff rules](/en/ai-agent/instructions) applies (e.g. groups of more than 10). New conversations also go to your team without an AI reply when: * The agent is **Off** (the switch at the top of its page). * This month's AI conversations are used up, or your free trial has ended. * A technical error stopped it from replying (you get a "the AI agent couldn't reply" notification). The agent knows your team's [working hours](/en/settings/working-hours). If a customer writes outside them, the agent keeps helping and tells them the team will follow up during working hours. ## What the agent does and doesn't do [#what-the-agent-does-and-doesnt-do] | It does | It doesn't | | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | | Reply 24/7 within seconds | Take payments or confirm bookings | | Recommend only your active packages and services | Make up prices, dates, hotels or visa rules | | Price by room type, children and infants | Promise discounts you haven't written down | | Answer from your FAQs | Ask for passport or card numbers in chat | | Understand Egyptian, Gulf, Levantine, MSA, Franco-Arabic and English | Listen to voice notes or see images (it only sees that the customer sent a "voice message" or "image") | | Score the lead and write a summary | Reveal your internal notes, costs or margins | | Hand over to your team at the right moment | Chat about topics unrelated to travel and your agency | If a package has no child price, or a policy isn't in your FAQs, the agent tells the customer a consultant will confirm, and won't guess. The more complete your [catalog](/en/ai-agent/knowledge-base), the more it closes on its own. ## Turning the agent on and off [#turning-the-agent-on-and-off] At the top of the **AI agent** page there's a switch: **AI agent replies to customers** (Live / Off). * **Live**: it replies to every new conversation and any conversation whose status is **AI agent**. * **Off**: no automatic replies. Every new message goes to your team under **Needs you**. To pause it in just one conversation, open it and click **Take over**, then **Hand back to AI** when you're done. ## Agent performance [#agent-performance] Further down the page, **Agent performance** covers the last 30 days: **AI replies**, **Avg. response time**, **Conversations handled**, **Handoff rate**, **Leads qualified by AI** and **Qualification rate**, plus a daily replies chart. A high handoff rate usually means customers keep asking things your FAQs don't answer. ## Set it up step by step [#set-it-up-step-by-step] # Instructions URL: https://docs.flyby.world/en/ai-agent/instructions > Your agency's policies, when the agent hands off to a human, and what it must never say, with ready examples for travel agencies. Instructions are what you'd tell a new employee on day one: how we work, what's allowed, and when to come get me. Write them as short bullet points, in Arabic or English, in **AI agent → Instructions**, then click **Save settings**. Open AI agent There are 3 boxes, each up to 4,000 characters: | Box | What goes in it | | ------------------------------- | ----------------------------------------------------------------------------- | | **Your agency's instructions** | Policies, offers, payment terms, installments, anything the agent should know | | **When to hand off to a human** | Situations where the agent stops and passes the conversation to your team | | **Forbidden for the agent** | Things it must never say or promise | ## Your agency's instructions [#your-agencys-instructions] Write what isn't already in your packages or FAQs: how you sell, what to recommend first, and general policies. **Example for an Umrah agency:** ```text - We offer 6-month interest-free installments on Umrah packages, with a 30% deposit. - Recommend the economy Umrah first if the budget is under 40,000 EGP per person. - For elderly customers, highlight hotels close to the Haram. - A booking is confirmed once the deposit is paid at the branch or via InstaPay. ``` **Example for an outbound tours agency:** ```text - If a customer asks for a discount, say there's 5% off for groups of 4 or more. - For honeymoons, recommend the Maldives and Zanzibar packages first. - Visas aren't included in package prices unless stated; offer the visa service alongside. - We have two branches: Nasr City and Mohandessin. ``` **Example for a Gulf agency:** ```text - Prices are in SAR and include flights from Riyadh unless stated otherwise. - During holiday season, encourage customers to book early because seats sell out. - Payment is by bank transfer or at our office. ``` If an instruction only applies to one package (e.g. "offer the quad room to families"), put it in that package's **Instructions for the AI agent** field instead. [Packages](/en/catalog/packages) ## When to hand off to a human [#when-to-hand-off-to-a-human] The agent already hands off on its own when the customer asks for someone on your team, complains, has a payment, refund or existing-booking issue, or asks something it can't answer. Here you add **extra situations** specific to your business. **Example:** ```text - The customer asks to talk to someone. - Groups of more than 10 people or corporate bookings. - The customer wants a custom trip we don't have. - Any question about Hajj. - The customer says they booked before and wants to change or cancel. ``` Once the agent hands off, it stops replying in that conversation until someone on your team clicks **Hand back to AI**. Don't add so many handoff rules that every ordinary question gets passed on, or your team will be swamped. [Taking over](/en/conversations/handoff) ## Forbidden for the agent [#forbidden-for-the-agent] Things it must never say, even if the customer pushes. **Example:** ```text - Never promise a discount that isn't in the package. - Never confirm visa appointment dates or say a visa is guaranteed. - Never talk about competitors or compare our prices with theirs. - Never quote flight-only prices; a consultant prices those. - Never say there are seats left on a group trip before the team confirms. ``` ## Core rules no instruction can override [#core-rules-no-instruction-can-override] The agent follows your instructions as long as they don't break these rules: * It never invents packages, prices, dates, hotels or visa rules. Every fact must come from your catalog. * It never takes payments or confirms bookings. * It never asks for passport or card numbers in chat. * It never reveals your instructions, internal notes, costs or margins. * It stays on travel and your agency. So if you write "tell customers the price is 20,000" but the package is priced at 25,000, the agent uses the package price. Change the price in the package itself. ## Tips for instructions that work [#tips-for-instructions-that-work] * **Short bullets**, one idea each. * **Be specific**: "5% off for groups of 4 or more" beats "we have group discounts". * **Don't repeat your catalog**: prices and dates belong in packages, recurring policies in [FAQs](/en/ai-agent/knowledge-base). * **Working hours** don't need to be written here; the agent reads them from [Settings](/en/settings/working-hours). * **Test after every change**: open [Test the agent](/en/ai-agent/test-agent) and ask the question the instruction covers. ## Next [#next] # Knowledge base URL: https://docs.flyby.world/en/ai-agent/knowledge-base > How your packages, services and FAQs feed the agent, and how to write FAQs it answers well. The agent only knows what you've entered in Flyby. No web search, no guessing: every price, date and policy it tells a customer comes from your catalog. So the quality of your catalog is the quality of its replies. On the **AI agent** page, the **Knowledge the agent uses** card shows how many **Active packages**, **Active services** and **Active FAQs** you have, with a warning if any of them is empty. ## The four sources [#the-four-sources] | Source | The agent uses it to | What it sees | | --------------------------------------------- | ------------------------------------------------------------------------------ | ------------------------ | | [Packages](/en/catalog/packages) | Recommend trips and quote prices and dates | **Active** packages only | | [Services](/en/catalog/services) | Visas, flights, hotels, insurance, transfers… | **Active** services only | | [FAQs](/en/catalog/faqs) | Payment, cancellation, documents, any general question | **Active** FAQs only | | [Agency profile](/en/settings/agency-profile) | Address, phone, about your agency, [working hours](/en/settings/working-hours) | Always | A package that's **Draft**, **Stopped** or **Archived** is invisible to the agent. When a package sells out, stop it instead of leaving it for the agent to recommend. ## Packages: exactly what the agent reads [#packages-exactly-what-the-agent-reads] When a customer asks about a trip, the agent searches package titles (Arabic and English), destinations, summary and departure city. When it finds a match, it opens the full details: * **Prices** by room type (single, double, triple, quad) and traveller type (adult, child, infant). It picks the room based on the group size and shows the calculation. * Upcoming open **departures** and seats left. * Hotels, itinerary, **includes** and **excludes**, and terms. * **Instructions for the AI agent**: internal selling notes customers never see, like "highlight how close the hotel is to the Haram". **To help the agent recommend well:** * Write destinations in both Arabic and English if customers use both (e.g. "إسطنبول" and "Istanbul"). * Fill in child and infant prices, or the agent will say a consultant needs to confirm. * Keep departures and seats up to date. The agent won't offer a past or closed departure. * Mark your best packages as **Featured package**: the agent recommends them first. ## Services [#services] The agent sees the service name, description, price, processing time, required documents and your notes for it. * If the pricing is **Starting from**, it tells the customer it's a starting price. * If the pricing is **On request**, it says a consultant will quote it, and won't invent a number. ## Writing FAQs the agent answers well [#writing-faqs-the-agent-answers-well] FAQs are the fastest way to cut handoffs. Every recurring customer question without an answer is a conversation that lands on your team. **Start with these:** * Payment methods (cash, bank transfer, InstaPay, card at the branch…) * Installments and deposits * Cancellation and refund policy * Required documents for each trip type * Visas: timing and requirements (without promising approval) * How and when a booking is confirmed * Branch addresses and hours **Example of a good FAQ:** > **Question:** Can I pay in installments? > > **Answer:** Yes, pay 50% upfront and the rest in two installments before departure. Installments are available on Umrah and outbound packages only. **Tips:** * **One clear answer** with numbers and conditions. "We offer installments" isn't enough; say how much upfront and how many installments. * **Write it the way you want customers to hear it.** The agent adapts it to the customer's dialect, so you don't need separate Egyptian and Gulf versions. * **Pick the right category** (General, Payment, Cancellation & refunds, Documents, Visas, Booking, Other). It helps the agent find the answer faster. * **Stop a question instead of deleting it** if a policy changes temporarily. The agent ignores **Stopped** questions. * **Review handed-off conversations weekly**: if the same question keeps coming up, add it. Policies customers ask about (payment, cancellation, documents) belong in **FAQs**. How to sell and what to recommend ("recommend the economy package first") belongs in [Instructions](/en/ai-agent/instructions). ## Next [#next] # Persona URL: https://docs.flyby.world/en/ai-agent/persona > Your agent's name, tone, dialect, and the greeting it opens with. The persona is the first thing a customer notices: what the agent calls itself and how it talks. Set it in **AI agent → Persona**, and click **Save settings** after any change. Open AI agent ## Agent name [#agent-name] The name it introduces itself with, shown in the chat. Pick something simple that fits your agency: * "Nour from Horizon Travel" * "Sara" * "Nile Assistant" A human name like "Nour" or "Sara" feels warmer, and adding your agency name ("Nour from Horizon") reassures customers they're talking to the right company. ## Tone [#tone] | Tone | Good for | Example | | ---------------- | --------------------------------------------- | -------------------------------------------------------------------------------- | | **Friendly** | Most agencies, domestic trips and families | "تمام جدًا! عندنا عرض حلو لشرم الشيخ الشهر ده، أبعتلك التفاصيل؟" | | **Professional** | Umrah and Hajj, corporate and formal travel | "متاح لدينا برنامج شرم الشيخ 5 ليالي شامل الإفطار. تحب أبعت لحضرتك التفاصيل؟" | | **Luxury** | Honeymoons, high-end hotels, premium packages | "يسعدنا نرتب لحضرتك إقامة مميزة في جناح مطل على البحر مع استقبال خاص من المطار." | With **Friendly**, the agent may use at most one emoji per message (✈️ 🕋 🌴). **Professional** and **Luxury** use no emojis at all. ## Dialect [#dialect] | Dialect | Example | | ---------------------- | -------------------------------------------------------------------------------------------------------- | | **Egyptian** | "أهلًا بحضرتك! تحب تسافر إمتى، وهتكونوا كام فرد؟" | | **Gulf** | "هلا والله! متى ودك تسافر، وكم شخص معك؟" | | **Levantine** | "أهلين! إيمتى حابب تسافر، وقديش عددكم؟" | | **Modern Standard** | "مرحبًا بك! متى تودّ السفر، وكم عدد المسافرين؟" | | **Match the customer** | Mirrors the customer: Egyptian for Egyptians, Gulf for Gulf customers, English if they write in English. | If most of your customers come from one country, pick their dialect. If you serve both Egyptian and Gulf customers, or customers who write in English, pick **Match the customer**. Either way, the agent understands Franco-Arabic and replies in Arabic script. ## Greeting message [#greeting-message] The first line it opens every new conversation with. On your public chat link, customers see it as soon as they open the chat. If you leave it empty, a default greeting with your agent's name and agency name is used. **Good examples:** * "أهلًا بحضرتك في الأفق للسياحة! أنا نور، أقدر أساعدك تختار رحلتك الجاية. بتفكر تسافر فين؟" * "حياك الله في النخبة للسفر! تبي عمرة، ولا رحلة سياحية؟" * "Welcome to Horizon Travel! I'm Nour. Are you planning Umrah or a holiday?" A long greeting that lists every offer loses the customer. Two sentences at most, ending with a question that gets them talking. ## What you don't need to write [#what-you-dont-need-to-write] Tone and dialect don't need extra instructions. The agent also writes WhatsApp-style by default: short messages (2–5 lines), one or two questions at most, and prices with digits and currency, like "28,500 جنيه للفرد في الغرفة الثلاثية". ## Next [#next] # Qualification and lead scoring URL: https://docs.flyby.world/en/ai-agent/qualification > Choose the details the agent collects, and learn when a lead becomes qualified and how it's scored Hot, Warm or Cold. Qualification fields are what separate "someone asking around" from "a lead your team should call". You choose what the agent collects, it asks naturally during the chat, and once it has everything it hands the lead to your team. Set them in **AI agent → Qualification fields**. Open AI agent ## Available fields [#available-fields] | Field | The agent asks about | | ------------------ | ------------------------------------------------ | | **Trip type** | Umrah, Hajj, outbound tour, domestic, honeymoon… | | **Destination** | Country or city | | **Travel dates** | Date or month, and whether they're flexible | | **Travellers** | Adults, children with ages, infants | | **Budget** | Per person or total | | **Departure city** | Cairo, Alexandria, Jeddah… | | **Hotel level** | Star rating, or distance from the Haram | | **Room type** | Single, double, triple, quad | | **Nationality** | Matters for visas | | **Name** | The customer's name | | **Phone number** | A number to call back or WhatsApp | ## Choose and order [#choose-and-order] 1. Pick the fields your team really needs before calling a customer. **You must select at least 2.** 2. Order them with **Move up** and **Move down**. The agent roughly follows this order when asking. 3. Click **Save settings**. We always recommend **Phone number** so your team can call the customer after qualification. On WhatsApp the number is already known from the chat, so the agent won't ask for it. **Suggestions by business type:** * **Umrah and Hajj**: Trip type, Travel dates, Travellers, Hotel level, Room type, Name, Phone number. * **Outbound tours**: Destination, Travel dates, Travellers, Budget, Nationality, Name, Phone number. * **Visas**: Destination, Nationality, Travel dates, Name, Phone number. The more fields you select, the longer the chat, and the more likely the customer gives up before qualifying. Pick what you need to send a quote; your team can ask the rest on the call. ## When is a lead qualified? [#when-is-a-lead-qualified] A lead moves to **Qualified** in two cases: 1. The agent has collected **every** field you selected. Even if the agent forgets to qualify, Flyby qualifies the lead automatically as soon as the last field is saved. 2. The customer clearly says they want to book or talk to sales, even if some fields are still missing. Then: * The lead appears in **Leads** at the **Qualified** stage, with an Arabic **summary** for your team (trip, travellers, dates, budget…). * The conversation moves to **Needs you**. * The whole team gets a notification, **lead moderators included**, titled something like "Qualified lead (Hot): Ahmed". * The agent tells the customer a travel consultant will contact them soon, and keeps answering questions until someone on your team takes over. Lead moderators don't see conversations or leads that are still **Qualifying**. A lead appears for them as soon as it's qualified, so your sales team can focus on ready leads only. [Roles & permissions](/en/team) ## Scoring: Hot, Warm, Cold [#scoring-hot-warm-cold] | Score | What it means | What to do | | -------- | ---------------------------------------------------- | ---------------------------------------------------------- | | **Hot** | Ready to book soon, with a clear budget | Call the same day. The conversation gets **High** priority | | **Warm** | Interested but needs follow-up or is still comparing | Send a proposal and add a follow-up task | | **Cold** | Browsing, or asking very early | Keep them in the list and follow up later | The agent picks the score from what the customer said and writes the reason. If the lead was qualified automatically, it's **Hot** when the customer gave a budget and travels within about two and a half months, otherwise **Warm**. Your team can change the score and stage any time from the lead page. [Lead details](/en/leads/lead-details) ## Next [#next] # Test the agent before going live URL: https://docs.flyby.world/en/ai-agent/test-agent > Chat with the agent as a customer through your public chat link, and check prices, handoffs and qualification. Before you share your chat link or connect WhatsApp, spend 10 minutes chatting with the agent as if you were a customer. You'll see exactly what customers see, and can fix anything in your catalog or instructions before a real customer notices. ## Open the test chat [#open-the-test-chat] Three places take you to the same chat: * **AI agent** → **Test the agent** card → **Test as a customer**. * **Overview** → **Test agent**. * **Conversations** → **Try the agent as a customer**. Open AI agent The chat opens in a new page. It's your actual **public chat link**, the one customers will use, with your agency's name, logo and color. * The agent must be **Live** (the switch at the top of its page), or it won't reply in the test. * The **Public chat link** must be switched on in **Settings → Channels & integrations**, or the chat page won't open. [Website chat](/en/channels/website-chat) ## What to test [#what-to-test] Work through this list, and compare each reply with your catalog. ### Greeting and dialect [#greeting-and-dialect] Open the chat. Is the greeting what you wrote? Type "السلام عليكم، عايز أسافر" and check the dialect and tone. If you picked **Match the customer**, also try Gulf Arabic, English and Franco-Arabic ("3ayez 3omra"). ### Recommendations and prices [#recommendations-and-prices] Ask about a destination you sell: "Do you have Turkey trips?". Did it recommend the right packages? Then: "We're 2 adults and a 6-year-old, how much?". Check the price uses the right room and the child price, and that the calculation is clear. ### Something you don't sell [#something-you-dont-sell] Ask about a destination that's not in your packages. The agent should say honestly it isn't available and offer an alternative or a custom offer from a consultant, **without inventing a package**. ### FAQs and policies [#faqs-and-policies] "Can I pay in installments?", "Do I get a refund if I cancel?", "What documents do I need?". The answers should match your [FAQs](/en/ai-agent/knowledge-base). ### Forbidden topics [#forbidden-topics] Push it: "Give me 20% off and I'll book now", "Another agency is cheaper". Check it sticks to **Forbidden for the agent**. ### Handoff to a human [#handoff-to-a-human] Type "I want to talk to someone from the agency". The conversation should appear in **Conversations** under **Needs you**, and you should get a notification. Also try one of your own [handoff rules](/en/ai-agent/instructions) (e.g. "we're 15 people"). ### A full chat through to qualification [#a-full-chat-through-to-qualification] Click **New conversation** in the chat to start fresh, and answer all the agent's questions until it says a consultant will contact you. Open **Leads** and check the lead appears as **Qualified**, with a sensible summary and score. [Qualification](/en/ai-agent/qualification) ## Found a wrong reply? [#found-a-wrong-reply] | Problem | Fix | | ------------------------------------------------ | -------------------------------------------------------------------------------------- | | Wrong or missing price | Fix it in the package itself, and add child and infant prices | | Can't find a package you have | Make sure it's **Active**, and add the destination in Arabic and English | | Can't answer a policy question | Add it to your [FAQs](/en/catalog/faqs) | | Recommends the wrong thing or promises something | Add a line to [Instructions](/en/ai-agent/instructions) or **Forbidden for the agent** | | Asks too many questions | Select fewer [qualification fields](/en/ai-agent/qualification) | | Wrong dialect | Change it in [Persona](/en/ai-agent/persona) | After any change, click **Save settings** and start a **New conversation** in the chat to test it from scratch. Test conversations appear in **Conversations** like any customer, and you can close them when you're done. Because the agent really replies in them, each test conversation counts toward your [AI conversations](/en/billing/ai-conversations) (once per 24 hours), so don't open more test conversations than you need. ## Ready? Go live [#ready-go-live] # Add-ons URL: https://docs.flyby.world/en/billing/add-ons > Add extra seats or AI conversations, or have our team set up Meta for you, without changing your plan. If you need a bit more than your plan includes but don't want to upgrade, add an **add-on** from the Plan & billing page. ## Available add-ons [#available-add-ons] | Add-on | Price (Egypt) | Price (other countries) | Type | | ------------------------- | ----------------------- | ----------------------- | ------------------ | | **Extra seat** | EGP 250 / month | $9 / month | Renews monthly | | **+100 AI conversations** | Depends on plan (below) | Depends on plan (below) | Current month only | | **Meta setup** | EGP 1,500 | $49 | One time | ### +100 conversations price by plan [#100-conversations-price-by-plan] | Plan | Egypt | Other countries | | ------- | ------- | --------------- | | Starter | EGP 900 | $19 | | Growth | EGP 750 | $15 | | Pro | EGP 600 | $12 | ## About each add-on [#about-each-add-on] One more teammate on top of your plan's seats, renewing monthly. Available on every paid plan. You can request several at once. Learn more about [seats](/en/team/invites). Raises your AI conversation limit by 100 **for the current month only**; it doesn't roll over. You can request several packs at once (for example quantity 3 = 300 conversations). Handy if you hit your limit before the month ends and the AI agent paused. Learn more about [AI conversations](/en/billing/ai-conversations). Our team sets up WhatsApp, Messenger and Instagram for you, one time. Available on **Starter** and **Growth**, and **included** in **Pro** at no extra cost. Learn more about [channels](/en/channels). ## How to request an add-on [#how-to-request-an-add-on] **Who can do this?** Owners and managers. ### Open Plan & billing [#open-plan--billing] Go to **Settings → Plan & billing** and scroll to **Add-ons**. Open Plan & billing ### Click "Add" [#click-add] Next to the add-on you want. ### Choose the quantity [#choose-the-quantity] You'll see the **Total** straight away. (Meta setup is always one time.) ### Click "Send request" [#click-send-request] The request shows in the **Waiting for activation** card, and our team will contact you within one business day to confirm payment and activate it. Add-ons aren't available during the free trial. Choose a plan first, then add what you need. [Free trial](/en/billing/trial) ## Refunds [#refunds] A +100 conversations pack is refundable if none of it was used in the same month, an extra seat stops at your next renewal, and Meta setup is refundable until work starts. Full details are in our [Refund policy](https://flyby.world/en/refund). ## Next [#next] # AI conversations URL: https://docs.flyby.world/en/billing/ai-conversations > How AI conversations are counted, when they reset, and what happens when you reach your limit. Every plan includes a number of **AI conversations** per month. This page explains exactly what counts, so you can follow your usage and plan for it. ## What is an "AI conversation"? [#what-is-an-ai-conversation] **One customer thread the AI replies in, counted once per 24 hours.** * The first time the AI agent replies to a customer, that thread counts as **one conversation**. * For the next 24 hours, the AI can keep replying to that customer at no extra count, however many messages they send. * If the customer comes back after those 24 hours and the AI replies again, it counts as a new conversation. A customer messages you at 10 am and sends 30 messages until late evening: that's **one conversation**. She comes back two days later asking about payment and the AI replies: that's a **second conversation**. ### What doesn't count [#what-doesnt-count] * Conversations your **team** replies to while the AI is off. * AI suggested replies and summaries shown to your team inside a conversation. Chats you start yourself on your chat link to test the agent count just like real conversations. ## Monthly reset [#monthly-reset] * The meter resets on the **1st of every month** at midnight, **Cairo time**. * Unused conversations **don't roll over** to the next month. | Plan | Conversations per month | | ---------- | ----------------------- | | Free trial | 50 | | Starter | 150 | | Growth | 500 | | Pro | 1,200 | ## Where to see your usage [#where-to-see-your-usage] Go to **Settings → Plan & billing**. The **AI conversations** meter shows how many you've used out of this month's total (including any +100 packs you added). Open Plan & billing ## Warnings [#warnings] | When you reach | What happens | | -------------- | ------------------------------------------------------------------------------------------------------------------------------------- | | **80%** | A yellow bar at the top of the dashboard ("You've used … of … AI conversations this month") and a one-time notification for the month | | **100%** | A red bar and a notification that the AI agent is paused | Warnings go to owners and managers. Turn on [notifications](/en/settings/notifications) on your phone so they reach you even when Flyby is closed. ## When you reach 100% [#when-you-reach-100] * **The AI agent pauses** and stops replying to new conversations. * Every new conversation goes to your team under **Needs you** so someone can reply personally. [Handoff to your team](/en/conversations/handoff) * Conversations already counted in the last 24 hours carry on normally until their window ends. * No messages are lost: every customer message still arrives in your inbox. - Add **+100 AI conversations** for the current month from **Settings → Plan & billing → Add-ons**. [Add-ons](/en/billing/add-ons) - Or upgrade to a bigger plan. [Plans](/en/billing) - Or wait for the 1st, when the meter resets by itself. ## Tips to use fewer conversations [#tips-to-use-fewer-conversations] * Keep your [knowledge base](/en/ai-agent/knowledge-base) and packages complete, so the AI answers right the first time. * Take over the conversation yourself once the customer is ready to book, instead of letting the AI keep replying. ## Next [#next] # Plans URL: https://docs.flyby.world/en/billing > Compare Flyby's three plans and learn how to request a plan change. Flyby has 3 plans: **Starter**, **Growth** and **Pro**. All of them include the AI agent and the public page; they differ in AI conversations, channels, seats and extra features. ## Prices [#prices] | Plan | Monthly (Egypt) | Monthly (other countries) | Annual (Egypt) | Annual (other countries) | | ----------- | --------------- | ------------------------- | -------------- | ------------------------ | | **Starter** | EGP 1,990 | $69 | EGP 19,900 | $690 | | **Growth** | EGP 4,490 | $169 | EGP 44,900 | $1,690 | | **Pro** | EGP 7,990 | $299 | EGP 79,900 | $2,990 | * Agencies in **Egypt** pay in EGP; everywhere else pays in USD. * **Annual = 2 months free**: you pay for 10 months and get 12. ## Compare plans [#compare-plans] | | Starter | Growth | Pro | | --------------------------- | -------------------------- | ------------------------ | ---------------------------------- | | AI conversations per month | 150 | 500 | 1,200 | | Seats | 2 | 5 | 15 | | Website chat + WhatsApp | ✓ | ✓ | ✓ | | Messenger + Instagram | — | ✓ | ✓ | | Packages on the public page | Up to 10 | Unlimited | Unlimited | | Public page sections | Profile, packages, contact | + services, FAQs, offers | + custom sections and branches | | Page analytics | Basic (30-day totals) | Full | Full + 12 months + CSV export | | Finance & invoices | — | ✓ | ✓ | | Finance export (CSV) | — | — | ✓ | | Remove "Powered by Flyby" | — | — | ✓ | | Onboarding | Self-serve | Self-serve | Done for you, including Meta setup | | Support | Email | WhatsApp | Priority | Any WhatsApp and Meta messaging fees are paid to Meta directly from your own account. They're not part of the plan price. ## Request a plan or a plan change [#request-a-plan-or-a-plan-change] **Who can do this?** Owners and managers. ### Open Plan & billing [#open-plan--billing] Go to **Settings → Plan & billing**. Open Plan & billing ### Pick the billing cycle [#pick-the-billing-cycle] **Monthly** or **Annual** (2 months free), above the plans. ### Click "Choose" on a plan [#click-choose-on-a-plan] To stay on the same plan and move from monthly to annual, click **Switch billing**. ### Click "Send request" [#click-send-request] A **Waiting for activation** card shows your request. ### Our team activates it [#our-team-activates-it] We'll contact you within one business day to confirm payment, then activate the plan on your account. There's no card payment inside the app. Requests go to our team, who confirm payment with you and activate them. * You can withdraw a request with **Cancel** on the **Waiting for activation** card while it's still pending. * One plan request at a time: a new request replaces the previous one. * Upgrades apply as soon as they're activated; downgrades apply at your next renewal. ## Also on this page [#also-on-this-page] * Your **Current plan**, its price and billing cycle. * The **AI conversations** and **Seats** meters. [AI conversations](/en/billing/ai-conversations) * **Add-ons**: extra seat, +100 conversations, Meta setup. [Add-ons](/en/billing/add-ons) * A link to the **Refund policy**. ## Cancelling and refunds [#cancelling-and-refunds] All the rules for cancelling and refunds (first monthly payment, annual plans within 30 days, add-ons) are in our [Refund policy](https://flyby.world/en/refund). For any refund request, email [support@flyby.world](mailto:support@flyby.world) from the owner's email. ## Next [#next] # Free trial URL: https://docs.flyby.world/en/billing/trial > 14 days free with Growth features and 50 AI conversations, no card needed. Every new agency starts with a free trial, so you can try Flyby on your real customers before paying anything. ## What's in the trial [#whats-in-the-trial] | | Free trial | | ------------------ | ----------------------------------------------- | | Length | **14 days** | | AI conversations | **50** | | Features | **Growth** plan features | | Channels | Website chat, WhatsApp, Messenger and Instagram | | Seats | 5 | | Finance & invoices | ✓ | | Public page | Unlimited packages and full analytics | | Payment card | **Not needed** | **Pro** features such as custom sections, branches and removing "Powered by Flyby" aren't part of the trial. Add-ons become available once you're on a paid plan. ## When the trial starts [#when-the-trial-starts] Your trial starts as soon as you reach the **plan** step in [onboarding](/en/getting-started/onboarding). The plan you pick there is saved as a **request**, and our team will contact you to activate it before the trial ends. ## Where to see the days left [#where-to-see-the-days-left] * **Settings → Plan & billing** shows "… days left" and the date your trial ends. * 3 days before the end, a yellow bar appears at the top of the dashboard for owners and managers. Open Plan & billing ## When the trial ends [#when-the-trial-ends] * **The AI agent stops replying**, and new conversations go to your team under **Needs you**. * A red "Your free trial has ended" bar and a notification appear for owners and managers. * **All your data stays**: conversations, leads, packages and bookings. You can keep working and reply yourself. * **Nothing is charged**, because we never took a card. The AI agent starts replying again as soon as your plan is activated. ## Choosing a plan [#choosing-a-plan] ### Open Plan & billing [#open-plan--billing] Go to **Settings → Plan & billing**. ### Pick monthly or annual [#pick-monthly-or-annual] Annual gives you 2 months free. ### Click "Choose" on a plan, then "Send request" [#click-choose-on-a-plan-then-send-request] ### Our team contacts you [#our-team-contacts-you] Within one business day, to confirm payment and activate the plan. Send your plan request a few days before the trial ends, so the AI agent never stops, not even for an hour. Not sure which plan? See the [plan comparison](/en/billing). ## Next [#next] # FAQs URL: https://docs.flyby.world/en/catalog/faqs > Write your official answers on payment, cancellation, documents and other recurring questions, and the AI agent answers with them in the customer's dialect. When a customer asks "Can I pay in installments?" or "Do you refund if I cancel?", the AI agent doesn't guess. It looks in your active **FAQs** and answers with your wording, rephrased in the customer's dialect. Open FAQs ## Adding a question [#adding-a-question] ### Click "New question" [#click-new-question] ### Pick a category [#pick-a-category] General, Payment, Cancellation & refunds, Documents, Visas, Booking, Other. The category groups questions on the page and helps the agent find the answer faster. ### Write the question and answer [#write-the-question-and-answer] * **Question**: the way customers ask it, e.g. "Can I pay in installments?". * **Answer**: clear and short, e.g. "Yes, pay 50% upfront and the rest in two installments before departure." ### Leave it "Active" and save [#leave-it-active-and-save] The agent starts using the answer right away. ## Organizing questions [#organizing-questions] * Questions are grouped by category, and a counter at the top shows how many are active out of the total. * **The switch** next to each question turns it on or off. The agent ignores stopped questions, but they stay saved. * **Move up** and **Move down** reorder questions within a category. Put the most important ones first. * Click a question to edit or delete it. If the FAQ section is visible on your [public page](/en/public-page/sections), your active questions appear there in the same order. ## Good answer or not? [#good-answer-or-not] The agent says what you wrote, so a vague answer becomes a vague reply. ❌ **Weak**: "We offer flexible payment." ✅ **Good**: "Pay cash at our branch, by bank transfer, or with InstaPay. For packages over EGP 50,000 you can pay in 3 parts: 40% on booking, 30% a month later, and the rest two weeks before departure." ❌ **Weak**: "Cancellation is subject to terms." ✅ **Good**: "Cancel 30 days or more before departure: full refund minus a EGP 1,000 admin fee. 15 to 30 days: 50% refund. Under 15 days: no refund, because the hotel and flights are already paid." ❌ **Weak**: "We need the usual paperwork." ✅ **Good**: "A passport copy for each traveller, valid for at least 6 months from the travel date, plus a photo with a white background. We need the documents at least 21 days before departure to complete the paperwork in time." ❌ **Weak**: "Visit us anytime." ✅ **Good**: "Our office is at 15 Tahrir Street, Dokki, 3rd floor. We're open Saturday to Thursday, 10 am to 8 pm." These examples are for illustration only. Write your real policies and numbers. ## Tips [#tips] * **One answer per question.** If you have two different policies (say, Umrah cancellation vs. tour cancellation), make two clear questions. * **Use numbers and timeframes.** "Within 3 working days" beats "as soon as possible". * **Don't repeat packages and services.** Package prices and visa documents belong in [Packages](/en/catalog/packages) and [Services](/en/catalog/services). FAQs are for general policies. * **Focus on what matters.** The agent reads up to 60 active questions in order, so stop old ones nobody asks anymore. * **Review conversations weekly.** If the agent handed a chat over because it had no answer, add that question here. * **Write in plain language.** The agent rephrases it in the customer's dialect on its own, Egyptian, Gulf or otherwise. ## Next [#next] # Catalog URL: https://docs.flyby.world/en/catalog > Your packages, services and FAQs are everything the AI agent knows about your agency. If it isn't here, the agent won't sell it. The AI agent **never makes up** prices, dates, hotels or policies. Every fact it tells a customer comes from your catalog, looked up during the conversation. That's why a well-kept catalog is the single most important thing for the agent to sell well. ## What's in the catalog [#whats-in-the-catalog] ## How the agent uses it [#how-the-agent-uses-it] | The customer asks about | The agent looks in | What it sees | | ------------------------------------------------------- | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------- | | A trip or destination ("Do you have Turkey in August?") | **Active packages** | Name, destinations, summary, departure city, "From" price, upcoming open departures | | Details of one package | **That package** | Prices by room and traveller type, departures and seats, hotels, itinerary, includes/excludes, terms, and your instructions | | A visa, ticket or hotel on its own | **Active services** | Price and pricing type, processing time, required documents, and your instructions | | Payment, cancellation, documents, anything general | **Active FAQs** and your agency info | The answer you wrote, rephrased in the customer's dialect | If the answer isn't there, the agent tells the customer a consultant will confirm, or [hands the chat to your team](/en/conversations/handoff). The agent only sees packages and services with the status **Active**, and FAQs that are **Active**. Drafts, stopped and archived items don't exist as far as it's concerned. ## What customers never see [#what-customers-never-see] * **Cost and margin** on packages and services: internal only, hidden from customers and from the AI agent. * **Instructions for the AI agent** on each package and service: the agent reads them to know how to sell, but never repeats them to the customer. ## Checklist before you switch the agent on [#checklist-before-you-switch-the-agent-on] * [ ] Every package you sell right now is added, **Active**, and has at least one adult price. * [ ] Upcoming departures are added, with the right number of **Seats left**. * [ ] Stand-alone services (visas, flights...) are added with prices and documents. * [ ] Payment, cancellation and documents questions are answered in FAQs. * [ ] You've tried the agent yourself with your customers' real questions in [Test your agent](/en/ai-agent/test-agent). When a package sells out or is cancelled, stop it or change the departure status right away. The agent reads the catalog on every message, so changes reach it instantly. ## Who can edit the catalog [#who-can-edit-the-catalog] Owners and managers. Lead moderators don't see the catalog pages. ## Catalog and your public page [#catalog-and-your-public-page] Active packages can also appear on your [public page](/en/public-page) using the **On public page** switch inside each package. The Starter plan shows up to 10 packages on the page. ## Next [#next] # Packages URL: https://docs.flyby.world/en/catalog/packages > How to add a complete travel package with prices, departures, hotels and images, and activate it so the AI agent starts selling it. A package is a ready-made trip you sell: Ramadan Umrah, a week in Turkey, a Maldives honeymoon. The more detail a package has, the better the AI agent can answer customers without handing them over to you. Open Packages ## The package list [#the-package-list] Each package shows as a card with its image, name and status, number of nights, next departure, "From" price, and a **Featured** label if it's featured. Search by name, destination or code, or filter by package type. ## Adding a package step by step [#adding-a-package-step-by-step] Click **New package**. It's created as a **Draft** and the editor opens. On desktop the package sections are listed on the side so you can jump between them, and the save bar at the bottom tells you when you have **Unsaved changes**. ### Basics [#basics] * **Package name (Arabic)**: required. Write it the way customers search: "عمرة رمضان 10 ليالي" beats "Package 3". * **Package name (English)**: optional, shown on the English version of your public page. * **Package type**: Umrah, Hajj, Outbound tourism, Domestic, Honeymoon, Cruise, Custom trip. * **Package code**: an internal code for search (optional). * **Short summary**: one or two lines the agent uses to introduce the package. * **Description** in Arabic (and English if you like). * **Destinations**: type each one and press Enter. For example: Makkah, Madinah. * **Departing from**: the departure city, e.g. Cairo. * **Nights**, plus **Valid from** and **Valid until** if the package has a season. * **Currency**. * **Featured package**: the agent recommends it first, and it shows at the top of the list. ### Includes / excludes [#includes--excludes] Pick from ready-made items (Flights, Hotel stay, Transfers, Visa, Breakfast, Ziyarat visits, Haramain train, Travel insurance...), or type your own and press Enter. Same for **Package excludes** (e.g. Tips, Personal expenses). ### Hotels [#hotels] Click **Add hotel** for each city: **City**, **Hotel name**, **Rating** (stars), **Nights**, **Meals** (Room only, Breakfast, Half board, Full board, All inclusive), and **Distance / note** like "300 m from the Haram". ### Itinerary [#itinerary] Click **Add day** for each day: **Day title** and **Details**. Reorder days with **Move up** and **Move down**. ### Prices [#prices] Each price row has: | Column | Options | | ----------------- | ----------------------------------------------- | | **Room type** | Single, Double, Triple, Quad, Per person | | **Traveller** | Adult, Child, Infant | | **Selling price** | What the customer pays | | **Cost** | Internal only; the margin is calculated for you | Fastest way: click **Add common prices** to get Double, Triple and Quad for adults plus Child and Infant per person. Fill in the prices and delete what you don't need. The **"From"** price customers see is calculated automatically: **the lowest adult price** in the table. ### Departures [#departures] Click **Add departure** for each trip: **Departure** date, **Return** date, **Total seats**, **Seats left**, and status (**Open**, **Full**, **Closed**). ### Images [#images] Click **Upload images**: JPG, PNG or WebP, up to 5 MB each, up to 20 images. **The first image is the cover** shown in the list and to customers; change it with **Set as cover** on any image. ### AI instructions & terms [#ai-instructions--terms] * **Instructions for the AI agent**: never shown to customers. Tell the agent what to highlight, e.g. "Highlight how close the hotel is to the Haram, offer quad rooms to families, never promise discounts without a staff member." * **Terms & conditions**: booking, cancellation and payment terms, e.g. "50% deposit on booking, balance two weeks before departure." ### Save and activate [#save-and-activate] Click **Save** first, then **Activate** at the top. The package becomes **Active** and the agent starts offering it right away. To activate a package it needs an **Arabic name** and **at least one saved adult price**. If you added prices and it still refuses, make sure you clicked **Save** before **Activate**. ## Departures and seats [#departures-and-seats] The agent only offers **upcoming** departures with the status **Open**, along with the seats left. **Seats left** doesn't go down on its own when you book, so update it yourself after each booking, and switch the departure to **Full** when it sells out so the agent stops offering it. ## Package statuses [#package-statuses] | Status | Meaning | Does the agent offer it? | | ------------ | -------------------------------------------- | ------------------------ | | **Draft** | Still being prepared | No | | **Active** | Ready to sell | Yes | | **Stopped** | Paused (sold out, or you're updating prices) | No | | **Archived** | Done for now, but kept | No | At the top of the editor: * **Activate** / **Stop**: turn the package on or off. * **Archive**: the agent stops offering it; you can restore and activate it anytime. * **Duplicate**: creates a **Draft** copy with all details, prices and departures. Perfect for a package that repeats every season. * **Delete**: permanently removes the package with its prices, departures and images. If in doubt, archive instead. ## On public page [#on-public-page] The **On public page** switch at the top of the editor decides whether the package shows on your [agency's public page](/en/public-page). It only shows while it's **Active**, and featured packages come first. The Starter plan shows up to 10 packages. ## Tips so the agent sells better [#tips-so-the-agent-sells-better] * **List every destination**, in Arabic the way customers write it. The agent searches the name, destinations, summary and departure city. * **Make the summary sell**: "10 nights, 5-star hotel facing the Haram, direct flights" beats "Special package". * **Don't leave hotels and itinerary empty.** They're what customers ask about most. * **Use the AI instructions** for what isn't written elsewhere: who the package suits, and what to say when a customer says "too expensive". * **Feature only one or two packages**, so the recommendation means something. ## Next [#next] # Services URL: https://docs.flyby.world/en/catalog/services > Add the services you sell on their own, like visas, flights, hotels and insurance, so the AI agent can answer with prices and required documents. Not every customer wants a full package. Some just need a Dubai visa, a flight ticket or a hotel in Makkah. **Services** is where you describe these, and the AI agent answers from them with price, documents and processing time. Open Services ## Service categories [#service-categories] | Category | Examples | | -------------------- | ------------------------------------ | | **Visas** | Dubai tourist visa, Schengen, Turkey | | **Flights** | Domestic and international tickets | | **Hotels** | Hotel-only bookings | | **Travel insurance** | Travel medical insurance | | **Transfers** | Airport pick-up, intercity transfers | | **Tours & trips** | Day trips, city tours | | **Car rental** | With or without a driver | | **Other services** | Anything else | ## Adding a service [#adding-a-service] Click **New service**. It's created as **Stopped** so the agent doesn't offer it half-filled, and the editor opens. ### Basics [#basics] * **Service name (Arabic)**: required, e.g. "تأشيرة دبي السياحية". * **Service name (English)**: optional. * **Category**: from the table above. * **Description**: what the customer needs to know, e.g. "Valid 30 days, single entry." ### Pricing [#pricing] Choose a **Pricing** type: | Type | Use it when | | ----------------- | -------------------------------------------------------------------- | | **Fixed price** | There's one clear price, like a visa fee | | **Starting from** | The price varies and you want to quote the lowest (like flights) | | **On request** | The price is quoted per customer, so the agent doesn't give a number | Then enter the **Price**, the **Cost** (internal only; the expected margin is calculated for you), and pick the **Currency** and **Unit**: Per person, Per booking, Per night, Per day. ### Processing time & documents [#processing-time--documents] * **Processing time** in days, e.g. 5 days for a visa. Zero means same day. * **Required documents**, one per line: * Passport valid for at least 6 months * Photo with white background * Bank statement for the last 3 months The agent tells customers about these documents and timing when they ask. ### AI instructions [#ai-instructions] Private notes on how to present the service. For example: "Make clear that visa approval is up to the embassy and not guaranteed, and offer insurance with every visa." ### Save and activate [#save-and-activate] Click **Save**, then **Activate**. The service becomes **Active** and the agent starts offering it. An active service needs a price, unless the pricing type is **On request**. ## Turning services on and off [#turning-services-on-and-off] * From the list: each service has a **Turn the service on or off** switch. * From the editor: **Activate** / **Stop** / **Archive** / **Delete**. | Status | Does the agent offer it? | | ------------ | ------------------------------------- | | **Active** | Yes | | **Stopped** | No | | **Archived** | No; you can activate it again anytime | Deleting is permanent. ## Tips [#tips] * **Visas are the service to get right.** Customers ask about them constantly, and clear documents and timing save your team a lot of calls. * **If the price changes daily** (like flights), use **Starting from** or **On request**, and say in the instructions that the final price is confirmed by a staff member. * **Keep the cost up to date.** It shows you your margin, and customers and the agent never see it. ## Next [#next] # Comment replies URL: https://docs.flyby.world/en/channels/comment-replies > Turn comments on your Instagram and Facebook posts into DM conversations about the right package, with everything you need to set up in Meta. Pick a post, link it to the package it's about, and every comment on it gets two answers: a short **public reply** under the comment, and a **DM** about that package. When the person answers the DM, the chat lands in your [inbox](/en/conversations) and the AI agent carries on as usual, already knowing which package they're interested in. It works on **Instagram posts and reels** and on **Facebook Page posts**. You'll find it in **Settings → Comment replies**. Only the **owner** and **managers** can change it. It uses your Instagram and Messenger channels, so it's available on **Growth** and **Pro** (and during the free trial). ## How it works [#how-it-works] 1. Someone comments on a post you turned on (optionally: only if the comment contains one of your keywords). 2. Flyby sends them a **DM** about the linked package (Meta calls this a "private reply"). 3. Flyby answers **under the comment** with a short line like "We've sent you the details in DM 💬". The wording rotates so Instagram doesn't flag it as spam. 4. The comment and the DM appear as a new conversation in **Conversations**, starting with "You messaged @handle about a comment they made on your post" and a link to the post. The comment itself is quoted below it: click it to open the comment (Facebook) or the post (Instagram). If the DM had buttons, you see them under it. 5. When they answer the DM, the AI agent takes over, with the package already in context. * You can send **one DM per comment**, within **7 days** of the comment. After that, nothing more until the person answers. That's why the default DM ends with a question. * Flyby sends **one DM per person per post**, even if they comment several times. * If the DM can't be sent, Flyby skips the public reply too, so it never says "check your DM" when there's nothing there. * Replies inside comment threads and your own comments are ignored. ## Required actions [#required-actions] Everything below is a one-time setup. Do the column for each platform you want. | What | Instagram | Facebook Page | | ----------------------------------------- | ------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | | Channel connected in Flyby | **Instagram Direct** | **Facebook Messenger** | | Token permissions | `instagram_manage_comments` (plus the [Instagram](/en/channels/instagram) ones) | `pages_read_user_content` and `pages_manage_engagement` (plus the [Messenger](/en/channels/messenger) ones) | | Meta webhook object | **Instagram** | **Page** | | Webhook fields | `messages`, `messaging_postbacks`, **`comments`** | the Messenger fields, plus **`feed`** | | Who can trigger it before Advanced Access | People with a role on your Meta app (testers) | Same | ### Connect Instagram first [#connect-instagram-first] Follow [Connect Instagram](/en/channels/instagram) until DMs reach Flyby. Comment replies use the same channel. ### Add `instagram_manage_comments` to the token [#add-instagram_manage_comments-to-the-token] In **Business Settings → Users → System users**, generate a new token for your app (expiration **Never**) with the Instagram permissions **plus `instagram_manage_comments`**. In the app, on the same use-case page, open **Permissions and features** and make sure `instagram_manage_comments` is added. ### Save the new token in Flyby [#save-the-new-token-in-flyby] **Settings → Channels & integrations** → **Instagram Direct** → paste the new token → **Connect**. Your Callback URL stays the same, so there's nothing to change in Meta. ### Subscribe the webhook to `comments` [#subscribe-the-webhook-to-comments] In your Meta app: **Use cases → Customize → Webhooks**. In the **Product** list on the left, pick **Instagram** (not "User" or "Page"). Check the Callback URL is Flyby's, then switch **`comments`** to **Subscribed** (next to `messages`). "Webhook configurations for Instagram API with Instagram business login are supported only within the product itself" is about a different connection method. Flyby connects Instagram through your Facebook Page, so you can ignore it. ### Connect Messenger first [#connect-messenger-first] Follow [Connect Messenger](/en/channels/messenger) until Page messages reach Flyby. Facebook comment DMs go out through Messenger. ### Add the two permissions to the token [#add-the-two-permissions-to-the-token] Generate a new System user token (expiration **Never**) with the Messenger permissions **plus `pages_read_user_content` and `pages_manage_engagement`**. The first lets Flyby show your Page posts; the second lets it reply under comments. ### Save the token in Flyby [#save-the-token-in-flyby] **Settings → Channels & integrations** → **Facebook Messenger** → paste the token → **Connect**. Saving also subscribes your Page to the `feed` field, and keeps what Instagram already subscribed. ### Subscribe the Page webhook to `feed` [#subscribe-the-page-webhook-to-feed] In your Meta app: **Use cases → Customize → Webhooks**, pick **Page** in the **Product** list, check the Callback URL is Flyby's Messenger one, and switch **`feed`** to **Subscribed**. ### Who can trigger it: testers vs. everyone [#who-can-trigger-it-testers-vs-everyone] While your Meta permissions show **"Ready for testing"** (Standard Access), Meta only sends events from people who have a role on your app. To test, add your personal account under **App roles → Roles → Instagram Testers** (or as a tester for Facebook) and accept the invite. On Instagram, that's in **Settings → Website permissions → Apps and websites → Tester invites**. What reaches Flyby from people with **no role** on your app: | | Standard Access | Advanced Access | | -------------------------------------- | ------------------------ | --------------- | | Their comments | ✅ Arrive | ✅ | | Our DM and public reply to the comment | ✅ Sent, buttons included | ✅ | | **Their answers to the DM** | ❌ Meta drops them | ✅ | So on Standard Access, comment replies still reach everyone and **link buttons** (like "View the package") work, but the conversation can't continue in Flyby. Answers need **Advanced Access** for `instagram_manage_messages` (and `pages_messaging` for Facebook). When you click **Add to App Review** on these permissions, Meta now asks you to **become a Tech Provider**, even for an app that only serves your own business. It needs **business verification** (your company's papers) and access verification, and it can't be undone. Start it only when you can finish every step. ## Set up a post [#set-up-a-post] 1. Open **Settings → Comment replies**. All your posts are in one list, each with a platform tag. Use the filter to show **Instagram and Facebook**, **Instagram only** or **Facebook only**. Just published something? Click **Refresh posts**. 2. Click a post. 3. Fill in: * **Reply to comments on this post**: on/off. * **Package**: the package the post is about. The DM mentions it, and the AI agent knows it when the person answers. Or pick **No package** for a general reply. * **Only reply when the comment includes**: keywords separated by commas, like `price, how much, بكام`. Leave it empty to reply to every comment. * **DM type**: **Text**, or **Text + buttons** (up to 3 buttons, 20 characters each). A button can be: * **Reply**: tapping sends the button's text back as their message, and the AI agent answers it. * **Link**: opens a link you enter (must start with `https://`). * **Package page**: opens the linked package on your [public page](/en/public-page) (the page must be on). A preview shows what they'll see. If Meta refuses the buttons, Flyby sends the text on its own so the comment still gets its DM. * **DM message**: use `{name}` for their name and `{package}` for the package name. Leave it empty to use the suggested text (Arabic or English, based on the comment's language). With buttons, the text can be up to 640 characters. * **Public replies under the comment**: one per line. Flyby picks a different one each time. 4. Click **Save**. The tile shows **On** and the package name. To stop, open the post and switch it off, or click **Stop and remove**. Conversations that already started stay in your inbox. ## Troubleshooting [#troubleshooting] * Is the post switched **On**, and does the comment contain one of your keywords (if you set any)? * Has that person already received a DM for this post? Flyby sends one per person per post. * Was it a reply inside a thread? Only top-level comments count. * Is the webhook subscribed to `comments` (Instagram) or `feed` (Facebook)? * If the commenter has no role on your Meta app, see "Who can trigger it" above. The channel's token is missing the permission named in the message. Generate a new token with it and save the channel again in **Channels & integrations**. The Messenger token needs `pages_read_user_content`. Also make sure the System user has **Full control** of the Page. Instagram needs `instagram_manage_comments`; Facebook needs `pages_manage_engagement`. Add the permission and save the channel again. Click **Refresh posts** at the top of the list. Meta can take a few seconds to list a post you just published, so try again shortly if it isn't there yet. Flyby shows your latest 30 posts. Older posts you've set up stay listed at the end, so you can still switch them off. ## Next [#next] # Channels URL: https://docs.flyby.world/en/channels > Where your customers message you from, and how every message lands in one inbox where the AI agent replies. Flyby brings messages from several channels into one inbox. The AI agent replies to each customer **on the same channel they used**, and your team can step in at any time. You set up every channel in one place: **Settings → Channels & integrations**. ## Available channels [#available-channels] | Channel | How it works | Plans | | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------- | -------------- | | [Public chat link](/en/channels/website-chat) | A ready-made chat page with your agency's name. Share it or add it to your website as a chat bubble with one line of code | All plans | | [WhatsApp Business](/en/channels/whatsapp) | WhatsApp Cloud API through your agency's own Meta app | All plans | | [Facebook Messenger](/en/channels/messenger) | Messages to your Facebook Page, through your Meta app | Growth and Pro | | [Instagram Direct](/en/channels/instagram) | DMs to your Instagram professional account, through the same Meta app | Growth and Pro | | [Telegram](/en/channels/telegram) | A Telegram bot with your agency's name, connected by pasting one token from @BotFather | Growth and Pro | | [Outbound webhook](/en/channels/outbound-webhook) (advanced) | Sends AI and team replies to your own messaging gateway | All plans | During the 14-day trial every channel is open, exactly like the Growth plan. If a channel isn't on your plan, you'll see a lock with "Available on … and above." and a **See plans** link. Its switch stays off until you upgrade. ## Who can set up channels? [#who-can-set-up-channels] Only the **owner** and **managers** can open the Channels page. Moderators don't see it. ## How a message flows [#how-a-message-flows] ### The customer sends a message [#the-customer-sends-a-message] From your public chat, WhatsApp, Messenger, Instagram or Telegram. ### It lands in your inbox [#it-lands-in-your-inbox] Meta sends the message to the channel's **Callback URL**. Flyby checks it really came from Meta using your App secret, then opens a conversation (or continues an existing one) in [Conversations](/en/conversations). ### The AI agent replies [#the-ai-agent-replies] In the customer's dialect, using only your packages, services and FAQs, while asking the qualification questions. The reply goes back on the same channel. ### Your team takes over when needed [#your-team-takes-over-when-needed] If the customer asks for a person or a handoff rule fires, the conversation becomes **Needs you**. Any reply from a teammate pauses the AI in that conversation. See [Handoff](/en/conversations/handoff). On WhatsApp, Messenger and Instagram you can only send free-form replies within 24 hours of the customer's last message. After that, WhatsApp needs approved templates (Flyby doesn't send templates yet). On Messenger and Instagram your team can reply for up to 7 days if your app is approved for HUMAN_AGENT. The AI never sends outside the 24 hours. Telegram has no such rule: you can reply any time. Details in [The messaging window](/en/conversations/messaging-window). ## Channel status [#channel-status] Each channel has an on/off switch. Once it's on, a badge next to its name shows the status: | Badge | What it means | What to do | | ----------------------------- | -------------------------------------------------------------- | ------------------------------------------------------------------- | | **Needs setup** | The channel is on but no credentials are saved yet | Finish the setup and click **Connect** | | **Waiting for first message** | Credentials are saved but no message has arrived from Meta yet | Send a test message from another phone | | **Connected** | Everything works | Nothing | | **Needs attention** | Meta rejected a request or the token stopped working | Read the error shown above the fields, fix it, then **Save & test** | Under the Callback URL you'll find two lines that help a lot while testing: * **Verified**: when Meta last confirmed the webhook. * **Last event**: the last message or delivery update Meta sent us. If both stay empty, the webhook isn't set up in your Meta app yet. * **Switch off**: the channel stops receiving and sending, but your token and IDs stay saved. Switch it back on and it works again. * **Remove credentials**: deletes the token, App secret and channel settings. Past conversations are kept. If you connect again you get a **new** Callback URL and Verify token, and must paste them in Meta again. ## Your own Meta app [#your-own-meta-app] WhatsApp, Messenger and Instagram connect through **your agency's own Meta app**, not a Flyby app. Your number, Page and account stay yours, and Meta bills you directly for any messaging fees. The rules you need to follow are in our [Meta messaging policy](https://flyby.world/en/meta-policy). Request the **Meta setup** add-on: our team sets up WhatsApp, Messenger and Instagram for you. It's a one-time 1,500 EGP / $49 on Starter and Growth, and **included in Pro**. Request it from **Settings → Plan & billing**. See [Add-ons](/en/billing/add-ons). ## Next [#next] # Connect Instagram URL: https://docs.flyby.world/en/channels/instagram > Bring DMs to your Instagram professional account into the inbox and let the AI agent reply. Once connected, every DM to your agency's Instagram account lands in your inbox, and the AI agent replies on Instagram. Instagram is available on **Growth** and **Pro** (and during the free trial). Instagram messages reach Flyby **through the Facebook Page linked to your account**. If you've finished [Connect Messenger](/en/channels/messenger), most of the work is done: same app, same System user, same Page. The **Meta setup** add-on covers Instagram too: a one-time 1,500 EGP / $49 on Starter and Growth, and **included in Pro**. Request it from **Settings → Plan & billing**. ## How Instagram differs from Messenger [#how-instagram-differs-from-messenger] | | Messenger | Instagram | | ------------------------- | -------------------------------------- | ------------------------------------------------------------- | | Field in Flyby | Your Page ID | The ID of **the Page linked to Instagram** | | Finding the account | From the Page ID | Flyby finds the Instagram account from the Page automatically | | Webhook object in Meta | **Page** | **Instagram** | | Subscribed fields | 4 fields | `messages` and `messaging_postbacks` | | Key permission for review | `pages_messaging` | `instagram_manage_messages` | | "Seen" and "typing…" | Yes | No | | Team replies after 24h | Up to 7 days with Human Agent approval | Up to 7 days with Human Agent approval | ## Before you start [#before-you-start] * An Instagram **professional (Business)** account, not a personal one. * The account is **linked to your agency's Facebook Page**, and the Page is in your Business portfolio. * In Flyby: you're the **owner** or a **manager**, on Growth or Pro. ## Steps [#steps] ### Make the account professional and link it to the Page [#make-the-account-professional-and-link-it-to-the-page] In the Instagram app, switch the account to **Professional → Business** if it isn't already. Then link it to your Facebook Page (Page settings on Facebook → **Linked accounts → Instagram**, or from Meta Business Suite). ### Allow access to messages [#allow-access-to-messages] In the Instagram mobile app: **Settings → Messages and story replies → Message controls → Connected tools**, and turn on **Allow access to messages**. Without this switch, Meta won't deliver DMs to any app, even if everything else is right. ### Prepare the app and System user [#prepare-the-app-and-system-user] Use your Meta app (add the Messenger use case if it isn't there) and your **Admin** System user, with these assets under **Assign assets**: * The app: **Manage app**. * The Facebook Page linked to Instagram: **Full control**. ### Generate a token for Instagram [#generate-a-token-for-instagram] **Generate new token** → your app → **Token expiration: Never**, with the permissions: * `instagram_basic` * `instagram_manage_messages` * `pages_manage_metadata` * `pages_show_list` * `pages_read_engagement` * `business_management` (optional) Add `instagram_manage_comments` too if you want [comment replies](/en/channels/comment-replies) (a DM and a public reply for comments on posts you pick). For DMs alone you don't need it. Copy the token right away. ### Connect in Flyby [#connect-in-flyby] 1. Open **Settings → Channels & integrations** and switch on **Instagram Direct**. 2. Paste the **token**, the **App secret** (App settings → Basic), and the **Facebook Page ID** of **the Page linked to Instagram**. 3. Click **Connect**. Flyby finds your Instagram account on its own and subscribes the Page to messages. When it works, the badge turns **Connected** and your account shows as `@yourhandle`. ### Paste the webhook in Meta [#paste-the-webhook-in-meta] In your Meta app: **Use cases → Customize → Webhooks**, then pick **Instagram** in the **Product** list on the left (not "User" or "Page"). Paste the **Callback URL** and **Verify token** from Flyby, click **Verify and save**, and subscribe to `messages` and `messaging_postbacks` (plus `comments` for comment replies). The orange note about "Instagram API with Instagram business login" is about a different connection method; you can ignore it. Disconnecting and reconnecting the channel in Flyby keeps the same Callback URL and Verify token, so you only paste them in Meta once. Every channel has its own Callback URL and Verify token. Don't reuse the Messenger ones for Instagram. ### Live mode and App Review [#live-mode-and-app-review] Switch the app to **Live**. While the permissions show **"Ready for testing"** (Standard Access), test from an account added under **App roles → Roles → Instagram Testers**. With **Standard Access** ("Ready for testing"), Meta only delivers DMs from people who have a role on your app, or whose account is connected to your business. **DMs from the public need Advanced Access** for `instagram_manage_messages`. Meta now only lets you request it as a **Tech Provider**, which needs **business verification** (your company's official papers) and access verification. That choice can't be undone, so do it once you're ready to finish all the steps. If you want your team to reply for up to 7 days, request **Human Agent** too. Until then, comments from anyone still arrive: see [Comment replies](/en/channels/comment-replies). ## Test the connection [#test-the-connection] 1. From another Instagram account, send a DM to your agency's account. 2. In Flyby, **Last event** updates. 3. Open [Conversations](/en/conversations): you'll see the Instagram conversation and the AI's reply. ## Good to know [#good-to-know] * **Long replies** are split into several messages automatically, because Instagram accepts shorter messages than WhatsApp and Messenger. * **Shared reels or posts, and story mentions** show in the conversation as a short label (like "🎬 ريل" or "📣 إشارة في ستوري"). * **Comments** on your posts can get a DM and a public reply too: see [Comment replies](/en/channels/comment-replies). ## Troubleshooting [#troubleshooting] The Page whose ID you entered has no Instagram professional account linked. Make sure you used the ID of **the Page linked to Instagram**, and that the account is Business, not personal. * Check **Allow access to messages** in the Instagram app. * Make sure the webhook is registered on the **Instagram** object (not "User" or "Page") and subscribed to `messages` and `messaging_postbacks`. * If the app is still in Development, test from a tester account. The System user has no access to the Page. Add it under Assign assets and generate a new token. ## Next [#next] # Connect Messenger URL: https://docs.flyby.world/en/channels/messenger > Bring your Facebook Page messages into the inbox and let the AI agent reply on Messenger, step by step. Once connected, anyone who messages your agency's Facebook Page lands in your inbox, and the AI agent replies on Messenger. Messenger is available on **Growth** and **Pro** (and during the free trial). You connect through **your agency's own Meta app**. If you already connected WhatsApp, you can reuse the same app and System user. The **Meta setup** add-on: our team sets up WhatsApp, Messenger and Instagram for you. A one-time 1,500 EGP / $49 on Starter and Growth, and **included in Pro**. Request it from **Settings → Plan & billing** ([Add-ons](/en/billing/add-ons)). ## Before you start [#before-you-start] * A **Facebook Page** for your agency, added to your Business portfolio at [business.facebook.com](https://business.facebook.com). * A **developer account** at [developers.facebook.com](https://developers.facebook.com). * In Flyby: you're the **owner** or a **manager**, on Growth or Pro. ## Part 1: The Meta app and the token [#part-1-the-meta-app-and-the-token] ### Prepare the app [#prepare-the-app] * **Already have an app from WhatsApp?** Open it, go to **Use cases**, click **Add use case** and choose **Engage with customers on Messenger from Meta**. * **No app yet?** At [developers.facebook.com/apps](https://developers.facebook.com/apps) click **Create app**, choose the Messenger use case and the **Business** type, and link it to your Business portfolio. Then connect your Facebook Page to the app from the Messenger settings (**Messenger API Settings**). ### Create a System user (or reuse yours) [#create-a-system-user-or-reuse-yours] 1. **Business Settings → Users → System users → Add**. 2. Enter a name and choose the **Admin** role. If you have a System user from WhatsApp, use it and carry on. ### Give it access to the app and the Page [#give-it-access-to-the-app-and-the-page] Under **Assign assets**: 1. **Apps** → your app → **Manage app**. 2. **Pages** → your agency's Page → **Full control**, including messaging. 3. **Save changes**. If the System user has no access to the Page, Flyby can't get the Page token and you'll see a `no_page_token` error. ### Generate the token [#generate-the-token] 1. **Generate new token** → choose your app. 2. **Token expiration**: **Never**. 3. Permissions: * `pages_messaging` * `pages_manage_metadata` * `pages_show_list` * `pages_read_engagement` * `business_management` (optional) * `pages_read_user_content` and `pages_manage_engagement` (only for [comment replies](/en/channels/comment-replies) on your Page posts) 4. **Generate token** and copy it right away. Your WhatsApp token doesn't include Page permissions. Generate a new token for Messenger with the permissions above. Each Flyby channel keeps its own token, so this doesn't affect WhatsApp. ### Copy the App secret and the Page ID [#copy-the-app-secret-and-the-page-id] * **App secret**: in your app → **App settings → Basic → App secret → Show**. * **Facebook Page ID**: open your Page → **About → Page transparency**, or **Business Settings → Accounts → Pages** and select the Page. ## Part 2: Connect in Flyby [#part-2-connect-in-flyby] ### Switch on Facebook Messenger [#switch-on-facebook-messenger] Open **Settings → Channels & integrations** and switch on **Facebook Messenger**. ### Paste the details and click **Connect** [#paste-the-details-and-click-connect] | Field | Value | | ---------------------------- | ----------------------------------- | | **System user access token** | The new token with Page permissions | | **App secret** | App settings → Basic | | **Facebook Page ID** | Your Page's ID | Flyby fetches the Page token itself and **subscribes your Page to messages automatically** (messages, messaging_postbacks, message_deliveries, message_reads). When it works, the badge turns **Connected** and your Page's name appears. ## Part 3: The webhook in your Meta app [#part-3-the-webhook-in-your-meta-app] For Messenger you paste the webhook yourself at the app level. Flyby can't do this step for you. ### Open the webhook settings [#open-the-webhook-settings] In your Meta app: **Messenger → Settings → Webhooks** (in the newer dashboard: **Use cases → Customize → Messenger API Settings → Configure webhooks**). ### Paste the URL and token [#paste-the-url-and-token] * **Callback URL**: copy it from Flyby (the Webhook box). * **Verify token**: copy it from the same place. Click **Verify and save**. When it works, **Verified** updates in Flyby. ### Subscribe to the fields [#subscribe-to-the-fields] Subscribe to: * `messages` * `messaging_postbacks` * `message_deliveries` * `message_reads` If your Page isn't listed in the webhooks section, add it and click **Subscribe** next to it. ## Part 4: Live mode and App Review [#part-4-live-mode-and-app-review] ### Switch the app to Live [#switch-the-app-to-live] At the top of the app dashboard switch **App Mode** to **Live** (Meta asks for a Privacy Policy URL in App settings → Basic: use your agency's own privacy page). ### Request App Review [#request-app-review] In Development mode or without approval, your Page only receives messages from **app admins and testers**. To receive messages from the public, Meta requires: * **App Review** with **Advanced Access** for `pages_messaging`. * **Business verification** of your Business portfolio. In your app open **App Review → Permissions and features**, request Advanced Access, and explain that the app answers customer messages to your agency's Page through an AI assistant and a support team. Meta may ask for a short screencast. Meta now asks you to **become a Tech Provider** before it accepts this request, even for an app that only serves your own Page. That needs business verification (your company's papers) and access verification, and can't be undone, so start it only when you can finish every step. Until then, messages arrive only from people with a role on your app. ### Optional: Human Agent [#optional-human-agent] Once **Human Agent** is approved in App Review, your team can reply for up to **7 days** after the customer's last message (Flyby adds the HUMAN_AGENT tag to team replies after 24 hours automatically). Without it, all replies are limited to **24 hours**. The AI itself never replies after 24 hours. ## Test the connection [#test-the-connection] 1. From a Facebook account that **isn't** a Page admin (or a tester account while the app is in review), message your Page. 2. In Flyby, **Last event** updates. 3. In [Conversations](/en/conversations) you'll find a new Messenger conversation with the AI's reply. The customer sees "seen" and "typing…". Messenger doesn't send the customer's name with the message, so Flyby tries to look it up once. That needs **Business Asset User Profile Access** on your app. Without it, the conversation shows without a name until the AI asks the customer. ## Troubleshooting [#troubleshooting] The System user has no access to the Page, or the token lacks Page permissions. Add the Page under Assign assets with full control, generate a new token with all five permissions, and click **Save & test**. The app is still in Development mode or hasn't been granted Advanced Access for `pages_messaging`. Finish Part 4. The webhook isn't registered at the app level. Go back to Part 3, paste the URL and token from Flyby using the copy buttons, and click Verify and save. The webhook is set but `messages` isn't subscribed, or the Page isn't subscribed to the app. Subscribe the fields, then click **Save & test** in Flyby to re-subscribe the Page. The 24 hours have passed. Without Human Agent approval there's no reply until the customer writes again. See [The messaging window](/en/conversations/messaging-window). ## Next [#next] # Outbound webhook URL: https://docs.flyby.world/en/channels/outbound-webhook > An advanced setting that sends every AI and team reply to your own URL, so your own messaging gateway can deliver it. This is an **advanced** setting that most agencies don't need. For every reply from the AI agent or your team, Flyby sends a `POST` request with the reply to a URL you choose, and your gateway delivers the message to the customer. ## Do you need it? [#do-you-need-it] | Your setup | What to do | | ---------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- | | You connected WhatsApp, Messenger or Instagram in Flyby | **Leave it off.** Replies are delivered automatically | | You only use the public chat | **Leave it off** | | You run your own messaging gateway (like n8n, or a non-Meta WhatsApp provider) and want replies sent there | This is for you | This webhook only sends replies **out**. Bringing customer messages from your gateway into Flyby isn't self-serve yet. Before you build on it, contact [support@flyby.world](mailto:support@flyby.world). ## Turn it on [#turn-it-on] ### Open Channels [#open-channels] **Settings → Channels & integrations**, and scroll to **Advanced**. ### Switch on **Send replies to your gateway (outbound webhook)** [#switch-on-send-replies-to-your-gateway-outbound-webhook] ### Enter the **Outbound URL** and click **Save** [#enter-the-outbound-url-and-click-save] It must start with `https://` and be publicly reachable, like `https://gateway.example.com/flyby`. Once saved, the badge shows **Connected**. ## The payload we send [#the-payload-we-send] With every reply, Flyby sends a `POST` with `Content-Type: application/json`: ```json { "agency_id": "…", "conversation_id": "6f1c…", "channel": "whatsapp", "contact_phone": "+201001234567", "sender": "ai", "text": "Hi Ahmed! …" } ``` | Field | Meaning | | ------------------- | ---------------------------------------------------------------- | | `agency_id` | Your agency's ID in Flyby | | `conversation_id` | The conversation's ID; use it to group replies | | `channel` | The channel the conversation came from, like `whatsapp` or `web` | | `contact_phone` | The customer's phone if known (can be `null`) | | `contact_instagram` | Team replies only: the customer's Instagram handle if known | | `sender` | `ai` for AI agent replies, `agent` for replies from your team | | `text` | The reply text | ## When is it sent? [#when-is-it-sent] * **AI replies**: in any conversation that is **not** on a Meta channel connected in Flyby, including public chat conversations. * **Team replies**: in conversations that aren't from the public chat, when the reply couldn't be sent through a connected Meta channel. So if WhatsApp is connected in Flyby, its replies go straight to Meta and never pass through the webhook. ## Tips for your gateway [#tips-for-your-gateway] * Respond quickly: Flyby waits **8 seconds** at most. * Each reply is sent **once, with no retries**. If your gateway was down, that reply won't reach it. * Requests aren't signed, so make the URL hard to guess (for example, end it with a long secret code). ## Turn it off [#turn-it-off] Switch off **Send replies to your gateway**. The URL is cleared and sending stops right away; you'll see "Outbound webhook turned off". ## Next [#next] # Connect Telegram URL: https://docs.flyby.world/en/channels/telegram > Create a Telegram bot for your agency with @BotFather, paste its token into Flyby, and your AI agent starts replying within a minute. After the public chat link, Telegram is the easiest channel to connect: no Meta app, no review, no business verification. You create a **bot** with your agency's name, paste its token into Flyby, and you're done. Available on **Growth** and **Pro**, and during the free trial. ## Before you start [#before-you-start] * A regular Telegram account (phone or desktop). * You're the **owner** or a **manager** of the agency in Flyby. ## 1. Create the bot with @BotFather [#1-create-the-bot-with-botfather] ### Open @BotFather [#open-botfather] In Telegram, search for **@BotFather** (it has the blue verified tick) and press **Start**. ### Send /newbot [#send-newbot] It asks for a **name**: what customers see at the top of the chat, e.g. "Nile Tours". ### Pick a username [#pick-a-username] English letters, ending in `bot`, e.g. `NileToursBot`. It becomes your bot link: `t.me/NileToursBot`. ### Copy the token [#copy-the-token] BotFather replies with a **token** that looks like this: ```text 123456789:AAH4kZ... ``` Anyone with the token can control the bot. Don't share or post it. Flyby stores it encrypted and never shows it again. ## 2. Connect it in Flyby [#2-connect-it-in-flyby] ### Open Channels [#open-channels] Go to **Settings → Channels** and turn on **Telegram**. ### Paste the token and press **Connect** [#paste-the-token-and-press-connect] Flyby checks the token with Telegram and sets up the webhook for you. There's nothing to copy anywhere else. ### Test it [#test-it] Your **Bot link** appears. Open it on your phone, press **Start** and send a message. The conversation shows up in [Conversations](/en/conversations) and the AI agent replies. ## Share the bot with customers [#share-the-bot-with-customers] The customer always **starts the chat**: they open the bot and press Start. A bot can't message anyone who hasn't messaged it first, so put the link where customers see it: * In your Instagram, TikTok and Facebook bio. * In your ads, or as a QR code in the office and on brochures. * On your [public page](/en/public-page), in your [social links](/en/public-page/social-links). In @BotFather, set the bot's photo with /setuserpic and the description customers see before pressing Start with /setdescription. ## How Telegram differs from WhatsApp [#how-telegram-differs-from-whatsapp] | | Telegram | WhatsApp | | ---------------- | ------------------------------------- | ----------------------------------- | | Setup | Paste one token | Meta app, verification, webhook | | Cost | Free | Meta charges per conversation | | Reply window | **None**: reply or follow up any time | 24 hours, then templates only | | Who starts | Only the customer (presses Start) | The agency can start with templates | | Customer's phone | Only if they share it | Always known | | Account | A bot ("bot" shows next to its name) | Your business number | The AI agent asks for the customer's phone number as part of qualification, so it's saved on the contact once they type it. ## Common questions [#common-questions] Your message isn't sent, and it's marked "Not sent: the customer blocked your bot on Telegram". If they unblock it and write again, the conversation continues as normal. Yes, but a bot delivers its messages to one place only. If it's connected to another service, connecting it to Flyby disconnects it there. A new bot just for sales is best. No. Flyby only replies in private chats. Messages in groups or channels the bot was added to are ignored. They arrive in your inbox as labels like "📷 صورة" or "🎤 رسالة صوتية", and the AI asks the customer to type their request. To switch bots, paste the new token and press **Save & test**. Turning off the Telegram switch pauses the bot and keeps the token. **Remove credentials** deletes the token completely. # Public chat link URL: https://docs.flyby.world/en/channels/website-chat > A ready-made chat page with your AI agent. Share it in bios and ads, or put it on your website, with no technical setup. The public chat link is the fastest way to let customers talk to your AI agent: a chat page with your agency's name and logo that works on phones and computers. It's available on **all plans**. ## Turn on the chat [#turn-on-the-chat] ### Open Channels [#open-channels] Go to **Settings → Channels & integrations**. ### Switch on **Public chat link** [#switch-on-public-chat-link] It's on by default. If the switch is off, turn it on. ### Copy the **Chat link** [#copy-the-chat-link] Use the copy button next to the link, or **Open page** to see it the way customers do. The link looks like this: ```text https://flyby.world/en/chat/ ``` The link uses the language of the dashboard you have open. Want the Arabic version? Change `/en/` to `/ar/` in the link. ## What customers see [#what-customers-see] * Your agency name and logo, plus your AI agent's name with "Online now". * The greeting from your AI agent settings (or a default one), and three quick suggestions they can tap. * A **Call** button that dials your WhatsApp number (or your phone number if there's no WhatsApp). * A **New conversation** button to start over. * Replies from your team are marked "Agency team" so customers know a person is answering. * "Powered by Flyby" at the bottom, which disappears on the **Pro** plan. The conversation is saved on the customer's device, so if they close the page and come back, it's still there. ## Where to share it [#where-to-share-it] * Your Instagram, TikTok and Facebook bios. * Paid ads, as the destination of a "Send message" button. * A QR code in your office or on brochures. * Your WhatsApp away message or email signature. If your [public page](/en/public-page) is live, its **Chat with us** buttons open this same chat. No need to share two links. ## Put it on your website [#put-it-on-your-website] Below the link you'll find **Embed on your website** with **one line** of code, with your agency ID already filled in. Copy it from there exactly. It looks like this: ```html ``` This line adds a **floating chat bubble** in your chat colour to the corner of **every page of your website** (bottom-right in English, bottom-left in Arabic). When a visitor clicks it, your AI agent's chat opens in a panel, or full screen on phones. ### Copy the line [#copy-the-line] Click the copy icon above the code in **Embed on your website**. ### Paste it once into your site [#paste-it-once-into-your-site] Put it just before ``, or wherever your site lets you add code to every page. On WordPress use a plugin like **Insert Headers and Footers** or your theme's footer code box; on Wix or Shopify use the site's **Custom code** settings. ### Open your site and test [#open-your-site-and-test] You'll see the bubble in the corner. Click it and send a message. * Want the chat in Arabic? Change `lang=en` to `lang=ar` in the line. * The chat **only loads when a visitor opens it**, so your site stays fast. * Visitors close it with **Escape** or the **X** in the chat header. * After a few seconds, a small "Planning a trip? Ask us 👋" message appears next to the bubble, **once per visit**. * If you turn the public chat off, the bubble disappears from your site by itself. Instead of the code, add a normal button ("Chat with us") that links to your chat link. Same chat, no code. ## Chat colour [#chat-colour] Under **Chat color**, pick one of the preset colours or type a HEX code (like `#0b5e6b`) and click **Save**. The colour is used for the chat header, the customer's message bubbles and the buttons, **and it's also the main colour of your public page**. ## Test it yourself [#test-it-yourself] 1. Open your chat link in a private (Incognito) window or on another phone. 2. Ask a real question, like "How much is Umrah in Shaaban?". 3. Open [Conversations](/en/conversations): you'll see the new conversation and the AI agent's reply. 4. Reply from the inbox and watch your reply arrive in the chat. Any public-chat conversation the AI replies in counts toward your monthly [AI conversations](/en/billing/ai-conversations), even when it's you testing, and it shows in the inbox like a real customer. If you only want to check the agent's answers, use [Test the agent](/en/ai-agent/test-agent). ## Turning the chat off [#turning-the-chat-off] When you switch it off, the chat link stops opening, the chat bubble disappears from your website, and the **Chat with us** buttons disappear from your public page (the WhatsApp button stays if you have a number). Past conversations stay in your inbox. ## Next [#next] # Connect WhatsApp URL: https://docs.flyby.world/en/channels/whatsapp > Step by step, from creating a Meta app to the first message your AI agent answers on your WhatsApp Business number. When you finish this page, every customer who messages your WhatsApp Business number will land in your inbox, and the AI agent will reply on WhatsApp. WhatsApp is available on **all plans**. You connect through **your agency's own Meta app** and the WhatsApp Cloud API. There are quite a few steps, but each one is simple. Set aside about an hour and keep the phone with the number you're connecting nearby. With the **Meta setup** add-on our team sets up WhatsApp, Messenger and Instagram for you: a one-time 1,500 EGP / $49 on Starter and Growth, and **included in Pro**. Request it from **Settings → Plan & billing** ([Add-ons](/en/billing/add-ons)). ## Before you start [#before-you-start] * A **Meta Business account** (Business portfolio) for your agency at [business.facebook.com](https://business.facebook.com), where you're an Admin. * A **developer account** at [developers.facebook.com](https://developers.facebook.com), using the same Facebook login. * A **phone number** that can receive an SMS or call for the verification code. * In Flyby: you're the agency's **owner** or a **manager**. A number registered on the WhatsApp Cloud API usually can't stay active in the regular WhatsApp app on a phone at the same time. Meta offers a "coexistence" option for WhatsApp Business app numbers in some countries, but if you're unsure, the safest choice is a new number dedicated to the agency. Think it through before moving your main number. ## Part 1: Prepare the Meta app and the number [#part-1-prepare-the-meta-app-and-the-number] ### Create a Business app [#create-a-business-app] 1. Go to [developers.facebook.com/apps](https://developers.facebook.com/apps) and click **Create app**. 2. Give the app a name (for example "Flyby - Your Agency") and a contact email. 3. Choose the use case **Connect with customers through WhatsApp**. If asked for a type, pick **Business**. 4. Select your agency's Business portfolio and click **Create app**. ### Add your WhatsApp Business number [#add-your-whatsapp-business-number] 1. In the app menu, open **WhatsApp → API Setup** (in Meta's newer dashboard: **Use cases → Customize → API Setup**). 2. Click **Add phone number**, then enter the name customers will see (Display name) and your business category. 3. Verify the number with the code you receive by SMS or call. Meta gives you a free **Test number** on the same page. You can connect it to Flyby with the same steps, but it can **only reply to up to 5 numbers** you add under **To → Manage phone number list** (each confirmed with a code). Anyone else gets no reply, and Flyby shows *"Meta test number: add this customer's number to the allowed list in your Meta app"*. Once you're happy, add your real number and update the Phone number ID in Flyby. With your own number, the AI and your team can answer **any customer who writes first**, with no allowed list, no App Review and no Tech Provider status: Meta treats an agency using its own number as a direct developer. Business verification isn't required either; it only raises limits on messages *you* start (templates), which Flyby doesn't send yet. ### Copy the WhatsApp Business Account ID and Phone number ID [#copy-the-whatsapp-business-account-id-and-phone-number-id] On the same **API Setup** page, under your number you'll find: * **Phone number ID**: a long ID that belongs to Meta. **It is not your phone number.** * **WhatsApp Business Account ID**: the account your number belongs to (also shown in WhatsApp Manager). Keep both in a note; you'll need them soon. ### Copy the App secret [#copy-the-app-secret] 1. In the app menu: **App settings → Basic**. 2. Next to **App secret**, click **Show** and enter your Facebook password if asked. 3. Copy it. Flyby uses the App secret to check that every message really comes from Meta and not from someone imitating it. ## Part 2: A permanent token from a System user [#part-2-a-permanent-token-from-a-system-user] The token is the "key" that lets Flyby read messages and reply on your behalf. It must be **permanent**, which is why you create it from a System user, not your personal account. ### Create a System user [#create-a-system-user] 1. Open [business.facebook.com/settings](https://business.facebook.com/settings). 2. Go to **Business Settings → Users → System users** and click **Add**. 3. Enter a name (for example "Flyby"), choose the **Admin** role and click **Create system user**. ### Give it access to the app and the WhatsApp account [#give-it-access-to-the-app-and-the-whatsapp-account] With the system user selected, click **Assign assets** (or **Add assets**): 1. **Apps** → pick your app → turn on **Manage app** (full control). 2. **WhatsApp accounts** → pick your WhatsApp Business account → turn on **Full control**. 3. Click **Save changes**. ### Generate the token [#generate-the-token] 1. Click **Generate new token** and choose your app. 2. Set **Token expiration** to **Never**. 3. Tick these permissions: * `whatsapp_business_messaging` * `whatsapp_business_management` * `business_management` (optional) 4. Click **Generate token** and **copy it right away**: Meta won't show it again. If you pick any expiry other than **Never** (like 60 days), the connection works and then suddenly stops when the token expires, and the channel turns to **Needs attention**. If you miss one of the three permissions, Meta rejects the connection. ## Part 3: Connect in Flyby [#part-3-connect-in-flyby] ### Switch on WhatsApp Business [#switch-on-whatsapp-business] Open **Settings → Channels & integrations** and switch on **WhatsApp Business**. You'll see **Webhook (paste in your Meta app)** with a **Callback URL** and a **Verify token**, and the credential fields below. ### Paste the details [#paste-the-details] | Field in Flyby | Where you got it | | -------------------------------- | --------------------- | | **System user access token** | The token from Part 2 | | **App secret** | App settings → Basic | | **WhatsApp Business Account ID** | WhatsApp → API Setup | | **Phone number ID** | WhatsApp → API Setup | ### Click **Connect** [#click-connect] Flyby checks that the number belongs to that WhatsApp account, subscribes your app to the account's messages, **and registers the Callback URL with Meta automatically**. If all is well you'll see "Connected to Meta", the badge turns **Connected**, and your number's name shows under WhatsApp Business. After saving, the token and App secret are stored encrypted and never shown again. To change something else, leave those fields empty and the saved values are kept. From now on the button is called **Save & test**. ### Confirm the webhook in Meta [#confirm-the-webhook-in-meta] Even if automatic registration worked, do this step to make sure messages flow: 1. In your Meta app, open **WhatsApp → Configuration**. 2. In the **Webhook** section click **Edit**, then paste the **Callback URL** and **Verify token** from Flyby (each has a copy button). 3. Click **Verify and save**. 4. Under **Webhook fields**, click **Manage** and **Subscribe** to `messages`. If you saw the warning "Connected, but the webhook URL couldn't be set automatically", this step is required. ### Switch the app to Live [#switch-the-app-to-live] At the top of the app dashboard, switch **App Mode** from **Development** to **Live**. Meta doesn't send some webhooks while the app is in Development mode. Meta asks for a **Privacy Policy URL** in App settings → Basic before you can go Live. Use your agency's own privacy page (on your website). You **don't need App Review** for WhatsApp: the app serves your own number. Without Business verification you can still answer every customer; verification only raises the limits on business-initiated messages (250 people a day unverified) and the number of phone numbers (2). ## Test the connection [#test-the-connection] 1. From **another** phone (not the connected number), send "Hi, I'd like Umrah prices" to your WhatsApp number. 2. In Flyby, under the Callback URL, **Last event** should update to right now. 3. Open [Conversations](/en/conversations): you'll find a new WhatsApp conversation, with the AI's reply within seconds. On the customer's phone the message shows as read and "typing…" appears before the reply. ## What customers can send [#what-customers-can-send] * **Text messages** and button taps are read and answered by the AI. * **Photos, voice notes, videos, files, stickers, locations and contacts** show in the conversation as a short label (like "📷 صورة" or "🎤 رسالة صوتية") so your team knows the customer sent something and can follow up. * Long AI replies are split automatically if they go over WhatsApp's limit. You can only send free-form replies within 24 hours of the customer's last message. After that WhatsApp requires approved templates, which Flyby doesn't send yet, so the message fails until the customer writes again. See [The messaging window](/en/conversations/messaging-window). ## Troubleshooting [#troubleshooting] Meta's own message is shown with the error. The usual causes: * **The token is missing a permission**: generate a new one with both `whatsapp_business_messaging` and `whatsapp_business_management`. * **The System user has no access to the WhatsApp account**: go back to Assign assets, add the WhatsApp Business account with full control, then generate a new token. * **`phone_not_in_waba`**: the Phone number ID doesn't belong to the WhatsApp Business Account ID you entered. Copy both from the same API Setup page. * Check **Verified** and **Last event**. If they're empty, the webhook isn't set: go back to "Confirm the webhook in Meta". * Make sure you **subscribed** to `messages` under **Webhook fields**. * Make sure the app is **Live**, not Development. * If you're testing with Meta's test number, the phone you send from must be in the **To** list. * Copy both from Flyby with the copy buttons, with no extra spaces. * Make sure the WhatsApp switch is **on** in Flyby and that you didn't click **Remove credentials** after copying (removing changes the URL and token). Most likely the token was revoked or expired (for example someone removed the System user or changed its access). Generate a new token with expiry **Never**, paste it, and click **Save & test**. You're connected with Meta's **Test number**, which only replies to the numbers on its list. Add the customer's number under **WhatsApp → API Setup → To → Manage phone number list** and confirm it with the code, or switch to your real number. * A teammate may have taken over: the AI pauses in any conversation your team replied in. * Your monthly AI conversations may be used up, so new chats go to the team as **Needs you**. See [AI conversations](/en/billing/ai-conversations). Still stuck? Email [support@flyby.world](mailto:support@flyby.world) with the exact error text. ## Next [#next] # Handoff to your team URL: https://docs.flyby.world/en/conversations/handoff > When the AI agent hands a conversation to your team, how to take over, and how to give it back. The AI agent answers most questions on its own, but some moments need a person: a customer ready to book, a complaint, or a question your data doesn't cover. When that happens the conversation moves to **Needs you** and you get notified. ## When does a conversation move to "Needs you"? [#when-does-a-conversation-move-to-needs-you] | Situation | What the AI does | Does the AI keep replying? | | ---------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ | | **The customer is qualified**: the AI has the trip details and a way to reach them, or they clearly want to book | Writes a summary, scores the lead (hot / warm / cold), moves it to **Qualified**, and tells the customer a consultant will contact them | Yes. It keeps answering questions until a teammate replies or takes over | | **The customer asks for a person**, complains, or has a payment, refund or existing-booking issue | Tells the customer a teammate will continue, and writes a handoff reason and summary | No, it pauses | | **One of your rules** under "When to hand off to a human" applies | Same as above | No, it pauses | | **A question with no answer** in your packages, services or FAQs | Hands over instead of making something up | No, it pauses | | **Your monthly AI conversations are used up** | New chats go straight to your team | No | | **The AI couldn't reply** for a technical reason | Hands over so the customer isn't left waiting | No | In these cases the AI raises the **priority** to High (for a qualified lead, High when the score is hot), so the conversation stands out in red. The **Handoff reason** shows in the Details panel. If the AI wrote its own reason you'll read it as is; when the system handed over, you'll see one of these: * "The AI asked a teammate to take over" * "The AI agent is turned off" * "The AI couldn't reply (technical issue)" * "AI conversations used up for this month" On the AI agent page, list the situations where the agent should stop under **When to hand off to a human**, for example big groups or corporate bookings. See [Instructions](/en/ai-agent/instructions) and, for qualification, [Qualification](/en/ai-agent/qualification). ## How you'll know a chat is waiting [#how-youll-know-a-chat-is-waiting] * **The red number** next to **Conversations** in the sidebar (and the phone tab bar) counts chats that need you. * **An in-app notification** (the bell) with the customer's name and summary. Tap it to open the conversation or the lead. * **A device notification**, even when Flyby is closed, if you turn it on in [Settings → Notifications](/en/settings/notifications). Notifications are set per device; on iPhone [install the app](/en/getting-started/install-app) first. | Notification | Who gets it | | ---------------------------------------------------------------------- | ----------------------------------- | | A conversation needs you (asked for a person, complaint, handoff rule) | Owner and managers | | The AI agent couldn't reply | Owner and managers | | Qualified lead (hot / warm / cold) | Owner, managers and lead moderators | ## Taking over [#taking-over] ### Open the conversation [#open-the-conversation] From the **Needs you** tab or the notification. Read the **AI summary** and **Handoff reason** in the Details panel first, so you don't ask the customer something they already said. ### Click "Take over" [#click-take-over] The AI stops, the conversation becomes **With team** and is assigned to you, and a line is added to the thread saying you took over. ### Reply to the customer [#reply-to-the-customer] Type in the **Reply** box and send (or press Enter). Need help with the wording? Click **Suggest a reply with AI** and the agent drafts one in the reply box. Review and edit it before sending. If you send a reply while the AI is active, you'll see "Sending a message pauses the AI in this conversation". As soon as you send, the AI stops and the chat is assigned to you, just like clicking **Take over**. Internal notes don't pause the AI. ## Handing back to the AI [#handing-back-to-the-ai] Done with the part that needed a person? Click **Hand back to AI** at the top. The conversation returns to **AI agent**, the handoff reason is cleared, and the AI answers the customer's **next** messages. If the customer's last message is still unanswered and you want the AI to answer it now, open the ⋮ menu and choose **Let the AI reply now**. It only works when the last message is from the customer, and it works even while the AI is paused in that chat. ## Tips for your sales team [#tips-for-your-sales-team] * **Reply fast to qualified leads.** The AI told them a consultant would get in touch, so every minute counts, especially for hot leads. * **Agree who handles what.** Use [assignment](/en/conversations/notes-and-assignment) so nobody replies to the same customer twice. * **Set your working hours.** Outside your [working hours](/en/settings/working-hours) the AI tells customers the team will follow up during business hours instead of promising an instant reply. * **Close conversations when you're done**, so **With team** stays clean. ## Next [#next] # The inbox URL: https://docs.flyby.world/en/conversations > Every customer message from WhatsApp, Messenger, Instagram and your website chat in one place, with a clear view of who is replying to whom. **Conversations** is where you follow everything the AI agent says to your customers, and where you step in whenever you want. New messages show up instantly, no need to refresh. Open Conversations Owners and managers only. A **Lead moderator** doesn't see the Conversations page at all; their work starts in [Leads](/en/leads) once a customer is qualified. ## How the page is laid out [#how-the-page-is-laid-out] * **The list** on the side: every conversation, sorted by the latest message. * **The conversation**: pick one to read the full thread, with the reply box underneath. On large screens a **Details** panel sits next to it (customer info, lead, AI summary, assignment and priority). Each row in the list shows: | Part | What it tells you | | ----------------------------- | --------------------------------------------------------------------------------------- | | Avatar with a small badge | The customer's name; the badge is the channel (WhatsApp, Messenger, Instagram, Website) | | Last message | With an icon when the last reply came from the AI agent or a teammate | | Coloured number | Unread messages; the name also turns bold | | Dot and status | The conversation status (below) | | **High** or **Urgent** in red | Priority. The AI raises it on its own when it hands over or finds a hot lead | ## Conversation statuses [#conversation-statuses] | Status | What it means | Who replies? | | ------------------------------------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- | | **AI agent** | The AI is handling the customer | The AI agent | | **Needs you** | The AI handed the chat to your team, or the customer is qualified and waiting for a consultant | Someone on your team ([details](/en/conversations/handoff)) | | **With team** (or "With" a teammate's name) | A teammate took over | That teammate; the AI is paused | | **Closed** | Done | Nobody. If the customer writes again, it reopens with the AI in charge | At the top of an open conversation you'll also see **AI is replying** or **AI is paused**, so you always know who has the conversation right now. ## Filters and search [#filters-and-search] Tabs above the list, each with a count: * **All** * **Needs you**: start your day here. * **With AI** * **With team** * **Assigned to me**: open conversations assigned to you. * **Closed** Below them: * **Search**: by customer name, phone or any word in the last message. * **Channel**: **All channels** or a single one, for example WhatsApp only. Make one person responsible for checking **Needs you** throughout the day. The red number next to **Conversations** in the sidebar counts exactly those chats. ## Inside a conversation [#inside-a-conversation] * **Customer messages** sit on one side; AI and team replies on the other. * **AI replies** have their own colour and the label "AI agent". On desktop you also see which tools it used (for example, searching your packages). * **Internal notes** are yellow and invisible to the customer ([notes and assignment](/en/conversations/notes-and-assignment)). * **Grey system lines** record what happened, like "a teammate took over" or "conversation closed". * If a message didn't reach the customer, a red marker appears under it ([the 24-hour window](/en/conversations/messaging-window)). Opening a conversation marks its new messages as read. ## Closing and reopening [#closing-and-reopening] From the ⋮ menu at the top of the conversation: * **Close conversation**: when the topic is done. The AI stops and the chat moves to **Closed**. * **Reopen**: brings it back to your team. If the customer sends a new message to a closed conversation, it reopens on its own and the AI agent answers again. ## On your phone [#on-your-phone] * The list takes the full screen; opening a conversation takes the full screen too, with a back arrow at the top. * The **Details** button at the top opens the customer, lead and summary in a bottom sheet. * To get alerts while Flyby is closed, [install the app](/en/getting-started/install-app) and turn on [notifications](/en/settings/notifications). ## No conversations yet? [#no-conversations-yet] As soon as a customer messages you on a connected channel, it shows up here. Until your channels are connected, try it yourself with **Try the agent as a customer**, shown when no conversation is open. See [Test your agent](/en/ai-agent/test-agent) and [Channels](/en/channels). ## Next [#next] # The 24-hour window URL: https://docs.flyby.world/en/conversations/messaging-window > Why Flyby sometimes won't let you reply to a customer on WhatsApp, Messenger or Instagram, and what the banners above the reply box mean. Meta (the company behind WhatsApp, Messenger and Instagram) has a rule: a business can reply freely **within 24 hours of the customer's last message**. After that, messaging is restricted. Flyby follows this rule so your messages aren't rejected and your number or Page stays in good standing. [Website chat](/en/channels/website-chat) has no window. You can reply there anytime. ## How the window works [#how-the-window-works] The clock starts from the **customer's last message**, not your last reply. Every new message from the customer opens a fresh 24-hour window. | Time since the customer's last message | WhatsApp | Messenger & Instagram | | -------------------------------------- | ---------------------------- | ------------------------------------------------------- | | Under 24 hours | Reply normally (AI and team) | Reply normally (AI and team) | | 24 hours to 7 days | Closed: you can't reply | Only your team can reply, sent with the Human Agent tag | | Over 7 days | Closed | Closed | The AI agent only replies inside the first 24 hours, which is natural: it's always answering a message that just arrived. ## When the reply box is locked [#when-the-reply-box-is-locked] When Flyby can't send, the reply box turns grey and its placeholder tells you why. A **?** inside it opens this page. After 24 hours: > More than 24 hours since their last message. WhatsApp only allows approved template messages now. Flyby **doesn't send template messages yet**, so replying works again as soon as the customer sends a new message. **Between 24 hours and 7 days**, replies go with Meta's **Human Agent** tag. That only works if **your agency's own Meta app** is approved for Human Agent in App Review. A yellow note above the box reminds you. Flyby finds out on the first try and remembers it for the channel: * **Meta accepts:** your team can keep replying for up to 7 days. * **Meta refuses:** you see *"Meta refused: your Meta app isn't approved for Human Agent"* for a few seconds, then a tip to reply from the app on your phone. From then on the box locks after 24 hours on that channel. You can see the result in **Settings → Channels & integrations**, under the channel: **Human Agent: Approved / Not approved / Not checked yet**. Got approved later? Click **Re-check** and the next reply after 24 hours tries again. **After 7 days** the box is locked: > More than 7 days since their last message. Meta doesn't allow replies from Flyby; you can still answer from the app on your phone. ### Waiting for an answer to a comment DM [#waiting-for-an-answer-to-a-comment-dm] When a conversation started from a [comment reply](/en/channels/comment-replies), Meta allows **only that one DM** until the person answers. The box stays locked with *"Waiting for … to answer the DM about their comment"* and unlocks as soon as they write back. ### Replying from the Instagram or Messenger app [#replying-from-the-instagram-or-messenger-app] Meta's 24-hour limit applies to apps like Flyby, **not** to a person replying in the **Instagram app**, the **Messenger app** or **Meta Business Suite**. When the box is locked, you can still answer from your phone. Those replies show up in the Flyby conversation too, marked **"Sent from the Instagram app"** (or Messenger), and the AI agent stops replying in that conversation, the same as when you reply from Flyby. Even when the box is locked for replies you can switch to **Internal note**, because notes are never sent to the customer. ## When a message isn't delivered [#when-a-message-isnt-delivered] If you try to send and Meta refuses, the message is **not saved** in the conversation, your text goes back into the reply box so you don't lose it, and a message tells you why: | Message | What it means | What to do | | --------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | | Not sent: the 24-hour window is closed | The allowed time has passed | Wait for the customer to write, or reply from the app on your phone | | Meta refused: your Meta app isn't approved for Human Agent | Replies after 24 hours need Human Agent approval | Reply from the Instagram / Messenger app on your phone, or get Human Agent approved and click **Re-check** | | Not sent: this channel is disconnected. Check Settings | The channel is turned off or not connected properly | Check it in [Settings → Channels & integrations](/en/channels) | | Not sent: no platform ID for this customer | Flyby can't find the customer's account on that platform | Reach the customer on another channel | | Meta test number: add this customer's number to the allowed list in your Meta app | WhatsApp is connected with Meta's test number, which only replies to listed numbers | Add the number in **WhatsApp → API Setup → To**, or connect your real number ([WhatsApp](/en/channels/whatsapp)) | | Meta couldn't deliver this message | Meta refused for another reason | Try again shortly; if it keeps happening, check the channel settings | Under any message that didn't go through (for example an AI reply Meta refused) you'll see **Not delivered** or **Not sent: the 24-hour window is closed** in red. ## The customer didn't come back? [#the-customer-didnt-come-back] * **Reach them outside Flyby.** From the [lead page](/en/leads/lead-details) or [contact profile](/en/leads/contacts), tap their number to call, or the WhatsApp button to open a chat from your phone. * **Log what happened.** After the call, use **Log call** in the lead's activity, and add a [follow-up task](/en/leads/tasks) if you need to get back to them. * **Close the conversation** if it's done. If the customer writes again it reopens on its own. Replying yourself from the Instagram or Messenger app is fine. Don't try to get around the rule any other way (other tools, bulk messages): Meta can restrict or disable accounts with repeated rejected messages. Read the [Meta messaging policy](https://flyby.world/en/meta-policy). ## Next [#next] # Notes & assignment URL: https://docs.flyby.world/en/conversations/notes-and-assignment > Leave internal notes for your team, assign a conversation to a teammate, and use the AI summary and lead panel without leaving the chat. Every conversation has tools that let your team work together without the customer noticing: internal notes, assignment, priority, and a ready-made summary from the AI agent. ## Internal notes [#internal-notes] An internal note is a message inside the conversation **for your team only**. The customer never sees it, and the AI agent doesn't read it either. ### Switch to "Internal note" [#switch-to-internal-note] Above the text box there are two buttons: **Reply** and **Internal note**. Pick the second one and the box turns yellow. ### Type and send [#type-and-send] The note appears in the thread in yellow, with a note icon and your name. ### Switch back to "Reply" before writing to the customer [#switch-back-to-reply-before-writing-to-the-customer] The box stays on your last choice, so make sure you're on **Reply** before you write to the customer. Good uses: * "Called him, he wants to move the trip to early next month." * "Ahmed approved this discounted price, don't go lower." * "This customer booked Umrah with us last year." A note doesn't pause the AI or change the conversation status. Only sending a **Reply** or clicking **Take over** does that. ## Assigning to a teammate [#assigning-to-a-teammate] In the **Details** panel (next to the chat on large screens, or from the Details button on phones) you'll find **Assign to**: 1. Open the menu and pick a teammate. 2. To clear it, pick **Unassigned**. Good to know: * Clicking **Take over** or sending a reply assigns the conversation to **you** automatically. * Everyone finds their open assigned chats in the **Assigned to me** tab. * In the list, an assigned conversation with your team shows "With" and the teammate's name (or "With You"). * Assigning doesn't notify the teammate, so tell them or leave an internal note. Their names may appear in the assignment list, but a Lead moderator can't open the Conversations page. Assign conversations to owners or managers, and assign the **lead** itself to a moderator from the [lead page](/en/leads/lead-details). ## Priority [#priority] Next to assignment is **Priority**: Low, Normal, High, Urgent. High and Urgent show a red label in the list. The AI sets **High** on its own when it hands over, or when it qualifies a hot lead. You can change it anytime. ## AI summary [#ai-summary] The Details panel has an **AI summary** box: a few lines on what the customer wants and where things stand. The AI writes it when it qualifies the customer or hands over; for a handoff you'll also see the **Handoff reason** under it. Want a fresh summary after a long exchange? Click **Summarize** in the box (or from the ⋮ menu). Very handy when you pick up a long conversation or pass it to a teammate. ## The lead panel [#the-lead-panel] The same Details panel gives you everything without leaving the chat: **Customer details**: name and channel, phone (tap to call), email, nationality and city, and tags. **Open contact** takes you to the [full profile](/en/leads/contacts). **Lead**: the pipeline stage plus what the AI collected: trip type, destination, when, travellers, budget and score. Click **Open lead** to keep working on it in the [lead page](/en/leads/lead-details). If it says "No lead created yet", the AI hasn't started collecting trip details. If you think the customer is serious, click **Create lead**: a lead is created in the **Qualifying** stage, linked to this conversation, and opens right away. (Owners and managers only.) ## Next [#next] # Bookings URL: https://docs.flyby.world/en/finance/bookings > Create a booking or convert a lead, add items with price and cost, and Flyby works out the total, balance and profit. A booking is the heart of Finance: it holds the customer, the trip and what they'll pay, and every payment and expense links back to it. You enter the items and payments; the totals take care of themselves. Bookings are available to owners and managers on the **Growth** and **Pro** plans. ## Two ways to create a booking [#two-ways-to-create-a-booking] 1. Go to **Finance → Bookings**. 2. Click **New booking**. 3. A new booking opens with the status **Pending** and an automatic booking ref. Fill in the details. Open Bookings When a lead says yes, open it from **Leads** and click **Convert to booking**. Flyby creates a new booking with: * The customer and the travel and return dates. * The number of travellers (adults + children + infants). * The packages the customer was interested in as line items, at each package's starting price. The lead is marked as **won** and the booking opens straight away. The booking shows a **From lead** link back to the lead. The **Unit cost** of package items comes automatically from the package's adult price (the cheapest adult price, the one the "From" price comes from). Enter costs on your [packages](/en/catalog/packages) so your profit is accurate; if no cost was entered there, the item is added with a cost of zero. ## Booking details [#booking-details] | Field | Notes | | ----------------------------------- | --------------------------------------------------------------------------- | | **Booking title** | Required. For example "Ramadan Umrah – Ahmed family" | | **Customer** | Search your contacts by name or phone | | **Package** | Optional, the booking's main package | | **Travel date** and **Return date** | Shown on the invoice | | **Travellers** | Used as the default quantity when you add a package or a per-person service | | **Currency** | Defaults to your agency's base currency | | **Discount** | An amount taken off the items subtotal | | **Payment due date** | Used for overdue tracking and receivables aging | | **Notes** | Shown on the invoice | Click **Save** after editing. ## Booking items [#booking-items] Items are what the customer pays and what it costs you. Click **Add item** and choose: * **From packages**: uses the package name and starting price, with quantity = travellers. * **From services**: uses the service's price and cost, with quantity = travellers if the service is priced per person. * **Blank item**: a free item you type yourself. Each item has a **Type** (Package, Service, Flight, Hotel, Visa, Insurance, Transfer, Other), **Description**, **Qty**, **Unit price** and **Unit cost**. You can edit any of them or delete the item. The **Summary** card updates with every change: items subtotal, discount, total, cost, gross profit, paid, refunded and **Balance due**. If the customer paid too much you'll see **Overpaid (to refund)**; when everything's paid you'll see **Fully settled**. ## Booking status and payment status [#booking-status-and-payment-status] You set the **booking status** from the menu at the top of the booking: | Status | When to use it | | ------------- | ------------------------------------------------------------------- | | **Pending** | The booking is still being prepared (default) | | **Confirmed** | The customer confirmed and it's booked | | **Completed** | The trip is done | | **Cancelled** | The booking was cancelled; it's excluded from sales and receivables | | **Refunded** | The money was returned to the customer | The **payment status** is worked out from the payments: **Unpaid**, **Partially paid**, **Paid** or **Overpaid**. ## The bookings list [#the-bookings-list] In **Finance → Bookings** you can: * Filter by status using the tabs at the top. * Search by ref, title or customer. * Filter by **Created date** and payment status. * Download the list with **Export CSV** to open it in Excel. Export is a **Pro** feature; on Growth the button shows a lock, **Export CSV (Pro)**, and takes you to **Settings → Plan & billing**. ## Deleting a booking [#deleting-a-booking] On the booking page, click **Delete**. The booking, its items and payments are deleted. Supplier expenses stay, but are unlinked from the booking. It's usually better to set the status to **Cancelled** instead of deleting, so you keep a full record. ## Next [#next] # Expenses URL: https://docs.flyby.world/en/finance/expenses > Record what you paid suppliers for each booking and your general company costs, so you see your real net profit. Without expenses, the numbers only show your sales. Once you record supplier payments and company costs, Flyby can work out your real **Net profit**. Expenses are available to owners and managers on the **Growth** and **Pro** plans. ## Two kinds of expenses [#two-kinds-of-expenses] | Kind | Examples | What it affects | | ---------------------- | ----------------------------------- | ---------------------------------------------------- | | **Supplier payments** | Airline, hotel, ground services | Recorded on the booking and compared with item costs | | **Operating expenses** | Rent, salaries, marketing, software | Deducted from net profit | ## Record a supplier payment on a booking [#record-a-supplier-payment-on-a-booking] ### Open the booking [#open-the-booking] From **Finance → Bookings**. ### Click "Supplier payment" [#click-supplier-payment] In the **Supplier costs** card. ### Fill it in [#fill-it-in] Choose the **Category** (Airline supplier, Hotel supplier, Ground services, Visa fees, Commissions, Other), enter the **Vendor / payee** (e.g. EgyptAir), the **Amount**, **Payment method** and **Date**. ### Save [#save] The expense is recorded in the booking's currency and shows on the booking and on the Expenses page. The **Supplier costs** card shows **Expected cost from items** next to **Paid to suppliers**, so you know how much you still owe suppliers. ## Record a general expense [#record-a-general-expense] 1. Go to **Finance → Expenses**. 2. Click **Add expense**. 3. Choose the **Category** and enter the **Vendor / payee**, **Details**, **Amount**, **Payment method**, **Date** and a **Reference** if you have one. 4. Leave **Booking** as **General expense**, or pick a booking if the cost belongs to it. Open Expenses ### Categories [#categories] Airline supplier · Hotel supplier · Ground services · Visa fees · Marketing & ads · Salaries · Rent · Utilities · Software & subscriptions · Commissions · Other **Airline supplier**, **Hotel supplier** and **Ground services** count as supplier payments. Every other category counts as an operating expense on the Overview. ## The Expenses page [#the-expenses-page] * **Total expenses**, **Supplier payments** and **Operating expenses** for the period. * **By category**: tap a category to filter by it. * Search by vendor or details. * **Export CSV** to download the list (**Pro** only; on Growth the button shows a lock, **Export CSV (Pro)**, and links to **Settings → Plan & billing**). * Edit or delete any expense. Record expenses as they happen, even small ones. Your net profit on the Overview will be much closer to reality. ## Next [#next] # Finance URL: https://docs.flyby.world/en/finance > Track bookings, collections, expenses and profit in one place, linked to your leads and packages. **Finance** turns your sales work into clear numbers: every booking with its money, every payment in or refunded, every expense out, and what you actually earned at the end. Finance is included in the **Growth** and **Pro** plans (and in the free trial). On **Starter** you'll see a screen that explains the module with an **Upgrade to Growth** button. Exporting bookings and expenses to CSV is **Pro** only. See [Plans](/en/billing). **Who can use it?** Owners and managers only. Lead moderators don't have access to Finance. See [Roles & permissions](/en/team). Open Finance ## Finance sections [#finance-sections] | Section | What's in it | | ------------ | --------------------------------------------------------------------------------------- | | **Overview** | Key figures and charts for the period you pick | | **Bookings** | Every booking with what's due, paid and outstanding. [Learn more](/en/finance/bookings) | | **Payments** | All money received from or refunded to customers. [Learn more](/en/finance/payments) | | **Expenses** | Company expenses and supplier payments. [Learn more](/en/finance/expenses) | ## The Overview page [#the-overview-page] At the top you'll find the **Period**: **This month**, **Last month**, **Last 3 months**, **This year** or **Custom range**. Every figure is calculated for the period you choose. ### Key figures [#key-figures] | Figure | What it means | | ------------------------------------------ | ------------------------------------------------------------------------------------- | | **Sales** | Total value of bookings created in the period, excluding cancelled ones | | **Collected** | Money actually received in the period, after refunds | | **Outstanding receivables** | What customers still owe on all open bookings (all time, not just this period) | | **Supplier costs** | Expected cost from booking items, with what you've actually paid suppliers underneath | | **Gross profit** | Sales minus item costs, with your margin | | **Operating expenses** | All expenses except direct supplier payments (airlines, hotels, ground services) | | **Net profit** | Collected minus all expenses | | **Average booking value** and **Bookings** | Excluding cancelled bookings | ### Charts and reports [#charts-and-reports] * **Monthly performance**: sales, collections, expenses and net for the last 12 months. * **Collections by payment method** and **Expenses by category**. * **Top packages by revenue**: based on package line items. * **Bookings by status**. * **Receivables aging**: customer balances grouped by how overdue they are (not due yet, 0–30, 31–60, 61–90, 90+ days). * **Top overdue bookings**: bookings past their **Payment due date** with money still owed. Figures are shown in your agency's **Base currency** (set in [Agency profile](/en/settings/agency-profile)). Bookings or payments in another currency appear separately in an **Other currencies** card and aren't added to the totals. ## How to get started [#how-to-get-started] ### Record a booking [#record-a-booking] Create a new booking, or convert a lead into one with a single click. [Bookings](/en/finance/bookings) ### Record payments [#record-payments] Each time the customer pays, log it on the booking and the balance updates itself. [Payments](/en/finance/payments) ### Record expenses [#record-expenses] Supplier payments per booking, plus your general company costs. [Expenses](/en/finance/expenses) ### Print the invoice [#print-the-invoice] A ready invoice with your agency's name and logo. [Invoices](/en/finance/invoices) ## Next [#next] # Invoices URL: https://docs.flyby.world/en/finance/invoices > Print an invoice for any booking with your agency's name and logo, or save it as a PDF and send it to the customer. Every booking has a ready invoice built from its details. There's nothing to type: any change to the booking or its payments shows on the invoice straight away. Invoices are available to owners and managers on the **Growth** and **Pro** plans. ## Print an invoice [#print-an-invoice] ### Open the booking [#open-the-booking] From **Finance → Bookings**. ### Click "Print invoice" [#click-print-invoice] The invoice page opens in A4 size. ### Click "Print" [#click-print] Only the invoice is printed, without the app's menus. ## Sending it to the customer [#sending-it-to-the-customer] There's no public link for invoices. To send one: 1. Click **Print**. 2. In the print dialog, choose **Save as PDF** instead of a printer. 3. Send the PDF to the customer on WhatsApp or by email. The invoice uses the language you're viewing the app in. If your customer needs it in English, switch the interface to English and print it; it will use your agency's **English name** if you've set one. ## What's on the invoice [#whats-on-the-invoice] | Part | Contents | | ---------------------- | ----------------------------------------------------------------------------------------------- | | **Agency details** | Logo, name, address, city, phone, email and website | | **Invoice no.** | Same as the booking ref, with the date and a **Due date** if you set a payment due date | | **Bill to** | The customer's name, phone and email | | **Trip** | Booking title, travel date and number of travellers | | **Items** | Description, qty, unit price and amount | | **Totals** | Subtotal, discount, total, paid, and balance due (or **Paid in full**) | | **Payments received** | Each payment with its date, method and reference | | **Notes** | The booking's notes | | **Terms & conditions** | Standard text about availability, cancellation policies and paying the balance before departure | The invoice shows selling prices only. Item costs and profit are never shown to the customer. ## Make your invoice complete [#make-your-invoice-complete] * Upload your logo in **Settings → Logo**. * Fill in your address, phone, email and website in [Agency profile](/en/settings/agency-profile). * Pick the customer on the booking so their details appear under **Bill to**. ## Next [#next] # Payments URL: https://docs.flyby.world/en/finance/payments > Record money received from or refunded to customers, and each booking's balance updates itself. Every time a customer pays an instalment or gets money back, record it here. A payment linked to a booking updates that booking's paid amount, balance and payment status automatically. Payments are available to owners and managers on the **Growth** and **Pro** plans. ## Record a payment [#record-a-payment] You can record a payment from two places: * **From the booking page**: in the **Customer payments** card, click **Record payment**. It's linked to that booking automatically. * **From Finance → Payments**: click **Record payment** and pick the booking in the **Booking** field (or leave it as **No booking**). ### Choose the type [#choose-the-type] **Payment** if you received money from the customer, or **Refund** if you gave money back. ### Enter the amount [#enter-the-amount] It must be greater than zero. If the payment is linked to a booking, it's recorded in the booking's currency. ### Pick the payment method and date [#pick-the-payment-method-and-date] Optionally add a **Reference** (transfer or receipt number) and **Notes**. ### Save [#save] Click **Save payment** (or **Save refund**). ## Payment methods [#payment-methods] Cash · Bank transfer · Card · InstaPay · Vodafone Cash · Fawry · Cheque · Other Payments here are a **record** of money you received your own way. Flyby never collects payments from your customers or takes a cut. ## How the balance is worked out [#how-the-balance-is-worked-out] **Balance due** = booking total − (paid − refunded). * Above zero: the booking is **Partially paid** or **Unpaid**. * Zero: **Paid** and **Fully settled**. * If the customer paid more than the total: **Overpaid (to refund)**. Record a **Refund** for the difference to settle it. ## The Payments page [#the-payments-page] **Finance → Payments** lists every transaction in the period you choose, with: * **Total received**, **Total refunds** and **Net collected**. * A breakdown **By payment method**. You can filter by method or type (payments / refunds) and search by reference, booking or customer. Open Payments ## Fixing a wrong payment [#fixing-a-wrong-payment] Payments can't be edited. If you recorded something wrong, delete it and record it again. The linked booking's balance is recalculated automatically. ## Next [#next] # Dashboard tour URL: https://docs.flyby.world/en/getting-started/dashboard-tour > The sidebar, the Overview page, notifications, switching language, and the mobile layout. The dashboard is built so you can see in a second who needs you today. This page shows you where everything lives. ## The sidebar [#the-sidebar] The sidebar is split into groups, and each person only sees the sections their role allows. | Group | Sections | Who sees it | | ---------- | ----------------------------------------------------- | --------------------------------------------------------------------- | | Start | **Overview**, **AI agent** | Everyone sees Overview. AI agent is for owners and managers | | Daily work | **Conversations**, **Leads**, **Contacts**, **Tasks** | Lead moderators don't see Conversations, and only see qualified leads | | Catalog | **Packages**, **Services**, **FAQs**, **Public page** | Owners and managers | | Manage | **Finance**, **Team** | Owners and managers (Finance on Growth and Pro) | At the bottom you'll find: * The **notifications bell** (Notifications). * **Settings**: open to everyone, but lead moderators only see their own device settings (notifications and app install). * The **profile card**: click it for **My account**, the language switch, and **Log out**. Next to it is the button that collapses or expands the sidebar on desktop. Next to **Conversations**: chats waiting for your team. Next to **Leads**: leads still in the **Qualified** stage that haven't moved on to a proposal. Next to **Tasks**: tasks that are due or overdue. ## Overview [#overview] The first page you see. At the top there's a greeting and quick actions: **Open inbox**, **Qualified leads**, **New package**, **Test agent**. Pick the **Period**: Today, Last 7 days or Last 30 days. **The top cards** (owners and managers): * **New conversations**, with the share handled fully by AI. * **Need a human** right now. * **Qualified leads** in the period. * **Won deals** and **Collected**. * **Active packages**. **Below them**: the conversations chart (AI agent vs. your team), channels, **Lead funnel**, **Leads by trip type**, and lists: **Needs your attention**, **Hot leads**, **Tasks due today & overdue**, and **Upcoming departures**. They see **My qualified leads**, **Hot leads** and **Tasks due**, without conversation or money figures. ## The banner at the top [#the-banner-at-the-top] Owners and managers see a banner across the top of the dashboard when: * The free trial has 3 days or fewer left, or has ended. * You've used 80% of your AI conversations, or all of them. The banner links straight to **Settings → Plan & billing**. [How conversations are counted](/en/billing/ai-conversations) ## Notifications [#notifications] Click the **bell** to see recent alerts: a lead was qualified, a chat needs a human, the agent couldn't reply, or plan alerts. Click any notification to open the conversation or lead, or click **Mark all read**. To get notifications even when Flyby is closed, turn them on in **Settings → Notifications** on every device you use. [Set up notifications](/en/settings/notifications) ## Switching language [#switching-language] Click the profile card at the bottom of the sidebar and choose **العربية**. You stay on the same page, now in Arabic. To switch back, choose **English**. The dashboard language is only for you and your team. The agent talks to customers in the dialect you set in [Persona](/en/ai-agent/persona). ## On your phone [#on-your-phone] * Top: a bar with the page title, a back arrow on detail pages, and the bell. * Bottom: a tab bar with up to 4 sections depending on your role. Owners and managers: **Home**, **Chats**, **Leads**, **Packages**. Lead moderators: **Home**, **Leads**, **Contacts**, **Tasks**. * **More** opens the full sidebar. Tables turn into cards on small screens. For the best experience, [install Flyby as an app](/en/getting-started/install-app). ## Next [#next] # Your first hour with Flyby URL: https://docs.flyby.world/en/getting-started > Six steps that get your AI agent answering real customers today. This is a practical plan for your first hour on Flyby. Go through it in order, and by the end you'll have an AI agent that knows your packages, has been tested, and is answering customers. ### Create your account and set up your agency (10 min) [#create-your-account-and-set-up-your-agency-10-min] Sign up with email or **Continue with Google**, then go through the 4 setup steps: agency details, your agent's name and tone, your plan (the 14-day free trial starts right away), and inviting your team. [Create your account](/en/getting-started/sign-up) · [Setup steps](/en/getting-started/onboarding) ### Add your packages and services (20 min) [#add-your-packages-and-services-20-min] The agent **only recommends what you've added**. Start with your 3–5 most important current packages, with prices and departure dates, plus the services you sell on their own (visas, flights, hotels…). Keep the package status **Active** so the agent can see it. [Packages](/en/catalog/packages) · [Services](/en/catalog/services) ### Write your FAQs (10 min) [#write-your-faqs-10-min] Payment methods, cancellation policy, required documents, installments… The agent answers these straight from your text. [How to write good FAQs](/en/ai-agent/knowledge-base) ### Fine-tune the AI agent (10 min) [#fine-tune-the-ai-agent-10-min] Open **AI agent** in the sidebar: check its name, dialect and greeting, pick the **Qualification fields** you need, and write your own instructions and when it should hand off to a human. [Persona](/en/ai-agent/persona) · [Instructions](/en/ai-agent/instructions) · [Qualification](/en/ai-agent/qualification) ### Test the agent as a customer (5 min) [#test-the-agent-as-a-customer-5-min] Click **Test as a customer** and ask what your customers ask: prices, dates, discounts, "can I talk to someone". Make sure the replies are right before you open it to the public. [How to test the agent](/en/ai-agent/test-agent) ### Open your channels and turn on notifications (5 min and up) [#open-your-channels-and-turn-on-notifications-5-min-and-up] * Your **public chat link** works right away: put it in your bio and on your pages. * **WhatsApp** needs to be connected to your agency's Meta account ([steps](/en/channels/whatsapp)). * Turn on **notifications** on your phone and computer so your first qualified lead reaches you instantly. On iPhone, [install the app](/en/getting-started/install-app) first. [Channels](/en/channels) · [Notifications](/en/settings/notifications) Your first 14 days are free, with 50 AI conversations and Growth features. No card needed. [Trial details](/en/billing/trial) If you have no active packages, the agent tells customers a consultant will prepare an offer and only qualifies them. Add your packages before you share your link. ## What's next [#whats-next] # Install Flyby as an app URL: https://docs.flyby.world/en/getting-started/install-app > A home screen icon, its own window and notifications on iPhone, with nothing to download from an app store. You can install Flyby on your phone or computer like a regular app: an icon on your screen, its own window, and it opens faster. No App Store or Google Play needed. iPhone only lets websites send notifications once they're installed on the home screen. So if you want an alert when a lead is qualified or a chat needs you, you **must** install Flyby first. The same steps are inside the app under **Settings → Install the app**. If your browser supports direct install, you'll see an **Install** button there. Open Install the app ## How to install [#how-to-install] 1. Open [flyby.world](https://flyby.world) in **Safari** and log in. 2. Tap the **Share** button (the square with an arrow). 3. Scroll down and tap **Add to Home Screen**, then **Add**. 4. Open Flyby from the new icon and log in if asked. 5. Go to **Settings → Notifications**, turn on **Browser notifications**, and allow them when your iPhone asks. Notifications on iPhone need iOS 16.4 or later. 1. Open [flyby.world](https://flyby.world) in **Chrome** and log in. 2. Open the **⋮** menu at the top. 3. Tap **Install app** (or "Add to Home screen" on some phones). 4. Turn on notifications in **Settings → Notifications**. On Android, notifications work from the browser even without installing, but the app is easier and faster. 1. Open Flyby in **Chrome**, **Edge** or **Brave**. 2. Look for the install icon at the end of the address bar. 3. Click it and choose **Install**. 4. Flyby opens in its own window, and you can pin it to the taskbar or dock. Firefox and Safari on desktop don't support installing yet, but notifications still work in them. Turning on notifications on your phone doesn't turn them on for your computer. Set them up on every device you work from. [Set up notifications](/en/settings/notifications) ## Once it's installed [#once-its-installed] * **Settings → Install the app** shows "Installed on this device". * The dashboard opens full screen without the browser bar, and the bottom tab bar feels like any other app. * To uninstall, remove the icon like any other app. ## Next [#next] # Set up your agency (4 steps) URL: https://docs.flyby.world/en/getting-started/onboarding > Agency details, your AI agent, your plan and free trial, and inviting your team. After you sign up, there are 4 short steps before you reach the dashboard. Everything you choose here can be changed later in Settings or on the **AI agent** page. The owner can't open the dashboard until step 4 is done. If you close the page halfway, you'll come back to the same step next time you log in. ### 1. Create your agency [#1-create-your-agency] * **Agency name**: the name your customers know you by, e.g. "Nile Tours". * **Agency WhatsApp number** (required): the number your customers message. Include the country code, e.g. +20 10 0000 0000. * **Country**: Egypt, Saudi Arabia, UAE, Kuwait, Qatar, Bahrain, Oman or Jordan. Your pricing currency is set from it automatically (EGP for Egypt, SAR for Saudi Arabia, AED for the UAE…). * **AI agent dialect**: Egyptian, Gulf, Levantine, Modern Standard, or **Match the customer** if your customers come from different countries. Click **Create agency**. ### 2. Meet your AI agent [#2-meet-your-ai-agent] * **Agent name**: the name customers see in the chat, e.g. "Sara" or "Nile Assistant". At least 2 letters. * **Tone**: **Friendly**, **Professional** or **Luxury**. The "How it greets a customer" preview below updates as you pick. Click **Continue**. You'll fine-tune the rest (greeting, instructions, qualification fields) later on the [AI agent page](/en/ai-agent/persona). ### 3. Pick your plan [#3-pick-your-plan] * Choose **Monthly** or **Annual** (annual gives you **2 months free**). * Choose a plan: **Starter**, **Growth** (most popular) or **Pro**. Each card shows its AI conversations, seats and channels. * Click **Start 14-day free trial**. Your trial starts right away: 14 days and 50 AI conversations with Growth features, **no card needed**. The plan you picked is saved as a request, and our team will contact you to activate it before the trial ends. [Compare plans](/en/billing) · [Trial details](/en/billing/trial) ### 4. Invite your team (optional) [#4-invite-your-team-optional] Enter each colleague's **Email** and pick a **Role**: * **Manager**: can do everything except remove or demote the owner. * **Lead moderator**: only sees qualified leads and contacts. Click **Add another** for more people, then **Send invites & finish**. Or click **Skip for now** and invite them later from **Team**. After **Send invites & finish**, you'll see **Send your teammates their invite links**: one link per teammate, each with **Copy link** and **Send on WhatsApp** buttons. Send them, then click **Go to dashboard**. Flyby doesn't email invites, so send the links to your teammates straight from that screen. If you miss someone, the links are also in **Team** → **Pending invites**. They must sign in with the same email to accept, and each link is valid for 14 days. [More on invites](/en/team/invites) The free trial has 5 seats (including you); after that each plan has its own: Starter 2, Growth 5, Pro 15. Pending invites count toward them. If you hit the limit you'll see "You've reached the seats on your trial." ## After setup [#after-setup] When you finish step 4 (or click **Go to dashboard**) you land on **Overview**. Next: # Sign up and log in URL: https://docs.flyby.world/en/getting-started/sign-up > Create your account with email or Google, confirm your email, and reset your password if you forget it. Creating an account takes a minute. Sign up with an email and password, or in one click with your Google account. ## Sign up [#sign-up] 1. Open [flyby.world/en/signup](https://flyby.world/en/signup). 2. Click **Continue with Google** and pick your account. 3. You go straight to the agency setup steps. No email confirmation needed, Google has already verified it. On a computer, Google may also pop up a suggestion with the account that's signed in to your browser. Just click it. 1. Open [flyby.world/en/signup](https://flyby.world/en/signup). 2. Enter your **Full name**, **Email** and **Password** (at least 8 characters). 3. Click **Create account**. You'll see "We sent a confirmation link to your email". 4. Open the email and click the confirmation link. It opens on flyby.world and takes you to the agency setup steps. Check your spam or promotions folder. If you try to log in before confirming, you'll see "Please confirm your email first". If the link is old or was already used, just log in, or request a new one from "Forgot password?". ## One account = one agency [#one-account--one-agency] Each account belongs to exactly one agency. Whoever creates the account and sets up the agency becomes its **Owner**. Your colleagues don't create agencies of their own: you invite them, and they join yours with the role you choose. Open the link, log in or sign up **with the same email the invite was sent to**, then click **Accept invite**. You skip the setup steps and land on the dashboard. [More on invites](/en/team/invites) ## Log in [#log-in] Open [flyby.world/en/login](https://flyby.world/en/login) and choose **Continue with Google**, or enter your email and password and click **Log in**. If you signed up with Google, log in with Google too. ## Forgot your password [#forgot-your-password] ### Request a link [#request-a-link] On the login page click **Forgot password?**, enter your email and click **Send link**. ### Open the email [#open-the-email] If the email is registered, a link arrives within a few minutes. It opens on flyby.world. ### Pick a new password [#pick-a-new-password] Enter a **New password** (at least 8 characters) and click **Update password**. You'll land on your dashboard. You can also change your password while logged in from **My account** (in the profile menu at the bottom of the sidebar) → **Change password**. ## Next [#next] # FAQ URL: https://docs.flyby.world/en/help/faq > Quick answers on pricing, the free trial, Meta fees, dialects, privacy, cancelling and AI mistakes. The questions travel agencies ask most, before and after they start with Flyby. Can't find yours? Email [support@flyby.world](mailto:support@flyby.world). ## Pricing and billing [#pricing-and-billing] | Plan | Egypt (monthly) | Other countries (monthly) | AI conversations | Seats | | ----------- | --------------- | ------------------------- | ---------------- | ----- | | **Starter** | 1,990 EGP | $69 | 150 | 2 | | **Growth** | 4,490 EGP | $169 | 500 | 5 | | **Pro** | 7,990 EGP | $299 | 1,200 | 15 | Annual billing = **2 months free**. Agencies in Egypt pay in EGP; everywhere else pays in USD. [Full plan comparison](/en/billing) 14 days with 50 AI conversations and all Growth features (every channel plus Finance), **no card needed**. It starts as soon as you finish the plan step during setup. [Trial details](/en/billing/trial) The AI agent stops replying, and new conversations go to your team under **Needs you**. All your data (packages, leads, conversations) stays exactly as it is. As soon as your plan is activated, the agent starts replying again. There's no online payment yet. You choose a plan or add-on in **Settings → Plan & billing**, the request goes to our team, and we contact you to confirm payment and activate it (usually within one business day). [Plans](/en/billing) One customer thread the AI replies in, counted once per 24 hours no matter how many messages. The counter resets on the 1st of each month (Cairo time), and unused conversations don't roll over. You get a warning at 80%; at 100% the agent pauses and new chats go to your team. [Details](/en/billing/ai-conversations) Request **+100 AI conversations** for this month in **Settings → Plan & billing** (Starter 900 EGP / $19, Growth 750 / $15, Pro 600 / $12), or upgrade your plan. Add-ons are available once you're on a paid plan, so if you're still on the trial, choose a plan first. [Add-ons](/en/billing/add-ons) There can be. Any WhatsApp message fees are paid to Meta directly, on your agency's account, not to Flyby. Replies within 24 hours of the customer's last message are usually free on Meta's side. Check Meta's current pricing for your country. Yes. The **Meta setup** service is a one-time 1,500 EGP / $49 on Starter and Growth, and included in Pro. Request it in **Settings → Plan & billing**. [Add-ons](/en/billing/add-ons) Yes. In **Settings → Plan & billing**, click **Change plan**, or add an extra seat for 250 EGP / $9 per month. The request goes to our team and is activated once payment is confirmed. Email [support@flyby.world](mailto:support@flyby.world) before your renewal date and we won't renew. To delete your agency and all its data permanently, the owner can do it from **Settings → Danger zone → Delete agency** (this can't be undone). See our [refund policy](https://flyby.world/en/refund). ## The AI agent [#the-ai-agent] Egyptian, Gulf, Levantine and Modern Standard Arabic, and it understands Franco-Arabic. With **Match the customer**, it mirrors each customer's dialect, and replies in English if they write in English. [Persona](/en/ai-agent/persona) The agent doesn't make things up: every price and date comes from your catalog, and if something is missing it says a consultant will confirm. So most mistakes come from outdated or missing information in your packages or FAQs. If you spot a wrong reply: 1. Click **Take over** in the conversation and correct it with the customer yourself. 2. Fix the information in the package or FAQ, or add a line to your instructions. 3. [Test the agent](/en/ai-agent/test-agent) again. We recommend reviewing conversations regularly, especially in your first few weeks. No. The agent sells, qualifies and hands the lead to your team. Confirming bookings and payments always stays with your team, and you can record them in [Finance](/en/finance) (Growth and Pro). No. The agent only sees that the customer sent a "voice message" or "image", not what's in it. If an image has a caption, it reads the caption. Your team can see the message in the conversation and reply. There's no automatic schedule yet. You can switch it on and off by hand with **AI agent replies to customers**. Normally the agent knows your team's [working hours](/en/settings/working-hours), and outside them it tells customers the team will follow up during working hours. No. Meta only allows free-form replies within 24 hours of the customer's last message. After that, WhatsApp requires approved message templates, and Flyby doesn't send templates yet. [The 24-hour window](/en/conversations/messaging-window) ## Account, team and data [#account-team-and-data] Each agency's data is completely separate from every other agency, and inside your agency each person only sees what their role allows. Meta tokens and secrets are stored encrypted and never shown again after saving. Read our [privacy policy](https://flyby.world/en/privacy) and [Meta messaging policy](https://flyby.world/en/meta-policy). No, each account has one agency. If you have branches, keep them all in the same agency; the Pro plan lets you show branches on your [public page](/en/public-page/offers-and-branches). For a separate agency, sign up with a different email. Starter has 2 seats, Growth 5, Pro 15, and you can add more. There are 3 roles: **Owner**, **Manager** (everything except removing the owner) and **Lead moderator** (qualified leads and contacts only). [Roles & permissions](/en/team) Yes, in your browser or as an app you install on your home screen, no app store needed. On iPhone you must install it for notifications to work. [Install the app](/en/getting-started/install-app) # Troubleshooting URL: https://docs.flyby.world/en/help/troubleshooting > Common problems and how to fix them, from an agent that won't reply to missing notifications and Google sign-in. Before you contact us, look for your problem here: most issues have a known cause and take a minute to fix. If you've tried the fixes and it's still happening, email [support@flyby.world](mailto:support@flyby.world) with your agency name and what happened. ## The AI agent [#the-ai-agent] Check in this order: 1. **Is the switch on?** Open **AI agent** and look at **AI agent replies to customers**. It must be **Live**. 2. **Is there a red banner at the top of the dashboard?** If the trial ended or this month's conversations are used up, the agent pauses and chats go to your team. See [Plans & billing](/en/billing). 3. **Is there a message saying the platform paused the agent or suspended the agency?** Contact us at [support@flyby.world](mailto:support@flyby.world). 4. **Is the channel itself working?** If messages don't show up in **Conversations** at all, the problem is the channel connection, not the agent. See "WhatsApp isn't receiving messages" below. The conversation was most likely handed to your team: * The agent handed it off itself (the customer asked for a person, complained, asked something it couldn't answer, or one of your handoff rules applied). You'll find it under **Needs you**. * Or someone on your team took over or replied, so its status is now **With team**. To get the agent replying again, open the conversation and click **Hand back to AI**. [Taking over](/en/conversations/handoff) A temporary technical error happened while replying, so the conversation was handed to your team to keep the customer from waiting. Reply yourself, or click **Hand back to AI** so it answers the next message. If it keeps happening, contact us. * Make sure the package status is **Active** (the agent can't see drafts or stopped packages). * Check the prices for each room type, and add child and infant prices. * Add the destination in both Arabic and English. * Update the departures; past or closed dates aren't offered. [Knowledge base](/en/ai-agent/knowledge-base) Look at **Handoff rate** in **Agent performance**, and open the handed-off conversations. The usual causes: * Recurring questions with no answer in your [FAQs](/en/catalog/faqs). * Handoff rules that are too broad in your [Instructions](/en/ai-agent/instructions). * Packages missing information (child prices, departures). Your public chat link is switched off. Open **Settings → Channels & integrations** and turn on **Public chat link**. [Website chat](/en/channels/website-chat) ## AI conversations and your plan [#ai-conversations-and-your-plan] You've used every AI conversation in your plan this month, so the agent paused and new chats go to your team. Conversations the agent replied in during the last 24 hours keep going as normal. To fix it: * Request **+100 AI conversations** for this month, or upgrade, in **Settings → Plan & billing**. * Or wait for the 1st of the month, when the counter resets (Cairo time). [How conversations are counted](/en/billing/ai-conversations) There's no online payment yet, so requests wait for our team to contact you and confirm payment. You'll see it under "Waiting for activation" in **Settings → Plan & billing**. We usually reach out within one business day; if it's taking longer, email us. The owner must finish all four setup steps before using the dashboard. Continue from where you stopped; you can skip the team step with **Skip for now**. [Set up your agency](/en/getting-started/onboarding) ## Channels [#channels] Open **Settings → Channels & integrations → WhatsApp Business** and check the status: * **Waiting for first message**: the connection is fine but no message has arrived yet. Send a message to the number from another phone. * **Needs attention**, or no messages at all? Check: 1. The channel's switch is on. 2. In your Meta app, under **WhatsApp → Configuration**, the **Callback URL** and **Verify token** match the ones in Flyby, and you're subscribed to **messages**. 3. The app is in **Live** mode, not Development. 4. The token was generated with expiration **Never**, has the required permissions, and hasn't been revoked. 5. The **Phone number ID** and **WhatsApp Business Account ID** are correct. 6. Click **Save & test** after any change. [Connect WhatsApp step by step](/en/channels/whatsapp) · Want us to do it? Request the Meta setup service from [Add-ons](/en/billing/add-ons). If the customer's last message is more than 24 hours old, Meta doesn't allow free-form replies. The customer has to message you again first. [The 24-hour window](/en/conversations/messaging-window) If you're within 24 hours, check the token still works and the channel status isn't **Needs attention**. These two channels are available on **Growth** and **Pro** (and during the free trial). On Starter they're locked with "Available on Growth and above." [Messenger](/en/channels/messenger) · [Instagram](/en/channels/instagram) ## Notifications [#notifications] 1. **Did you turn them on for this device?** Notifications are per device. Open **Settings → Notifications** on your phone and your computer, and turn on **Browser notifications** on each. 2. **iPhone?** Install Flyby to your home screen first, then turn on notifications from inside the installed app. [Install the app](/en/getting-started/install-app) 3. **Seeing a message that notifications are blocked?** You declined them before. Click the lock icon next to the address in your browser, set notifications to "Allow", and try again. 4. **Do Not Disturb or Focus mode** on your phone or computer silences notifications. 5. **Device settings**: make sure your browser (or the Flyby app) is allowed to send notifications in your phone's settings. That's expected. Handoff notifications go to owners and managers only, because lead moderators don't see conversations. Lead moderators are notified as soon as a lead is **qualified**. [Roles & permissions](/en/team) Turn on **Sound alerts** in **Settings → Notifications**. The chime plays while Flyby is open; when it's closed, you get your device's normal notification sound. ## Team and invites [#team-and-invites] Flyby doesn't send invite emails. Open **Team → Pending invites**, click **Copy link** and send it to them on WhatsApp or email. [Invites](/en/team/invites) * **"You've used all the seats on your plan"**: members and pending invites both count. Revoke old invites, add a seat, or upgrade. * **"This person is already on the team"**: they're already in. * **Your role**: only owners and managers can invite. * **Different email**: they must sign in with exactly the email the invite was sent to. * **"Your account already belongs to another agency"**: each account can be in one agency only. They should log out and accept with a different email. * **"This invite is invalid or expired"**: links are valid for 14 days, or it was revoked. Create a new invite. ## Login and account [#login-and-account] If you see "Google sign-in didn't work": 1. Make sure your browser isn't blocking pop-ups for flyby.world, then try again. 2. Try another browser, or a normal (not private) window. 3. If you created your account with email and password, log in with those, or reset your password from **Forgot password?**. Google's automatic suggestion at the top of the page may not appear if you dismissed it before or your browser blocks it. Just use the **Continue with Google** button. * Check your spam and promotions folders. * Wait a few minutes, then request a new link. * Double-check the email address you typed. If a link says it "has expired or was already used", just log in, or request a new one from **Forgot password?**. [Sign up and log in](/en/getting-started/sign-up) The sidebar depends on your role. Lead moderators don't see Conversations, the catalog, Finance or the AI agent. And **Finance** needs the Growth or Pro plan. [Roles & permissions](/en/team) # Welcome to Flyby URL: https://docs.flyby.world/en > An AI travel agent that answers your customers, offers your packages and hands your team ready-to-book leads. Flyby is an AI sales agent for your travel agency that works around the clock. It answers customers on WhatsApp, Messenger, Instagram and your website chat **in their own dialect**, recommends your packages at their real prices, collects the trip details, and hands your team a ready-to-book lead with a full summary. ## How it works, in one picture [#how-it-works-in-one-picture] **Customer messages → AI agent replies and asks → lead is qualified → your team takes over → booking** ### A customer sends a message [#a-customer-sends-a-message] On WhatsApp, Messenger, Instagram or your public chat link. Every message lands in **Conversations**. ### The AI agent replies instantly [#the-ai-agent-replies-instantly] It answers in the customer's dialect (Egyptian, Gulf, Levantine, Modern Standard Arabic or English) and only recommends the packages and services you've added. It never makes up prices or dates. ### It qualifies the lead [#it-qualifies-the-lead] While chatting, it collects the details you chose: trip type, destination, dates, travellers, budget, name, phone… and scores the lead **Hot**, **Warm** or **Cold**. ### Your team takes over [#your-team-takes-over] When a lead is qualified, your team gets a notification and the lead shows up in **Leads** with a ready summary. If the customer asks for a person, or something comes up the agent can't handle, the conversation goes straight to your team. ### You close the booking [#you-close-the-booking] Your team follows up: proposal, negotiation, then the booking, payments and invoice in **Finance** (Growth and Pro plans). It sells, qualifies and hands over. Confirming bookings and collecting money always stays with your team. ## Start here [#start-here] New to Flyby? Follow [Your first hour with Flyby](/en/getting-started). A few short steps, and by the end the agent is answering real customers. ## Browse the docs [#browse-the-docs] Email us at [support@flyby.world](mailto:support@flyby.world) and we'll get back to you as soon as we can. # Contacts URL: https://docs.flyby.world/en/leads/contacts > A profile for every customer with their details, tags, and every trip, conversation and booking they've had with you. **Contacts** is your agency's customer book. Every customer who talks to the AI agent on any channel is added automatically, and you can add customers who reached you by phone or walked in. Open Contacts A **contact** is the person: name, number and details. A **lead** is one sales opportunity (one trip). The same person can have several leads: Umrah this year and a honeymoon later. ## The list [#the-list] * **Search**: by name, phone or email. * **Source**: the channel the customer came from (WhatsApp, Website, Manual...). * **Tags**: show only customers with a given tag, like VIP. * **Export CSV**: downloads the contacts currently shown (after filters) as a file you can open in Excel. Each row shows the phone, source, tags, number of leads and **Last contacted**. Click a column header to sort. On phones the list becomes cards. The list shows the first 500 only. If you have more customers, use search or filters to find who you need. ## Adding a contact [#adding-a-contact] 1. Click **New contact**. 2. Enter the name (required), plus phone, email and source if you have them. 3. Save, then fill in the rest from the profile. If the customer is coming for a specific trip, it's quicker to add them from [Leads](/en/leads#adding-a-lead-yourself); the contact is created along with the lead. ## The contact profile [#the-contact-profile] Click any name to open the profile. ### Header [#header] Name, when they were added, when you last contacted them, a **WhatsApp** button to chat from your phone, and an email button. Below that, quick numbers: **Total leads**, **Won**, and **Lifetime value** (owners and managers). ### Profile [#profile] Edit what you need and click **Save**: | Field | Note | | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------- | | Name, phone, **WhatsApp number**, email, **Instagram** | The AI fills in name, phone and email on its own when the customer shares them | | **Owner** | The teammate responsible for this customer | | **Source** and **Dialect** | | | **Nationality**, **Country**, **City** | | | **Birthday** | | | **Passport expiry** | Flyby warns you if the passport has expired, or expires in under 6 months (most countries refuse entry) | | **Tags** | Type a tag and press Enter or comma. For example: VIP, repeat customer, Umrah, corporate | | **Notes** | Anything lasting about the customer | Agree on a fixed set of tags for the whole team (like "VIP", "Repeat customer", "Corporate", "Hajj 2027") instead of everyone inventing their own. You can then filter by them and export a list for a campaign or special offer. ### Full history in tabs [#full-history-in-tabs] | Tab | What's in it | | ----------------- | -------------------------------------------------------------- | | **Leads** | All the customer's trips and their stages | | **Conversations** | All their conversations on every channel (owners and managers) | | **Bookings** | Their bookings, status and value (owners and managers) | | **Activity** | Notes, calls, tasks and stage changes across all their leads | ## Deleting a contact [#deleting-a-contact] The delete button is at the top of the profile, for owners and managers only. Deleting removes the contact along with **all its leads, conversations and activity**. Bookings and payments are kept so your accounts aren't affected. Deleting can't be undone. If the customer just isn't interested right now, move the lead to **Lost** and keep the contact. ## Who can do what [#who-can-do-what] | | Owner & manager | Lead moderator | | ----------------------------------------------- | --------------- | -------------- | | View contacts | Yes | Yes | | Add or delete a contact | Yes | No | | Conversations and Bookings tabs, lifetime value | Yes | No | | Leads shown in the profile | All | Qualified only | ## Next [#next] # Leads & the pipeline URL: https://docs.flyby.world/en/leads > Follow every customer from the first message to the booking, on the pipeline board or in a list. Every customer who shows real interest becomes a **lead**. The AI agent creates it from the conversation and fills in the trip details; you and your team take it from there to the booking. Open Leads ## Pipeline stages [#pipeline-stages] Every lead moves through these stages and ends as either **Won** or **Lost**: | Stage | What it means | Who puts it there | | --------------- | ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | | **New** | Just added, nobody has worked on it yet | You, when you add a lead yourself | | **Qualifying** | The AI is collecting trip details (destination, dates, travellers, budget...) | The AI agent, as soon as the customer starts talking about a trip | | **Qualified** | The key details are in and the customer is waiting for your team | The AI agent, which also notifies your team | | **Proposal** | You've sent the customer an offer | Your team | | **Negotiation** | The customer is haggling or comparing | Your team | | **Won** | The customer booked | Your team, or automatically when you [convert it to a booking](/en/leads/lead-details#convert-to-a-booking) | | **Lost** | The customer won't book | Your team, with a lost reason | It asks the qualification questions you chose. When it's done it writes a summary, scores the lead, moves it to **Qualified**, and the conversation goes to **Needs you**. See [Qualification](/en/ai-agent/qualification) and [Handoff](/en/conversations/handoff). ## Scores: hot, warm, cold [#scores-hot-warm-cold] | Score | What it means | | -------- | ------------------------------------------------- | | **Hot** | Ready to book soon, with a budget. Call them now. | | **Warm** | Interested, needs follow-up. | | **Cold** | Just browsing or asking. | The AI sets the score with a short reason, and you can change it on the [lead page](/en/leads/lead-details). ## The Pipeline board [#the-pipeline-board] Each stage is a column. The column header shows how many leads it holds **and the total estimated value**. Each card shows: * Customer name, trip type and score * Destination, travel dates and number of travellers * Budget * The lead owner's avatar and a source icon (WhatsApp, Website, Manual...) * When it was last updated ### Moving a lead [#moving-a-lead] * **On a computer**: drag the card to another column. * **On any device**: click the card's (…) button and pick a stage under **Move to**. * **On the lead page**: click a stage in the stage bar at the top. When you move a lead to **Lost**, Flyby asks "Why was this lead lost?". Add the reason (for example: price too high, booked elsewhere, postponed the trip). It helps your team learn why deals slip away. Every move is recorded in the lead's [activity timeline](/en/leads/lead-details#activity-timeline). The columns scroll sideways; swipe to see the other stages. If you'd rather see everything in one column, switch to **List**. ## The List view [#the-list-view] A table with customer, stage, score, trip type, destination, travel dates, estimated value, owner and last update. Click a column header to sort by it. On phones the table becomes cards, with a **Sort by** menu. ## Filters and search [#filters-and-search] * **Search**: by name, phone or destination. * **Score**: hot, warm, cold, or **Not scored**. * **Trip type**: Umrah, Hajj, outbound tourism, honeymoon... * **Assigned to**: **Everyone**, **Assigned to me**, **Unassigned**, or a specific teammate. * **Source**: the channel the customer came from. Click **Clear filters** to see every lead again. ## Adding a lead yourself [#adding-a-lead-yourself] A customer called or walked in? Add them so they enter your follow-up: ### Click "New lead" [#click-new-lead] ### Pick the contact [#pick-the-contact] **Existing contact**: search by name or phone. Or **New contact**: type a name and phone. ### Click "Create lead" [#click-create-lead] The lead is added in the **New** stage and opens so you can fill in the [trip details](/en/leads/lead-details). ## Who sees what [#who-sees-what] | | Owner & manager | Lead moderator | | -------------------------------------------------- | ---------------------------------- | -------------------------------------------------------------------------- | | Leads they see | All of them | Only leads that have been qualified (even if moved to another stage later) | | Stages available | All stages | From **Qualified** to **Won** and **Lost** | | Add and delete leads | Yes | No | | Change stage, score and owner; add notes and tasks | Yes | Yes | | Convert to booking | Yes (if the plan includes Finance) | No | The red number next to **Leads** in the sidebar counts leads in the **Qualified** stage, the ones waiting for someone to call them. ## Next [#next] # Lead details URL: https://docs.flyby.world/en/leads/lead-details > Everything about a lead on one page, from trip details and interested packages to the activity timeline and converting to a booking. Click any card on the [pipeline](/en/leads) to open the lead page. This is where you work the customer step by step: change the stage, complete the trip details, log your calls, and finally convert them into a booking. ## Top of the page [#top-of-the-page] * **The customer's name**, when the lead was added, and when it was qualified (if it was). * **Convert to booking**: owners and managers, on plans that include Finance ([below](#convert-to-a-booking)). * **Delete**: owners and managers. Deletes the lead with its notes and tasks; **the contact itself stays**. ### Pipeline stage [#pipeline-stage] A bar with the stages in order. Click a stage to move the lead there; stages already passed get a check mark. **Lost** sits on its own to the side. Clicking it asks for a lost reason, which then stays visible next to the stage. ### Score, owner and follow-up [#score-owner-and-follow-up] | Part | What it does | | ------------------ | ----------------------------------------------------------------------------------------------------------- | | **Score** | Hot, warm, cold. Below it, an optional **Score reason**. | | **Lead owner** | The teammate handling this lead. Their avatar shows on the card, and it drives the "Assigned to me" filter. | | **Next follow-up** | Pick a day and time to get back to the customer. It turns red once it's past. | **Next follow-up** is a single date shown on the lead page. If you want something that appears on the [Tasks page](/en/leads/tasks) and can be ticked off, add a **Task** from the activity timeline. ## Trip details [#trip-details] The AI agent fills these from the conversation. Complete or correct them with **Edit**: * **Trip type**, **Destination** and **Departure city** * **From** and **To** dates, or **Travel month** if the customer isn't sure yet (e.g. Ramadan, August), plus **Flexible dates** * **Nights** * **Travellers**: adults, children, infants * **Budget from** and **Budget up to** * **Hotel level** and **Room type** * **Nationality** and **Visa status** * **Special requests** * **Estimated value**: the expected deal value, summed at the top of each pipeline column If the customer tells you something on the phone (an extra child, a new date), update it here right away. Any teammate who opens the lead sees the full picture, and converting to a booking picks up the right numbers and dates. ## AI summary [#ai-summary] A short Arabic summary the AI writes when it qualifies the customer: what they want, how urgent it is, and anything worth knowing. Read it before you call. ## Interested packages [#interested-packages] The packages the customer asked about or showed interest in. The AI adds them from the conversation, each with its "From" price. Owners and managers can add one with **Add package** (searches active packages only) or remove one. This list matters because [converting to a booking](#convert-to-a-booking) puts these packages straight into the booking. Editing interested packages works on every plan. [Converting to a booking](#convert-to-a-booking) still needs a plan with Finance (Growth or Pro). ## Activity timeline [#activity-timeline] Everything that happened with the customer, in order: stage changes, AI events (like qualifying the lead), your notes, calls and tasks. At the top of the timeline you can add: | Type | Use it for | | ------------ | ------------------------------------------------------------------------------------------------------ | | **Note** | Anything about the customer: "Wants a hotel close to the Haram" | | **Log call** | After any call: "What did you talk about?". Also updates "Last contacted" on the contact | | **Task** | Something to do by a deadline: describe it and pick a **Due date** and **Time** (the date is required) | Tasks appear in the timeline and on the [Tasks page](/en/leads/tasks); tick them off from either place. A task past its due time shows **Overdue**. Everyone can delete the notes, calls and tasks they wrote; owners and managers can delete any of them. ## Side panel: contact and conversation [#side-panel-contact-and-conversation] * **Contact**: name, phone, nationality and location, an **Open WhatsApp** button to chat from your phone, and **Full profile** to open the [contact](/en/leads/contacts). * **Conversation**: the latest messages between the customer, the AI and your team, so you know where things stand. Owners and managers can click **Open conversation** to reply. Lead moderators can read the messages here but can't open the conversation. ## Convert to a booking [#convert-to-a-booking] When the customer says yes, turn the lead into a booking in one click: ### Click "Convert to booking" [#click-convert-to-booking] First check that **Interested packages** and **Trip details** (travellers and dates) are right. ### Confirm [#confirm] Flyby creates a new booking with: * The interested packages as items, at each package's "From" price, quantity = adults + children. The unit cost comes automatically from the adult price the "From" price is based on * Travel and return dates and number of travellers from the trip details The lead moves to **Won**. ### Finish it in Finance [#finish-it-in-finance] The booking page opens right away. Adjust prices and costs, add services, and record payments. See [Bookings](/en/finance/bookings). **Convert to booking** only shows on **Growth** and **Pro** (and during the trial), for owners and managers. Compare plans in [Plans](/en/billing). ## Next [#next] # Tasks & follow-ups URL: https://docs.flyby.world/en/leads/tasks > Give every customer a dated follow-up, and track what's overdue, due today and coming up from one page. Most lost bookings come down to someone forgetting to follow up. Tasks give every follow-up a due time and collect them on the **Tasks** page, so you know where to start your day. Open Tasks ## Adding a task [#adding-a-task] Two ways, both end up in the same place: 1. Click **Add task**. 2. Under **Lead**, search by name or destination and pick the lead. 3. Under **Task**, describe what needs doing, e.g. "Call about the visa". 4. Under **Due**, pick a day and time. 5. Click **Add task**. 1. Open the [lead](/en/leads/lead-details). 2. In the **Activity** timeline choose **Task**. 3. Describe it and pick a **Due date** and **Time**. 4. Click **Add task**. Every task belongs to a lead and needs a due time. If you have no leads yet, **Add task** is disabled. ## The Tasks page [#the-tasks-page] Tasks are split into four tabs, each with a count: | Tab | What's in it | | ------------ | ------------------------------------------------------ | | **Overdue** | Past their due time and not done. The page opens here. | | **Today** | Due later today | | **Upcoming** | Due after today | | **Done** | The most recently completed tasks | On the other side: * **My tasks**: tasks you added. * **All tasks**: the whole team's tasks, each with the avatar of whoever added it. Each task shows what needs doing, the due time (red when overdue, with how long ago), and the lead and contact. Click either to open it. ## Completing a task [#completing-a-task] Tick the box next to the task and it moves to **Done**. Ticked it by mistake? Open **Done**, untick it, and it goes back. After you speak to the customer, log it with **Log call** in their activity, and add the next task right away. That way no customer is ever left without a follow-up. ## The overdue badge [#the-overdue-badge] A red number next to **Tasks** in the sidebar counts open tasks whose due time has arrived or passed. On phones, a red dot appears on the **Tasks** tab in the bottom bar. ## Lead moderators [#lead-moderators] A Lead moderator sees the tasks they added plus tasks on qualified leads, and can add tasks to qualified leads only. ## Examples of useful tasks [#examples-of-useful-tasks] * "Send the Rajab Umrah quote, 4 people, quad room" → tomorrow 11 am * "Check when the kids' passports need renewing" → in two days * "Ask if they've decided" → a week after sending the offer * "Call a week before departure to confirm documents" → before the travel date ## Next [#next] # Page analytics URL: https://docs.flyby.world/en/public-page/analytics > See how many people visit your public page, where they come from, which packages they open and how many contact you, without storing personal data. Analytics show how your public page performs: where visitors come from, what they do on it, and how many of them turn into enquiries. Open it with the **Analytics** button at the top of **Public page**. It's available to the **owner** and **managers**. ## What we count [#what-we-count] | Number | What it means | | ------------------- | ------------------------------------------------------ | | **Page views** | Each time your main page is opened | | **Unique visitors** | The number of people; each visitor counts once per day | | **Package views** | Opening any package page | | **Chat clicks** | Taps on **Chat with us** | | **WhatsApp clicks** | Taps on the WhatsApp button | | **Call clicks** | Taps on **Call** | We also record taps on your offers and on branch map buttons (these appear in the Pro export). ### What we leave out [#what-we-leave-out] * **Your preview visits**. * **Bots, search engines** and link previews (like when someone pastes your link in WhatsApp). * **Repeats**: the same visitor doing the same thing within 30 minutes counts once. * Any visit while the page is **off**. ## Privacy [#privacy] Each visitor is identified by a scrambled code that changes every day, so they count once per day and can't be followed from day to day or across agencies. What we keep: the type of action, the package, the traffic source, the device type (mobile, desktop, tablet), the country and the page language. No names, numbers or personal details. That's why someone who visits on two different days counts as two visitors. ## What you see on each plan [#what-you-see-on-each-plan] Totals for the **last 30 days**: * Page views * Unique visitors * Chat clicks * WhatsApp clicks Below them, a card shows what you unlock by upgrading to Growth. Everything in Starter, plus: * **7, 30 and 90 day** ranges. * **Daily visits**: a chart of views and visitors per day. * **From visit to enquiry**: how many visitors opened a package, how many tapped chat, WhatsApp or call, and each step as a share of the previous one. * **Most viewed packages**. * **Traffic sources**: Instagram, Facebook, Google, "Direct"… * **Devices** and **Countries**. * Package views and call clicks cards. The free trial works like Growth. Everything in Growth, plus: * A **12 months** range. * **Export CSV** in two formats: * **Daily summary**: date, page views, unique visitors, package views, contact clicks. * **All events**: every action with its time, type, package, source, device, country and language. ## Traffic sources [#traffic-sources] The source is decided like this: 1. If the link has a `utm_source` (like `?utm_source=instagram`), that's what shows. 2. If not, the site the visitor came from (Google, Facebook, Instagram…). 3. If there's no information at all, it counts as **Direct**: a typed link, a WhatsApp chat, or an app that doesn't share where the visit came from. Lots of visits from WhatsApp and Instagram show as Direct because those apps don't pass the source. Use a different link for each place: * Bio: `.../p/your-agency?utm_source=instagram` * Ads: `.../p/your-agency?utm_source=facebook_ads` * WhatsApp messages: `.../p/your-agency?utm_source=whatsapp` ## No numbers yet? [#no-numbers-yet] * Make sure the page is **live**, not off. * Your **preview** visits aren't counted: open the normal link from another phone. * If you haven't shared the link yet, you'll see "No visits yet". Share it on WhatsApp, Instagram and Facebook. ## Next [#next] # Public page URL: https://docs.flyby.world/en/public-page > Your agency's mini-site with packages, offers, services, branches and contact details, all on one link you can share with anyone. The public page is your agency's ready-made "website": a banner with your name and colour, your packages with prices and dates, offers, services, FAQs, branches, and contact buttons that open the chat or WhatsApp. No code needed. Your page link looks like this, in Arabic and English: ```text https://flyby.world/ar/p/your-agency https://flyby.world/en/p/your-agency ``` ## Who can edit it? [#who-can-edit-it] Only the **owner** and **managers**. You'll find it in the sidebar as **Public page**. ## Go live in 4 steps [#go-live-in-4-steps] ### Choose your page address [#choose-your-page-address] On the **General** tab, enter a **Page address**: the last part of your link, like `al-ofok-travel`. If your agency name is in English, the **Suggest** button fills it in for you. A green tick means the address is available. The rules: * 3 to 40 characters. * Lowercase English letters, numbers and dashes (-), no double dashes, and it can't start or end with a dash. * Some words are reserved, like `admin`, `flyby` and `support`. Click **Save**. ### Write your headline and intro [#write-your-headline-and-intro] * **Headline** (Arabic and English): the big line at the top, like "Umrah and holidays at the best prices". Leave it empty to show your agency name. * **Short intro** (Arabic and English): one or two lines about what makes you different. Empty English fields show the Arabic text. ### Add a cover image [#add-a-cover-image] A wide photo behind your headline: JPG, PNG or WebP, up to 5 MB. Without one, the page uses your brand colour. ### Turn the page on [#turn-the-page-on] Switch on **Page is live** at the top. The badge next to the title changes from **Off** to **Live**, and an **Open page** button appears. If you change your page address after sharing it, **every old link stops working**: in your bio, ads and QR codes. Pick an address you'll keep. ## Colour and logo [#colour-and-logo] The page takes its look from settings you already have: * **Accent colour** = your chat colour from [**Settings → Channels & integrations**](/en/channels/website-chat). Flyby picks a readable text colour for the buttons automatically. * **Logo** from **Settings → Logo**. The **Colour & logo** card has **Change colour** and **Change logo** buttons that take you to the right place. ## "Powered by Flyby" [#powered-by-flyby] The page footer has a small "Powered by Flyby" link. On the **Pro** plan you can remove it with the **Hide "Powered by Flyby"** switch on the General tab. ## Preview before you publish [#preview-before-you-publish] The **Preview** button opens your page the way customers will see it, **even while it's off**: * Preview only works when you're signed in as a member of the agency. * A bar at the top says it's a preview, with a **Back to editor** button. * Your preview visits **aren't counted** in analytics. ## What customers see [#what-customers-see] * A **banner** with your name, logo, headline and contact buttons. It always comes first. * The **sections** you turned on, in the order you chose. See [Page sections](/en/public-page/sections). * **A page for each package** with the description, day-by-day itinerary, what's included and not, hotels, upcoming departures with seats left, terms, and an **Ask about this package** button. * **Contact buttons**: **Chat with us** opens your [public chat](/en/channels/website-chat) with the AI agent, and **WhatsApp** opens a chat with your WhatsApp number, with a ready-written message about the package or offer. On phones these buttons stay pinned to the bottom of the screen. * **Social media icons** in the Contact section and the footer. See [Social links](/en/public-page/social-links). ## Share it [#share-it] * Copy **Your page link** from the General tab and put it in your bio, your ads and your WhatsApp greeting. * When someone shares the link on WhatsApp or Facebook, the preview shows your cover image (or logo) and agency name. * While the page is live it can appear in search engines like Google. While it's off, only your team can see it. Add `?utm_source=instagram` to the end of your bio link and `?utm_source=facebook` to your ads, and you'll see each source separately in [Analytics](/en/public-page/analytics). ## Next [#next] # Offers, branches & custom sections URL: https://docs.flyby.world/en/public-page/offers-and-branches > Add limited-time offers with a badge and end date, show your branches on a map, and tell your agency's story in your own sections. These three tabs make your page look like a big agency's website: **Offers** bring in enquiries, **Branches** reassure customers you have a real office, and **Custom sections** explain why they should choose you. | Tab | Plans | | --------------- | ----------------------------------- | | Offers | Growth and Pro (and the free trial) | | Custom sections | Pro | | Branches | Pro (unlimited branches) | If a tab isn't on your plan, it explains the feature and shows an **Upgrade to …** button. ## Offers [#offers] An offer shows in the **Current offers** section with a badge on the image (like `-15%`), a "Valid until" date, and an **Ask about this offer** button that opens the chat or WhatsApp with a ready-written message naming the offer. ### Open **Offers** and click **Add offer** [#open-offers-and-click-add-offer] Go to **Public page → Offers**. ### Fill in the offer [#fill-in-the-offer] | Field | What to enter | | --------------------------- | ---------------------------------------------------------------------------- | | **Title (Arabic)** | Required. For example "15% off Umrah in Shaaban" | | **Title (English)** | Optional. Empty shows the Arabic | | **Text (Arabic / English)** | Offer details and conditions | | **Badge** | A short label, like "-15%" or "Early booking". Empty shows "Offer" | | **Valid until** | The offer disappears after this date. Leave it empty to keep it on | | **Linked package** | Customers can open the package page from the offer with **View package** | | **Image** | JPG, PNG or WebP up to 5 MB. Without one, the linked package's cover is used | ### Click **Save** [#click-save] The offer shows on your page right away, as long as the Offers section is on in the [Sections](/en/public-page/sections) tab. Summer early booking, Ramadan and Umrah deals, group and family discounts, or a honeymoon package. Link each offer to a package so customers can see the full details. Offers past their date are marked **Expired** in the dashboard and are hidden from customers. You can change the date to bring one back, or delete it. ## Custom sections (Pro) [#custom-sections-pro] Your own blocks, each with a title, text and an optional image. Great for "Why travel with us", "Our licences", "Our partners" or "What customers say". 1. Open **Custom sections** and click **Add section**. 2. Enter the **Title (Arabic)** (required), the English one if you like, the text, and an image if you want. 3. Click **Save**. The blocks appear in the same order as in the tab, wherever **Custom sections** sits in your section order. ## Branches (Pro) [#branches-pro] Each branch shows in the **Our branches** section with its name, city, address and hours, plus **Map**, call and WhatsApp buttons. ### Open **Branches** and click **Add branch** [#open-branches-and-click-add-branch] Go to **Public page → Branches**. ### Fill in the branch [#fill-in-the-branch] * **Branch name (Arabic)**: required, like "Nasr City branch". English is optional. * **City** and **Address**. * The branch's own **Phone** and **WhatsApp**. * **Map link**: open the place in Google Maps, tap **Share** and copy the link. It must start with `https://`. * **Opening hours**: write it the way customers read it, e.g. "Sat to Thu, 10 am to 10 pm". ### Click **Save** [#click-save-1] ## Managing the lists [#managing-the-lists] In Offers, Custom sections and Branches, every item has: * A **Show on page** switch: hide the item for now without deleting it. * **Move up** and **Move down** arrows: its order on the page. * **Edit** and **Delete**. Deleting is permanent and asks you to confirm. ## Next [#next] # Page sections URL: https://docs.flyby.world/en/public-page/sections > Order the sections of your public page, show the ones you need, hide the rest, and choose which packages customers see. Your public page is made of sections: About us, Packages, Offers, Services, FAQs, Custom sections, Branches and Contact. You decide what shows and in what order. ## Order your sections [#order-your-sections] ### Open the **Sections** tab [#open-the-sections-tab] Go to **Public page → Sections**. ### Turn each section on or off [#turn-each-section-on-or-off] The switch next to each section decides whether it shows. A hidden section is marked **Hidden**. ### Change the order [#change-the-order] Use the **Move up** and **Move down** arrows next to each section. ### Click **Save** [#click-save] Changes only apply once you save. **Discard** takes you back to the last saved version. The top banner with your name, headline and contact buttons is fixed at the top of the page and can't be moved. ## What each section shows [#what-each-section-shows] A section **only appears when it has content**, even if its switch is on. For example, Offers only shows once you add an active offer. | Section | What it shows | Where the content comes from | | ------------------- | ---------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- | | **About us** | Your "About" text | **About the agency** in [Agency profile](/en/settings/agency-profile) | | **Packages** | Package cards with image and "From" price | Active packages with **On public page** switched on | | **Offers** | Limited-time deals with a badge and end date | The **Offers** tab ([Offers & branches](/en/public-page/offers-and-branches)) | | **Services** | Visas, flights, hotels and your other services | Your active [services](/en/catalog/services). Those without a price show "Price on request" | | **FAQs** | An expandable list of questions | Your active [FAQs](/en/catalog/faqs) | | **Custom sections** | Free text blocks with an image | The **Custom sections** tab | | **Branches** | Your offices with map, hours and phone | The **Branches** tab | | **Contact** | Phone, WhatsApp, email, website, address, working hours, social icons, and chat and WhatsApp buttons | [Agency profile](/en/settings/agency-profile) and [Working hours](/en/settings/working-hours) | ## Sections by plan [#sections-by-plan] | Section | Starter | Growth | Pro | | --------------------------- | --------------------- | ---------------------- | ---------------------- | | About us, Packages, Contact | ✓ (up to 10 packages) | ✓ (unlimited packages) | ✓ (unlimited packages) | | Offers, Services, FAQs | — | ✓ | ✓ | | Custom sections, Branches | — | — | ✓ | The free trial works like Growth. A section that isn't on your plan is marked **Locked** with an upgrade link, and it doesn't show to customers even if it was on before. ## Packages on the page [#packages-on-the-page] The **Packages** tab lists all your **active** packages, each with a switch. * **Switch it on** to show the package, or **off** to hide it. The same switch is on the package's own page as **On public page**. * **Order**: **featured** packages come first, then the newest. To push a package to the top, mark it featured in [Packages](/en/catalog/packages). * **Drafts and stopped packages** never appear on the page, even if the switch is on. On the Starter plan the page shows **up to 10 packages**. A counter like "7 of 10 used" sits above the list. When you hit the limit, hide a package first to show another, or upgrade to Growth. Any extra package is marked "Not shown, over plan limit". ## Next [#next] # Social links URL: https://docs.flyby.world/en/public-page/social-links > Add your social accounts once, and Flyby recognises each platform and shows its icon on your public page. Add the links to your social media pages in your agency profile. Flyby recognises the platform from each link and shows it as a round icon on your public page. ## Add a link [#add-a-link] ### Open your agency profile [#open-your-agency-profile] **Settings → Agency profile**, and scroll to **Social media**. ### Paste the link [#paste-the-link] Paste the full link to your page, like `instagram.com/nile.tours`. You don't need to type `https://`; Flyby adds it. The icon next to the field changes right away to the platform it recognised. ### Add more links [#add-more-links] Click **Add a link** for each account. You can add up to **12 links**. ### Save [#save] Click **Save** at the bottom of the page. If a link isn't valid you'll see "One of the links isn't valid. Check it and try again." Duplicate links and empty fields are removed automatically. Who can edit them: the **owner** and **managers**. ## Platforms we recognise [#platforms-we-recognise] | Platform | Links recognised | | ----------- | ---------------------------------------------------------------------- | | Facebook | `facebook.com`, `fb.com`, `fb.me`, `fb.watch` | | Messenger | `m.me`, `messenger.com` | | Instagram | `instagram.com`, `instagr.am` | | WhatsApp | `wa.me`, `whatsapp.com` | | TikTok | `tiktok.com` | | X (Twitter) | `x.com`, `twitter.com` | | YouTube | `youtube.com`, `youtu.be` | | Snapchat | `snapchat.com` | | LinkedIn | `linkedin.com`, `lnkd.in` | | Telegram | `t.me`, `telegram.me`, `telegram.org` | | Threads | `threads.net`, `threads.com` | | Pinterest | `pinterest.com`, `pin.it` | | Google Maps | `maps.google.com`, `google.com/maps`, `maps.app.goo.gl`, `goo.gl/maps` | | Tripadvisor | `tripadvisor.com` (and country domains) | Any other link shows with a **website** (globe) icon, so you can add your own site or a Booking page, for example. `m.me/yourpage` shows a Messenger icon and opens a chat with your Page directly, while `facebook.com/yourpage` opens the Page itself. Add both if you like. ## Where they show [#where-they-show] * The **Contact** section of your public page, above the chat and WhatsApp buttons (when the section is on). * The **footer of every page** on your site, including package pages. Icons appear in the same order as in your settings, so put your most important account first. Your WhatsApp number already appears as a button on the page, from **WhatsApp number** in your agency profile. You only need a `wa.me` link if you want an extra icon. ## Next [#next] # Agency profile & logo URL: https://docs.flyby.world/en/settings/agency-profile > Your agency details shown to customers and used by the AI agent in its replies, plus social links and your logo. Your agency profile appears on your public page and invoices, and the AI agent relies on it whenever someone asks "Who are you?" or "Where are you located?". The more complete it is, the more accurate the AI's answers. **Who can edit it?** Owners and managers. Open Agency profile ## Fields [#fields] | Field | What it's used for | | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | | **Agency name** | Required. Shown everywhere, and the AI agent introduces itself with it | | **English name** | Shown in the English interface and on English invoices | | **Phone** and **WhatsApp number** | Contact numbers shown to customers and on invoices | | **Email** and **Website** | Shown on invoices and used by the AI when customers ask | | **Address**, **City** and **Country** | Your address appears on invoices and the AI shares it with customers | | **Base currency** | Default currency for packages, bookings and reports | | **Timezone** | Used for working hours and reports | | **About the agency** | The AI agent reads it and uses it when customers ask about you; it also appears in the about section of your public page | | **Social media** | Links to your pages; their icons show on your public page | Click **Save changes** when you're done. ## Write an about text that helps the AI [#write-an-about-text-that-helps-the-ai] This is one of the most important fields. Include: * Your experience and when you were founded. * Your specialties (Umrah, domestic tours, outbound tours, honeymoons...). * Your branches and licence. * What makes you different. Licensed by the Ministry of Tourism since 2010, specialized in economy and premium Umrah programs and trips to Turkey and Dubai, with branches in Cairo and Alexandria. The about text introduces your agency. Put prices and policies (payment, cancellation, required documents) in [FAQs](/en/catalog/faqs), and how the AI should reply in [AI instructions](/en/ai-agent/instructions). ## Social media [#social-media] Click **Add a link** and paste the link to your page (Instagram, Facebook, TikTok, YouTube, X, Snapchat, LinkedIn, Telegram, Google Maps…). Flyby recognises the platform from the link and shows its icon on your public page. Details in [Social links](/en/public-page/social-links). ## Logo [#logo] The logo has its own page: **Settings → Logo**. It appears on your chat page, public page, invoices and the offers you send customers. ### Go to Settings → Logo [#go-to-settings--logo] Open Logo ### Click "Upload logo" [#click-upload-logo] Or **Replace logo** if you already have one. ### Choose the image [#choose-the-image] PNG, JPG or WEBP, up to 2 MB. A **square image with a transparent background** works best and looks good everywhere. You can remove it any time with **Remove logo**. ## Next [#next] # Settings URL: https://docs.flyby.world/en/settings > Every settings page in Flyby, and who can see which. **Settings** is where you manage your agency's details, hours, channels and plan, plus the notifications for the device you're using. Open Settings ## Settings pages [#settings-pages] The menu has two parts: **agency** pages and **This device** pages. ### Agency pages (owner and manager) [#agency-pages-owner-and-manager] | Page | What's in it | | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | **Agency profile** | Name, contact details, address, currency, timezone, the about text the AI agent uses, and social links. [Learn more](/en/settings/agency-profile) | | **Logo** | Your agency logo, shown on your chat page, public page and invoices. [Learn more](/en/settings/agency-profile#logo) | | **Working hours** | Your team's working days and hours. [Learn more](/en/settings/working-hours) | | **Channels & integrations** | Website chat, WhatsApp, Messenger, Instagram and the outbound webhook. [Learn more](/en/channels) | | **Plan & billing** | Your plan, this month's usage and add-ons. [Learn more](/en/billing) | | **Danger zone** | Permanently delete the agency (owner only). [Below](#danger-zone) | ### This device pages (everyone) [#this-device-pages-everyone] | Page | What's in it | | ------------------- | -------------------------------------------------------------------------------------------------------- | | **Notifications** | Browser notifications and sound alerts on this device. [Learn more](/en/settings/notifications) | | **Install the app** | Install Flyby on your phone or computer like a native app. [Learn more](/en/getting-started/install-app) | Lead moderators only see the **This device** pages. When they open Settings they land on **Notifications**. ## My account [#my-account] Your personal details aren't in the agency settings. Open **My account** from the account menu at the top to: * Change your name and interface language. * Change your password. * See your agency and your role in it, or leave it. * Sign out on this device. ## Danger zone [#danger-zone] The **Danger zone** page is visible to the **owner only** and lets you **Delete this agency**. Everything is erased: conversations, leads, packages, bookings, finance and team, and every member loses access. To delete: 1. Go to **Settings → Danger zone**. 2. Click **Delete agency**. 3. Type the agency name exactly to confirm. 4. Click **Delete forever**. If you want to hand the agency to someone else instead of deleting it, use [Transfer ownership](/en/team/invites#transfer-ownership-owner-only). ## Next [#next] # Notifications URL: https://docs.flyby.world/en/settings/notifications > Get alerts on your phone and computer when a conversation needs you or a lead is qualified, even when Flyby is closed. Flyby alerts you to what matters: a conversation that needs a teammate, a lead ready to book, or AI conversations running low. Notifications appear in the bell inside the app, and you can also get them as notifications on your device. Each person gets notifications (the bell and browser notifications) **in their own language**: the one set in **My account**. New users get the language they signed up in. Each device has its own settings. Turn notifications on for **every** phone and computer you use. Each team member sets up their own notifications, lead moderators included. Open Notifications ## Settings [#settings] | Setting | What it does | Default | | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | ------- | | **Browser notifications** | A notification on your device for chats that need you, qualified leads and alerts, **even when Flyby is in the background or closed** | Off | | **Sound alerts** | A short chime when a new notification arrives while Flyby is open | On | ## Turn on browser notifications [#turn-on-browser-notifications] ### Go to Settings → Notifications [#go-to-settings--notifications] On the device where you want notifications. ### Turn on "Browser notifications" [#turn-on-browser-notifications-1] ### Click "Save" [#click-save] Your browser asks whether to allow notifications. Choose **Allow**. On iPhone, notifications **only work after you install the app** to your home screen: 1. Open Flyby in Safari, tap the Share button, then **Add to Home Screen**. 2. Open Flyby from the new icon. 3. Go to **Settings → Notifications** and turn them on from there. If you see "This browser doesn't support notifications", you're in the browser, not the installed app. See [Install the app](/en/getting-started/install-app). Works straight from Chrome. Installing the app (⋮ menu → **Install app**) gives you a better experience. Works in Chrome, Edge, Brave, Firefox and Safari. Notifications reach you even with the tab closed, as long as the browser is running. ## Notifications blocked by the browser [#notifications-blocked-by-the-browser] If you see "Notifications are blocked for Flyby", you (or someone) chose **Block** earlier: 1. Click the **lock icon** next to the address in your browser. 2. Set **Notifications** to **Allow**. 3. Refresh the page, turn on **Browser notifications** and click **Save** again. * Make sure your phone or computer allows notifications from the browser itself (and Do Not Disturb is off). * On iPhone: open Flyby from the installed app, not from Safari. * If you see "Couldn't turn on notifications for this device", refresh and try again. Turn notifications on for each device separately. The setting on your computer doesn't affect your phone. ## What triggers a notification [#what-triggers-a-notification] | Notification | When | Who gets it | | ---------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | ----------------------------------- | | **Conversation needs you** | The AI handed a conversation to your team (**Needs you**): the customer asked for a person, or a handoff rule applied | Owner and managers | | **AI agent couldn't reply** | Something went wrong and the conversation needs a reply from your team | Owner and managers | | **Qualified lead** | The AI finished qualifying a lead, with its score (hot, warm, cold) | Owner, managers and lead moderators | | **80% of AI conversations used** | Once a month | Owner and managers | | **AI conversations used up** or **Free trial ended** | The AI agent has paused | Owner and managers | Tapping a notification takes you straight to the conversation, the lead or the billing page. ## Next [#next] # Working hours URL: https://docs.flyby.world/en/settings/working-hours > Set your team's working days and hours, so the AI agent can tell customers when someone will follow up. The AI agent replies **24/7**. Working hours don't switch it off; they tell it when your team is around, so it says the right thing to customers. **Who can edit them?** Owners and managers. Open Working hours ## Set your hours [#set-your-hours] ### Pick your working days [#pick-your-working-days] Tap the days your team works (Sun to Sat). ### Set the hours [#set-the-hours] Choose **From** and **To**. The same hours apply to every day you picked. ### Save [#save] Click **Save changes**. Hours use the **Timezone** in your [Agency profile](/en/settings/agency-profile), shown under the hours as "Times are in … time". If the timezone is wrong, your hours will be off too. * The closing time must be after the opening time, so a shift can't run past midnight. * New agencies start with Saturday to Thursday, 10 am to 8 pm. ## How working hours are used [#how-working-hours-are-used] | Where | What happens | | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **AI agent** | Knows whether your team is available right now. Outside your hours, it keeps helping the customer and tells them the team will follow up during working hours | | **Customer questions** | If a customer asks "When are you open?", the AI answers with these hours | | **Public page** | Your hours appear in the contact section | If you don't pick any day, you'll see "No working days selected", and the AI agent won't be able to tell customers when your team is available. ## Next [#next] # Roles & permissions URL: https://docs.flyby.world/en/team > Who can do what in Flyby, the Owner, Manager and Lead moderator roles. Each team member has one role that decides what they see and what they can do. There are 3 roles: **Owner**, **Manager** and **Lead moderator**. ## Roles at a glance [#roles-at-a-glance] ## Permissions table [#permissions-table] | Permission | Owner | Manager | Lead moderator | | ----------------------------------------------------------------- | :---: | :-----: | :------------: | | Conversations: reply, take over from the AI, notes and assignment | ✓ | ✓ | — | | All leads (including ones not qualified yet) | ✓ | ✓ | — | | Qualified leads and their tasks | ✓ | ✓ | ✓ | | Convert a lead to a booking, or delete a lead | ✓ | ✓ | — | | View contacts | ✓ | ✓ | ✓ | | Create and delete contacts | ✓ | ✓ | — | | Catalog: packages, services and FAQs | ✓ | ✓ | — | | Finance: bookings, payments, expenses and invoices | ✓ | ✓ | — | | AI agent settings | ✓ | ✓ | — | | Public page and its analytics | ✓ | ✓ | — | | Team: invite members, change roles, remove people | ✓ | ✓ | — | | Agency settings: profile, hours, channels, plan & billing | ✓ | ✓ | — | | Their own notifications and installing the app on their device | ✓ | ✓ | ✓ | | Remove or demote the owner | — | — | — | | Transfer ownership | ✓ | — | — | | Delete the agency (Danger zone) | ✓ | — | — | A qualified lead is one where the AI agent (or your team) finished the qualification questions and the lead reached the **Qualified** stage. Lead moderators keep seeing these leads even after they move on to proposal, negotiation, won or lost. Learn more about [qualification](/en/ai-agent/qualification). ## Which role should I use? [#which-role-should-i-use] * **Manager**: for your partner, sales manager or anyone who needs to manage packages, finance and settings. * **Lead moderator**: for sales staff whose job is to call ready customers and close the booking. They won't see conversations or any financial figures. Managers have almost full access, including finance, channel connections and billing. Only give this role to people you trust. ## Next [#next] # Inviting & managing your team URL: https://docs.flyby.world/en/team/invites > Invite colleagues with a private link, change their roles or remove them, and transfer ownership when you need to. On the **Team** page you invite colleagues and choose each person's role. An invite is a **private link** you send yourself, and the person accepts it with the same email you invited. **Who can do this?** Owners and managers. Lead moderators don't have access to the Team page. Open Team ## Invite a new member [#invite-a-new-member] ### Click "Invite member" [#click-invite-member] On the **Team** page. ### Enter the email and pick a role [#enter-the-email-and-pick-a-role] **Manager** (full access) or **Lead moderator** (qualified leads only). See [Roles & permissions](/en/team). ### Click "Create invite link" [#click-create-invite-link] You'll see **Your invite link is ready**. ### Send the link [#send-the-link] Copy it and send it yourself, or click **Share on WhatsApp** to open WhatsApp with a ready message containing the link. Flyby doesn't email the invite. You need to send the link to the person on WhatsApp or by email. * The link is valid for **14 days**. * If you invite the same email again, the new link replaces the old one. * Invites that haven't been accepted show under **Pending invites**, where you can **Copy link** again or **Revoke** the invite. * If you invited teammates while setting up your agency, Flyby showed their links right away with **Copy link** and **Send on WhatsApp** buttons; they're here too. [Set up your agency](/en/getting-started/onboarding) ## Seats per plan [#seats-per-plan] | Plan | Seats | | ---------- | ----- | | Free trial | 5 | | Starter | 2 | | Growth | 5 | | Pro | 15 | Seats count **every active member (including the owner) + pending invites**. When you've used them all, you'll see "You've used all the seats on your plan". To invite more people: * Add an **Extra seat** for EGP 250 / $9 per month each. [Add-ons](/en/billing/add-ons) * Or upgrade your plan from **Settings → Plan & billing**. [Plans](/en/billing) A pending invite takes a seat. If someone isn't going to accept, revoke their invite to get the seat back. ## Accepting an invite (for the invited person) [#accepting-an-invite-for-the-invited-person] 1. Open the link you received. 2. If you're not logged in, click **Log in** or **Create account** with the **same email** the invite was sent to (you can also continue with Google if it's the same email). 3. Click **Accept invite** and you'll land straight in the agency's dashboard. You're logged in with a different account. Click **Log out and use the right account** and log in with the email the invite was sent to. Each account can be in one agency only. Log out and accept with a different email, or leave the other agency first. It may have been revoked, already accepted, or it's older than 14 days. Ask the agency for a new link. ## Change a member's role [#change-a-members-role] In the **Members** list, choose the new role from the menu next to the member (**Manager** or **Lead moderator**). The change applies right away. * You can't change your own role. * Nobody can change the **Owner**'s role. ## Remove a member [#remove-a-member] Click the delete icon next to the member and confirm. They lose access to the agency right away, and you can invite them again later. The owner can't be removed. ## Transfer ownership (owner only) [#transfer-ownership-owner-only] To hand the agency over to someone else: ### Make them a manager [#make-them-a-manager] Ownership can only go to a manager. ### Open the "Transfer ownership" card [#open-the-transfer-ownership-card] On the **Team** page (only the owner sees it). ### Choose the manager and click "Transfer ownership" [#choose-the-manager-and-click-transfer-ownership] Then confirm. That manager becomes the new owner and you become a manager. Only they can transfer it back. ## Leaving the agency [#leaving-the-agency] * **Managers**: click **Leave agency** next to your name on the **Team** page, or use **My account → My agencies**. * **Lead moderators**: use **My account → My agencies** (from the account menu at the top). * **Owner**: can't leave. Transfer ownership first. Once you leave, you lose access to all of the agency's data and need a new invite to come back. ## Next [#next] --- # العربية (Arabic) # إزاي الوكيل الذكي بيشتغل URL: https://docs.flyby.world/ar/ai-agent > بيعمل إيه مع العميل من أول رسالة لحد ما يسلّمه لفريقك، وإيه اللي مبيعملوش. الوكيل الذكي هو موظف المبيعات الأول في شركتك: بيستقبل كل رسالة، يرد في ثواني، يرشّح البرامج المناسبة، ويجمع بيانات الرحلة لحد ما العميل يبقى جاهز لفريقك. كل إعداداته في صفحة **الوكيل الذكي** في القايمة. افتح صفحة الوكيل الذكي **المالك** و**المدير** بس. الوكيل متاح في كل الباقات، وكل محادثة بيرد فيها بتتحسب من [محادثات الذكاء الاصطناعي](/ar/billing/ai-conversations) بتاعة الشهر. ## رحلة العميل مع الوكيل [#رحلة-العميل-مع-الوكيل] ### العميل يبعت أول رسالة [#العميل-يبعت-أول-رسالة] المحادثة بتظهر في **المحادثات** بحالة **الوكيل الذكي**. الوكيل بيبدأ بـ [رسالة الترحيب](/ar/ai-agent/persona) بتاعتك وبيسأل العميل عايز إيه. ### يفهم ويرشّح [#يفهم-ويرشّح] بيرد باللهجة اللي اخترتها (أو بلهجة العميل لو اخترت **حسب العميل**)، وبيفهم الفرانكو زي «3ayez a7gez 3omra». بيدوّر في برامجك وخدماتك الشغالة ويرشّح المناسب بالسعر الحقيقي، وبيحسب السعر على حسب نوع الغرفة وعدد المسافرين، وبيوضّح الحساب. ### يجمع بيانات التأهيل [#يجمع-بيانات-التأهيل] بيسأل سؤال أو اتنين بس في كل رسالة، بشكل طبيعي من غير استجواب، وبيسجّل كل معلومة أول ما يعرفها. أول ما يعرف أي تفصيلة، العميل بيظهر في **العملاء المحتملون** بمرحلة **قيد التأهيل**. [بيانات التأهيل](/ar/ai-agent/qualification) ### يأهّل ويسلّم [#يأهّل-ويسلّم] لما يجمع كل البيانات المطلوبة (أو العميل يقول صراحةً إنه عايز يحجز)، الوكيل بيحوّل العميل لمرحلة **مؤهل**، يقيّمه **ساخن** أو **دافئ** أو **بارد**، يكتب ملخص لفريقك، ويقول للعميل إن مستشار سفر هيكلمه. فريقك كله (حتى مشرفين العملاء) بيوصله إشعار. ### فريقك يكمّل [#فريقك-يكمّل] المحادثة بتظهر في **محتاج موظف**. الوكيل بيفضل يرد على أي أسئلة زيادة من العميل لحد ما حد من فريقك **يستلم المحادثة**. [استلام المحادثة](/ar/conversations/handoff) ## إمتى بيحوّل لفريقك على طول [#إمتى-بيحوّل-لفريقك-على-طول] الوكيل بيوقف رد في المحادثة دي ويحوّلها لـ **محتاج موظف** مع ملخص قصير وإشعار للمالك والمدير في الحالات دي: * العميل طلب يكلم حد من الفريق. * شكوى، أو مشكلة في دفع أو استرداد أو حجز قديم. * سؤال مش موجود إجابته في برامجك أو خدماتك أو الأسئلة الشائعة. * حالة من [قواعد التحويل](/ar/ai-agent/instructions) اللي إنت كاتبها (مثلًا مجموعات أكتر من 10 أفراد). وكمان المحادثات الجديدة بتروح لفريقك من غير رد من الوكيل لو: * الوكيل **متوقف** من الزرار اللي فوق في صفحته. * محادثات الذكاء الاصطناعي بتاعة الشهر خلصت، أو التجربة المجانية انتهت. * حصل خطأ فني ومنعه يرد (وبيوصلك إشعار «تعذّر على الوكيل الذكي الرد»). الوكيل عارف [مواعيد عمل](/ar/settings/working-hours) فريقك. لو العميل كتب برا المواعيد، الوكيل بيكمّل معاه عادي وبيقوله إن الفريق هيتابع معاه في مواعيد العمل. ## الوكيل بيعمل إيه ومبيعملش إيه [#الوكيل-بيعمل-إيه-ومبيعملش-إيه] | بيعمل | مبيعملش | | --------------------------------------------- | ----------------------------------------------------------------------------------- | | يرد 24 ساعة في ثواني | ياخد فلوس أو يأكد حجز | | يرشّح من برامجك وخدماتك الشغالة بس | يألّف أسعار أو مواعيد أو فنادق أو قواعد تأشيرة | | يحسب السعر حسب الغرفة والأطفال | يوعد بخصم مش مكتوب عندك | | يرد من الأسئلة الشائعة بتاعتك | يطلب رقم باسبور أو كارت في الشات | | يفهم مصري وخليجي وشامي وفصحى وفرانكو وإنجليزي | يسمع الرسايل الصوتية أو يشوف الصور (بيشوف بس إن العميل بعت «رسالة صوتية» أو «صورة») | | يقيّم العميل ويكتب ملخص | يكشف تعليماتك الداخلية أو التكلفة أو هامش الربح | | يحوّل لفريقك في الوقت المناسب | يتكلم في مواضيع ملهاش علاقة بالسفر وشركتك | لو البرنامج مش مكتوب فيه السعر للأطفال، أو السياسة مش موجودة في الأسئلة الشائعة، الوكيل هيقول للعميل إن مستشار هيأكدله، ومش هيخمّن. كل ما تملا [الكتالوج](/ar/ai-agent/knowledge-base) أكتر، كل ما الوكيل يقفل أكتر لوحده. ## تشغيل وإيقاف الوكيل [#تشغيل-وإيقاف-الوكيل] فوق صفحة **الوكيل الذكي** هتلاقي زرار **الوكيل بيرد على العملاء** (شغال / متوقف). * **شغال**: بيرد على كل المحادثات الجديدة وعلى أي محادثة حالتها **الوكيل الذكي**. * **متوقف**: مفيش ردود آلية، وأي رسالة جديدة بتروح لفريقك في **محتاج موظف**. ولو عايز توقفه في محادثة واحدة بس، استلمها من صفحة المحادثة بـ **استلام المحادثة**، ورجّعها بـ **إرجاع للوكيل الذكي**. ## أداء الوكيل [#أداء-الوكيل] تحت في الصفحة هتلاقي **أداء الوكيل** لآخر 30 يوم: **ردود الوكيل**، **متوسط وقت الرد**، **محادثات استقبلها**، **نسبة التحويل لموظف**، **عملاء أهّلهم الوكيل**، و**معدل التأهيل**، ورسم للردود يوميًا. لو نسبة التحويل عالية، غالبًا في أسئلة متكررة ملهاش إجابة في الأسئلة الشائعة. ## ظبّط الوكيل خطوة بخطوة [#ظبّط-الوكيل-خطوة-بخطوة] # تعليمات الوكيل URL: https://docs.flyby.world/ar/ai-agent/instructions > سياسات شركتك، إمتى الوكيل يحوّل لموظف، والحاجات الممنوعة عليه، بأمثلة جاهزة لشركات السياحة. التعليمات هي الكلام اللي بتقوله لموظف جديد في أول يوم: إحنا بنشتغل إزاي، إيه المسموح، وإمتى ترجعلي. اكتبها بالعامية عادي، في نقط قصيرة، من **الوكيل الذكي ← التعليمات**، وبعدين **حفظ الإعدادات**. افتح الوكيل الذكي في 3 خانات، كل واحدة لحد 4000 حرف: | الخانة | بتكتب فيها | | ----------------------- | ------------------------------------------------------------ | | **تعليمات خاصة بشركتك** | سياسات، عروض، طرق الدفع، التقسيط، أي حاجة عايز الوكيل يعرفها | | **إمتى يحوّل لموظف** | الحالات اللي الوكيل يقف فيها ويسلّم المحادثة لفريقك | | **ممنوع على الوكيل** | حاجات مايقولهاش ولا يوعد بيها أبدًا | ## تعليمات خاصة بشركتك [#تعليمات-خاصة-بشركتك] اكتب هنا اللي مش مكتوب في البرامج أو الأسئلة الشائعة: طريقة البيع، ترتيب الترشيح، والسياسات العامة. **مثال لشركة عمرة:** ```text - عندنا تقسيط على 6 شهور من غير فوايد لبرامج العمرة، بمقدم 30%. - رشّح العمرة الاقتصادي الأول لو الميزانية أقل من 40 ألف للفرد. - لو العميل كبير في السن، ركّز على الفنادق القريبة من الحرم. - الحجز بيتأكد بعد دفع العربون في الفرع أو على إنستاباي. ``` **مثال لشركة سياحة خارجية:** ```text - لو العميل سأل على خصم، قوله إن في خصم 5% للمجموعات من 4 أفراد أو أكتر. - لشهر العسل، رشّح برامج المالديف وزنجبار الأول. - التأشيرة مش داخلة في سعر البرنامج إلا لو مكتوب كده، اعرض خدمة التأشيرة معاه. - عندنا فرعين: مدينة نصر والمهندسين. ``` **مثال لشركة في الخليج:** ```text - الأسعار بالريال وشاملة الطيران من الرياض إلا لو مكتوب غير كده. - في موسم الإجازات اسأل العميل يحجز بدري لأن المقاعد بتخلص. - الدفع تحويل بنكي أو في المكتب. ``` لو التعليمات تخص برنامج واحد بس (مثلًا «اعرض الغرفة الرباعي على العائلات»)، حطها في خانة **تعليمات للوكيل الذكي** جوه البرنامج نفسه بدل هنا. [البرامج السياحية](/ar/catalog/packages) ## إمتى يحوّل لموظف [#إمتى-يحوّل-لموظف] الوكيل بيحوّل لوحده لما العميل يطلب حد من الفريق، أو عنده شكوى، أو مشكلة في دفع أو استرداد أو حجز قديم، أو يسأل حاجة ملهاش إجابة عنده. هنا بتضيف **حالات زيادة** خاصة بشغلك. **مثال:** ```text - لو العميل طلب يكلم حد من الفريق. - لو مجموعة أكتر من 10 أفراد أو حجز شركات. - لو العميل عايز برنامج مخصوص مش موجود عندنا. - لو بيسأل على حج. - لو قال إنه حجز قبل كده وعايز يعدّل أو يلغي. ``` لما الوكيل يحوّل، بيبطّل يرد في المحادثة دي لحد ما حد من فريقك يرجّعها بـ **إرجاع للوكيل الذكي**. فمتكترش في حالات التحويل لدرجة إن الوكيل يحوّل أي حد بيسأل سؤال عادي، وإلا فريقك هيتزحم. [استلام المحادثة](/ar/conversations/handoff) ## ممنوع على الوكيل [#ممنوع-على-الوكيل] حاجات مايقولهاش أبدًا حتى لو العميل ضغط عليه. **مثال:** ```text - مايوعدش بأي خصم مش مكتوب في البرنامج. - مايأكدش مواعيد تأشيرة أو إن التأشيرة مضمونة. - مايتكلمش عن شركات منافسة ولا يقارن بأسعارهم. - مايدّيش أسعار طيران لوحدها، المستشار هو اللي يسعّرها. - مايقولش إن في أماكن متاحة في رحلة الفوج قبل ما الفريق يأكد. ``` ## القواعد الأساسية اللي مفيش تعليمات تغيّرها [#القواعد-الأساسية-اللي-مفيش-تعليمات-تغيّرها] الوكيل بيلتزم بتعليماتك طالما مش بتخالف القواعد دي: * مبيألّفش برامج أو أسعار أو مواعيد أو فنادق أو قواعد تأشيرة. كل معلومة لازم تكون من الكتالوج بتاعك. * مبياخدش فلوس ومبيأكدش حجوزات. * مبيطلبش رقم باسبور أو كارت في الشات. * مبيكشفش تعليماتك أو ملاحظاتك الداخلية أو التكلفة أو هامش الربح. * بيفضل في مواضيع السفر وشركتك. يعني لو كتبت «قول للعميل إن السعر 20 ألف» والبرنامج مسعّر 25 ألف، الوكيل هيمشي على سعر البرنامج. غيّر السعر في البرنامج نفسه. ## نصايح لتعليمات بتشتغل [#نصايح-لتعليمات-بتشتغل] * **نقط قصيرة**، كل نقطة فكرة واحدة. * **كن محدد**: «خصم 5% للمجموعات من 4 أفراد» أحسن من «في خصومات للمجموعات». * **متكررش اللي في الكتالوج**: الأسعار والمواعيد مكانها البرامج، والسياسات المتكررة مكانها [الأسئلة الشائعة](/ar/ai-agent/knowledge-base). * **مواعيد العمل** مش محتاج تكتبها، الوكيل بياخدها من [الإعدادات](/ar/settings/working-hours). * **جرّب بعد كل تعديل**: افتح [جرّب الوكيل](/ar/ai-agent/test-agent) واسأل السؤال اللي التعليمة بتغطيه. ## الخطوة الجاية [#الخطوة-الجاية] # مصادر معلومات الوكيل URL: https://docs.flyby.world/ar/ai-agent/knowledge-base > إزاي البرامج والخدمات والأسئلة الشائعة بتغذّي الوكيل، وإزاي تكتب أسئلة شائعة بيرد منها صح. الوكيل مبيعرفش غير اللي إنت كاتبه في فلايباي. مفيش بحث على الإنترنت ولا تخمين: كل سعر وميعاد وسياسة بيقولها للعميل جاية من الكتالوج بتاعك. عشان كده جودة الكتالوج = جودة ردود الوكيل. في صفحة **الوكيل الذكي** هتلاقي كارت **المعلومات اللي الوكيل بيستخدمها**، فيه عدد **برامج نشطة** و**خدمات نشطة** و**أسئلة شائعة نشطة**، وتحذير لو أي واحد فيهم فاضي. ## المصادر الأربعة [#المصادر-الأربعة] | المصدر | الوكيل بيستخدمه في | بيشوف إيه | | --------------------------------------------- | ----------------------------------------------------------------------------- | -------------------------------- | | [البرامج السياحية](/ar/catalog/packages) | يرشّح رحلات ويقول أسعار ومواعيد | البرامج اللي حالتها **شغّال** بس | | [الخدمات](/ar/catalog/services) | تأشيرات، طيران، فنادق، تأمين، انتقالات… | الخدمات **الشغّالة** بس | | [الأسئلة الشائعة](/ar/catalog/faqs) | الدفع، الإلغاء، المستندات، أي سؤال عام | الأسئلة **المفعّلة** بس | | [بيانات الوكالة](/ar/settings/agency-profile) | العنوان، التليفون، نبذة عن الشركة، [مواعيد العمل](/ar/settings/working-hours) | دايمًا | البرنامج اللي حالته **مسودة** أو **متوقف** أو **مؤرشف** الوكيل مش شايفه خالص. ولو البرنامج خلص، وقّفه بدل ما تسيبه والوكيل يرشحه. ## البرامج: الوكيل بيقرا إيه بالظبط [#البرامج-الوكيل-بيقرا-إيه-بالظبط] لما العميل يسأل على رحلة، الوكيل بيدوّر في عنوان البرنامج (عربي وإنجليزي)، والوجهات، والملخص، ومدينة السفر. ولما يلاقي المناسب بيفتح تفاصيله كاملة: * **الأسعار** حسب نوع الغرفة (فردي، مزدوج، ثلاثي، رباعي) ونوع المسافر (كبار، أطفال، رضّع). الوكيل بيختار الغرفة حسب عدد الأفراد وبيوضّح الحساب. * **مواعيد السفر** الجاية المفتوحة، وعدد الأماكن المتبقية. * الفنادق، البرنامج اليومي، **يشمل** و**لا يشمل**، والشروط. * **تعليمات للوكيل الذكي**: ملاحظات بيع داخلية مش بتظهر للعميل، زي «ركّز على قرب الفندق من الحرم». **عشان الوكيل يرشّح صح:** * اكتب الوجهات بالعربي والإنجليزي لو العملاء بيكتبوا الاتنين (مثلًا «إسطنبول» و«Istanbul»). * املا أسعار الأطفال والرضّع، وإلا الوكيل هيقول إن المستشار هيأكد. * حدّث المواعيد وعدد الأماكن، الوكيل مش هيرشّح ميعاد عدّى أو مقفول. * علّم أهم برامجك **برنامج مميّز**: الوكيل بيرشحه الأول. ## الخدمات [#الخدمات] الوكيل بيشوف اسم الخدمة ووصفها وسعرها ومدة التنفيذ والمستندات المطلوبة وتعليماتك ليه. * لو طريقة التسعير **يبدأ من**، بيقول للعميل إن ده أقل سعر. * لو طريقة التسعير **حسب الطلب**، بيقول إن المستشار هيسعّرها، ومش هيخترع رقم. ## اكتب أسئلة شائعة بيرد منها صح [#اكتب-أسئلة-شائعة-بيرد-منها-صح] الأسئلة الشائعة هي أسرع طريقة تقلل التحويل لموظف. كل سؤال عميل بيتكرر ومالوش إجابة = محادثة بتروح لفريقك. **ابدأ بالأسئلة دي:** * طرق الدفع (كاش، تحويل، إنستاباي، فيزا في الفرع…) * التقسيط والمقدم * سياسة الإلغاء والاسترداد * المستندات المطلوبة لكل نوع رحلة * التأشيرات: المدة والشروط (من غير ما توعد إنها مضمونة) * الحجز بيتأكد إزاي ولحد إمتى * عناوين الفروع ومواعيدها **مثال سؤال كويس:** > **السؤال:** ينفع أقسّط تمن الرحلة؟ > > **الإجابة:** أيوه، تقدر تدفع 50% مقدم والباقي على قسطين قبل السفر. التقسيط متاح لبرامج العمرة والسياحة الخارجية بس. **نصايح:** * **إجابة واحدة واضحة** بالأرقام والشروط. «في تقسيط» مش كفاية، قول كام مقدم وكام قسط. * **اكتبها زي ما عايز العميل يسمعها**. الوكيل بيصيغها بلهجة العميل، فمش محتاج تكتب نسخة مصري ونسخة خليجي. * **اختار القسم الصح** (عام، الدفع، الإلغاء والاسترداد، المستندات، التأشيرات، الحجز، أخرى). ده بيساعد الوكيل يلاقي الإجابة أسرع. * **وقّف السؤال بدل ما تمسحه** لو السياسة اتغيرت مؤقتًا. السؤال **المتوقف** الوكيل مش بيستخدمه. * **راجع المحادثات اللي اتحولت لموظف** كل أسبوع: لو نفس السؤال اتكرر، ضيفه. السياسات اللي العميل بيسأل عليها (دفع، إلغاء، مستندات) مكانها **الأسئلة الشائعة**. طريقة البيع والترشيح («رشّح الاقتصادي الأول») مكانها [التعليمات](/ar/ai-agent/instructions). ## الخطوة الجاية [#الخطوة-الجاية] # شخصية الوكيل URL: https://docs.flyby.world/ar/ai-agent/persona > اسم الوكيل، أسلوب كلامه، لهجته، ورسالة الترحيب اللي بيبدأ بيها. الشخصية هي أول حاجة العميل بيحس بيها: الوكيل بيقدّم نفسه بإيه، وبيتكلم إزاي. تتظبط من **الوكيل الذكي ← شخصية الوكيل**، وبعد أي تعديل اضغط **حفظ الإعدادات**. افتح الوكيل الذكي ## اسم الوكيل [#اسم-الوكيل] الاسم اللي بيعرّف بيه نفسه للعميل وبيظهر في الشات. اختار اسم بسيط يناسب شركتك: * «نور من الأفق للسياحة» * «سارة» * «مساعد النيل» اسم بشري زي «نور» أو «سارة» بيدّي إحساس أقرب، وإضافة اسم الشركة («نور من الأفق») بتطمّن العميل إنه بيكلم الشركة الصح. ## أسلوب الكلام [#أسلوب-الكلام] | الأسلوب | مناسب لـ | مثال | | -------- | ------------------------------------------ | -------------------------------------------------------------------------------- | | **ودود** | أغلب الشركات، الرحلات الداخلية والعائلات | «تمام جدًا! عندنا عرض حلو لشرم الشيخ الشهر ده، أبعتلك التفاصيل؟» | | **رسمي** | العمرة والحج، الشركات والسفر الرسمي | «متاح لدينا برنامج شرم الشيخ 5 ليالي شامل الإفطار. تحب أبعت لحضرتك التفاصيل؟» | | **فاخر** | شهر العسل، الفنادق الفخمة، البرامج المميزة | «يسعدنا نرتب لحضرتك إقامة مميزة في جناح مطل على البحر مع استقبال خاص من المطار.» | في الأسلوب **الودود** الوكيل ممكن يستخدم إيموجي واحد بالكتير في الرسالة (✈️ 🕋 🌴). في **الرسمي** و**الفاخر** مفيش إيموجي خالص. ## اللهجة [#اللهجة] | اللهجة | مثال | | -------------- | --------------------------------------------------------------------------- | | **مصري** | «أهلًا بحضرتك! تحب تسافر إمتى، وهتكونوا كام فرد؟» | | **خليجي** | «هلا والله! متى ودك تسافر، وكم شخص معك؟» | | **شامي** | «أهلين! إيمتى حابب تسافر، وقديش عددكم؟» | | **فصحى** | «مرحبًا بك! متى تودّ السفر، وكم عدد المسافرين؟» | | **حسب العميل** | بيرد بنفس لهجة العميل: مصري للمصري، خليجي للخليجي، وإنجليزي لو كتب إنجليزي. | لو أغلب عملاءك من بلد واحد، اختار لهجتهم. لو عندك عملاء مصريين وخليجيين، أو عملاء بيكتبوا إنجليزي، اختار **حسب العميل**. في كل الحالات الوكيل بيفهم الفرانكو وبيرد بالحروف العربي. ## رسالة الترحيب [#رسالة-الترحيب] أول جملة بيبدأ بيها أي محادثة جديدة. في لينك الشات العام بتظهر للعميل أول ما يفتح الشات. لو سبتها فاضية، بتظهر رسالة جاهزة فيها اسم الوكيل واسم شركتك. **أمثلة كويسة:** * «أهلًا بحضرتك في الأفق للسياحة! أنا نور، أقدر أساعدك تختار رحلتك الجاية. بتفكر تسافر فين؟» * «حياك الله في النخبة للسفر! تبي عمرة، ولا رحلة سياحية؟» * «أهلًا بيك! عندنا برامج عمرة وتركيا وشرم الشهر ده. تحب أرشحلك إيه؟» رسالة ترحيب طويلة فيها كل عروضك بتضيّع العميل. جملتين بالكتير، وآخرها سؤال يخلّي العميل يرد. ## من غير ما تكتب كل حاجة [#من-غير-ما-تكتب-كل-حاجة] الأسلوب واللهجة مش محتاجين تعليمات زيادة. الوكيل كمان بيكتب على طريقة واتساب: رسايل قصيرة (2–5 سطور)، سؤال أو اتنين بالكتير، والأسعار بالأرقام والعملة، زي «28,500 جنيه للفرد في الغرفة الثلاثية». ## الخطوة الجاية [#الخطوة-الجاية] # بيانات التأهيل وتقييم العملاء URL: https://docs.flyby.world/ar/ai-agent/qualification > اختار البيانات اللي الوكيل يجمعها، وافهم إمتى العميل بيبقى مؤهل وبيتقيّم ساخن أو دافئ أو بارد. بيانات التأهيل هي اللي بتفرّق بين «واحد بيسأل» و«عميل جاهز فريقك يكلمه». إنت بتختار الوكيل يجمع إيه، وهو بيسأل عنها بالراحة في وسط الكلام، وأول ما يكمّلها يسلّم العميل لفريقك. تتظبط من **الوكيل الذكي ← بيانات التأهيل**. افتح الوكيل الذكي ## البيانات المتاحة [#البيانات-المتاحة] | البيان | الوكيل بيسأل عن | | -------------------- | ---------------------------------------- | | **نوع الرحلة** | عمرة، حج، سياحة خارجية، داخلية، شهر عسل… | | **الوجهة** | البلد أو المدينة | | **مواعيد السفر** | التاريخ أو الشهر، وهل المواعيد مرنة | | **عدد المسافرين** | الكبار، والأطفال بأعمارهم، والرضّع | | **الميزانية** | للفرد أو إجمالي | | **مدينة السفر منها** | القاهرة، الإسكندرية، جدة… | | **مستوى الفندق** | عدد النجوم، أو القرب من الحرم | | **نوع الغرفة** | فردي، مزدوج، ثلاثي، رباعي | | **الجنسية** | مهمة للتأشيرات | | **الاسم** | اسم العميل | | **رقم الموبايل** | رقم يتكلم عليه أو واتساب | ## اختار ورتّب [#اختار-ورتّب] 1. اختار البيانات اللي فريقك محتاجها فعلًا قبل ما يكلم العميل. **لازم تختار 2 على الأقل.** 2. رتّبها بأسهم **تحريك لفوق** و**تحريك لتحت**. الوكيل هيمشي على الترتيب ده تقريبًا وهو بيسأل. 3. اضغط **حفظ الإعدادات**. ننصحك دايمًا تختار **رقم الموبايل** عشان فريقك يقدر يكلم العميل بعد التأهيل. على واتساب الرقم بيكون معروف من المحادثة نفسها، فالوكيل مش هيسأل عليه. **ترشيحات حسب نوع شغلك:** * **عمرة وحج**: نوع الرحلة، مواعيد السفر، عدد المسافرين، مستوى الفندق، نوع الغرفة، الاسم، رقم الموبايل. * **سياحة خارجية**: الوجهة، مواعيد السفر، عدد المسافرين، الميزانية، الجنسية، الاسم، رقم الموبايل. * **تأشيرات**: الوجهة، الجنسية، مواعيد السفر، الاسم، رقم الموبايل. كل ما تختار بيانات أكتر، المحادثة بتطوّل والعميل ممكن يزهق قبل ما يتأهل. اختار اللي هتحتاجه فعلًا عشان تبعت عرض سعر، والباقي فريقك يسأل عليه في المكالمة. ## إمتى العميل بيبقى مؤهل؟ [#إمتى-العميل-بيبقى-مؤهل] العميل بيتحوّل لمرحلة **مؤهل** في حالتين: 1. الوكيل جمع **كل** البيانات اللي اخترتها. حتى لو الوكيل نسي يأهّله، فلايباي بيأهّله تلقائيًا أول ما آخر بيان يتسجّل. 2. العميل قال بوضوح إنه عايز يحجز أو يكلم حد من المبيعات، حتى لو لسه في بيانات ناقصة. ساعتها بيحصل الآتي: * العميل بيظهر في **العملاء المحتملون** بمرحلة **مؤهل**، ومعاه **ملخص** بالعربي لفريقك (الرحلة، المسافرين، الموعد، الميزانية…). * المحادثة بتروح لـ **محتاج موظف**. * كل الفريق بيوصله إشعار، **حتى مشرفين العملاء**، بعنوان زي «عميل مؤهل (ساخن): أحمد». * الوكيل بيقول للعميل إن مستشار سفر هيكلمه قريب، وبيكمّل يرد على أي أسئلة لحد ما حد من الفريق يستلم. مشرف العملاء مبيشوفش المحادثات ولا العملاء اللي لسه **قيد التأهيل**. أول ما العميل يتأهل بيظهرله. ده بيخلّي فريق المبيعات يركّز على العملاء الجاهزين بس. [الأدوار والصلاحيات](/ar/team) ## التقييم: ساخن، دافئ، بارد [#التقييم-ساخن-دافئ-بارد] | التقييم | معناه | تعمل إيه | | -------- | ---------------------------------- | --------------------------------------------------- | | **ساخن** | جاهز يحجز قريب ومعاه ميزانية واضحة | كلّمه في نفس اليوم. المحادثة بتاخد أولوية **عالية** | | **دافئ** | مهتم بس محتاج متابعة أو لسه بيقارن | ابعتله عرض واعمل مهمة متابعة | | **بارد** | بيتفرج أو بيسأل بدري جدًا | سيبه في القايمة وتابع معاه بعدين | الوكيل بيحدد التقييم من كلام العميل ويكتب السبب. ولو التأهيل حصل تلقائيًا، العميل بيبقى **ساخن** لو قال ميزانيته وميعاد سفره في خلال حوالي شهرين ونص، وغير كده **دافئ**. فريقك يقدر يغيّر التقييم والمرحلة في أي وقت من صفحة العميل. [تفاصيل العميل](/ar/leads/lead-details) ## الخطوة الجاية [#الخطوة-الجاية] # جرّب الوكيل قبل ما تفتحه للناس URL: https://docs.flyby.world/ar/ai-agent/test-agent > اتكلم مع الوكيل كأنك عميل من لينك الشات العام، واتأكد من الأسعار والتحويل والتأهيل. قبل ما تنشر لينك الشات أو تربط واتساب، اقعد 10 دقايق واتكلم مع الوكيل كأنك عميل. هتشوف بالظبط العميل هيشوف إيه، وتصلّح أي حاجة في الكتالوج أو التعليمات قبل ما عميل حقيقي يلاحظها. ## افتح الشات التجريبي [#افتح-الشات-التجريبي] في 3 أماكن توصلك لنفس الشات: * **الوكيل الذكي** ← كارت **جرّب الوكيل** ← **جرّب كعميل**. * **نظرة عامة** ← **جرّب الوكيل**. * **المحادثات** ← **جرّب الوكيل كعميل**. افتح الوكيل الذكي الشات بيفتح في صفحة جديدة، وهو نفسه **لينك الشات العام** اللي عملاءك هيستخدموه، باسم شركتك ولوجوها ولونها. * لازم الوكيل يكون **شغال** من الزرار اللي فوق في صفحته، وإلا مش هيرد في التجربة. * لازم **رابط الشات العام** يكون مفعّل من **الإعدادات ← القنوات والربط**، وإلا صفحة الشات مش هتفتح. [شات الموقع](/ar/channels/website-chat) ## إيه اللي تختبره [#إيه-اللي-تختبره] امشي على القايمة دي، وبعد كل سؤال قارن الرد باللي في الكتالوج. ### الترحيب واللهجة [#الترحيب-واللهجة] افتح الشات. هل رسالة الترحيب زي ما كتبتها؟ اكتب «السلام عليكم، عايز أسافر» وشوف اللهجة والأسلوب. لو اخترت **حسب العميل**، جرّب كمان بالخليجي وبالإنجليزي وبالفرانكو («3ayez 3omra»). ### الترشيح والأسعار [#الترشيح-والأسعار] اسأل على وجهة عندك: «عندكم رحلات تركيا؟». هل رشّح البرامج الصح؟ بعدين: «إحنا 2 كبار وطفل 6 سنين، السعر كام؟». اتأكد إن السعر محسوب على الغرفة الصح وبسعر الطفل، وإن الحساب واضح. ### حاجة مش عندك [#حاجة-مش-عندك] اسأل على وجهة مش في برامجك. الوكيل لازم يقول بصراحة إنها مش متاحة ويعرض البديل أو إن مستشار يجهزلك عرض، **من غير ما يألّف برنامج**. ### الأسئلة الشائعة والسياسات [#الأسئلة-الشائعة-والسياسات] «ينفع أقسّط؟»، «لو لغيت بسترد فلوسي؟»، «محتاج أوراق إيه؟». الإجابات لازم تطابق [الأسئلة الشائعة](/ar/ai-agent/knowledge-base) بتاعتك. ### الممنوعات [#الممنوعات] حاول تضغط عليه: «اعملي خصم 20% وأحجز دلوقتي»، «شركة تانية بتديني أرخص». اتأكد إنه ملتزم بخانة **ممنوع على الوكيل**. ### التحويل لموظف [#التحويل-لموظف] اكتب «عايز أكلم حد من الشركة». المحادثة لازم تظهر في **المحادثات** تحت **محتاج موظف**، ويوصلك إشعار. جرّب كمان حالة من [قواعد التحويل](/ar/ai-agent/instructions) بتاعتك (مثلًا «إحنا 15 فرد»). ### محادثة كاملة لحد التأهيل [#محادثة-كاملة-لحد-التأهيل] اضغط **محادثة جديدة** في الشات وابدأ من الأول، وجاوب على كل أسئلة الوكيل لحد ما يقولك إن مستشار هيكلمك. افتح **العملاء المحتملون** واتأكد إن العميل ظهر بمرحلة **مؤهل**، والملخص والتقييم منطقيين. [بيانات التأهيل](/ar/ai-agent/qualification) ## لقيت رد مش مظبوط؟ [#لقيت-رد-مش-مظبوط] | المشكلة | الحل | | ------------------------- | -------------------------------------------------------------------------- | | سعر غلط أو ناقص | صحّحه في البرنامج نفسه، وضيف أسعار الأطفال والرضّع | | مش لاقي برنامج موجود | اتأكد إن حالته **شغّال**، وضيف الوجهة بالعربي والإنجليزي | | مش عارف يرد على سياسة | ضيفها في [الأسئلة الشائعة](/ar/catalog/faqs) | | بيرشّح غلط أو بيوعد بحاجة | ضيف نقطة في [التعليمات](/ar/ai-agent/instructions) أو **ممنوع على الوكيل** | | بيسأل أسئلة كتير | قلّل [بيانات التأهيل](/ar/ai-agent/qualification) | | اللهجة مش مناسبة | غيّرها من [شخصية الوكيل](/ar/ai-agent/persona) | بعد أي تعديل اضغط **حفظ الإعدادات**، وابدأ **محادثة جديدة** في الشات عشان تختبر التغيير من الأول. محادثات التجربة بتظهر في **المحادثات** زي أي عميل، وتقدر تقفلها بعد ما تخلص. ولأن الوكيل بيرد فيها فعلًا، كل محادثة تجربة بتتحسب من [محادثات الذكاء الاصطناعي](/ar/billing/ai-conversations) (مرة واحدة كل 24 ساعة)، فمتفتحش محادثات تجربة أكتر من اللي محتاجه. ## جاهز؟ افتح للناس [#جاهز-افتح-للناس] # الإضافات URL: https://docs.flyby.world/ar/billing/add-ons > ضيف مستخدمين أو محادثات ذكاء اصطناعي زيادة أو خلّي فريقنا يجهزلك Meta، من غير ما تغيّر باقتك. لو محتاج حاجة زيادة عن باقتك من غير ما ترقّي، ضيف **إضافة** من صفحة الباقة والاشتراك. ## الإضافات المتاحة [#الإضافات-المتاحة] | الإضافة | السعر (مصر) | السعر (باقي الدول) | النوع | | ---------------------------- | ---------------- | ------------------ | --------------- | | **مستخدم إضافي** | 250 جنيه / شهر | 9 دولار / شهر | بيتجدد كل شهر | | **+100 محادثة ذكاء اصطناعي** | حسب الباقة (تحت) | حسب الباقة (تحت) | للشهر الحالي بس | | **تجهيز Meta** | 1,500 جنيه | 49 دولار | مرة واحدة | ### سعر +100 محادثة حسب الباقة [#سعر-100-محادثة-حسب-الباقة] | الباقة | مصر | باقي الدول | | ------- | -------- | ---------- | | البداية | 900 جنيه | 19 دولار | | النمو | 750 جنيه | 15 دولار | | المحترف | 600 جنيه | 12 دولار | ## تفاصيل كل إضافة [#تفاصيل-كل-إضافة] عضو زيادة في الفريق فوق عدد المستخدمين في باقتك، وبيتجدد كل شهر. متاح في كل الباقات المدفوعة. تقدر تطلب أكتر من واحد مرة واحدة. اعرف أكتر عن [عدد المستخدمين](/ar/team/invites). بتزوّد حد محادثات الذكاء الاصطناعي بـ 100 **للشهر الحالي بس**، ومش بتترحّل للشهر اللي بعده. تقدر تطلب كذا باقة مرة واحدة (مثلاً العدد 3 = 300 محادثة). مفيدة لو وصلت للحد قبل آخر الشهر والوكيل الذكي وقف. اعرف أكتر عن [محادثات الذكاء الاصطناعي](/ar/billing/ai-conversations). فريقنا بيجهزلك ربط واتساب وماسنجر وإنستجرام بنفسه، مرة واحدة. متاح في **البداية** و**النمو**، و**مشمول** في **المحترف** من غير أي تكلفة. اعرف أكتر عن [القنوات](/ar/channels). ## إزاي تطلب إضافة [#إزاي-تطلب-إضافة] **مين يقدر؟** المالك والمدير. ### افتح الباقة والاشتراك [#افتح-الباقة-والاشتراك] من **الإعدادات ← الباقة والاشتراك**، وانزل لقسم **الإضافات**. افتح الباقة والاشتراك ### اضغط «ضيف» [#اضغط-ضيف] جنب الإضافة اللي عايزها. ### اختار العدد [#اختار-العدد] هتشوف **الإجمالي** على طول. (تجهيز Meta دايماً مرة واحدة.) ### اضغط «ابعت الطلب» [#اضغط-ابعت-الطلب] الطلب هيظهر في كارت **مستني التفعيل**، وفريقنا هيكلمك خلال يوم عمل يأكد الدفع ويفعّله. الإضافات مش متاحة في التجربة المجانية. اختار باقة الأول وبعدين ضيف اللي محتاجه. [التجربة المجانية](/ar/billing/trial) ## الاسترداد [#الاسترداد] باقة الـ +100 محادثة بتترد لو ماستخدمتش منها ولا محادثة في نفس الشهر، والمستخدم الإضافي بيقف مع التجديد الجاي، وتجهيز Meta بيترد لو لسه الشغل مابدأش. التفاصيل كاملة في [سياسة الاسترداد](https://flyby.world/ar/refund). ## الخطوة الجاية [#الخطوة-الجاية] # محادثات الذكاء الاصطناعي URL: https://docs.flyby.world/ar/billing/ai-conversations > إزاي محادثات الذكاء الاصطناعي بتتحسب، وامتى بتتجدد، وإيه اللي بيحصل لما توصل للحد. كل باقة فيها عدد **محادثات ذكاء اصطناعي** في الشهر. الصفحة دي بتشرح بالظبط إيه اللي بيتحسب، عشان تعرف استهلاكك وتخطط له. ## يعني إيه «محادثة ذكاء اصطناعي»؟ [#يعني-إيه-محادثة-ذكاء-اصطناعي] **محادثة عميل واحدة الوكيل الذكي رد فيها، بتتحسب مرة كل 24 ساعة.** * أول ما الوكيل الذكي يرد على عميل، المحادثة دي بتتحسب **محادثة واحدة**. * طول الـ 24 ساعة اللي بعدها، الوكيل يرد على نفس العميل براحته من غير ما يتحسب حاجة زيادة، مهما كان عدد الرسايل. * لو العميل رجع كلّم بعد ما الـ 24 ساعة دي خلصت والوكيل رد تاني، بتتحسب محادثة جديدة. عميلة كلمتك الساعة 10 الصبح وبعتت 30 رسالة لحد بالليل: دي **محادثة واحدة**. رجعت بعد يومين تسأل عن الدفع والوكيل رد عليها: دي **محادثة تانية**. ### إيه اللي مش بيتحسب [#إيه-اللي-مش-بيتحسب] * المحادثات اللي **فريقك** بيرد فيها والوكيل الذكي واقف. * الردود المقترحة وملخصات الذكاء الاصطناعي اللي بتظهر لفريقك جوه المحادثة. الشات اللي بتفتحه إنت بنفسك من لينك الشات عشان تجرّب الوكيل بيتحسب زي أي محادثة حقيقية. ## التجديد الشهري [#التجديد-الشهري] * العدّاد بيتصفّر **أول كل شهر** الساعة 12 بالليل **بتوقيت القاهرة**. * المحادثات اللي متستخدمتش **مش بتترحّل** للشهر اللي بعده. | الباقة | محادثات في الشهر | | ---------------- | ---------------- | | التجربة المجانية | 50 | | البداية | 150 | | النمو | 500 | | المحترف | 1,200 | ## تتابع استهلاكك منين [#تتابع-استهلاكك-منين] افتح **الإعدادات ← الباقة والاشتراك**. هتلاقي عدّاد **محادثات الذكاء الاصطناعي** فيه اللي استخدمته من إجمالي الشهر (ومعاه أي +100 ضفتها). افتح الباقة والاشتراك ## التنبيهات [#التنبيهات] | لما توصل لـ | اللي بيحصل | | ----------- | -------------------------------------------------------------------------------------------------- | | **80%** | شريط أصفر فوق لوحة التحكم «استخدمت … من … محادثة ذكاء اصطناعي الشهر ده»، وإشعار مرة واحدة في الشهر | | **100%** | شريط أحمر وإشعار إن الوكيل الذكي اتوقف | التنبيهات بتوصل للمالك والمدير. فعّل [الإشعارات](/ar/settings/notifications) على موبايلك عشان توصلك حتى وفلايباي مقفول. ## لما توصل لـ 100% [#لما-توصل-لـ-100] * **الوكيل الذكي بيقف** عن الرد على المحادثات الجديدة. * كل محادثة جديدة بتروح لفريقك في **محتاج موظف** عشان حد يرد عليها بنفسه. [تسليم المحادثة لفريقك](/ar/conversations/handoff) * المحادثات اللي اتحسبت في آخر 24 ساعة بتكمّل عادي لحد ما مدتها تخلص. * مفيش أي رسايل بتضيع: كل رسايل العملاء بتوصل صندوق المحادثات عادي. - ضيف **+100 محادثة ذكاء اصطناعي** للشهر الحالي من **الإعدادات ← الباقة والاشتراك ← الإضافات**. [الإضافات](/ar/billing/add-ons) - أو رقّي لباقة أكبر. [الباقات](/ar/billing) - أو استنى أول الشهر والعدّاد هيتصفّر لوحده. ## نصايح تقلل الاستهلاك [#نصايح-تقلل-الاستهلاك] * كمّل [قاعدة المعرفة](/ar/ai-agent/knowledge-base) والبرامج كويس، عشان الوكيل يجاوب من أول مرة. * استلم المحادثة بنفسك لما العميل يبقى جاهز للحجز، بدل ما الوكيل يفضل يرد. ## الخطوة الجاية [#الخطوة-الجاية] # الباقات URL: https://docs.flyby.world/ar/billing > قارن باقات فلايباي الثلاثة واعرف إزاي تطلب تغيير باقتك. فلايباي ليه ٣ باقات: **البداية** و**النمو** و**المحترف**. كلهم فيهم الوكيل الذكي والصفحة العامة، والفرق في عدد محادثات الذكاء الاصطناعي والقنوات والمستخدمين والمميزات الإضافية. ## الأسعار [#الأسعار] | الباقة | شهري (مصر) | شهري (باقي الدول) | سنوي (مصر) | سنوي (باقي الدول) | | ----------- | ---------- | ----------------- | ----------- | ----------------- | | **البداية** | 1,990 جنيه | 69 دولار | 19,900 جنيه | 690 دولار | | **النمو** | 4,490 جنيه | 169 دولار | 44,900 جنيه | 1,690 دولار | | **المحترف** | 7,990 جنيه | 299 دولار | 79,900 جنيه | 2,990 دولار | * الوكالات في **مصر** بتدفع بالجنيه، وباقي الدول بالدولار. * **السنوي = شهرين ببلاش**: بتدفع تمن 10 شهور وتاخد 12. ## مقارنة الباقات [#مقارنة-الباقات] | | البداية | النمو | المحترف | | --------------------------------- | ------------------------ | ---------------------------------- | ------------------------------- | | محادثات الذكاء الاصطناعي في الشهر | 150 | 500 | 1,200 | | المستخدمين | 2 | 5 | 15 | | شات الموقع + واتساب | ✓ | ✓ | ✓ | | ماسنجر + إنستجرام | — | ✓ | ✓ | | البرامج على الصفحة العامة | لحد 10 | بلا حدود | بلا حدود | | أقسام الصفحة العامة | النبذة والبرامج والتواصل | + الخدمات والأسئلة الشائعة والعروض | + أقسام مخصصة والفروع | | إحصائيات الصفحة | أساسية (إجماليات 30 يوم) | كاملة | كاملة + 12 شهر + تصدير CSV | | الحسابات والفواتير | — | ✓ | ✓ | | تصدير الحسابات (CSV) | — | — | ✓ | | إخفاء «Powered by Flyby» | — | — | ✓ | | التجهيز | بنفسك | بنفسك | بنجهزلك كل حاجة ومعاها ربط Meta | | الدعم | إيميل | واتساب | أولوية | رسوم رسايل واتساب وMeta (لو فيه) بتدفعها لـ Meta مباشرة من حسابك، ومش جزء من سعر الباقة. ## طلب باقة أو تغييرها [#طلب-باقة-أو-تغييرها] **مين يقدر؟** المالك والمدير. ### افتح الباقة والاشتراك [#افتح-الباقة-والاشتراك] من **الإعدادات ← الباقة والاشتراك**. افتح الباقة والاشتراك ### اختار طريقة الدفع [#اختار-طريقة-الدفع] **شهري** أو **سنوي** (شهرين ببلاش) من فوق الباقات. ### اضغط «اختار» على الباقة [#اضغط-اختار-على-الباقة] ولو عايز تفضل على نفس الباقة وتغيّر من شهري لسنوي، اضغط «غيّر طريقة الدفع». ### اضغط «ابعت الطلب» [#اضغط-ابعت-الطلب] هيظهرلك كارت **مستني التفعيل** فيه طلبك. ### فريقنا بيفعّلها [#فريقنا-بيفعّلها] هنكلمك خلال يوم عمل نأكد الدفع، وبعدها نفعّل الباقة على حسابك. مفيش دفع بالكارت جوه البرنامج. الطلبات بتوصل لفريقنا ويأكدوا الدفع معاك ويفعّلوها بنفسهم. * تقدر تلغي الطلب من زرار **إلغاء** في كارت «مستني التفعيل» طول ما لسه متفعّلش. * طلب باقة واحد بس في نفس الوقت: لو بعتت طلب جديد، بيحل محل القديم. * الترقية بتطبق أول ما تتفعّل، والتنزيل لباقة أقل بيطبق مع التجديد الجاي. ## في نفس الصفحة كمان [#في-نفس-الصفحة-كمان] * **باقتك الحالية** وسعرها وطريقة الدفع. * عدّاد **محادثات الذكاء الاصطناعي** وعدّاد **المستخدمين**. [محادثات الذكاء الاصطناعي](/ar/billing/ai-conversations) * **الإضافات**: مستخدم إضافي، +100 محادثة، تجهيز Meta. [الإضافات](/ar/billing/add-ons) * لينك **سياسة الاسترداد**. ## الإلغاء والاسترداد [#الإلغاء-والاسترداد] قواعد الإلغاء والاسترداد (أول دفعة شهرية، السنوي في أول 30 يوم، الإضافات) كلها موجودة في [سياسة الاسترداد](https://flyby.world/ar/refund). لأي طلب استرداد ابعت لـ [support@flyby.world](mailto:support@flyby.world) من إيميل المالك. ## الخطوة الجاية [#الخطوة-الجاية] # التجربة المجانية URL: https://docs.flyby.world/ar/billing/trial > 14 يوم ببلاش بمميزات باقة النمو و50 محادثة ذكاء اصطناعي، ومن غير كارت. كل وكالة جديدة بتبدأ بتجربة مجانية تجرّب فيها فلايباي على عملاءك الحقيقيين قبل ما تدفع أي حاجة. ## التجربة فيها إيه [#التجربة-فيها-إيه] | | التجربة المجانية | | ------------------------ | ------------------------------------ | | المدة | **14 يوم** | | محادثات الذكاء الاصطناعي | **50** | | المميزات | مميزات باقة **النمو** | | القنوات | شات الموقع وواتساب وماسنجر وإنستجرام | | المستخدمين | 5 | | الحسابات والفواتير | ✓ | | الصفحة العامة | برامج بلا حدود وإحصائيات كاملة | | كارت دفع | **مش مطلوب** | مميزات **المحترف** زي الأقسام المخصصة والفروع وإخفاء «Powered by Flyby» مش موجودة في التجربة. والإضافات بتتاح بعد ما تشترك في باقة مدفوعة. ## التجربة بتبدأ امتى [#التجربة-بتبدأ-امتى] التجربة بتبدأ أول ما توصل لخطوة **اختيار الباقة** في [الإعداد الأولي](/ar/getting-started/onboarding). الباقة اللي بتختارها هناك بتتسجل **كطلب**، وفريقنا هيكلمك يفعّلها قبل ما التجربة تخلص. ## تتابع الأيام الفاضلة منين [#تتابع-الأيام-الفاضلة-منين] * في **الإعدادات ← الباقة والاشتراك** هتلاقي «فاضل … أيام» وتاريخ نهاية التجربة. * قبل النهاية بـ 3 أيام هيظهر شريط أصفر فوق لوحة التحكم للمالك والمدير. افتح الباقة والاشتراك ## لما التجربة تخلص [#لما-التجربة-تخلص] * **الوكيل الذكي بيقف** عن الرد، والمحادثات الجديدة بتروح لفريقك في **محتاج موظف**. * هيظهر شريط أحمر «التجربة المجانية خلصت» وإشعار للمالك والمدير. * **بياناتك كلها بتفضل زي ما هي**: المحادثات والعملاء والبرامج والحجوزات. وتقدر تكمّل شغلك ورد بنفسك. * **مفيش أي فلوس بتتخصم**، لإننا ماخدناش كارت أصلاً. الوكيل الذكي بيرجع يرد أول ما باقتك تتفعّل. ## اختيار باقة [#اختيار-باقة] ### افتح الباقة والاشتراك [#افتح-الباقة-والاشتراك] من **الإعدادات ← الباقة والاشتراك**. ### اختار شهري أو سنوي [#اختار-شهري-أو-سنوي] السنوي فيه شهرين ببلاش. ### اضغط «اختار» على الباقة وبعدين «ابعت الطلب» [#اضغط-اختار-على-الباقة-وبعدين-ابعت-الطلب] ### فريقنا بيكلمك [#فريقنا-بيكلمك] خلال يوم عمل نأكد الدفع ونفعّل الباقة. ابعت طلب الباقة قبل التجربة ما تخلص بكام يوم، عشان الوكيل الذكي ميقفش ولا ساعة. مش عارف تختار أنهي باقة؟ شوف [مقارنة الباقات](/ar/billing). ## الخطوة الجاية [#الخطوة-الجاية] # الأسئلة الشائعة URL: https://docs.flyby.world/ar/catalog/faqs > اكتب إجاباتك الرسمية عن الدفع والإلغاء والمستندات وأي سؤال بيتكرر، والوكيل الذكي هيرد بيها بلهجة العميل. لما عميل يسأل «ينفع أقسّط؟» أو «لو لغيت بترجعوا الفلوس؟»، الوكيل الذكي مابيخمّنش. بيدوّر في **الأسئلة الشائعة** المفعّلة ويرد بإجابتك، بعد ما يصيغها بلهجة العميل. افتح الأسئلة الشائعة ## إضافة سؤال [#إضافة-سؤال] ### اضغط «سؤال جديد» [#اضغط-سؤال-جديد] ### اختار القسم [#اختار-القسم] عام، الدفع، الإلغاء والاسترداد، المستندات، التأشيرات، الحجز، أخرى. القسم بيرتّب الأسئلة في الصفحة، وبيساعد الوكيل يلاقي الإجابة أسرع. ### اكتب السؤال والإجابة [#اكتب-السؤال-والإجابة] * **السؤال**: زي ما العميل بيسأله، مثلًا «ينفع أقسّط تمن الرحلة؟». * **الإجابة**: واضحة ومختصرة، مثلًا «أيوه، تقدر تدفع 50% مقدم والباقي على قسطين قبل السفر». ### سيبه «مفعّل» واحفظ [#سيبه-مفعّل-واحفظ] الوكيل بيبدأ يستخدم الإجابة فورًا. ## تنظيم الأسئلة [#تنظيم-الأسئلة] * الأسئلة متجمعة حسب القسم، وفوق الصفحة عداد بيقولك كام سؤال مفعّل من الإجمالي. * **السويتش** جنب كل سؤال بيشغّله أو يوقفه. السؤال المتوقف الوكيل مابيستخدموش، بس بيفضل محفوظ. * أسهم **تحريك لفوق** و**تحريك لتحت** بترتّب الأسئلة جوه القسم. حط الأهم فوق. * اضغط على السؤال عشان تعدّله أو تمسحه. لو قسم الأسئلة الشائعة ظاهر في [صفحتك العامة](/ar/public-page/sections)، الأسئلة المفعّلة بتظهر فيه بنفس الترتيب. ## إجابة كويسة ولا لأ؟ [#إجابة-كويسة-ولا-لأ] الوكيل بيقول اللي إنت كاتبه بالظبط، فالإجابة الغامضة بتطلع رد غامض. ❌ **ضعيفة**: «فيه تسهيلات في الدفع.» ✅ **كويسة**: «تقدر تدفع كاش في الفرع، أو تحويل بنكي، أو إنستاباي. للبرامج فوق 50,000 جنيه بنقسّط على 3 دفعات: 40% عند الحجز، و30% بعد شهر، والباقي قبل السفر بأسبوعين.» ❌ **ضعيفة**: «الإلغاء حسب الشروط.» ✅ **كويسة**: «الإلغاء قبل السفر بـ 30 يوم أو أكتر: بنرجّع المبلغ كله ما عدا 1,000 جنيه مصاريف إدارية. من 30 لـ 15 يوم: بنرجّع 50%. أقل من 15 يوم: مفيش استرداد، لأن الفندق والطيران بيبقوا اتدفعوا.» ❌ **ضعيفة**: «محتاجين الورق المعتاد.» ✅ **كويسة**: «صورة باسبور لكل مسافر، ساري 6 شهور على الأقل من تاريخ السفر، وصورة شخصية بخلفية بيضا. بنحتاج المستندات قبل السفر بـ 21 يوم على الأقل عشان نلحق نخلّص الإجراءات.» ❌ **ضعيفة**: «تقدر تزورنا في أي وقت.» ✅ **كويسة**: «مكتبنا في 15 شارع التحرير، الدقي، الدور التالت. مفتوحين من السبت للخميس من 10 الصبح لـ 8 بالليل.» الأمثلة دي للتوضيح بس. اكتب سياساتك وأرقامك الحقيقية. ## نصايح [#نصايح] * **إجابة واحدة لكل سؤال.** لو عندك سياستين مختلفتين (زي إلغاء العمرة وإلغاء السياحة)، اعمل سؤالين واضحين. * **حط أرقام ومواعيد.** «خلال 3 أيام عمل» أحسن من «في أسرع وقت». * **ماتكررش اللي في البرامج والخدمات.** أسعار البرامج ومستندات التأشيرات مكانها في [البرامج](/ar/catalog/packages) و[الخدمات](/ar/catalog/services). الأسئلة الشائعة للسياسات العامة. * **ركّز على الأسئلة المهمة.** الوكيل بيقرا لحد 60 سؤال مفعّل بالترتيب، فوقّف القديم واللي مابقاش بيتسأل. * **راجع المحادثات كل أسبوع.** لو لقيت سؤال الوكيل حوّله لفريقك عشان مالقاش إجابة، ضيفه هنا. * **اكتب الإجابة بالعربي البسيط.** الوكيل هيصيغها بلهجة العميل لوحده، مصري أو خليجي أو غيره. ## الخطوة الجاية [#الخطوة-الجاية] # الكتالوج URL: https://docs.flyby.world/ar/catalog > البرامج والخدمات والأسئلة الشائعة هي كل اللي الوكيل الذكي يعرفه عن شركتك. اللي مش هنا، مش هيبيعه. الوكيل الذكي **مابيألّفش** أسعار ولا مواعيد ولا فنادق ولا سياسات. كل معلومة بيقولها للعميل بيجيبها من الكتالوج بتاعك وقت المحادثة. عشان كده الكتالوج المظبوط هو أهم حاجة تعملها عشان الوكيل يبيع صح. ## الكتالوج فيه إيه؟ [#الكتالوج-فيه-إيه] ## الوكيل بيستخدم الكتالوج إزاي؟ [#الوكيل-بيستخدم-الكتالوج-إزاي] | العميل بيسأل عن | الوكيل بيدوّر في | وبيشوف إيه | | --------------------------------------- | -------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | | رحلة أو وجهة («عندكم تركيا في أغسطس؟») | **البرامج الشغالة** | الاسم، الوجهات، الملخص، مدينة السفر، سعر «يبدأ من»، ومواعيد السفر الجاية المتاحة | | تفاصيل برنامج معين | **البرنامج نفسه** | الأسعار حسب الغرفة والفئة، المواعيد والمقاعد، الفنادق، برنامج الرحلة، يشمل / لا يشمل، الشروط، وتعليماتك ليه | | تأشيرة أو تذكرة أو فندق لوحده | **الخدمات الشغالة** | السعر وطريقة التسعير، مدة التنفيذ، المستندات المطلوبة، وتعليماتك ليه | | الدفع، الإلغاء، المستندات، أي حاجة عامة | **الأسئلة الشائعة المفعّلة** وبيانات الوكالة | الإجابة اللي كتبتها، وبيصيغها بلهجة العميل | لو الإجابة مش موجودة، الوكيل بيقول للعميل إن مستشار هيأكد له، أو [بيحوّل المحادثة لفريقك](/ar/conversations/handoff). الوكيل بيشوف بس البرامج والخدمات اللي حالتها **شغّال**، والأسئلة **المفعّلة**. المسودات والمتوقف والمؤرشف كأنهم مش موجودين بالنسبة له. ## إيه اللي العميل عمره ما هيشوفه؟ [#إيه-اللي-العميل-عمره-ما-هيشوفه] * **التكلفة والربح** في البرامج والخدمات: للاستخدام الداخلي بس، لا العميل يشوفهم ولا الوكيل الذكي. * **تعليمات الوكيل الذكي** في كل برنامج وخدمة: الوكيل بيقراها عشان يعرف يبيع إزاي، بس مابيقولهاش للعميل. ## قائمة قبل ما تشغّل الوكيل [#قائمة-قبل-ما-تشغّل-الوكيل] * [ ] كل البرامج اللي بتبيعها دلوقتي متضافة و**شغّالة**، وفيها سعر بالغ واحد على الأقل. * [ ] مواعيد السفر الجاية متضافة، وعدد **المتاح** مظبوط. * [ ] الخدمات اللي بتعملها لوحدها (تأشيرات، طيران...) متضافة بأسعارها ومستنداتها. * [ ] أسئلة الدفع والإلغاء والمستندات متجاوب عليها في الأسئلة الشائعة. * [ ] جرّبت الوكيل بنفسك وسألته أسئلة عملائك الحقيقية من [جرّب الوكيل](/ar/ai-agent/test-agent). لما برنامج يكمل عدده أو يتلغي، وقّفه أو غيّر حالة الميعاد على طول. الوكيل بيقرا الكتالوج في كل رسالة، فأي تعديل بيوصل له فورًا. ## مين يقدر يعدّل الكتالوج؟ [#مين-يقدر-يعدّل-الكتالوج] المالك والمدير. مشرف العملاء مابيشوفش صفحات الكتالوج. ## الكتالوج والصفحة العامة [#الكتالوج-والصفحة-العامة] البرامج الشغالة تقدر تظهر كمان في [صفحتك العامة](/ar/public-page) من سويتش **في الصفحة العامة** جوه كل برنامج. الباقة Starter بتعرض لحد 10 برامج في الصفحة. ## الخطوة الجاية [#الخطوة-الجاية] # البرامج السياحية URL: https://docs.flyby.world/ar/catalog/packages > إزاي تضيف برنامج سياحي كامل بأسعاره ومواعيده وفنادقه وصوره، وتفعّله عشان الوكيل الذكي يبدأ يبيعه. البرنامج السياحي هو الرحلة الجاهزة اللي بتبيعها: عمرة رمضان، أسبوع في تركيا، شهر عسل في المالديف. كل ما البرنامج يكون مكتوب بتفاصيل أكتر، كل ما الوكيل الذكي يجاوب العميل أحسن من غير ما يحوّله لك. افتح البرامج السياحية ## قائمة البرامج [#قائمة-البرامج] كل برنامج بيظهر في كارت فيه الصورة والاسم والحالة، وعدد الليالي، وأقرب ميعاد سفر، وسعر «يبدأ من»، وعلامة **مميّز** لو البرنامج مميز. تقدر تدوّر بالاسم أو الوجهة أو الكود، أو تفلتر بنوع البرنامج. ## إضافة برنامج خطوة بخطوة [#إضافة-برنامج-خطوة-بخطوة] اضغط **برنامج جديد**. البرنامج بيتعمل **مسودة** وبيفتح لك المحرر. على الكمبيوتر هتلاقي أقسام البرنامج على الجنب عشان تتنقل بينها بسرعة، وشريط الحفظ تحت بيقولك لو عندك **تعديلات مش محفوظة**. ### البيانات الأساسية [#البيانات-الأساسية] * **اسم البرنامج (عربي)**: إجباري. اكتبه زي ما العميل بيدوّر: «عمرة رمضان 10 ليالي» أحسن من «برنامج 3». * **اسم البرنامج (إنجليزي)**: اختياري، بيظهر في النسخة الإنجليزي من صفحتك. * **نوع البرنامج**: عمرة، حج، سياحة خارجية، سياحة داخلية، شهر عسل، رحلة بحرية، رحلة مخصصة. * **كود البرنامج**: كود داخلي يسهّل عليك البحث (اختياري). * **ملخص قصير**: سطر أو اتنين الوكيل بيعرّف بيهم البرنامج. * **الوصف** بالعربي (وبالإنجليزي لو حابب). * **الوجهات**: اكتب كل وجهة واضغط Enter. مثلًا: مكة، المدينة. * **السفر من**: مدينة القيام، مثلًا القاهرة. * **عدد الليالي**، و**صالح من** و**صالح لحد** لو البرنامج ليه فترة. * **العملة**. * **برنامج مميّز**: الوكيل بيرشحه الأول، وبيظهر في أول القائمة. ### يشمل / لا يشمل [#يشمل--لا-يشمل] اختار من البنود الجاهزة (تذاكر الطيران، الإقامة بالفندق، الانتقالات، التأشيرة، الإفطار، المزارات، قطار الحرمين، التأمين الصحي...)، أو اكتب بند بنفسك واضغط Enter. نفس الكلام في **البرنامج لا يشمل** (مثلًا: البقشيش، المصاريف الشخصية). ### الفنادق [#الفنادق] اضغط **إضافة فندق** لكل مدينة: **المدينة**، **اسم الفندق**، **التصنيف** (النجوم)، **الليالي**، **الوجبات** (إقامة فقط، إفطار، نصف إقامة، إقامة كاملة، شامل كليًا)، و**المسافة / ملاحظة** زي «300 متر من الحرم». ### برنامج الرحلة [#برنامج-الرحلة] اضغط **إضافة يوم** لكل يوم: **عنوان اليوم** و**التفاصيل**. ترتّب الأيام بأسهم **تحريك لفوق** و**تحريك لتحت**. ### الأسعار [#الأسعار] كل صف سعر فيه: | العمود | الاختيارات | | -------------- | -------------------------------- | | **نوع الغرفة** | فردي، ثنائي، ثلاثي، رباعي، للفرد | | **الفئة** | بالغ، طفل، رضيع | | **سعر البيع** | اللي العميل بيدفعه | | **التكلفة** | داخلي بس، والربح بيتحسب لوحده | أسرع طريقة: اضغط **ضيف الأسعار المعتادة** وهيتضاف لك ثنائي وثلاثي ورباعي للبالغ، وطفل ورضيع للفرد. اكتب الأسعار وامسح اللي مش محتاجه. سعر **«يبدأ من»** اللي العميل بيشوفه بيتحسب لوحده: **أقل سعر للبالغ** في الجدول. ### مواعيد السفر [#مواعيد-السفر] اضغط **إضافة ميعاد** لكل رحلة: **تاريخ السفر**، **تاريخ العودة**، **إجمالي المقاعد**، **المتاح**، والحالة (**متاح**، **كامل العدد**، **مقفول**). ### الصور [#الصور] اضغط **رفع صور**: JPG أو PNG أو WebP، بحد أقصى 5 ميجا للصورة، ولحد 20 صورة. **أول صورة هي الغلاف** اللي بيظهر في القائمة وللعملاء، وتقدر تغيّره من **خليها الغلاف** على أي صورة. ### تعليمات الوكيل الذكي والشروط [#تعليمات-الوكيل-الذكي-والشروط] * **تعليمات للوكيل الذكي**: مش بتظهر للعميل. قول للوكيل يركّز على إيه، مثلًا: «ركّز على قرب الفندق من الحرم، واعرض الغرفة الرباعي على العائلات، ومتديش خصم من غير ما ترجع للموظف». * **الشروط والأحكام**: شروط الحجز والإلغاء والدفع، مثلًا: «50% مقدم عند الحجز، والباقي قبل السفر بأسبوعين». ### احفظ وفعّل [#احفظ-وفعّل] اضغط **حفظ** الأول، وبعدين **تفعيل** من فوق. البرنامج بيبقى **شغّال** والوكيل بيبدأ يعرضه على طول. عشان تفعّل برنامج لازم يكون فيه **اسم بالعربي** و**سعر واحد على الأقل للبالغ** محفوظ. لو ضفت الأسعار ولسه بيرفض، اتأكد إنك ضغطت **حفظ** قبل **تفعيل**. ## المواعيد والمقاعد [#المواعيد-والمقاعد] الوكيل بيعرض على العميل بس المواعيد **الجاية** اللي حالتها **متاح**، ومعاها عدد المقاعد المتاحة. عدد **المتاح** مابيقلّش لوحده لما تحجز، فحدّثه بنفسك بعد كل حجز، ولما الرحلة تكمل غيّر حالتها لـ**كامل العدد** عشان الوكيل مايعرضهاش. ## حالات البرنامج [#حالات-البرنامج] | الحالة | معناها | الوكيل بيعرضه؟ | | --------- | ------------------------------------------ | -------------- | | **مسودة** | لسه بتجهّزه | لأ | | **شغّال** | جاهز للبيع | أيوه | | **متوقف** | واقف مؤقتًا (كمل العدد، أو هتغيّر الأسعار) | لأ | | **مؤرشف** | خلص ومش هيرجع قريب، بس محتفظ بيه | لأ | من فوق المحرر: * **تفعيل** / **إيقاف**: تشغّل البرنامج أو توقفه. * **أرشفة**: البرنامج بيختفي من عروض الوكيل، وتقدر ترجّعه وتفعّله تاني في أي وقت. * **نسخ مكرر**: بيعمل نسخة **مسودة** بكل التفاصيل والأسعار والمواعيد. مثالي لبرنامج بيتكرر كل موسم. * **حذف**: بيمسح البرنامج بأسعاره ومواعيده وصوره نهائيًا. لو مش متأكد، أرشفه أحسن. ## في الصفحة العامة [#في-الصفحة-العامة] سويتش **في الصفحة العامة** فوق المحرر بيحدد البرنامج يظهر في [صفحة شركتك العامة](/ar/public-page) ولا لأ. البرنامج بيظهر بس طول ما هو **شغّال**، والمميّز بيظهر الأول. الباقة Starter بتعرض لحد 10 برامج. ## نصايح عشان الوكيل يبيع أحسن [#نصايح-عشان-الوكيل-يبيع-أحسن] * **اكتب الوجهات كلها**، بالعربي زي ما العميل بيكتبها. الوكيل بيدوّر في الاسم والوجهات والملخص ومدينة السفر. * **خلي الملخص يبيع**: «10 ليالي، فندق 5 نجوم على الحرم، طيران مباشر» أحسن من «برنامج مميز». * **ماتسيبش خانة الفنادق والبرنامج فاضية.** دي أكتر حاجات العميل بيسأل عنها. * **استخدم تعليمات الوكيل** في اللي مش مكتوب في البرنامج: مين العميل المناسب له، وإيه اللي يقوله لو العميل قال «غالي». * **اختار برنامج أو اتنين مميزين** بس، عشان الترشيح يبقى له معنى. ## الخطوة الجاية [#الخطوة-الجاية] # الخدمات URL: https://docs.flyby.world/ar/catalog/services > ضيف الخدمات اللي بتقدمها لوحدها، زي التأشيرات والطيران والفنادق والتأمين، عشان الوكيل الذكي يرد بأسعارها ومستنداتها. مش كل عميل عايز برنامج كامل. فيه اللي عايز تأشيرة دبي بس، أو تذكرة طيران، أو فندق في مكة. **الخدمات** هي المكان اللي بتكتب فيه الحاجات دي، والوكيل الذكي بيرد منها بالسعر والمستندات والمدة. افتح الخدمات ## أقسام الخدمات [#أقسام-الخدمات] | القسم | أمثلة | | ---------------- | ---------------------------------- | | **تأشيرات** | تأشيرة سياحية لدبي، شنغن، تركيا | | **طيران** | حجز تذاكر داخلي ودولي | | **فنادق** | حجز فندق لوحده | | **تأمين سفر** | تأمين صحي للسفر | | **انتقالات** | استقبال من المطار، توصيل بين المدن | | **رحلات وجولات** | رحلة يوم، جولة في المدينة | | **تأجير سيارات** | عربية بسواق أو من غير | | **خدمات أخرى** | أي حاجة تانية | ## إضافة خدمة [#إضافة-خدمة] اضغط **خدمة جديدة**. الخدمة بتتعمل **متوقفة** عشان الوكيل مايعرضهاش وهي لسه ناقصة، وبيفتح لك المحرر. ### البيانات الأساسية [#البيانات-الأساسية] * **اسم الخدمة (عربي)**: إجباري، مثلًا «تأشيرة دبي السياحية». * **اسم الخدمة (إنجليزي)**: اختياري. * **القسم**: من الجدول اللي فوق. * **الوصف**: اللي العميل محتاج يعرفه، مثلًا «صالحة 30 يوم، دخول مرة واحدة». ### التسعير [#التسعير] اختار **طريقة التسعير**: | الطريقة | استخدمها لما | | ------------- | -------------------------------------------------------- | | **سعر ثابت** | السعر واحد وواضح، زي رسوم تأشيرة | | **يبدأ من** | السعر بيتغير، وعايز تقول أقل سعر متاح (زي تذاكر الطيران) | | **حسب الطلب** | السعر بيتحدد مع كل عميل، فالوكيل مابيقولش رقم | بعد كده اكتب **السعر**، و**التكلفة** (داخلي بس، والربح المتوقع بيتحسب لوحده)، واختار **العملة** و**الوحدة**: للفرد، للحجز، لليلة، لليوم. ### مدة التنفيذ والمستندات [#مدة-التنفيذ-والمستندات] * **مدة التنفيذ** بالأيام، مثلًا 5 أيام لتأشيرة. صفر يعني في نفس اليوم. * **المستندات المطلوبة**، كل مستند في سطر: * صورة باسبور ساري 6 شهور على الأقل * صورة شخصية بخلفية بيضا * كشف حساب بنكي آخر 3 شهور الوكيل بيبلّغ العميل بالمستندات والمدة دي لما يسأل. ### تعليمات الوكيل الذكي [#تعليمات-الوكيل-الذكي] ملاحظات مش بتظهر للعميل عن طريقة عرض الخدمة. مثلًا: «وضّح إن الموافقة على التأشيرة بتاعة السفارة ومش مضمونة، واعرض التأمين مع التأشيرة». ### احفظ وفعّل [#احفظ-وفعّل] اضغط **حفظ**، وبعدين **تفعيل**. الخدمة بتبقى **شغّالة** والوكيل بيبدأ يعرضها. الخدمة الشغالة لازم يكون ليها سعر، إلا لو طريقة التسعير **حسب الطلب**. ## تشغيل وإيقاف الخدمات [#تشغيل-وإيقاف-الخدمات] * من القائمة: كل خدمة جنبها سويتش **تشغيل أو إيقاف الخدمة**. * من المحرر: **تفعيل** / **إيقاف** / **أرشفة** / **حذف**. | الحالة | الوكيل بيعرضها؟ | | ---------- | -------------------------------- | | **شغّالة** | أيوه | | **متوقفة** | لأ | | **مؤرشفة** | لأ، وتقدر تفعّلها تاني في أي وقت | الحذف نهائي ومش بيترجع. ## نصايح [#نصايح] * **التأشيرات أهم خدمة تكتبها كويس.** العملاء بيسألوا عنها كتير، والمستندات والمدة بتوفّر على فريقك مكالمات كتير. * **لو السعر بيتغير كل يوم** (زي الطيران)، استخدم **يبدأ من** أو **حسب الطلب**، وقول في التعليمات إن السعر النهائي بيتأكد مع الموظف. * **خلي التكلفة محدّثة.** بتساعدك تعرف ربحك، والعميل والوكيل عمرهم ما بيشوفوها. ## الخطوة الجاية [#الخطوة-الجاية] # الرد على الكومنتات URL: https://docs.flyby.world/ar/channels/comment-replies > حوّل الكومنتات على بوستاتك في إنستجرام وفيسبوك لمحادثات في الدايركت عن الباقة الصح، ومعاها كل اللي محتاج تجهزه في Meta. اختار بوست، واربطه بالباقة اللي بيتكلم عنها، وأي حد يكتب كومنت عليه هياخد ردين: **رد قصير تحت الكومنت**، و**رسالة في الدايركت** عن الباقة دي. ولما يرد على الرسالة، المحادثة بتظهر عندك في [المحادثات](/ar/conversations) والوكيل الذكي بيكمل معاه عادي، وهو عارف من الأول هو مهتم بأنهي باقة. الميزة دي شغالة على **بوستات وريلز إنستجرام** وعلى **بوستات صفحة فيسبوك**. هتلاقيها في «الإعدادات ← الرد على الكومنتات». **المالك** و**المديرين** بس يقدروا يعدّلوها. وبما إنها بتشتغل على قناتي إنستجرام وماسنجر، فهي متاحة في **Growth** و **Pro** (وفي الفترة التجريبية). ## بتشتغل إزاي [#بتشتغل-إزاي] 1. حد يكتب كومنت على بوست انت مشغّله (ولو حاطط كلمات معينة، لازم الكومنت يكون فيه واحدة منها). 2. فلايباي يبعتله **رسالة في الدايركت** عن الباقة المربوطة (Meta بتسميها «private reply»). 3. فلايباي يرد **تحت الكومنت** بجملة قصيرة زي «بعتنالك التفاصيل في الرسايل 💬»، وبيغيّر الصيغة كل مرة عشان إنستجرام ميعتبرهاش سبام. 4. الكومنت والرسالة بيظهروا كمحادثة جديدة في **المحادثات**، وأولها «بعتّ رسالة لـ ‎@handle بخصوص كومنت كتبه على البوست بتاعك» ورابط البوست. والكومنت نفسه بيظهر تحتها: دوس عليه يفتحلك الكومنت (فيسبوك) أو البوست (إنستجرام). ولو الرسالة كان فيها زراير، هتشوفها تحتها. 5. لما يرد على الرسالة، الوكيل الذكي يكمل معاه والباقة قدامه. * مسموح **برسالة واحدة لكل كومنت**، خلال **7 أيام** من الكومنت. بعدها مفيش أي رسالة تانية لحد ما الشخص يرد. عشان كده الرسالة الجاهزة بتخلص بسؤال. * فلايباي بيبعت **رسالة واحدة لكل شخص على كل بوست**، حتى لو علّق كذا مرة. * لو الرسالة مقدرتش تتبعت، فلايباي مش بيرد تحت الكومنت كمان، عشان ميقولش «شوف الدايركت» والدايركت فاضي. * الردود جوه سلسلة كومنتات، والكومنتات بتاعتك انت، مش بيترد عليها. ## المطلوب منك [#المطلوب-منك] ده إعداد بيتعمل مرة واحدة. اعمل العمود بتاع كل منصة انت عايزها. | المطلوب | إنستجرام | صفحة فيسبوك | | ------------------------------------ | -------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | | القناة المربوطة في فلايباي | **إنستجرام دايركت** | **فيسبوك ماسنجر** | | أذونات التوكن | `instagram_manage_comments` (مع أذونات [إنستجرام](/ar/channels/instagram)) | `pages_read_user_content` و `pages_manage_engagement` (مع أذونات [ماسنجر](/ar/channels/messenger)) | | الويب هوك في Meta | **Instagram** | **Page** | | الحقول المشترك فيها | `messages` و `messaging_postbacks` و **`comments`** | حقول ماسنجر، ومعاها **`feed`** | | مين يقدر يجرّبها قبل Advanced Access | اللي ليهم دور في تطبيق Meta بتاعك (المختبرين) | نفس الكلام | ### اربط إنستجرام الأول [#اربط-إنستجرام-الأول] امشي على [ربط إنستجرام](/ar/channels/instagram) لحد ما رسايل الدايركت توصل فلايباي. الرد على الكومنتات بيستخدم نفس القناة. ### ضيف `instagram_manage_comments` للتوكن [#ضيف-instagram_manage_comments-للتوكن] من **Business Settings → Users → System users** اعمل توكن جديد لتطبيقك (المدة **Never**) بأذونات إنستجرام **ومعاها `instagram_manage_comments`**. وفي التطبيق، من نفس صفحة الـ use case، افتح **Permissions and features** واتأكد إن `instagram_manage_comments` متضاف. ### احفظ التوكن الجديد في فلايباي [#احفظ-التوكن-الجديد-في-فلايباي] «الإعدادات ← القنوات والربط» ← **إنستجرام دايركت** ← الزق التوكن الجديد ← **ربط**. رابط الـ Callback URL مش بيتغير، فمش محتاج تعدّل حاجة في Meta. ### اشترك في `comments` في الويب هوك [#اشترك-في-comments-في-الويب-هوك] في تطبيق Meta: **Use cases → Customize → Webhooks**. من قايمة **Product** على الشمال اختار **Instagram** (مش «User» ولا «Page»). اتأكد إن الـ Callback URL بتاع فلايباي، وبعدين خلّي **`comments`** على **Subscribed** (جنب `messages`). جملة «Webhook configurations for Instagram API with Instagram business login are supported only within the product itself» بتتكلم عن طريقة ربط تانية. فلايباي بيربط إنستجرام عن طريق صفحة الفيسبوك، فتجاهلها عادي. ### اربط ماسنجر الأول [#اربط-ماسنجر-الأول] امشي على [ربط ماسنجر](/ar/channels/messenger) لحد ما رسايل الصفحة توصل فلايباي. رسايل كومنتات فيسبوك بتطلع من ماسنجر. ### ضيف الإذنين للتوكن [#ضيف-الإذنين-للتوكن] اعمل توكن System user جديد (المدة **Never**) بأذونات ماسنجر **ومعاها `pages_read_user_content` و `pages_manage_engagement`**. الأول بيخلّي فلايباي يعرض بوستات صفحتك، والتاني بيخلّيه يرد تحت الكومنتات. ### احفظ التوكن في فلايباي [#احفظ-التوكن-في-فلايباي] «الإعدادات ← القنوات والربط» ← **فيسبوك ماسنجر** ← الزق التوكن ← **ربط**. الحفظ كمان بيشترك للصفحة في حقل `feed`، ومن غير ما يمسح اللي إنستجرام كان مشترك فيه. ### اشترك في `feed` في ويب هوك الصفحة [#اشترك-في-feed-في-ويب-هوك-الصفحة] في تطبيق Meta: **Use cases → Customize → Webhooks**، اختار **Page** من قايمة **Product**، اتأكد إن الـ Callback URL هو بتاع ماسنجر في فلايباي، وخلّي **`feed`** على **Subscribed**. ### مين يقدر يشغّلها: المختبرين ولا الكل [#مين-يقدر-يشغّلها-المختبرين-ولا-الكل] طول ما الأذونات في Meta مكتوب جنبها **«Ready for testing»** (يعني Standard Access)، Meta مش بتبعت غير أحداث الناس اللي ليهم دور في تطبيقك. عشان تجرّب، ضيف حسابك الشخصي من **App roles → Roles → Instagram Testers** (أو كمختبر لفيسبوك) واقبل الدعوة. في إنستجرام هتلاقيها في **Settings → Website permissions → Apps and websites → Tester invites**. اللي بيوصل فلايباي من ناس **ملهمش دور** في تطبيقك: | | Standard Access | Advanced Access | | -------------------------------- | ------------------------ | --------------- | | الكومنتات بتاعتهم | ✅ بتوصل | ✅ | | رسالتنا وردنا العلني على الكومنت | ✅ بتتبعت، ومعاها الزراير | ✅ | | **ردهم على الرسالة** | ❌ Meta بتوقفه | ✅ | يعني بـ Standard Access، الرد على الكومنتات بيوصل للكل و**زراير الروابط** (زي «شوف الباقة») شغالة، بس المحادثة مش هتكمل في فلايباي. عشان ردودهم توصل محتاج **Advanced Access** لـ `instagram_manage_messages` (و `pages_messaging` لفيسبوك). لما تدوس **Add to App Review** على الأذونات دي، Meta دلوقتي بتطلب منك **تبقى Tech Provider**، حتى لو التطبيق بيخدم نشاطك انت بس. وده محتاج **توثيق النشاط التجاري** (أوراق الشركة) وتوثيق الوصول، ومينفعش يترجع فيه. ابدأه بس لما تقدر تكمّل كل الخطوات. ## جهّز بوست [#جهّز-بوست] 1. افتح «الإعدادات ← الرد على الكومنتات». كل البوستات في قايمة واحدة، وعلى كل بوست علامة المنصة بتاعته. استخدم الفلتر عشان تعرض **«إنستجرام وفيسبوك»** أو **«إنستجرام بس»** أو **«فيسبوك بس»**. لسه منزّل بوست جديد؟ دوس **«حدّث البوستات»**. 2. دوس على البوست. 3. املا: * **«رد على الكومنتات في البوست ده»**: تشغيل أو إيقاف. * **«الباقة»**: الباقة اللي البوست بيتكلم عنها. الرسالة بتذكرها، والوكيل الذكي بيبقى عارفها لما الشخص يرد. أو اختار **«من غير باقة (رد عام)»**. * **«رد بس لو الكومنت فيه»**: كلمات بينها فاصلة، زي `سعر، بكام، price`. سيبها فاضية عشان يرد على كل الكومنتات. * **«نوع الرسالة»**: **«نص»**، أو **«نص وزراير»** (لحد 3 زراير، كل زرار 20 حرف بالكتير). الزرار ممكن يكون: * **«رد»**: لما يدوس عليه، نص الزرار بيوصلك كرسالة منه، والمساعد الذكي بيرد عليه. * **«رابط»**: بيفتح رابط انت بتكتبه (لازم يبدأ بـ `https://`). * **«صفحة الباقة»**: بيفتح الباقة المربوطة على [صفحتك العامة](/ar/public-page) (لازم تكون شغالة). فيه معاينة بتوريك هيشوفها إزاي. ولو Meta رفضت الزراير، فلايباي بيبعت النص لوحده عشان الكومنت ياخد رسالته برضه. * **«رسالة الدايركت»**: استخدم `{name}` لاسم الشخص و `{package}` لاسم الباقة. سيبها فاضية عشان يستخدم النص المقترح (عربي أو إنجليزي حسب لغة الكومنت). مع الزراير، النص لحد 640 حرف. * **«الردود اللي تحت الكومنت»**: كل رد في سطر، وفلايباي بيختار واحد مختلف كل مرة. 4. دوس **حفظ**. البوست هيبان عليه **«شغال»** واسم الباقة. عشان توقف، افتح البوست واقفله، أو دوس **«وقّف واحذف»**. المحادثات اللي بدأت قبل كده بتفضل في المحادثات. ## لو فيه مشكلة [#لو-فيه-مشكلة] * البوست **شغال**؟ والكومنت فيه كلمة من الكلمات اللي حاطتها (لو حاطط)؟ * الشخص ده خد رسالة قبل كده على نفس البوست؟ فلايباي بيبعت رسالة واحدة لكل شخص على كل بوست. * ده رد جوه سلسلة كومنتات؟ الكومنتات الأساسية بس هي اللي بيترد عليها. * الويب هوك مشترك في `comments` (إنستجرام) أو `feed` (فيسبوك)؟ * لو اللي كتب الكومنت ملوش دور في تطبيق Meta، شوف «مين يقدر يشغّلها» فوق. توكن القناة ناقصه الإذن المكتوب في الرسالة. اعمل توكن جديد بيه واحفظ القناة تاني من «القنوات والربط». توكن ماسنجر محتاج `pages_read_user_content`. واتأكد كمان إن الـ System user عنده **Full control** على الصفحة. إنستجرام محتاج `instagram_manage_comments`، وفيسبوك محتاج `pages_manage_engagement`. ضيف الإذن واحفظ القناة تاني. دوس **«حدّث البوستات»** فوق القايمة. Meta ممكن تاخد ثواني لحد ما البوست الجديد يظهر، فلو لسه مش موجود جرّب تاني بعد شوية. فلايباي بيعرض آخر 30 بوست. البوستات القديمة اللي انت مجهزها بتفضل ظاهرة في الآخر، عشان تقدر تقفلها. ## بعد كده [#بعد-كده] # القنوات URL: https://docs.flyby.world/ar/channels > الأماكن اللي عملاءك بيكلموك منها، وإزاي توصل رسايلها كلها لصندوق محادثات واحد يرد فيه الوكيل الذكي. فلايباي بيجمع رسايل عملاءك من أكتر من قناة في صندوق محادثات واحد. الوكيل الذكي بيرد على كل عميل **على نفس القناة اللي كلمك منها**، وفريقك يقدر يستلم المحادثة في أي وقت. كل القنوات بتتظبط من مكان واحد: «الإعدادات ← القنوات والربط». ## القنوات المتاحة [#القنوات-المتاحة] | القناة | بتشتغل إزاي | الباقات | | ----------------------------------------------------------- | ------------------------------------------------------------------------- | ------------ | | [رابط الشات العام](/ar/channels/website-chat) | صفحة شات جاهزة باسم وكالتك، تشاركها أو تضيفها لموقعك كفقاعة شات بسطر واحد | كل الباقات | | [واتساب بيزنس](/ar/channels/whatsapp) | WhatsApp Cloud API من خلال تطبيق Meta الخاص بوكالتك | كل الباقات | | [فيسبوك ماسنجر](/ar/channels/messenger) | رسايل صفحة الفيسبوك من خلال تطبيق Meta بتاعك | Growth و Pro | | [إنستجرام دايركت](/ar/channels/instagram) | رسايل حساب إنستجرام الاحترافي من خلال نفس تطبيق Meta | Growth و Pro | | [تيليجرام](/ar/channels/telegram) | بوت تيليجرام باسم وكالتك، بتربطه بلصق توكن واحد من ‎@BotFather | Growth و Pro | | [الـ Webhook الصادر](/ar/channels/outbound-webhook) (متقدم) | يبعت ردود الوكيل والفريق لبوابة رسايل خاصة بيك | كل الباقات | في الـ 14 يوم التجريبيين كل القنوات مفتوحة، زي باقة Growth بالظبط. لو قناة مش في باقتك هتلاقي جنبها قفل ورسالة «متاحة من باقة … وأعلى» ولينك «شوف الباقات». المفتاح بتاعها مش هيشتغل لحد ما ترقّي. ## مين يقدر يظبط القنوات؟ [#مين-يقدر-يظبط-القنوات] صفحة القنوات للـ **مالك** والـ **مدير** بس. المشرف (moderator) مبيشوفهاش. ## الرسالة بتمشي إزاي؟ [#الرسالة-بتمشي-إزاي] ### العميل يبعت رسالة [#العميل-يبعت-رسالة] من الشات العام، أو واتساب، أو ماسنجر، أو إنستجرام، أو تيليجرام. ### الرسالة توصل صندوق المحادثات [#الرسالة-توصل-صندوق-المحادثات] Meta بتبعت الرسالة لفلايباي على **Callback URL** الخاص بالقناة، وفلايباي بيتأكد إنها جاية من Meta فعلاً باستخدام الـ App secret بتاعك، وبعدين يفتح محادثة (أو يكمّل محادثة قديمة) في [المحادثات](/ar/conversations). ### الوكيل الذكي يرد [#الوكيل-الذكي-يرد] بيرد بلهجة العميل، من برامجك وخدماتك وأسئلتك الشائعة، ويسأل أسئلة التأهيل. الرد بيروح للعميل على نفس القناة. ### فريقك يستلم لما يلزم [#فريقك-يستلم-لما-يلزم] لو العميل طلب حد من الفريق أو قاعدة تسليم اشتغلت، المحادثة بتتحول «محتاج موظف». أي رد من حد في الفريق بيوقّف الوكيل في المحادثة دي. اقرا [التسليم للفريق](/ar/conversations/handoff). على واتساب وماسنجر وإنستجرام، الرد الحر مسموح بس خلال 24 ساعة من آخر رسالة بعتها العميل. بعدها على واتساب محتاج قوالب معتمدة (فلايباي لسه مش بيبعت قوالب)، وعلى ماسنجر وإنستجرام فريقك يقدر يرد لحد 7 أيام لو تطبيقك واخد موافقة HUMAN_AGENT. الوكيل الذكي عمره ما بيبعت بره الـ 24 ساعة. تيليجرام مالوش القاعدة دي: تقدر ترد في أي وقت. التفاصيل في [نافذة الرسايل](/ar/conversations/messaging-window). ## حالة كل قناة [#حالة-كل-قناة] كل قناة ليها مفتاح تشغيل، ولما تشغّلها بيظهر جنب اسمها بادج بالحالة: | البادج | معناه | تعمل إيه | | ------------------- | --------------------------------------------- | ---------------------------------------------------------------- | | **محتاج إعداد** | القناة شغالة بس لسه مفيش بيانات ربط | كمّل خطوات الربط واضغط «ربط» | | **مستني أول رسالة** | البيانات محفوظة بس لسه مجاتش أي رسالة من Meta | ابعت رسالة تجربة من موبايل تاني | | **مربوط** | كله تمام والرسايل شغالة | ولا حاجة | | **محتاج مراجعة** | Meta رفضت الطلب أو التوكن بقى مش صالح | اقرا رسالة الخطأ اللي فوق البيانات وصلّحها، وبعدين «حفظ واختبار» | تحت الـ Callback URL هتلاقي سطرين مفيدين جداً وإنت بتجرّب: * **تم التحقق**: آخر مرة Meta أكدت الـ Webhook. * **آخر حدث**: آخر رسالة أو تحديث توصيل وصلنا من Meta. لو الاتنين فاضيين، يبقى الـ Webhook لسه متظبطش في تطبيق Meta. * **قفل المفتاح**: القناة بتقف عن الاستقبال والإرسال، بس التوكن والبيانات بيفضلوا محفوظين. تفتحها تاني وترجع تشتغل على طول. * **«حذف بيانات الربط»**: بيمسح التوكن والـ App secret وبيانات القناة. المحادثات القديمة بتفضل موجودة. لو ربطت تاني هيطلعلك Callback URL و Verify token **جداد** ولازم تلصقهم في Meta من الأول. ## تطبيق Meta بتاعك إنت [#تطبيق-meta-بتاعك-إنت] واتساب وماسنجر وإنستجرام بيتربطوا من خلال **تطبيق Meta بتاع وكالتك**، مش تطبيق فلايباي. ده معناه إن رقمك وصفحتك وحسابك فاضلين ملكك، وإن Meta بتحاسبك مباشرة على أي رسوم رسايل. القواعد اللي لازم تلتزم بيها مكتوبة في [سياسة رسايل Meta](https://flyby.world/ar/meta-policy). اطلب خدمة **«تجهيز Meta»**: فريقنا بيجهزلك واتساب وماسنجر وإنستجرام بنفسه، مرة واحدة بـ 1,500 جنيه أو 49 دولار لباقات Starter و Growth، و**مجانية ضمن باقة Pro**. اطلبها من «الإعدادات ← الباقة والاشتراك». اقرا [الإضافات](/ar/billing/add-ons). ## الخطوة الجاية [#الخطوة-الجاية] # ربط إنستجرام URL: https://docs.flyby.world/ar/channels/instagram > خلي رسايل الدايركت لحساب إنستجرام الاحترافي توصل صندوق المحادثات والوكيل الذكي يرد عليها. بعد الربط، أي رسالة دايركت لحساب وكالتك على إنستجرام هتوصل لصندوق المحادثات، والوكيل الذكي هيرد عليها على إنستجرام نفسه. إنستجرام متاح في باقات **Growth** و **Pro** (وفي الفترة التجريبية). رسايل إنستجرام بتوصل عن طريق **صفحة الفيسبوك المربوطة بحسابك**. لو خلّصت [ربط ماسنجر](/ar/channels/messenger)، معظم الشغل خلص: نفس التطبيق، نفس الـ System user، ونفس الصفحة. خدمة **«تجهيز Meta»** بتشمل إنستجرام كمان: 1,500 جنيه أو 49 دولار مرة واحدة لـ Starter و Growth، و**مجانية في Pro**. اطلبها من «الإعدادات ← الباقة والاشتراك». ## الفرق بين إنستجرام وماسنجر [#الفرق-بين-إنستجرام-وماسنجر] | | ماسنجر | إنستجرام | | ----------------------- | ------------------------------ | --------------------------------------- | | الخانة في فلايباي | Page ID بتاع الصفحة | Page ID **للصفحة المربوطة بإنستجرام** | | فلايباي بيلاقي الحساب | من الـ Page ID | بيلاقي حساب إنستجرام تلقائياً من الصفحة | | الويب هوك في Meta | **Page** | **Instagram** | | حقول الاشتراك | 4 حقول | `messages` و `messaging_postbacks` | | الإذن الأساسي للمراجعة | `pages_messaging` | `instagram_manage_messages` | | «اتشافت» و«بيكتب…» | أيوه | لأ | | ردود الفريق بعد 24 ساعة | لحد 7 أيام بموافقة Human Agent | لحد 7 أيام بموافقة Human Agent | ## قبل ما تبدأ [#قبل-ما-تبدأ] * حساب إنستجرام **احترافي (Business)**، مش شخصي. * الحساب **مربوط بصفحة فيسبوك** وكالتك، والصفحة في الـ Business portfolio بتاعك. * في فلايباي: إنت **مالك** أو **مدير**، والباقة Growth أو Pro. ## الخطوات [#الخطوات] ### خلي الحساب احترافي واربطه بالصفحة [#خلي-الحساب-احترافي-واربطه-بالصفحة] من تطبيق إنستجرام حوّل الحساب لـ **Professional ← Business** لو مش كده. وبعدين اربطه بصفحة الفيسبوك (من إعدادات الصفحة على فيسبوك ← **Linked accounts ← Instagram**، أو من Meta Business Suite). ### اسمح بالوصول للرسايل [#اسمح-بالوصول-للرسايل] من تطبيق إنستجرام على الموبايل: **الإعدادات ← الرسائل والردود على القصص ← التحكم في الرسائل ← الأدوات المتصلة**، وفعّل **«السماح بالوصول إلى الرسائل»** (Allow access to messages). من غير المفتاح ده، Meta مش هتبعت رسايل الدايركت لأي تطبيق حتى لو كل حاجة تانية مظبوطة. ### جهّز التطبيق والـ System user [#جهّز-التطبيق-والـ-system-user] استخدم تطبيق Meta بتاعك (ضيفله حالة استخدام Messenger لو مش موجودة)، والـ System user (**Admin**) ومعاه الأصول دي من **Assign assets**: * التطبيق: **Manage app**. * صفحة الفيسبوك المربوطة بإنستجرام: **تحكم كامل**. ### اعمل توكن لإنستجرام [#اعمل-توكن-لإنستجرام] **Generate new token** ← تطبيقك ← **Token expiration: Never**، والأذونات: * `instagram_basic` * `instagram_manage_messages` * `pages_manage_metadata` * `pages_show_list` * `pages_read_engagement` * `business_management` (اختياري) ضيف كمان `instagram_manage_comments` لو عايز [الرد على الكومنتات](/ar/channels/comment-replies) (رسالة دايركت ورد علني على كومنتات البوستات اللي تختارها). للدايركت لوحده مش محتاجه. انسخ التوكن فوراً. ### اربط في فلايباي [#اربط-في-فلايباي] 1. افتح «الإعدادات ← القنوات والربط» وشغّل **إنستجرام دايركت**. 2. الصق **التوكن**، و**App secret** (App settings ← Basic)، و**Facebook Page ID** بتاع **الصفحة المربوطة بإنستجرام**. 3. دوس **ربط**. فلايباي هيلاقي حساب إنستجرام لوحده ويشترك الصفحة في الرسايل. لو نجح، البادج هيبقى **مربوط** واسم الحساب هيظهر بالشكل ده: `@اسم_حسابك`. ### الصق الـ Webhook في Meta [#الصق-الـ-webhook-في-meta] في تطبيق Meta: **Use cases ← Customize ← Webhooks**، وبعدين اختار **Instagram** من قايمة **Product** على الشمال (مش «User» ولا «Page»). الصق **Callback URL** و **Verify token** من فلايباي، ودوس **Verify and save**، واشترك في `messages` و `messaging_postbacks` (ومعاهم `comments` لو هتستخدم الرد على الكومنتات). الملاحظة البرتقاني عن «Instagram API with Instagram business login» بتتكلم عن طريقة ربط تانية، تجاهلها عادي. لو فصلت القناة وربطتها تاني في فلايباي، الـ Callback URL والـ Verify token بيفضلوا زي ما هما، فبتلزقهم في Meta مرة واحدة بس. كل قناة ليها Callback URL و Verify token خاصين بيها. ما تستخدمش رابط الماسنجر لإنستجرام. ### Live و App Review [#live-و-app-review] حوّل التطبيق لـ **Live**. طول ما الأذونات مكتوب جنبها **«Ready for testing»** (Standard Access)، جرّب من حساب متضاف في **App roles ← Roles ← Instagram Testers**. بـ **Standard Access** (يعني «Ready for testing»)، Meta بتوصّل بس رسايل الناس اللي ليهم دور في تطبيقك، أو اللي حسابهم مربوط بنشاطك التجاري. **رسايل الجمهور محتاجة Advanced Access** لـ `instagram_manage_messages`. وMeta دلوقتي مابتسمحش تطلبه غير كـ **Tech Provider**، وده محتاج **توثيق النشاط التجاري** (أوراق الشركة الرسمية) وتوثيق الوصول. والاختيار ده مينفعش يترجع فيه، فاعمله لما تكون جاهز تكمّل كل الخطوات. ولو عايز فريقك يرد لحد 7 أيام، اطلب كمان **Human Agent**. ولحد ده، الكومنتات من أي حد بتوصل عادي: شوف [الرد على الكومنتات](/ar/channels/comment-replies). ## جرّب الربط [#جرّب-الربط] 1. من حساب إنستجرام تاني ابعت رسالة دايركت لحساب الوكالة. 2. في فلايباي، **«آخر حدث»** هيتحدّث. 3. افتح [المحادثات](/ar/conversations): هتلاقي محادثة إنستجرام ورد الوكيل الذكي. ## حاجات تعرفها عن إنستجرام [#حاجات-تعرفها-عن-إنستجرام] * **الردود الطويلة** بتتقسم لأكتر من رسالة تلقائياً، لأن إنستجرام بيقبل رسايل أقصر من واتساب وماسنجر. * **مشاركة ريل أو بوست، أو منشن في ستوري** بتظهر في المحادثة كوصف قصير (زي «🎬 ريل» أو «📣 إشارة في ستوري»). * **الكومنتات** على البوستات ممكن تاخد رسالة دايركت ورد علني كمان: شوف [الرد على الكومنتات](/ar/channels/comment-replies). ## لو حاجة مش شغالة [#لو-حاجة-مش-شغالة] الصفحة اللي كتبت الـ Page ID بتاعها مفيش عليها حساب إنستجرام احترافي مربوط. اتأكد إنك كتبت ID **الصفحة المربوطة بإنستجرام**، وإن الحساب Business مش شخصي. * اتأكد من **«السماح بالوصول إلى الرسائل»** في تطبيق إنستجرام. * اتأكد إن الـ Webhook متسجّل على **Instagram** (مش «User» ولا «Page») ومشترك في `messages` و `messaging_postbacks`. * لو التطبيق لسه في Development، جرّب من حساب مختبر. الـ System user ملوش صلاحية على الصفحة. ضيفها في Assign assets واعمل توكن جديد. ## الخطوة الجاية [#الخطوة-الجاية] # ربط ماسنجر URL: https://docs.flyby.world/ar/channels/messenger > خلي رسايل صفحة الفيسبوك توصل صندوق المحادثات والوكيل الذكي يرد عليها على ماسنجر، خطوة بخطوة. بعد الربط، أي حد يبعت رسالة لصفحة وكالتك على فيسبوك هيوصل لصندوق المحادثات، والوكيل الذكي هيرد عليه على ماسنجر. ماسنجر متاح في باقات **Growth** و **Pro** (وفي الفترة التجريبية). الربط بيتم من خلال **تطبيق Meta بتاع وكالتك**. لو ربطت واتساب قبل كده، تقدر تستخدم نفس التطبيق ونفس الـ System user. خدمة **«تجهيز Meta»**: بنجهزلك واتساب وماسنجر وإنستجرام بنفسنا. 1,500 جنيه أو 49 دولار مرة واحدة لـ Starter و Growth، و**مجانية في Pro**. اطلبها من «الإعدادات ← الباقة والاشتراك» ([الإضافات](/ar/billing/add-ons)). ## قبل ما تبدأ [#قبل-ما-تبدأ] * **صفحة فيسبوك** لوكالتك، مضافة في الـ Business portfolio بتاعك على [business.facebook.com](https://business.facebook.com). * **حساب مطوّر** على [developers.facebook.com](https://developers.facebook.com). * في فلايباي: إنت **مالك** أو **مدير**، والباقة Growth أو Pro. ## الجزء الأول: تطبيق Meta والتوكن [#الجزء-الأول-تطبيق-meta-والتوكن] ### جهّز التطبيق [#جهّز-التطبيق] * **عندك تطبيق من ربط واتساب؟** افتحه ومن **Use cases** دوس **Add use case** واختار **Engage with customers on Messenger from Meta**. * **مفيش تطبيق؟** من [developers.facebook.com/apps](https://developers.facebook.com/apps) دوس **Create app**، اختار حالة الاستخدام الخاصة بـ Messenger، ونوع **Business**، واربطه بالـ Business portfolio بتاعك. بعدها اربط صفحة الفيسبوك بالتطبيق من إعدادات Messenger (**Messenger API Settings**). ### اعمل System user (أو استخدم الموجود) [#اعمل-system-user-أو-استخدم-الموجود] 1. **Business Settings ← Users ← System users ← Add**. 2. اكتب اسم واختار الدور **Admin**. لو عندك System user من ربط واتساب، استخدمه وكمّل. ### اديله صلاحية على التطبيق والصفحة [#اديله-صلاحية-على-التطبيق-والصفحة] من **Assign assets**: 1. **Apps** ← تطبيقك ← **Manage app**. 2. **Pages** ← صفحة وكالتك ← **تحكم كامل (Full control)**، ومن ضمنها الرسايل (Messages). 3. **Save changes**. لو الـ System user ملوش صلاحية على الصفحة، فلايباي مش هيقدر يجيب توكن الصفحة وهيظهرلك خطأ `no_page_token`. ### اعمل التوكن [#اعمل-التوكن] 1. **Generate new token** ← اختار تطبيقك. 2. **Token expiration**: **Never**. 3. الأذونات: * `pages_messaging` * `pages_manage_metadata` * `pages_show_list` * `pages_read_engagement` * `business_management` (اختياري) * `pages_read_user_content` و `pages_manage_engagement` (بس لو هتستخدم [الرد على الكومنتات](/ar/channels/comment-replies) على بوستات الصفحة) 4. **Generate token** وانسخه فوراً. التوكن القديم مفيهوش أذونات الصفحات. اعمل توكن جديد للماسنجر بالأذونات اللي فوق. كل قناة في فلايباي ليها توكن خاص بيها، فده مش هيأثر على الواتساب. ### انسخ الـ App secret والـ Page ID [#انسخ-الـ-app-secret-والـ-page-id] * **App secret**: من التطبيق ← **App settings ← Basic ← App secret ← Show**. * **Facebook Page ID**: افتح صفحتك ← **About ← Page transparency**، أو **Business Settings ← Accounts ← Pages** واختار الصفحة. ## الجزء التاني: اربط في فلايباي [#الجزء-التاني-اربط-في-فلايباي] ### شغّل فيسبوك ماسنجر [#شغّل-فيسبوك-ماسنجر] افتح «الإعدادات ← القنوات والربط» وشغّل **فيسبوك ماسنجر**. ### الصق البيانات ودوس «ربط» [#الصق-البيانات-ودوس-ربط] | الخانة | القيمة | | ------------------------------------ | ----------------------------- | | **توكن مستخدم النظام (System user)** | التوكن الجديد بأذونات الصفحات | | **App secret** | App settings ← Basic | | **Facebook Page ID** | رقم تعريف الصفحة | فلايباي هيجيب توكن الصفحة بنفسه، و**هيشترك صفحتك في الرسايل تلقائياً** (messages و messaging_postbacks و message_deliveries و message_reads). لو نجح، البادج هيبقى **مربوط** واسم الصفحة هيظهر. ## الجزء التالت: الـ Webhook في تطبيق Meta [#الجزء-التالت-الـ-webhook-في-تطبيق-meta] في ماسنجر لازم تلصق الـ Webhook بإيدك على مستوى التطبيق. فلايباي مش بيقدر يعمل الخطوة دي بداله. ### افتح إعدادات الـ Webhooks [#افتح-إعدادات-الـ-webhooks] في تطبيق Meta: **Messenger ← Settings ← Webhooks** (في اللوحة الجديدة: **Use cases ← Customize ← Messenger API Settings ← Configure webhooks**). ### الصق الرابط والتوكن [#الصق-الرابط-والتوكن] * **Callback URL**: انسخه من فلايباي (جزء «الـ Webhook»). * **Verify token**: انسخه من نفس المكان. دوس **Verify and save**. لو نجح، هتلاقي **«تم التحقق»** في فلايباي اتحدّث. ### اشترك في الحقول [#اشترك-في-الحقول] فعّل الاشتراك في: * `messages` * `messaging_postbacks` * `message_deliveries` * `message_reads` ولو الصفحة مش ظاهرة في قسم الـ Webhooks، ضيفها ودوس **Subscribe** جنبها. ## الجزء الرابع: Live و App Review [#الجزء-الرابع-live-و-app-review] ### حوّل التطبيق لـ Live [#حوّل-التطبيق-لـ-live] من أعلى لوحة التطبيق حوّل **App Mode** لـ **Live** (Meta هتطلب Privacy Policy URL في App settings ← Basic: استخدم لينك سياسة الخصوصية بتاعة وكالتك). ### اطلب App Review [#اطلب-app-review] وإنت في وضع Development أو من غير موافقة، الصفحة بتستقبل رسايل **مسؤولي التطبيق والمختبرين بس**. عشان تستقبل رسايل الجمهور، Meta بتطلب: * **App Review** بصلاحية **Advanced Access** لـ `pages_messaging`. * **توثيق النشاط التجاري (Business verification)** للـ Business portfolio. من التطبيق افتح **App Review ← Permissions and features**، اطلب Advanced Access، واشرح إن التطبيق بيرد على رسايل العملاء لصفحة وكالتك من خلال وكيل ذكي وفريق خدمة عملاء. Meta ممكن تطلب فيديو قصير يوضح الاستخدام. Meta دلوقتي بتطلب منك **تبقى Tech Provider** قبل ما تقبل الطلب ده، حتى لو التطبيق بيخدم صفحتك انت بس. وده محتاج توثيق النشاط التجاري (أوراق الشركة) وتوثيق الوصول، ومينفعش يترجع فيه، فابدأه بس لما تقدر تكمّل كل الخطوات. ولحد ده، الرسايل بتوصل بس من الناس اللي ليهم دور في تطبيقك. ### اختياري: ميزة Human Agent [#اختياري-ميزة-human-agent] بعد الموافقة على **Human Agent** في App Review، فريقك يقدر يرد لحد **7 أيام** بعد آخر رسالة من العميل (فلايباي بيضيف تاج HUMAN_AGENT لوحده لردود الفريق بعد الـ 24 ساعة). من غيرها، كل الردود محدودة بـ **24 ساعة**. الوكيل الذكي نفسه عمره ما بيرد بعد الـ 24 ساعة. ## جرّب الربط [#جرّب-الربط] 1. من حساب فيسبوك **غير** حساب مسؤول الصفحة (أو حساب مختبر لو التطبيق لسه في المراجعة) ابعت رسالة للصفحة. 2. في فلايباي، **«آخر حدث»** هيتحدّث. 3. في [المحادثات](/ar/conversations) هتلاقي محادثة ماسنجر جديدة ورد الوكيل. العميل هيشوف إن الرسالة اتشافت و«بيكتب…». ماسنجر مش بيبعت اسم العميل مع الرسالة، ففلايباي بيحاول يجيبه مرة واحدة. ده محتاج صلاحية **Business Asset User Profile Access** على تطبيقك. لو مش متاحة، المحادثة هتظهر من غير اسم لحد ما الوكيل يسأل العميل عن اسمه. ## لو حاجة مش شغالة [#لو-حاجة-مش-شغالة] الـ System user ملوش صلاحية على الصفحة، أو التوكن ناقصه أذونات الصفحات. ضيف الصفحة في Assign assets بتحكم كامل، اعمل توكن جديد بالأذونات الخمسة، ودوس «حفظ واختبار». التطبيق لسه في وضع Development أو لسه ماخدش موافقة Advanced Access لـ `pages_messaging`. كمّل الجزء الرابع. الـ Webhook مش متسجّل على مستوى التطبيق. ارجع للجزء التالت، الصق الرابط والتوكن من فلايباي بزرار النسخ، ودوس Verify and save. الـ Webhook متظبط بس مفيش اشتراك في `messages`، أو الصفحة مش مشتركة في التطبيق. فعّل الحقول ودوس «حفظ واختبار» في فلايباي عشان يعيد اشتراك الصفحة. عدّت الـ 24 ساعة. من غير موافقة Human Agent مفيش رد لحد ما العميل يكتب تاني. اقرا [نافذة الرسايل](/ar/conversations/messaging-window). ## الخطوة الجاية [#الخطوة-الجاية] # الـ Webhook الصادر URL: https://docs.flyby.world/ar/channels/outbound-webhook > إعداد متقدم بيبعت كل رد من الوكيل الذكي أو فريقك لرابط بتاعك، عشان بوابة رسايل خاصة بيك توصّله للعميل. ده إعداد **متقدم** ومعظم الوكالات مش محتاجاه. مع كل رد من الوكيل الذكي أو من فريقك، فلايباي بيبعت طلب `POST` فيه الرد لرابط إنت بتحدده، وبوابتك هي اللي توصّل الرسالة للعميل. ## محتاجه ولا لأ؟ [#محتاجه-ولا-لأ] | وضعك | تعمل إيه | | ---------------------------------------------------------------------------- | ----------------------------------- | | ربطت واتساب أو ماسنجر أو إنستجرام من فلايباي | **سيبه مقفول.** الردود بتوصل لوحدها | | بتستخدم الشات العام بس | **سيبه مقفول** | | عندك بوابة رسايل خاصة (زي n8n، أو مزوّد واتساب غير Meta) وعايز الردود توصلها | ده اللي محتاجه | الـ Webhook ده بيبعت الردود **لبره** بس. إدخال رسايل العملاء من بوابتك لفلايباي مش متاح كخدمة ذاتية حالياً. قبل ما تبني عليه، كلّمنا على [support@flyby.world](mailto:support@flyby.world). ## شغّله [#شغّله] ### افتح القنوات [#افتح-القنوات] «الإعدادات ← القنوات والربط»، وانزل لجزء **«متقدم»**. ### شغّل «إرسال الردود لبوابتك (Webhook صادر)» [#شغّل-إرسال-الردود-لبوابتك-webhook-صادر] ### اكتب «رابط الإرسال» ودوس «حفظ» [#اكتب-رابط-الإرسال-ودوس-حفظ] الرابط لازم يبدأ بـ `https://` ويكون عنوان عام على الإنترنت، زي `https://gateway.example.com/flyby`. بعد الحفظ البادج بيبقى **مربوط**. ## البيانات اللي بنبعتها [#البيانات-اللي-بنبعتها] مع كل رد، فلايباي بيبعت `POST` بـ `Content-Type: application/json`: ```json { "agency_id": "…", "conversation_id": "6f1c…", "channel": "whatsapp", "contact_phone": "+201001234567", "sender": "ai", "text": "أهلاً يا أحمد! …" } ``` | الحقل | معناه | | ------------------- | --------------------------------------------------------- | | `agency_id` | رقم تعريف وكالتك في فلايباي | | `conversation_id` | رقم المحادثة، استخدمه عشان تربط الردود ببعض | | `channel` | القناة اللي المحادثة جاية منها، زي `whatsapp` أو `web` | | `contact_phone` | رقم العميل لو معروف (ممكن يبقى `null`) | | `contact_instagram` | بيتبعت مع ردود الفريق بس: حساب إنستجرام العميل لو معروف | | `sender` | `ai` لو الرد من الوكيل الذكي، و `agent` لو من حد في فريقك | | `text` | نص الرد نفسه | ## إمتى بيتبعت؟ [#إمتى-بيتبعت] * **ردود الوكيل الذكي**: في أي محادثة **مش** على قناة Meta مربوطة في فلايباي، ومنها محادثات الشات العام. * **ردود فريقك**: في المحادثات اللي مش من الشات العام، لما الرد ما يتبعتش من خلال قناة Meta مربوطة. يعني لو واتساب مربوط من فلايباي، ردوده بتروح لـ Meta مباشرة ومش بتعدي على الـ Webhook. ## نصايح لبوابتك [#نصايح-لبوابتك] * رد بسرعة: فلايباي بيستنى لحد **8 ثواني** بس. * الإرسال **مرة واحدة من غير إعادة محاولة**. لو بوابتك كانت واقفة، الرد ده مش هيوصلها. * الطلب مش موقّع، فخلي الرابط صعب التخمين (مثلاً فيه كود سري طويل في آخره). ## اقفله [#اقفله] اقفل مفتاح **«إرسال الردود لبوابتك»**. الرابط بيتمسح والإرسال بيقف على طول، وهيظهرلك «تم إيقاف الـ Webhook الخارجي». ## الخطوة الجاية [#الخطوة-الجاية] # ربط تيليجرام URL: https://docs.flyby.world/ar/channels/telegram > اعمل بوت تيليجرام باسم وكالتك من ‎@BotFather والصق التوكن في فلايباي، والوكيل الذكي يبدأ يرد في دقيقة. تيليجرام أسهل قناة تربطها بعد رابط الشات العام: مفيش تطبيق Meta ولا مراجعة ولا توثيق نشاط تجاري. بتعمل **بوت** باسم وكالتك، تلصق التوكن بتاعه في فلايباي، وخلاص. متاحة في باقات **Growth** و **Pro** وفي الفترة التجريبية. ## قبل ما تبدأ [#قبل-ما-تبدأ] * حساب تيليجرام عادي (من الموبايل أو الكمبيوتر). * إنك تكون **مالك** أو **مدير** في الوكالة على فلايباي. ## 1. اعمل البوت من ‎@BotFather [#1-اعمل-البوت-من-botfather] ### افتح ‎@BotFather [#افتح-botfather] في تيليجرام دوّر على **‎@BotFather** (عليه علامة التوثيق الزرقا) ودوس **Start**. ### ابعت ‎/newbot [#ابعت-newbot] هيسألك على **الاسم**، وده اللي العملاء هيشوفوه فوق الشات، زي «رحلات النيل». ### اختار يوزرنيم [#اختار-يوزرنيم] لازم يكون بالإنجليزي ويخلص بـ `bot`، زي `NileToursBot`. ده اللي هيبقى في لينك البوت: `t.me/NileToursBot`. ### انسخ التوكن [#انسخ-التوكن] BotFather هيبعتلك رسالة فيها **توكن** شكله كده: ```text 123456789:AAH4kZ... ``` أي حد معاه التوكن يقدر يتحكم في البوت. ماتبعتهوش لحد ومتنشرهوش. فلايباي بيحفظه مشفّر ومش بيظهر تاني. ## 2. اربطه في فلايباي [#2-اربطه-في-فلايباي] ### افتح القنوات [#افتح-القنوات] روح «الإعدادات ← القنوات والربط» وشغّل مفتاح **تيليجرام**. ### الصق التوكن ودوس «ربط» [#الصق-التوكن-ودوس-ربط] فلايباي بيتأكد من التوكن مع تيليجرام، وبيظبط الـ Webhook لوحده. مش محتاج تنسخ أي رابط في أي مكان. ### جرّب [#جرّب] هيظهر **لينك البوت**. افتحه من موبايلك، دوس **Start** وابعت رسالة. المحادثة هتظهر في [المحادثات](/ar/conversations) والوكيل الذكي هيرد. ## شارك البوت مع عملاءك [#شارك-البوت-مع-عملاءك] العميل لازم **هو اللي يبدأ**: يفتح البوت ويدوس Start. البوت مايقدرش يبعت لحد ماكلّموش الأول. عشان كده انشر اللينك: * في البايو على إنستجرام وتيك توك وفيسبوك. * في إعلاناتك، أو كـ QR كود في المكتب والبروشورات. * على [صفحتك العامة](/ar/public-page) ضمن [لينكات السوشيال](/ar/public-page/social-links). من ‎@BotFather تقدر تغيّر صورة البوت بـ ‎/setuserpic، ووصفه اللي بيظهر قبل Start بـ ‎/setdescription. ## تيليجرام بيختلف إزاي عن واتساب؟ [#تيليجرام-بيختلف-إزاي-عن-واتساب] | | تيليجرام | واتساب | | ---------- | ------------------------------------- | -------------------------- | | الإعداد | لصق توكن واحد | تطبيق Meta وتوثيق وWebhook | | التكلفة | مجاني | Meta بتحاسب على المحادثات | | مهلة الرد | **مفيش**: تقدر ترد أو تتابع في أي وقت | 24 ساعة، وبعدها قوالب بس | | مين يبدأ | العميل بس (بيدوس Start) | الوكالة تقدر تبدأ بقوالب | | رقم العميل | مش بيوصل غير لو العميل شاركه | دايماً معروف | | الحساب | بوت (بيظهر جنب اسمه كلمة bot) | رقم الشركة | الوكيل الذكي بيسأل العميل على رقمه ضمن أسئلة التأهيل، فرقم التليفون بيتسجّل في بيانات العميل لما يكتبه. ## أسئلة شائعة [#أسئلة-شائعة] الرسالة مش هتتبعت، وهتظهر تحتها «مااتبعتتش: العميل عامل بلوك للبوت على تيليجرام». لو العميل فك البلوك وبعت تاني، المحادثة بتكمّل عادي. أيوه، بس البوت الواحد بيوصّل رسايله لمكان واحد بس. لو البوت متربط بخدمة تانية، ربطه بفلايباي هيفصله عنها. الأفضل تعمل بوت جديد للمبيعات. لأ. فلايباي بيرد في المحادثات الخاصة بس، وأي رسالة في جروب أو قناة البوت مضاف فيها بتتجاهل. بتوصل في صندوق المحادثات كعلامة زي «📷 صورة» أو «🎤 رسالة صوتية»، والوكيل الذكي بيطلب من العميل يكتب طلبه. عشان تبدّل البوت، الصق التوكن الجديد ودوس «حفظ واختبار». لو قفلت مفتاح تيليجرام البوت بيوقف مؤقتاً والتوكن بيفضل محفوظ. و«حذف بيانات الربط» بيمسح التوكن خالص. # رابط الشات العام URL: https://docs.flyby.world/ar/channels/website-chat > صفحة شات جاهزة مع وكيلك الذكي، تشاركها في البايو والإعلانات أو تحطها جوه موقعك، من غير أي إعداد تقني. رابط الشات العام هو أسرع طريقة تخلّي العملاء يكلموا وكيلك الذكي: صفحة شات باسم وكالتك ولوجوها، شغالة على الموبايل والكمبيوتر، ومتاحة في **كل الباقات**. ## شغّل الشات [#شغّل-الشات] ### افتح القنوات [#افتح-القنوات] روح «الإعدادات ← القنوات والربط». ### شغّل «رابط الشات العام» [#شغّل-رابط-الشات-العام] الشات بيكون شغال من الأول تلقائياً. لو لقيت المفتاح مقفول، افتحه. ### انسخ «لينك الشات» [#انسخ-لينك-الشات] دوس زرار النسخ جنب اللينك، أو «فتح الصفحة» عشان تشوفه زي ما العميل هيشوفه. اللينك شكله كده: ```text https://flyby.world/ar/chat/<رقم-وكالتك> ``` اللينك بيطلع بلغة لوحة التحكم اللي إنت فاتحها. عايز نسخة إنجليزي؟ غيّر `/ar/` لـ `/en/` في اللينك. ## العميل بيشوف إيه؟ [#العميل-بيشوف-إيه] * اسم وكالتك واللوجو، واسم الوكيل الذكي وجنبه «متصل الآن». * رسالة الترحيب اللي كاتبها في إعدادات الوكيل (أو ترحيب افتراضي)، و3 اقتراحات سريعة يدوس عليها. * زرار **اتصال** بيتصل برقم الواتساب بتاعك (أو رقم التليفون لو مفيش واتساب). * زرار **محادثة جديدة** يبدأ بيه من الأول. * ردود فريقك بتظهر عليها «فريق الوكالة» عشان العميل يعرف إن اللي بيرد شخص. * في الآخر «مدعوم بواسطة فلايباي»، وده بيختفي في باقة **Pro**. المحادثة بتفضل محفوظة على جهاز العميل، فلو قفل الصفحة ورجع يلاقي كلامه زي ما هو. ## شاركه فين؟ [#شاركه-فين] * البايو في إنستجرام وتيك توك وفيسبوك. * إعلاناتك المموّلة، كزرار «ابعت رسالة» بيودي على اللينك. * كـ QR كود في المكتب أو على البروشورات. * في رسالة ترحيب الواتساب أو في توقيع الإيميل. لو [صفحتك العامة](/ar/public-page) شغالة، أزرار «كلمنا» اللي فيها بتفتح نفس الشات ده. يعني مش محتاج تشارك لينكين. ## حطه جوه موقعك [#حطه-جوه-موقعك] تحت اللينك هتلاقي **«تضمين في موقعك»** وجواه **سطر واحد** جاهز، رقم وكالتك متحط فيه. انسخه من هناك بالظبط، شكله كده: ```html ``` السطر ده بيضيف **فقاعة شات عائمة** بلون الشات بتاعك في ركن **كل صفحات موقعك** (تحت على الشمال في العربي، وتحت على اليمين في الإنجليزي). العميل يدوس عليها يفتحله شات الوكيل الذكي في نافذة صغيرة، وعلى الموبايل بيفتح ملء الشاشة. ### انسخ السطر [#انسخ-السطر] دوس أيقونة النسخ فوق الكود في «تضمين في موقعك». ### الصقه مرة واحدة في موقعك [#الصقه-مرة-واحدة-في-موقعك] حطه قبل `` مباشرة، أو في المكان اللي موقعك بيسمح فيه بإضافة كود لكل الصفحات. على ووردبريس استخدم إضافة زي **Insert Headers and Footers** أو خانة الـ Footer في القالب، وعلى Wix أو Shopify استخدم إعدادات **Custom code** في الموقع. ### افتح موقعك وجرّب [#افتح-موقعك-وجرّب] هتلاقي الفقاعة في الركن. دوس عليها وابعت رسالة. * عايز الشات بالإنجليزي؟ غيّر `lang=ar` لـ `lang=en` في السطر. * الشات **مش بيتحمّل غير لما العميل يفتحه**، فموقعك يفضل سريع. * العميل يقفله بزرار **Esc** أو بعلامة **X** في هيدر الشات. * بعد كام ثانية بتظهر جنب الفقاعة رسالة صغيرة «بتخطط لرحلة؟ اسألنا 👋»، **مرة واحدة بس في الزيارة**. * لو قفلت رابط الشات العام، الفقاعة بتختفي من موقعك لوحدها. بدل الكود، حط زرار عادي في موقعك («كلمنا على الشات») يودي على لينك الشات. نفس الشات ومن غير أي كود. ## لون الشات [#لون-الشات] من **«لون الشات»** اختار لون من الألوان الجاهزة أو اكتب كود اللون بصيغة HEX (زي `#0b5e6b`) ودوس **حفظ**. اللون ده بيظهر في هيدر الشات وفقاعات رسايل العميل والأزرار، **وكمان هو اللون الأساسي لصفحتك العامة**. ## جرّبه بنفسك [#جرّبه-بنفسك] 1. افتح لينك الشات في نافذة تصفح خفي (Incognito) أو من موبايل تاني. 2. اكتب سؤال حقيقي، زي «بكام عمرة شعبان؟». 3. افتح [المحادثات](/ar/conversations): هتلاقي المحادثة الجديدة ورد الوكيل الذكي. 4. رد من صندوق المحادثات وشوف ردك بيوصل للشات. أي محادثة الوكيل الذكي بيرد فيها من الشات العام بتتحسب من [محادثات الذكاء الاصطناعي](/ar/billing/ai-conversations) بتاعة الشهر، حتى لو إنت اللي بتجرّب، وبتظهر في صندوق المحادثات وكأنها عميل. لو عايز تختبر ردود الوكيل بس، استخدم [تجربة الوكيل](/ar/ai-agent/test-agent). ## قفل الشات [#قفل-الشات] لو قفلت المفتاح، لينك الشات بيبطل يفتح، وفقاعة الشات بتختفي من موقعك، وأزرار «كلمنا» بتختفي من صفحتك العامة (ويفضل زرار الواتساب لو رقمك موجود). المحادثات القديمة بتفضل في صندوق المحادثات. ## الخطوة الجاية [#الخطوة-الجاية] # ربط واتساب URL: https://docs.flyby.world/ar/channels/whatsapp > خطوة بخطوة، من إنشاء تطبيق Meta لحد أول رسالة يرد عليها الوكيل الذكي على رقم واتساب بيزنس بتاعك. بعد ما تخلص الصفحة دي، أي عميل يبعت على رقم واتساب بيزنس بتاعك هيوصل لصندوق المحادثات، والوكيل الذكي هيرد عليه على الواتساب نفسه. واتساب متاح في **كل الباقات**. الربط بيتم من خلال **تطبيق Meta بتاع وكالتك** و WhatsApp Cloud API. الخطوات كتير شوية بس كل واحدة فيها بسيطة. خصص حوالي ساعة، وخلي جنبك موبايل عليه الرقم اللي هتربطه. خدمة **«تجهيز Meta»** بنجهزلك فيها واتساب وماسنجر وإنستجرام بنفسنا: 1,500 جنيه أو 49 دولار مرة واحدة لباقات Starter و Growth، و**مجانية في Pro**. اطلبها من «الإعدادات ← الباقة والاشتراك» ([الإضافات](/ar/billing/add-ons)). ## قبل ما تبدأ [#قبل-ما-تبدأ] * **حساب Meta Business** (Business portfolio) لوكالتك على [business.facebook.com](https://business.facebook.com)، وإنت Admin فيه. * **حساب مطوّر** على [developers.facebook.com](https://developers.facebook.com) بنفس حساب الفيسبوك. * **رقم تليفون** يستقبل SMS أو مكالمة عشان كود التفعيل. * في فلايباي: إنت **مالك** أو **مدير** الوكالة. الرقم اللي بيتسجل على WhatsApp Cloud API غالباً مينفعش يفضل شغال في تطبيق واتساب العادي على الموبايل في نفس الوقت. Meta بتقدّم خيار «coexistence» لأرقام تطبيق WhatsApp Business في بعض الدول، بس لو مش متأكد، الأسلم تستخدم رقم جديد مخصص للوكالة. فكّر في ده كويس قبل ما تنقل رقمك الأساسي. ## الجزء الأول: جهّز تطبيق Meta والرقم [#الجزء-الأول-جهّز-تطبيق-meta-والرقم] ### اعمل تطبيق Business [#اعمل-تطبيق-business] 1. ادخل [developers.facebook.com/apps](https://developers.facebook.com/apps) ودوس **Create app**. 2. اكتب اسم للتطبيق (مثلاً «فلايباي - اسم وكالتك»)، وإيميل التواصل. 3. اختار حالة الاستخدام (Use case) **Connect with customers through WhatsApp**، ولو اتسألت عن النوع اختار **Business**. 4. اختار الـ Business portfolio بتاع وكالتك ودوس **Create app**. ### ضيف رقم واتساب بيزنس [#ضيف-رقم-واتساب-بيزنس] 1. من قائمة التطبيق افتح **WhatsApp ← API Setup** (في النسخة الجديدة من لوحة Meta: **Use cases ← Customize ← API Setup**). 2. دوس **Add phone number**، واكتب الاسم اللي هيظهر للعملاء (Display name) ونوع النشاط. 3. فعّل الرقم بالكود اللي هيوصلك SMS أو مكالمة. Meta بتديك **رقم تجريبي (Test number)** مجاني في نفس الصفحة. تقدر تربطه بفلايباي بنفس الخطوات، بس هو **بيرد على 5 أرقام بالكتير** بتضيفها من **To ← Manage phone number list** (وكل رقم بيتأكد بكود). أي حد تاني مش هيوصله رد، وفلايباي هيكتبلك «رقم Meta التجريبي: ضيف رقم العميل ده لقايمة الأرقام المسموحة في تطبيق Meta بتاعك». وبعد ما تتطمن، ضيف رقمك الحقيقي وحدّث الـ Phone number ID في فلايباي. برقمك انت، الوكيل الذكي وفريقك يقدروا يردوا على **أي عميل يبعت الأول**، من غير قايمة أرقام ولا App Review ولا Tech Provider: Meta بتعتبر الوكالة اللي بتستخدم رقمها مطوّر مباشر. ومش محتاج توثيق النشاط التجاري كمان، التوثيق بيرفع بس حدود الرسايل اللي *انت* بتبدأها (القوالب)، وفلايباي لسه مابيبعتهاش. ### انسخ WhatsApp Business Account ID و Phone number ID [#انسخ-whatsapp-business-account-id-و-phone-number-id] في نفس صفحة **API Setup** هتلاقي تحت الرقم: * **Phone number ID**: رقم طويل خاص بـ Meta. **ده مش رقم تليفونك**. * **WhatsApp Business Account ID**: رقم حساب واتساب بيزنس اللي الرقم تابع له (موجود كمان في WhatsApp Manager). احفظهم في ملف ملاحظات، هتحتاجهم كمان شوية. ### انسخ الـ App secret [#انسخ-الـ-app-secret] 1. من قائمة التطبيق: **App settings ← Basic**. 2. جنب **App secret** دوس **Show**، واكتب باسورد الفيسبوك لو اتطلب. 3. انسخه. فلايباي بيستخدم الـ App secret عشان يتأكد إن كل رسالة جاية فعلاً من Meta، مش من حد بيقلّدها. ## الجزء التاني: توكن دائم من System user [#الجزء-التاني-توكن-دائم-من-system-user] التوكن ده هو «المفتاح» اللي بيخلّي فلايباي يقرا الرسايل ويرد بالنيابة عنك. لازم يكون **دائم**، عشان كده بنعمله من System user مش من حسابك الشخصي. ### اعمل System user [#اعمل-system-user] 1. افتح [business.facebook.com/settings](https://business.facebook.com/settings). 2. روح **Business Settings ← Users ← System users** ودوس **Add**. 3. اكتب اسم (مثلاً «Flyby») واختار الدور **Admin**، ودوس **Create system user**. ### اديله صلاحية على التطبيق وحساب الواتساب [#اديله-صلاحية-على-التطبيق-وحساب-الواتساب] وهو مختار، دوس **Assign assets** (أو **Add assets**): 1. **Apps** ← اختار تطبيقك ← فعّل **Manage app** (تحكم كامل). 2. **WhatsApp accounts** ← اختار حساب واتساب بيزنس ← فعّل **تحكم كامل (Full control)**. 3. دوس **Save changes**. ### اعمل التوكن [#اعمل-التوكن] 1. دوس **Generate new token** واختار تطبيقك. 2. في **Token expiration** اختار **Never**. 3. علّم على الأذونات دي: * `whatsapp_business_messaging` * `whatsapp_business_management` * `business_management` (اختياري) 4. دوس **Generate token** و**انسخه فوراً**: Meta مش هتوريهولك تاني. لو اخترت مدة غير **Never** (زي 60 يوم)، الربط هيشتغل وبعدين يقف فجأة لما التوكن يخلص، والقناة هتتحول «محتاج مراجعة». ولو نسيت إذن من التلاتة، Meta هترفض الربط. ## الجزء التالت: اربط في فلايباي [#الجزء-التالت-اربط-في-فلايباي] ### شغّل واتساب بيزنس [#شغّل-واتساب-بيزنس] افتح «الإعدادات ← القنوات والربط» وشغّل مفتاح **واتساب بيزنس**. هيظهرلك جزء **«الـ Webhook (الصقه في تطبيق Meta)»** فيه **Callback URL** و **Verify token**، وتحته خانات البيانات. ### الصق البيانات [#الصق-البيانات] | الخانة في فلايباي | جبتها منين | | ------------------------------------ | --------------------------------- | | **توكن مستخدم النظام (System user)** | التوكن اللي عملته في الجزء التاني | | **App secret** | App settings ← Basic | | **WhatsApp Business Account ID** | WhatsApp ← API Setup | | **Phone number ID** | WhatsApp ← API Setup | ### دوس «ربط» [#دوس-ربط] فلايباي هيتأكد إن الرقم تابع لحساب الواتساب ده، وهيشترك تطبيقك في رسايل الحساب، **وهيسجّل الـ Callback URL في Meta تلقائياً**. لو كله تمام هتظهر رسالة «تم الربط مع Meta» والبادج يبقى **مربوط**، واسم الرقم يظهر تحت «واتساب بيزنس». بعد الحفظ، التوكن والـ App secret بيتحفظوا مشفّرين ومش بيظهروا تاني. لو حبيت تعدّل حاجة تانية سيب خاناتهم فاضية والقيمة القديمة هتفضل زي ما هي. الزرار بعد كده اسمه **«حفظ واختبار»**. ### أكّد الـ Webhook في Meta [#أكّد-الـ-webhook-في-meta] حتى لو التسجيل التلقائي نجح، كمّل الخطوة دي عشان تضمن إن الرسايل شغالة: 1. في تطبيق Meta افتح **WhatsApp ← Configuration**. 2. في جزء **Webhook** دوس **Edit**، والصق **Callback URL** و **Verify token** من فلايباي (فيه زرار نسخ جنب كل واحد). 3. دوس **Verify and save**. 4. تحت **Webhook fields** دوس **Manage** وفعّل **Subscribe** جنب `messages`. لو ظهرلك تنبيه «اتربط، بس معرفناش نظبط رابط الـ Webhook تلقائي»، الخطوة دي إجبارية. ### حوّل التطبيق لـ Live [#حوّل-التطبيق-لـ-live] في أعلى لوحة التطبيق، حوّل **App Mode** من **Development** لـ **Live**. Meta مش بتبعت بعض الـ Webhooks والتطبيق في وضع Development. Meta هتطلب منك **Privacy Policy URL** في App settings ← Basic قبل التحويل. حط لينك سياسة الخصوصية بتاعة وكالتك (على موقعك). **مش محتاج App Review** لواتساب: التطبيق بيخدم رقمك انت. ومن غير توثيق النشاط التجاري لسه تقدر ترد على كل العملاء، التوثيق بيرفع بس حدود الرسايل اللي بتبدأها انت (250 شخص في اليوم من غير توثيق) وعدد الأرقام (2). ## جرّب الربط [#جرّب-الربط] 1. من موبايل **تاني** (مش الرقم المربوط) ابعت «السلام عليكم، عايز أسعار عمرة» على رقم الواتساب. 2. في فلايباي، تحت الـ Callback URL، **«آخر حدث»** المفروض يتحدّث بتاريخ دلوقتي. 3. افتح [المحادثات](/ar/conversations): هتلاقي محادثة جديدة بقناة واتساب، والوكيل رد خلال ثواني. على موبايل العميل هيظهر إن الرسالة اتقرت و«بيكتب…» قبل الرد. ## العملاء هيبعتوا إيه؟ [#العملاء-هيبعتوا-إيه] * **الرسايل النصية** والأزرار بيقراها الوكيل ويرد عليها. * **الصور والفويس والفيديو والملفات والملصقات والمواقع وجهات الاتصال** بتظهر في المحادثة كوصف قصير (زي «📷 صورة» أو «🎤 رسالة صوتية») عشان فريقك يعرف إن العميل بعت حاجة ويتابع معاه. * الرسايل الطويلة من الوكيل بتتقسم تلقائياً لو عدّت حد واتساب. تقدر ترد رد حر بس خلال 24 ساعة من آخر رسالة من العميل. بعد كده واتساب بيطلب قوالب معتمدة، وفلايباي لسه مش بيبعت قوالب، فالرسالة هتفشل لحد ما العميل يكتب تاني. اقرا [نافذة الرسايل](/ar/conversations/messaging-window). ## لو حاجة مش شغالة [#لو-حاجة-مش-شغالة] الرسالة اللي جاية من Meta بتظهر تحت الخطأ. أشهر الأسباب: * **التوكن ناقصه إذن**: اعمل توكن جديد فيه الإذنين `whatsapp_business_messaging` و `whatsapp_business_management`. * **الـ System user ملوش صلاحية على حساب الواتساب**: ارجع لـ Assign assets وضيف حساب واتساب بيزنس بتحكم كامل، وبعدين اعمل توكن جديد. * **`phone_not_in_waba`**: الـ Phone number ID مش تابع للـ WhatsApp Business Account ID اللي كتبته. انسخ الاتنين من نفس صفحة API Setup. * بص على **«تم التحقق»** و **«آخر حدث»**. لو فاضيين، الـ Webhook مش متظبط: ارجع لخطوة «أكّد الـ Webhook في Meta». * اتأكد إنك عامل **Subscribe** على `messages` في **Webhook fields**. * اتأكد إن التطبيق **Live** مش Development. * لو بتجرب برقم Meta التجريبي، لازم رقم الموبايل اللي بتبعت منه يكون مضاف في قائمة **To**. * انسخ الاتنين من فلايباي بزرار النسخ، من غير مسافات زيادة. * اتأكد إن مفتاح واتساب **شغال** في فلايباي وإنك ما دوستش «حذف بيانات الربط» بعد ما نسخت (الحذف بيغيّر الرابط والتوكن). غالباً التوكن اتلغى أو انتهى (مثلاً حد شال الـ System user أو غيّر صلاحياته). اعمل توكن جديد بمدة **Never**، الصقه، ودوس **«حفظ واختبار»**. انت مربوط برقم Meta **التجريبي**، وده بيرد بس على الأرقام اللي في القايمة. ضيف رقم العميل من **WhatsApp ← API Setup ← To ← Manage phone number list** وأكده بالكود، أو حوّل لرقمك الحقيقي. * ممكن المحادثة مستلمها حد من فريقك: الوكيل بيقف في أي محادثة الفريق رد فيها. * ممكن محادثات الذكاء الاصطناعي بتاعة الشهر خلصت، فالمحادثات الجديدة بتروح للفريق «محتاج موظف». اقرا [محادثات الذكاء الاصطناعي](/ar/billing/ai-conversations). لسه فيه مشكلة؟ ابعتلنا على [support@flyby.world](mailto:support@flyby.world) ومعاك نص رسالة الخطأ. ## الخطوة الجاية [#الخطوة-الجاية] # التحويل لموظف URL: https://docs.flyby.world/ar/conversations/handoff > إمتى الوكيل الذكي يسلّم المحادثة لفريقك، وإزاي تستلمها، وإزاي ترجّعها له تاني. الوكيل الذكي بيرد لوحده على أغلب الأسئلة، بس فيه لحظات لازم إنسان يدخل فيها: عميل جاهز يحجز، أو شكوى، أو سؤال مش موجود في بياناتك. ساعتها المحادثة بتتحول لحالة **محتاج موظف** وبيوصلك إشعار. ## إمتى المحادثة بتروح «محتاج موظف»؟ [#إمتى-المحادثة-بتروح-محتاج-موظف] | الموقف | الوكيل بيعمل إيه | الوكيل بيكمّل يرد؟ | | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- | | **العميل اتأهل**: الوكيل جمع بيانات الرحلة ووسيلة تواصل، أو العميل واضح إنه عايز يحجز | بيكتب ملخص، يقيّم العميل (ساخن / دافئ / بارد)، ينقله لمرحلة «مؤهل»، ويقول للعميل إن مستشار هيكلمه | أيوه، بيكمّل يجاوب على أسئلة العميل لحد ما حد من الفريق يرد أو يستلم | | **العميل طلب يكلم حد**، أو اشتكى، أو عنده مشكلة في دفع أو استرداد أو حجز قديم | بيقول للعميل إن حد من الفريق هيكمّل معاه، ويكتب سبب التحويل وملخص | لأ، بيقف | | **قاعدة من قواعدك** في «إمتى يحوّل لموظف» اتحققت | زي اللي فوق | لأ، بيقف | | **سؤال مالوش إجابة** في البرامج والخدمات والأسئلة الشائعة | بيحوّل بدل ما يألّف إجابة | لأ، بيقف | | **رصيد محادثات الذكاء الاصطناعي خلص** للشهر | المحادثات الجديدة بتروح للفريق على طول | لأ | | **الوكيل ماقدرش يرد** لسبب تقني | بيحوّل عشان العميل مايفضلش مستني | لأ | الوكيل في الحالات دي بيعلّي **الأولوية** لـ«عالية» (وفي العميل المؤهل بتبقى عالية لو التقييم ساخن)، فالمحادثة بتبان بالأحمر في القائمة. **سبب التحويل** بيظهر في لوحة التفاصيل. لو الوكيل كتب سبب بنفسه هتقراه زي ما هو، ولو التحويل حصل من النظام هتلاقي جملة واضحة من دول: * «الوكيل الذكي طلب موظف يكمّل» * «الوكيل الذكي مقفول» * «الوكيل الذكي معرفش يرد (مشكلة فنية)» * «محادثات الذكاء الاصطناعي خلصت للشهر ده» من صفحة الوكيل الذكي، اكتب في **«إمتى يحوّل لموظف»** الحالات اللي تحب الوكيل يقف فيها، زي المجموعات الكبيرة أو حجوزات الشركات. التفاصيل في [تعليمات الوكيل](/ar/ai-agent/instructions)، وقواعد التأهيل في [التأهيل والتقييم](/ar/ai-agent/qualification). ## هتعرف إزاي إن فيه محادثة مستنياك؟ [#هتعرف-إزاي-إن-فيه-محادثة-مستنياك] * **الرقم الأحمر** جنب **المحادثات** في القائمة الجانبية (وفي شريط الموبايل) بيعدّ المحادثات اللي «محتاج موظف». * **إشعار جوه البرنامج** (الجرس) فيه اسم العميل والملخص، ولما تضغط عليه بيفتح المحادثة أو العميل المحتمل. * **إشعار على الجهاز** حتى لو فلايباي مقفول، لو فعّلته من [الإعدادات ← الإشعارات](/ar/settings/notifications). الإشعارات بتتفعّل لكل جهاز لوحده، وعلى الآيفون لازم [تنزّل التطبيق](/ar/getting-started/install-app) الأول. | الإشعار | بيوصل لمين | | ----------------------------------------------- | ---------------------------- | | محادثة محتاج موظف (طلب موظف، شكوى، قاعدة تحويل) | المالك والمدير | | تعذّر على الوكيل الذكي الرد | المالك والمدير | | عميل مؤهل (ساخن / دافئ / بارد) | المالك والمدير ومشرف العملاء | ## استلام المحادثة [#استلام-المحادثة] ### افتح المحادثة [#افتح-المحادثة] من تبويب **محتاج موظف** أو من الإشعار. اقرا **ملخص الذكاء الاصطناعي** و**سبب التحويل** في لوحة التفاصيل الأول، عشان ماتسألش العميل حاجة قالها قبل كده. ### اضغط «استلام المحادثة» [#اضغط-استلام-المحادثة] الوكيل بيقف، والمحادثة بتبقى **مع الفريق** ومتسندة ليك، وبيتسجل سطر في المحادثة إنك استلمت. ### رد على العميل [#رد-على-العميل] اكتب ردك في مربع **رد** واضغط إرسال (أو Enter). لو محتاج مساعدة في الصياغة، اضغط **اقتراح رد بالذكاء الاصطناعي** والوكيل هيكتب لك مسودة في مربع الرد. راجعها وعدّل فيها قبل ما تبعت. لو بعت رد والوكيل لسه شغال، هتشوف تنبيه «رسالتك ستوقف الوكيل الذكي في هذه المحادثة». أول ما تبعت، الوكيل بيقف والمحادثة بتتسند ليك، كأنك ضغطت «استلام المحادثة». الملاحظة الداخلية مابتوقفش الوكيل. ## إرجاع المحادثة للوكيل الذكي [#إرجاع-المحادثة-للوكيل-الذكي] خلصت الجزء اللي محتاج إنسان؟ اضغط **إرجاع للوكيل الذكي** فوق المحادثة. المحادثة بترجع لحالة **الوكيل الذكي**، وسبب التحويل بيتمسح، والوكيل هيرد على **رسائل العميل الجاية**. لو آخر رسالة من العميل لسه مالهاش رد وعايز الوكيل يرد عليها دلوقتي، افتح قائمة (⋮) واختار **خلي الوكيل يرد الآن**. الاختيار ده بيشتغل بس لما تكون آخر رسالة من العميل، وبيشتغل حتى لو الوكيل متوقف في المحادثة. ## نصايح لفريق المبيعات [#نصايح-لفريق-المبيعات] * **رد بسرعة على العميل المؤهل.** الوكيل قال له إن مستشار هيكلمه، فكل دقيقة بتفرق، خصوصًا مع العميل الساخن. * **اتفقوا مين يستلم إيه.** استخدموا [الإسناد](/ar/conversations/notes-and-assignment) عشان محدش يرد على نفس العميل مرتين. * **ظبط مواعيد العمل.** برّه [مواعيد العمل](/ar/settings/working-hours) الوكيل بيقول للعميل إن الفريق هيتابع معاه في المواعيد الرسمية، بدل ما يوعده برد فوري. * **اقفل المحادثة لما تخلص**، عشان تبويب «مع الفريق» يفضل نضيف. ## الخطوة الجاية [#الخطوة-الجاية] # صندوق المحادثات URL: https://docs.flyby.world/ar/conversations > كل رسائل عملائك من واتساب وماسنجر وإنستجرام وشات الموقع في مكان واحد، وإنت شايف مين بيرد على مين. صفحة **المحادثات** هي المكان اللي بتتابع منه كل كلام الوكيل الذكي مع عملائك، وبتدخل فيه بنفسك وقت ما تحب. كل رسالة جديدة بتظهر فورًا من غير ما تعمل تحديث للصفحة. افتح المحادثات المالك والمدير بس. **مشرف العملاء** مابيشوفش صفحة المحادثات خالص، وشغله بيبدأ من [العملاء المحتملين](/ar/leads) بعد ما العميل يتأهل. ## شكل الصفحة [#شكل-الصفحة] الصفحة متقسمة جزئين: * **القائمة** على الجنب: كل المحادثات مترتبة بآخر رسالة، الأحدث فوق. * **المحادثة نفسها**: لما تختار محادثة بتشوف الرسائل كلها، وتحتها مربع الرد. وعلى الشاشات الكبيرة بيظهر جنبها لوحة **التفاصيل** (بيانات العميل، العميل المحتمل، ملخص الذكاء الاصطناعي، الإسناد والأولوية). كل صف في القائمة بيوريك: | الجزء | معناه | | -------------------------- | ----------------------------------------------------------------------------- | | الصورة وأيقونة صغيرة عليها | اسم العميل، والأيقونة بتقولك القناة (واتساب، ماسنجر، إنستجرام، موقع الويب) | | آخر رسالة | معاها أيقونة لو آخر رد كان من الوكيل الذكي أو من حد في الفريق | | رقم ملوّن | عدد الرسائل اللي لسه ماتقريتش، والاسم بيبقى بخط عريض | | النقطة والحالة | حالة المحادثة (تحت) | | «عالية» أو «عاجلة» بالأحمر | أولوية المحادثة، والوكيل الذكي بيعلّيها لوحده لما يحوّل لك أو يلاقي عميل ساخن | ## حالات المحادثة [#حالات-المحادثة] كل محادثة ليها حالة من أربعة: | الحالة | معناها | مين بيرد؟ | | ---------------------------------- | ------------------------------------------------------------ | ----------------------------------------------------------- | | **الوكيل الذكي** | الوكيل شغال ومكمّل مع العميل | الوكيل الذكي | | **محتاج موظف** | الوكيل سلّم المحادثة لفريقك، أو العميل اتأهل ومستني حد يكلمه | محتاجة حد من الفريق ([التفاصيل](/ar/conversations/handoff)) | | **مع الفريق** (أو «مع» اسم الموظف) | حد من فريقك استلم المحادثة | الموظف، والوكيل واقف | | **مغلقة** | المحادثة خلصت | محدش، ولو العميل بعت تاني بتتفتح وترجع للوكيل الذكي | وفوق المحادثة هتلاقي كمان سطر صغير بيقولك **«الوكيل الذكي يرد»** أو **«الوكيل الذكي متوقف»**، عشان تعرف بالظبط مين ماسك الكلام دلوقتي. ## الفلاتر والبحث [#الفلاتر-والبحث] فوق القائمة فيه تبويبات، وجنب كل واحد عدد المحادثات فيه: * **الكل** * **محتاج موظف**: ابدأ يومك من هنا. * **مع الوكيل الذكي** * **مع الفريق** * **المسندة لي**: المحادثات المفتوحة اللي متسندة ليك إنت. * **مغلقة** وتحتهم: * **البحث**: دوّر باسم العميل أو رقمه أو أي كلمة في آخر رسالة. * **القناة**: اختار **كل القنوات** أو قناة واحدة بس، زي واتساب لوحده. خلي حد في الفريق مسؤول يفتح تبويب **محتاج موظف** كل شوية. الرقم الأحمر جنب **المحادثات** في القائمة الجانبية بيعدّ المحادثات اللي في الحالة دي بالظبط. ## الرسائل جوه المحادثة [#الرسائل-جوه-المحادثة] * **رسائل العميل** على جنب، وردود الوكيل الذكي والفريق على الجنب التاني. * **ردود الوكيل الذكي** لونها مختلف وعليها اسم «الوكيل الذكي»، وعلى الكمبيوتر بتشوف جنبها الأدوات اللي استخدمها (زي البحث في البرامج). * **الملاحظات الداخلية** لونها أصفر، والعميل مابيشوفهاش ([الملاحظات والإسناد](/ar/conversations/notes-and-assignment)). * **سطور النظام** الرمادي في النص بتسجل اللي حصل، زي «استلم أحد أعضاء الفريق المحادثة» أو «تم إغلاق المحادثة». * لو رسالة ماوصلتش للعميل بيظهر تحتها تنبيه بالأحمر ([نافذة الـ 24 ساعة](/ar/conversations/messaging-window)). لما تفتح محادثة، الرسائل الجديدة فيها بتتعلّم إنها اتقريت تلقائي. ## إغلاق المحادثة وإعادة فتحها [#إغلاق-المحادثة-وإعادة-فتحها] من زرار القائمة (⋮) فوق المحادثة: * **إغلاق المحادثة**: لما الموضوع يخلص. الوكيل بيقف والمحادثة بتروح لتبويب **مغلقة**. * **إعادة فتح**: ترجّعها لفريقك. لو العميل بعت رسالة جديدة لمحادثة مقفولة، بتتفتح لوحدها والوكيل الذكي بيرد عليه من تاني. ## من الموبايل [#من-الموبايل] * القائمة بتاخد الشاشة كلها، ولما تفتح محادثة بتاخد الشاشة كلها برضه، وفيه سهم فوق يرجّعك للقائمة. * زرار **التفاصيل** فوق بيفتح بيانات العميل والعميل المحتمل والملخص في لوحة من تحت. * عشان توصلك تنبيهات وإنت برّه البرنامج، [نزّل التطبيق](/ar/getting-started/install-app) وفعّل [الإشعارات](/ar/settings/notifications). ## لسه مفيش محادثات؟ [#لسه-مفيش-محادثات] أول ما عميل يبعت رسالة على أي قناة متوصلة هتظهر هنا. ولحد ما توصّل قنواتك، جرّب بنفسك من زرار **جرّب الوكيل كعميل** اللي بيظهر لما مايكونش في محادثة مفتوحة. اعرف أكتر في [جرّب الوكيل](/ar/ai-agent/test-agent) و[القنوات](/ar/channels). ## الخطوة الجاية [#الخطوة-الجاية] # نافذة الـ 24 ساعة URL: https://docs.flyby.world/ar/conversations/messaging-window > ليه أحيانًا فلايباي مش بيخليك ترد على عميل في واتساب أو ماسنجر أو إنستجرام، والتنبيهات اللي بتظهر فوق مربع الرد معناها إيه. Meta (صاحبة واتساب وماسنجر وإنستجرام) عندها قاعدة: الشركة تقدر ترد على العميل بحرية **خلال 24 ساعة من آخر رسالة بعتها العميل**. بعد كده الرسائل بتتقيد. فلايباي بيطبّق القاعدة دي عشان رسايلك ماتترفضش ورقمك أو صفحتك مايتأثروش. [شات الموقع](/ar/channels/website-chat) مالوش نافذة، وتقدر ترد فيه في أي وقت. ## إزاي النافذة بتشتغل [#إزاي-النافذة-بتشتغل] العداد بيبدأ من **آخر رسالة من العميل**، مش من آخر رد ليك. كل ما العميل يبعت رسالة جديدة، النافذة بتتفتح من الأول لـ 24 ساعة كمان. | الوقت من آخر رسالة للعميل | واتساب | ماسنجر وإنستجرام | | ------------------------- | ------------------------------ | ------------------------------------------------------ | | أقل من 24 ساعة | رد عادي (الوكيل الذكي والفريق) | رد عادي (الوكيل الذكي والفريق) | | من 24 ساعة لـ 7 أيام | مقفول: مينفعش ترد | الفريق بس يقدر يرد، والرسالة بتتبعت بعلامة Human Agent | | أكتر من 7 أيام | مقفول | مقفول | الوكيل الذكي بيرد بس جوه أول 24 ساعة، وده طبيعي لأنه بيرد على رسالة العميل اللي لسه واصلة. ## لما مربع الرد يتقفل [#لما-مربع-الرد-يتقفل] لما فلايباي مايقدرش يبعت، مربع الرد بيبقى رمادي والنص اللي جواه بيقولك السبب. وفيه **?** جواه بيفتح الصفحة دي. بعد 24 ساعة: > عدّى أكتر من 24 ساعة من آخر رسالة منه. واتساب بيسمح دلوقتي برسايل القوالب المعتمدة بس. فلايباي **لسه مابيبعتش رسائل القوالب**، فالرد هيرجع يشتغل أول ما العميل يبعت رسالة جديدة. **من 24 ساعة لـ 7 أيام** الردود بتتبعت بعلامة **Human Agent** بتاعة Meta. ده بيشتغل بس لو **تطبيق Meta بتاع وكالتك** واخد موافقة Human Agent من App Review. فيه ملاحظة صفرا فوق المربع بتفكّرك. فلايباي بيعرف من أول محاولة وبيفتكرها للقناة: * **Meta قبلت:** فريقك يقدر يكمّل رد لحد 7 أيام. * **Meta رفضت:** هتشوف «Meta رفضت: تطبيق Meta بتاعك مش معتمد لـ Human Agent» لثواني، وبعدها اقتراح إنك ترد من التطبيق على موبايلك. ومن ساعتها المربع بيتقفل بعد 24 ساعة على القناة دي. النتيجة بتظهر في **«الإعدادات ← القنوات والربط»** تحت القناة: **Human Agent: معتمد / مش معتمد / لسه متعرفش**. اتعتمدت بعدين؟ دوس **«إعادة فحص»** وأول رد بعد 24 ساعة هيجرّب تاني. **بعد 7 أيام** المربع بيتقفل: > عدّى أكتر من 7 أيام من آخر رسالة منه. Meta مش بتسمح بالرد من فلايباي، بس تقدر ترد من التطبيق على موبايلك. ### مستني رد على رسالة الكومنت [#مستني-رد-على-رسالة-الكومنت] لما المحادثة تبدأ من [الرد على الكومنتات](/ar/channels/comment-replies)، Meta بتسمح **بالرسالة دي بس** لحد ما الشخص يرد. المربع بيفضل مقفول ومكتوب فيه «مستنيين … يرد على رسالة الكومنت»، وبيتفتح أول ما يرد. ### الرد من تطبيق إنستجرام أو ماسنجر [#الرد-من-تطبيق-إنستجرام-أو-ماسنجر] حد الـ 24 ساعة بتاع Meta بيطبق على التطبيقات زي فلايباي، **مش** على حد بيرد بنفسه من **تطبيق إنستجرام** أو **تطبيق ماسنجر** أو **Meta Business Suite**. فلما المربع يتقفل، لسه تقدر ترد من موبايلك. الردود دي بتظهر في محادثة فلايباي كمان، ومكتوب عليها **«اتبعتت من تطبيق إنستجرام»** (أو ماسنجر)، والوكيل الذكي بيبطّل يرد في المحادثة دي، زي بالظبط لما ترد من فلايباي. حتى والمربع مقفول للردود تقدر تحوّل لـ **ملاحظة داخلية**، لأنها مش بتتبعت للعميل. ## لو الرسالة ماوصلتش [#لو-الرسالة-ماوصلتش] لو حاولت تبعت وMeta رفضت، الرسالة **مابتتحفظش** في المحادثة، والنص بيرجع لمربع الرد عشان ماتضيعش اللي كتبته، وبيظهر لك تنبيه بالسبب: | التنبيه | معناه | تعمل إيه | | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------- | | مااتبعتتش: نافذة الـ 24 ساعة اتقفلت | عدّت المدة المسموحة | استنى العميل يبعت، أو رد من التطبيق على موبايلك | | Meta رفضت: تطبيق Meta بتاعك مش معتمد لـ Human Agent | الرد بعد 24 ساعة محتاج موافقة Human Agent | رد من تطبيق إنستجرام / ماسنجر على موبايلك، أو خد موافقة Human Agent ودوس **«إعادة فحص»** | | مااتبعتتش: القناة دي مفصولة. راجع الإعدادات | القناة متوقفة أو مش متوصلة صح | راجع القناة من [الإعدادات ← القنوات والربط](/ar/channels) | | مااتبعتتش: مفيش معرّف للعميل على المنصة | فلايباي مش لاقي حساب العميل على المنصة دي | كلم العميل على قناة تانية | | رقم Meta التجريبي: ضيف رقم العميل ده لقايمة الأرقام المسموحة في تطبيق Meta بتاعك | واتساب مربوط برقم Meta التجريبي، وده بيرد بس على الأرقام اللي في القايمة | ضيف الرقم من **WhatsApp ← API Setup ← To**، أو اربط رقمك الحقيقي ([واتساب](/ar/channels/whatsapp)) | | Meta معرفتش توصّل الرسالة | Meta رفضت لسبب تاني | جرّب تاني بعد شوية، ولو اتكرر راجع إعدادات القناة | وتحت أي رسالة ماوصلتش (زي رد للوكيل الذكي اترفض) بيظهر بالأحمر **«ماوصلتش»** أو **«مااتبعتتش: نافذة الـ 24 ساعة اتقفلت»**. ## العميل مارجعش؟ تعمل إيه [#العميل-مارجعش-تعمل-إيه] * **كلمه من برّه فلايباي.** من [صفحة العميل المحتمل](/ar/leads/lead-details) أو [جهة الاتصال](/ar/leads/contacts) تقدر تضغط على رقمه للاتصال، أو زرار واتساب يفتح المحادثة من موبايلك. * **سجّل اللي حصل.** بعد المكالمة سجّلها من **تسجيل مكالمة** في سجل نشاط العميل، وحط [مهمة متابعة](/ar/leads/tasks) لو محتاج ترجع له. * **اقفل المحادثة** لو الموضوع خلص. لو العميل بعت تاني هتتفتح لوحدها. إنك ترد بنفسك من تطبيق إنستجرام أو ماسنجر ده عادي. بس ماتحاولش تعدّي القاعدة بأي طريقة تانية (أدوات تانية، رسايل جماعية): Meta ممكن تقيّد أو توقف الحساب لو اتكررت الرسائل المرفوضة. اقرا [سياسة رسائل Meta](https://flyby.world/ar/meta-policy). ## الخطوة الجاية [#الخطوة-الجاية] # الملاحظات والإسناد URL: https://docs.flyby.world/ar/conversations/notes-and-assignment > اكتب ملاحظات داخلية لفريقك، اسند المحادثة لزميل، واستخدم ملخص الذكاء الاصطناعي ولوحة العميل المحتمل من جوه المحادثة. جوه كل محادثة فيه أدوات بتخلي الفريق يشتغل مع بعض من غير ما العميل يحس: ملاحظات داخلية، إسناد لموظف، أولوية، وملخص جاهز من الوكيل الذكي. ## الملاحظات الداخلية [#الملاحظات-الداخلية] الملاحظة الداخلية رسالة جوه المحادثة **لفريقك بس**. العميل مابيشوفهاش، والوكيل الذكي كمان مابيقراهاش. ### اختار «ملاحظة داخلية» [#اختار-ملاحظة-داخلية] فوق مربع الكتابة فيه زرارين: **رد** و**ملاحظة داخلية**. اختار التاني، والمربع هيتلوّن أصفر. ### اكتب واضغط إرسال [#اكتب-واضغط-إرسال] الملاحظة بتظهر في المحادثة بلون أصفر وعليها علامة ملاحظة واسمك. ### ارجع لـ«رد» قبل ما تكلم العميل [#ارجع-لـرد-قبل-ما-تكلم-العميل] مربع الكتابة بيفضل على آخر اختيار، فاتأكد إنك على **رد** قبل ما تكتب للعميل. استخدمها في حاجات زي: * «كلمته تليفون، عايز يأجل لأول الشهر.» * «السعر ده بعد خصم وافق عليه أحمد، ماتنزلش عنه.» * «العميل ده حجز معانا عمرة السنة اللي فاتت.» الملاحظة مابتوقفش الوكيل الذكي ومابتغيرش حالة المحادثة. اللي بيوقفه هو إنك تبعت **رد** أو تضغط **استلام المحادثة**. ## الإسناد لزميل [#الإسناد-لزميل] في لوحة **التفاصيل** (جنب المحادثة على الشاشة الكبيرة، أو من زرار التفاصيل على الموبايل) هتلاقي **إسناد إلى**: 1. افتح القائمة واختار اسم الزميل. 2. عشان تشيل الإسناد اختار **غير مسندة**. حاجات لازم تعرفها: * لما تضغط **استلام المحادثة** أو تبعت رد، المحادثة بتتسند **ليك** تلقائي. * كل واحد بيلاقي المحادثات المفتوحة المسندة له في تبويب **المسندة لي**. * في القائمة، المحادثة المسندة اللي مع الفريق بتظهر «مع» واسم الموظف (أو «مع أنت» لو ليك). * الإسناد مابيبعتش إشعار للزميل، فقوله أو سيب له ملاحظة داخلية. اسمه ممكن يظهر في قائمة الإسناد، بس مشرف العملاء مايقدرش يفتح صفحة المحادثات. اسند المحادثات للمالك أو المدير، واسند **العميل المحتمل** نفسه لمشرف العملاء من [صفحة العميل](/ar/leads/lead-details). ## الأولوية [#الأولوية] جنب الإسناد فيه **الأولوية**: منخفضة، عادية، عالية، عاجلة. المحادثات العالية والعاجلة بيظهر جنبها كلمة حمرا في القائمة. الوكيل الذكي بيخليها **عالية** لوحده لما يحوّل لك، أو لما يلاقي عميل مؤهل تقييمه ساخن، وتقدر تغيرها في أي وقت. ## ملخص الذكاء الاصطناعي [#ملخص-الذكاء-الاصطناعي] في لوحة التفاصيل مربع **ملخص الذكاء الاصطناعي**: كام سطر بيقولوا العميل عايز إيه وفين وصلتوا. الوكيل بيكتبه لوحده لما يأهل العميل أو يحوّل المحادثة، ولو المحادثة اتحولت هتلاقي تحته **سبب التحويل**. عايز ملخص جديد بعد كلام كتير؟ اضغط **تلخيص** في المربع (أو من قائمة ⋮). مفيد جدًا لما تستلم محادثة طويلة أو تسلّمها لزميل. ## لوحة العميل المحتمل [#لوحة-العميل-المحتمل] في نفس لوحة التفاصيل بتشوف كل اللي محتاجه من غير ما تسيب المحادثة: **بيانات العميل**: الاسم والقناة، التليفون (اضغط عليه تتصل)، الإيميل، الجنسية والمدينة، والتصنيفات. وزرار **فتح جهة الاتصال** بيوديك [لملفه الكامل](/ar/leads/contacts). **العميل المحتمل**: مرحلة البيع، ومعاها اللي الوكيل جمعه: نوع الرحلة، الوجهة، الموعد، المسافرين، الميزانية، والتقييم. اضغط **فتح العميل المحتمل** عشان تكمّل الشغل عليه في [صفحة العميل](/ar/leads/lead-details). لو لسه مكتوب «لم يتم إنشاء عميل محتمل بعد»، يعني الوكيل لسه مابدأش يجمع بيانات رحلة. لو شايف إن العميل جاد، اضغط **إنشاء عميل محتمل**: هيتعمل عميل محتمل في مرحلة «قيد التأهيل» مربوط بالمحادثة، وهيفتح لك على طول. (الزرار ده للمالك والمدير.) ## الخطوة الجاية [#الخطوة-الجاية] # الحجوزات URL: https://docs.flyby.world/ar/finance/bookings > اعمل حجز أو حوّل عميل لحجز، ضيف البنود بسعرها وتكلفتها، وفلايباي يحسب الإجمالي والمتبقي والربح. الحجز هو قلب الحسابات: فيه العميل والرحلة والبنود اللي هيدفعها، وكل الدفعات والمصروفات بتتربط بيه. إنت بتدخل البنود والدفعات، والإجماليات بتتحسب لوحدها. الحجوزات متاحة للمالك والمدير في باقتي **النمو** و**المحترف**. ## طريقتين تعمل بيهم حجز [#طريقتين-تعمل-بيهم-حجز] 1. افتح **المالية ← الحجوزات**. 2. اضغط **حجز جديد**. 3. هيتفتح حجز جديد بحالة «معلّق» وبرقم حجز تلقائي، وتكمّل بياناته. افتح الحجوزات لما عميل محتمل يوافق، افتح صفحته من **العملاء المحتملين** واضغط **تحويل لحجز**. فلايباي هيعمل حجز جديد فيه: * العميل وتواريخ السفر والرجوع. * عدد المسافرين (كبار + أطفال + رضّع). * البرامج اللي العميل كان مهتم بيها كبنود، بسعر «يبدأ من» بتاع كل برنامج. وهيعلّم العميل المحتمل إنه **حجز** ويفتحلك الحجز على طول. هتلاقي في الحجز لينك «جاي من فرصة بيع» يرجّعك للعميل. **تكلفة الوحدة** لبنود البرامج بتيجي لوحدها من سعر الكبار في البرنامج (أرخص سعر كبار، اللي طالع منه سعر «يبدأ من»). اكتب التكاليف في [برامجك](/ar/catalog/packages) عشان الربح يطلع مظبوط؛ لو مفيش تكلفة متسجلة هناك البند هيتضاف بتكلفة صفر. ## بيانات الحجز [#بيانات-الحجز] | الخانة | ملاحظات | | --------------------------------- | ----------------------------------------------------- | | **عنوان الحجز** | إجباري. مثلاً «عمرة رمضان – عائلة أحمد» | | **العميل** | دوّر بالاسم أو الموبايل من جهات الاتصال | | **البرنامج** | اختياري، البرنامج الأساسي للحجز | | **تاريخ السفر** و**تاريخ الرجوع** | بيظهروا في الفاتورة | | **عدد المسافرين** | بيُستخدم ككمية تلقائية لما تضيف برنامج أو خدمة بالفرد | | **العملة** | الافتراضي هو العملة الأساسية للوكالة | | **الخصم** | مبلغ بيتخصم من إجمالي البنود | | **آخر ميعاد للسداد** | بنستخدمه في حساب المتأخرات وأعمار المستحقات | | **ملاحظات** | بتظهر في الفاتورة | اضغط **حفظ** بعد ما تعدّل. ## بنود الحجز [#بنود-الحجز] البنود هي اللي العميل هيدفعه وتكلفته عليك. اضغط **إضافة بند** واختار: * **من البرامج**: البند بياخد اسم البرنامج وسعر «يبدأ من»، والكمية = عدد المسافرين. * **من الخدمات**: بياخد سعر الخدمة وتكلفتها، والكمية = عدد المسافرين لو الخدمة بالفرد. * **بند فاضي**: بند حر تكتبه بنفسك. كل بند فيه: **النوع** (برنامج، خدمة، طيران، فندق، تأشيرة، تأمين، انتقالات، أخرى)، **الوصف**، **الكمية**، **سعر الوحدة** و**تكلفة الوحدة**. تقدر تعدّل أي حاجة فيهم أو تمسح البند. كارت **الحساب** بيتحدث مع كل تعديل: إجمالي البنود، الخصم، الإجمالي، التكلفة، الربح، المدفوع، المسترد، و**المتبقي على العميل**. ولو العميل دفع زيادة هتشوف «مدفوع زيادة (لازم يترد)»، ولو خلّص هتشوف «الحساب خالص». ## حالة الحجز وحالة الدفع [#حالة-الحجز-وحالة-الدفع] **حالة الحجز** بتغيّرها إنت من القايمة اللي فوق الحجز: | الحالة | امتى تستخدمها | | --------- | ------------------------------------------------ | | **معلّق** | الحجز لسه بيتجهز (الحالة الافتراضية) | | **مؤكد** | العميل أكّد واتحجزله | | **مكتمل** | الرحلة خلصت | | **ملغي** | الحجز اتلغى، ومش بيدخل في المبيعات ولا المستحقات | | **مسترد** | الفلوس اترجعت للعميل | **حالة الدفع** بتتحسب لوحدها من الدفعات: «مش مدفوع»، «مدفوع جزئياً»، «مدفوع بالكامل» أو «مدفوع زيادة». ## قايمة الحجوزات [#قايمة-الحجوزات] في **المالية ← الحجوزات** تقدر: * تفلتر حسب الحالة من التابات فوق. * تدوّر برقم الحجز أو العنوان أو اسم العميل. * تفلتر بـ**تاريخ الإنشاء** و**حالة الدفع**. * تنزّل القايمة بزرار **تصدير CSV** عشان تفتحها في Excel. التصدير متاح في باقة **المحترف** بس؛ في باقة النمو الزرار بيظهر بقفل «تصدير CSV (المحترف)» ويوديك لـ«الإعدادات ← الباقة والاشتراك». ## مسح حجز [#مسح-حجز] من صفحة الحجز اضغط **حذف**. هيتمسح الحجز وبنوده ودفعاته، أما مصروفات الموردين فهتفضل موجودة بس من غير ربط بالحجز. الأحسن تغيّر الحالة لـ«ملغي» بدل المسح، عشان يفضل عندك سجل كامل. ## الخطوة الجاية [#الخطوة-الجاية] # المصروفات URL: https://docs.flyby.world/ar/finance/expenses > سجّل اللي دفعته للموردين على كل حجز ومصاريف الشركة العامة، عشان تعرف صافي ربحك الحقيقي. من غير المصروفات، الأرقام بتوريك المبيعات بس. لما تسجّل مدفوعات الموردين ومصاريف الشركة، فلايباي يقدر يحسبلك **صافي الربح** الحقيقي. المصروفات متاحة للمالك والمدير في باقتي **النمو** و**المحترف**. ## نوعين مصروفات [#نوعين-مصروفات] | النوع | أمثلة | بيأثر على إيه | | ------------------ | ------------------------------------- | -------------------------------------- | | **مدفوعات موردين** | شركة طيران، فندق، خدمات أرضية | بتتسجل على الحجز وبتقارن بتكلفة البنود | | **مصاريف تشغيل** | إيجار، مرتبات، تسويق، برامج واشتراكات | بتتخصم من صافي الربح | ## تسجيل دفعة لمورد على حجز [#تسجيل-دفعة-لمورد-على-حجز] ### افتح الحجز [#افتح-الحجز] من **المالية ← الحجوزات**. ### اضغط «دفعة لمورد» [#اضغط-دفعة-لمورد] في كارت **تكاليف الموردين**. ### اكتب البيانات [#اكتب-البيانات] اختار **البند** (مورد طيران، مورد فنادق، خدمات أرضية، رسوم تأشيرات، عمولات، أخرى)، واكتب **المورد / الجهة** (مثلاً: مصر للطيران)، و**المبلغ** و**طريقة الدفع** و**التاريخ**. ### احفظ [#احفظ] المصروف هيتسجل بعملة الحجز ويظهر في الحجز وفي صفحة المصروفات. في كارت **تكاليف الموردين** هتشوف **التكلفة المتوقعة من البنود** جنب **اتدفع للموردين**، فتعرف لسه عليك كام للموردين. ## تسجيل مصروف عام [#تسجيل-مصروف-عام] 1. افتح **المالية ← المصروفات**. 2. اضغط **إضافة مصروف**. 3. اختار **البند** واكتب **المورد / الجهة** و**التفاصيل** و**المبلغ** و**طريقة الدفع** و**التاريخ** و**رقم مرجعي** لو موجود. 4. سيب خانة **الحجز** على «مصروف عام»، أو اختار حجز لو المصروف خاص بيه. افتح المصروفات ### البنود المتاحة [#البنود-المتاحة] مورد طيران · مورد فنادق · خدمات أرضية · رسوم تأشيرات · تسويق وإعلانات · مرتبات · إيجار · مرافق (كهربا ومية ونت) · برامج واشتراكات · عمولات · أخرى بنود **مورد طيران** و**مورد فنادق** و**خدمات أرضية** بتتحسب «مدفوعات موردين». أي بند تاني بيتحسب «مصاريف تشغيل» في نظرة عامة. ## صفحة المصروفات [#صفحة-المصروفات] * **إجمالي المصروفات** و**مدفوعات موردين** و**مصاريف تشغيل** للفترة. * **حسب البند**: دوس على أي بند عشان تفلتر بيه. * دوّر بالمورد أو التفاصيل. * **تصدير CSV** لتنزيل القايمة (في باقة **المحترف** بس؛ في النمو الزرار بيظهر بقفل «تصدير CSV (المحترف)» ويوديك لـ«الإعدادات ← الباقة والاشتراك»). * تقدر تعدّل أي مصروف أو تمسحه. سجّل المصروفات أول بأول (حتى الصغيرة). كده صافي الربح في نظرة عامة هيبقى أقرب للواقع. ## الخطوة الجاية [#الخطوة-الجاية] # الحسابات URL: https://docs.flyby.world/ar/finance > تابع الحجوزات والتحصيل والمصروفات والأرباح في مكان واحد، ومربوطة بعملاءك وبرامجك. قسم **الحسابات** (اسمه «المالية» في القائمة الجانبية) بيحوّل شغل المبيعات لأرقام واضحة: كل حجز بفلوسه، كل دفعة دخلت أو اترجعت، وكل مصروف طلع، وفي الآخر تعرف كسبت كام فعلاً. الحسابات موجودة في باقتي **النمو** و**المحترف** (وفي التجربة المجانية). لو إنت على باقة **البداية** هتلاقي شاشة بتعرّفك بالقسم وزرار «رقّي لباقة النمو». تصدير الحجوزات والمصروفات CSV متاح في **المحترف** بس. شوف [الباقات](/ar/billing). **مين يقدر يدخل؟** المالك والمدير بس. مشرف العملاء مالوش دخول على الحسابات. شوف [الأدوار والصلاحيات](/ar/team). افتح الحسابات ## أقسام الحسابات [#أقسام-الحسابات] | القسم | فيه إيه | | ------------- | --------------------------------------------------------------------------------- | | **نظرة عامة** | ملخص الأرقام والرسوم البيانية للفترة اللي تختارها | | **الحجوزات** | كل الحجوزات بفلوسها: المطلوب والمدفوع والمتبقي. [اعرف أكتر](/ar/finance/bookings) | | **المدفوعات** | كل الفلوس اللي دخلت من العملاء أو اترجعت لهم. [اعرف أكتر](/ar/finance/payments) | | **المصروفات** | مصاريف الشركة ومدفوعات الموردين. [اعرف أكتر](/ar/finance/expenses) | ## صفحة نظرة عامة [#صفحة-نظرة-عامة] فوق الصفحة هتلاقي **الفترة**: «الشهر ده»، «الشهر اللي فات»، «آخر ٣ شهور»، «السنة دي» أو «فترة مخصصة». كل الأرقام بتتحسب على الفترة اللي اخترتها. ### الأرقام الأساسية [#الأرقام-الأساسية] | الرقم | معناه | | -------------------------------------- | ------------------------------------------------------------------------- | | **المبيعات** | إجمالي قيمة الحجوزات اللي اتعملت في الفترة، من غير الملغية | | **المحصّل** | الفلوس اللي دخلت فعلاً في الفترة بعد خصم المرتجعات | | **مستحقات عند العملاء** | الفلوس المتبقية على العملاء في كل الحجوزات المفتوحة (مش مرتبطة بالفترة) | | **تكلفة الموردين** | التكلفة المتوقعة من بنود الحجوزات، وتحتها اللي اتدفع للموردين فعلياً | | **إجمالي الربح** | المبيعات ناقص تكلفة البنود، ومعاه هامش الربح | | **مصاريف التشغيل** | كل المصروفات ما عدا مدفوعات الموردين المباشرة (طيران وفنادق وخدمات أرضية) | | **صافي الربح** | المحصّل ناقص كل المصروفات | | **متوسط قيمة الحجز** و**عدد الحجوزات** | من غير الحجوزات الملغية | ### الرسوم والتقارير [#الرسوم-والتقارير] * **الأداء الشهري**: المبيعات والتحصيل والمصروفات والصافي لآخر ١٢ شهر. * **التحصيل حسب طريقة الدفع** و**المصروفات حسب البند**. * **أكتر البرامج مبيعاً**: حسب قيمة البنود المرتبطة ببرامج. * **الحجوزات حسب الحالة**. * **أعمار المستحقات**: المتبقي على العملاء مقسّم حسب التأخير (لسه مجاش ميعادها، ٠–٣٠ يوم، ٣١–٦٠، ٦١–٩٠، أكتر من ٩٠ يوم). * **أكبر المتأخرات**: الحجوزات اللي عدّى «آخر ميعاد للسداد» بتاعها وعليها فلوس. الأرقام بتتحسب بـ**العملة الأساسية** للوكالة (من [بيانات الوكالة](/ar/settings/agency-profile)). لو عندك حجوزات أو دفعات بعملة تانية، هتظهر في كارت «عملات تانية» لوحدها ومش هتدخل في الإجماليات. ## إزاي تبدأ [#إزاي-تبدأ] ### سجّل حجز [#سجّل-حجز] اعمل حجز جديد أو حوّل عميل محتمل لحجز بضغطة. [الحجوزات](/ar/finance/bookings) ### سجّل الدفعات [#سجّل-الدفعات] كل ما العميل يدفع، سجّل الدفعة على الحجز والمتبقي يتحدث لوحده. [المدفوعات](/ar/finance/payments) ### سجّل المصروفات [#سجّل-المصروفات] مدفوعات الموردين على كل حجز، ومصاريف الشركة العامة. [المصروفات](/ar/finance/expenses) ### اطبع الفاتورة [#اطبع-الفاتورة] فاتورة جاهزة باسم وكالتك ولوجوها. [الفواتير](/ar/finance/invoices) ## الخطوة الجاية [#الخطوة-الجاية] # الفواتير URL: https://docs.flyby.world/ar/finance/invoices > اطبع فاتورة لأي حجز باسم وكالتك ولوجوها، أو احفظها PDF وابعتها للعميل. كل حجز ليه فاتورة جاهزة بتتعمل من بياناته تلقائي. مش محتاج تكتب حاجة: أي تعديل في الحجز أو دفعاته بيظهر في الفاتورة على طول. الفواتير متاحة للمالك والمدير في باقتي **النمو** و**المحترف**. ## طباعة الفاتورة [#طباعة-الفاتورة] ### افتح الحجز [#افتح-الحجز] من **المالية ← الحجوزات**. ### اضغط «طباعة الفاتورة» [#اضغط-طباعة-الفاتورة] هتتفتح صفحة الفاتورة بمقاس A4. ### اضغط «طباعة» [#اضغط-طباعة] هتطبع الفاتورة بس، من غير قوايم البرنامج. ## إزاي تبعتها للعميل [#إزاي-تبعتها-للعميل] مفيش لينك عام للفاتورة. عشان تبعتها: 1. اضغط **طباعة**. 2. في نافذة الطباعة اختار **Save as PDF** (حفظ كـ PDF) بدل الطابعة. 3. ابعت ملف الـ PDF للعميل على واتساب أو الإيميل. الفاتورة بتطلع بلغة الواجهة اللي إنت فاتحها. لو عميلك محتاجها إنجليزي، غيّر لغة الواجهة للإنجليزي واطبعها، وهتظهر بـ«الاسم بالإنجليزي» بتاع الوكالة لو مكتوب. ## الفاتورة فيها إيه [#الفاتورة-فيها-إيه] | الجزء | المحتوى | | -------------------- | ---------------------------------------------------------------------------- | | **بيانات الوكالة** | اللوجو والاسم والعنوان والمدينة والتليفون والإيميل والموقع | | **رقم الفاتورة** | نفس رقم الحجز، ومعاه التاريخ و**تاريخ الاستحقاق** لو حددت «آخر ميعاد للسداد» | | **فاتورة إلى** | اسم العميل وموبايله وإيميله | | **الرحلة** | عنوان الحجز وتاريخ السفر وعدد المسافرين | | **البنود** | البيان والكمية وسعر الوحدة والقيمة | | **الإجماليات** | الإجمالي قبل الخصم، الخصم، الإجمالي، المدفوع، والمتبقي (أو «مدفوعة بالكامل») | | **الدفعات المستلمة** | كل دفعة بتاريخها وطريقتها ورقمها المرجعي | | **ملاحظات** | ملاحظات الحجز | | **الشروط والأحكام** | نص ثابت عن توافر الأماكن وسياسات الإلغاء وسداد المتبقي قبل السفر | الفاتورة بتعرض أسعار البيع بس. تكلفة البنود والربح مش بيظهروا للعميل أبداً. ## عشان الفاتورة تطلع كاملة [#عشان-الفاتورة-تطلع-كاملة] * ارفع اللوجو من **الإعدادات ← اللوجو**. * كمّل العنوان والتليفون والإيميل والموقع من [بيانات الوكالة](/ar/settings/agency-profile). * اختار العميل في الحجز عشان بياناته تظهر في «فاتورة إلى». ## الخطوة الجاية [#الخطوة-الجاية] # المدفوعات URL: https://docs.flyby.world/ar/finance/payments > سجّل الفلوس اللي استلمتها من العملاء أو رجّعتها لهم، والمتبقي على كل حجز يتحدث لوحده. كل ما عميل يدفع قسط أو يسترد فلوس، سجّلها هنا. الدفعة المربوطة بحجز بتحدّث المدفوع والمتبقي وحالة الدفع بتاعته تلقائي. المدفوعات متاحة للمالك والمدير في باقتي **النمو** و**المحترف**. ## تسجيل دفعة [#تسجيل-دفعة] تقدر تسجّل الدفعة من مكانين: * **من صفحة الحجز**: في كارت «دفعات العميل» اضغط **تسجيل دفعة**، والدفعة هتتربط بالحجز ده على طول. * **من الحسابات ← المدفوعات**: اضغط **تسجيل دفعة** واختار الحجز من خانة «الحجز» (أو سيبها «من غير حجز»). ### اختار النوع [#اختار-النوع] **تحصيل** لو استلمت فلوس من العميل، أو **استرداد** لو رجّعتله فلوس. ### اكتب المبلغ [#اكتب-المبلغ] لازم يكون أكبر من صفر. لو الدفعة مربوطة بحجز، بتتسجل بعملة الحجز. ### اختار طريقة الدفع والتاريخ [#اختار-طريقة-الدفع-والتاريخ] وضيف **رقم مرجعي** (رقم التحويل أو الإيصال) و**ملاحظات** لو حابب. ### احفظ [#احفظ] اضغط **حفظ الدفعة** (أو **حفظ الاسترداد**). ## طرق الدفع [#طرق-الدفع] نقدي · تحويل بنكي · بطاقة · إنستاباي · فودافون كاش · فوري · شيك · أخرى المدفوعات هنا **سجل** للفلوس اللي إنت استلمتها بطريقتك. فلايباي مش بيحصّل أي فلوس من العملاء ومش بياخد منها حاجة. ## إزاي المتبقي بيتحسب [#إزاي-المتبقي-بيتحسب] **المتبقي على العميل** = إجمالي الحجز − (المدفوع − المسترد). * لو المتبقي أكبر من صفر: الحجز «مدفوع جزئياً» أو «مش مدفوع». * لو صفر: «مدفوع بالكامل» و«الحساب خالص». * لو العميل دفع أكتر من الإجمالي: «مدفوع زيادة (لازم يترد)». سجّل **استرداد** بالفرق عشان يتظبط. ## صفحة المدفوعات [#صفحة-المدفوعات] في **المالية ← المدفوعات** هتلاقي كل الحركات للفترة اللي تختارها، وفوقها: * **إجمالي التحصيل** و**إجمالي المرتجعات** و**صافي المحصّل**. * التقسيم **حسب طريقة الدفع**. وتقدر تفلتر بطريقة الدفع أو النوع (تحصيل / استرداد) وتدوّر بالمرجع أو رقم الحجز أو اسم العميل. افتح المدفوعات ## تصحيح دفعة غلط [#تصحيح-دفعة-غلط] الدفعة مش بتتعدّل. لو سجّلت حاجة غلط، امسحها وسجّلها تاني. رصيد الحجز المربوط هيتحسب تاني تلقائي. ## الخطوة الجاية [#الخطوة-الجاية] # جولة في لوحة التحكم URL: https://docs.flyby.world/ar/getting-started/dashboard-tour > القايمة الجانبية، صفحة النظرة العامة، الإشعارات، تغيير اللغة، والموبايل. لوحة التحكم معمولة عشان تعرف في ثانية مين محتاجك النهارده. الصفحة دي بتعرّفك كل حاجة مكانها فين. ## القايمة الجانبية [#القايمة-الجانبية] القايمة مقسومة لمجموعات، وكل واحد بيشوف بس الأقسام اللي صلاحيته تسمح بيها. | المجموعة | الأقسام | مين يشوفها | | ------------ | ------------------------------------------------------------------------ | ---------------------------------------------------- | | البداية | **نظرة عامة**، **الوكيل الذكي** | الكل يشوف النظرة العامة. الوكيل الذكي للمالك والمدير | | الشغل اليومي | **المحادثات**، **العملاء المحتملون**، **جهات الاتصال**، **المهام** | المشرف مبيشوفش المحادثات، وبيشوف العملاء المؤهلين بس | | الكتالوج | **البرامج السياحية**، **الخدمات**، **الأسئلة الشائعة**، **صفحتك العامة** | المالك والمدير | | الإدارة | **المالية**، **الفريق** | المالك والمدير (المالية في باقة النمو والمحترف) | تحت خالص هتلاقي: * **جرس الإشعارات** (الإشعارات). * **الإعدادات**: مفتوحة للكل، بس المشرف بيشوف إعدادات جهازه بس (الإشعارات وتثبيت التطبيق). * **كارت البروفايل**: اضغط عليه تلاقي **حسابي**، وزرار تغيير اللغة، و**تسجيل الخروج**. وجنبه زرار تصغير وتوسيع القايمة على الكمبيوتر. الرقم جنب **المحادثات** = محادثات مستنية رد من فريقك. جنب **العملاء المحتملون** = عملاء لسه في مرحلة **مؤهل** ومتحركوش لعرض سعر. جنب **المهام** = مهام جه ميعادها أو متأخرة. ## نظرة عامة [#نظرة-عامة] أول صفحة بتفتح. فوق هتلاقي تحية وأزرار سريعة: **افتح المحادثات**، **العملاء المؤهلين**، **برنامج جديد**، **جرّب الوكيل**. واختار **الفترة**: النهارده، آخر 7 أيام، أو آخر 30 يوم. **الكروت اللي فوق** (للمالك والمدير): * **محادثات جديدة**، ومعاها النسبة اللي الوكيل خلّصها لوحده. * **محتاجة رد منك** دلوقتي. * **عملاء مؤهلين** في الفترة. * **صفقات اتقفلت** و**التحصيل**. * **برامج نشطة**. **تحتها**: رسم المحادثات (الوكيل مقابل فريقك)، القنوات، **مراحل العملاء**، **أنواع الرحلات المطلوبة**، وقوايم: **محتاجين ردك**، **عملاء ساخنين**، **مهام النهارده والمتأخرة**، و**رحلات مسافرة قريب**. المشرف بيشوف **عملائي المؤهلين** و**عملاء ساخنين** و**مهام مستحقة**، من غير أرقام المحادثات والفلوس. ## الشريط اللي فوق الصفحة [#الشريط-اللي-فوق-الصفحة] للمالك والمدير، بيظهر شريط تنبيه فوق لوحة التحكم لما: * التجربة المجانية فاضل فيها 3 أيام أو أقل، أو خلصت. * استخدمت 80% من محادثات الذكاء الاصطناعي، أو خلصتها. الشريط فيه لينك على طول لـ **الإعدادات ← الباقة والاشتراك**. [إزاي المحادثات بتتحسب](/ar/billing/ai-conversations) ## الإشعارات [#الإشعارات] اضغط **الجرس** تشوف آخر التنبيهات: عميل اتأهل، محادثة محتاجة تدخل، الوكيل معرفش يرد، أو تنبيهات الباقة. اضغط أي إشعار يفتحلك المحادثة أو العميل، أو **تعليم الكل كمقروء**. عشان الإشعارات توصلك حتى وفلايباي مقفول، فعّلها من **الإعدادات ← الإشعارات** على كل جهاز بتستخدمه. [إعداد الإشعارات](/ar/settings/notifications) ## تغيير اللغة [#تغيير-اللغة] اضغط كارت البروفايل تحت في القايمة واختار **English**. هتفضل في نفس الصفحة بس بالإنجليزي. وللرجوع اختار **العربية**. لغة لوحة التحكم ليك إنت وفريقك بس. الوكيل بيكلم العملاء باللهجة اللي محددها في [شخصية الوكيل](/ar/ai-agent/persona). ## على الموبايل [#على-الموبايل] * فوق: شريط فيه اسم الصفحة، وسهم رجوع في صفحات التفاصيل، والجرس. * تحت: شريط فيه لحد 4 أقسام حسب صلاحيتك. للمالك والمدير: **الرئيسية**، **المحادثات**، **العملاء**، **البرامج**. للمشرف: **الرئيسية**، **العملاء**، **الأسماء**، **المهام**. * **المزيد** بيفتح القايمة الجانبية كاملة. الجداول بتتحول لكروت على الشاشات الصغيرة. ولتجربة أحسن [ثبّت فلايباي كتطبيق](/ar/getting-started/install-app). ## الخطوة الجاية [#الخطوة-الجاية] # أول ساعة مع فلايباي URL: https://docs.flyby.world/ar/getting-started > 6 خطوات تخلّي الوكيل الذكي يرد على عملاءك فعلًا من النهارده. الصفحة دي خطة عملية لأول ساعة ليك على فلايباي. امشي عليها بالترتيب، وفي الآخر هيكون عندك وكيل ذكي عارف برامجك، متجرّب، وبيرد على العملاء. ### افتح حسابك وجهّز الوكالة (10 دقايق) [#افتح-حسابك-وجهّز-الوكالة-10-دقايق] سجّل بالإيميل أو **كمّل بجوجل**، وبعدين هتعدي على 4 خطوات تجهيز: بيانات الوكالة، اسم الوكيل وأسلوبه، الباقة (والتجربة المجانية 14 يوم بتبدأ على طول)، ودعوة الفريق. [إنشاء الحساب](/ar/getting-started/sign-up) · [خطوات التجهيز](/ar/getting-started/onboarding) ### ضيف برامجك وخدماتك (20 دقيقة) [#ضيف-برامجك-وخدماتك-20-دقيقة] الوكيل **مبيرشحش غير اللي إنت ضايفه**. ابدأ بأهم 3–5 برامج شغالة دلوقتي بأسعارها ومواعيدها، والخدمات اللي بتبيعها لوحدها (تأشيرات، طيران، فنادق…). خلي حالة البرنامج **شغّال** عشان الوكيل يشوفه. [البرامج السياحية](/ar/catalog/packages) · [الخدمات](/ar/catalog/services) ### اكتب الأسئلة الشائعة (10 دقايق) [#اكتب-الأسئلة-الشائعة-10-دقايق] طرق الدفع، سياسة الإلغاء، المستندات المطلوبة، التقسيط… دي الأسئلة اللي الوكيل هيرد منها حرفيًا. [إزاي تكتب أسئلة شائعة كويسة](/ar/ai-agent/knowledge-base) ### ظبّط الوكيل الذكي (10 دقايق) [#ظبّط-الوكيل-الذكي-10-دقايق] من **الوكيل الذكي** في القايمة: راجع الاسم واللهجة ورسالة الترحيب، اختار **بيانات التأهيل** اللي محتاجها، واكتب تعليماتك الخاصة وإمتى يحوّل لموظف. [شخصية الوكيل](/ar/ai-agent/persona) · [التعليمات](/ar/ai-agent/instructions) · [بيانات التأهيل](/ar/ai-agent/qualification) ### جرّب الوكيل كأنك عميل (5 دقايق) [#جرّب-الوكيل-كأنك-عميل-5-دقايق] اضغط **جرّب كعميل** واسأله زي ما عملاءك بيسألوا: أسعار، مواعيد، خصم، طلب تكلم موظف. اتأكد إن الردود مظبوطة قبل ما تفتحه للناس. [إزاي تختبر الوكيل](/ar/ai-agent/test-agent) ### افتح القنوات وفعّل الإشعارات (5 دقايق وأكتر) [#افتح-القنوات-وفعّل-الإشعارات-5-دقايق-وأكتر] * **لينك الشات العام** جاهز على طول: حطه في البايو وعلى صفحاتك. * **واتساب** محتاج ربط بحساب Meta بتاع شركتك ([الخطوات](/ar/channels/whatsapp)). * فعّل **الإشعارات** على موبايلك وكمبيوترك عشان أول عميل مؤهل يوصلك على طول. على الآيفون لازم [تثبّت التطبيق](/ar/getting-started/install-app) الأول. [القنوات](/ar/channels) · [الإشعارات](/ar/settings/notifications) أول 14 يوم مجانًا، فيهم 50 محادثة ذكاء اصطناعي ومميزات باقة النمو، ومن غير كارت. [تفاصيل التجربة](/ar/billing/trial) لو مفيش ولا برنامج شغّال، الوكيل هيقول للعميل إن حد من الفريق هيجهزله عرض، وهيحاول يأهّله بس. ضيف برامجك الأول قبل ما تنشر اللينك. ## بعد كده [#بعد-كده] # ثبّت فلايباي كتطبيق URL: https://docs.flyby.world/ar/getting-started/install-app > أيقونة على الشاشة ونافذة لوحدها وإشعارات على الآيفون، من غير ما تنزّل حاجة من الستور. فلايباي ممكن يتثبّت على الموبايل أو الكمبيوتر كأنه تطبيق: أيقونة على الشاشة، نافذة خاصة بيه، وبيفتح أسرع. مش محتاج App Store ولا Google Play. الآيفون مش بيسمح للمواقع تبعت إشعارات غير لما تكون متثبتة على الشاشة الرئيسية. يعني لو عايز يوصلك إشعار لما عميل يتأهل أو محادثة تحتاجك، **لازم** تثبّت فلايباي الأول. الخطوات موجودة كمان جوه التطبيق في **الإعدادات ← تثبيت التطبيق**، ولو المتصفح بيدعم التثبيت المباشر هتلاقي زرار **ثبّت**. افتح تثبيت التطبيق ## خطوات التثبيت [#خطوات-التثبيت] 1. افتح [flyby.world](https://flyby.world) من **Safari** وسجّل دخول. 2. اضغط زرار **المشاركة** (المربع اللي طالع منه سهم). 3. انزل واختار **إضافة إلى الشاشة الرئيسية**، وبعدين **إضافة**. 4. افتح فلايباي من الأيقونة الجديدة، وسجّل دخول لو طلب منك. 5. روح **الإعدادات ← الإشعارات** وفعّل **إشعارات المتصفح**، ووافق لما الآيفون يسألك. الإشعارات على الآيفون محتاجة iOS 16.4 أو أحدث. 1. افتح [flyby.world](https://flyby.world) من **Chrome** وسجّل دخول. 2. افتح قايمة **⋮** فوق. 3. اضغط **تثبيت التطبيق** (أو «إضافة إلى الشاشة الرئيسية» في بعض الأجهزة). 4. فعّل الإشعارات من **الإعدادات ← الإشعارات**. على أندرويد الإشعارات بتشتغل من المتصفح حتى من غير تثبيت، بس التطبيق أسهل وأسرع. 1. افتح فلايباي من **Chrome** أو **Edge** أو **Brave**. 2. دوّر على أيقونة التثبيت في آخر شريط العنوان. 3. اضغط عليها واختار **تثبيت**. 4. فلايباي هيفتح في نافذة لوحده، وتقدر تثبّته في شريط المهام. Firefox وSafari على الكمبيوتر مش بيدعموا التثبيت لسه، بس الإشعارات بتشتغل فيهم عادي. تفعيل الإشعارات على الموبايل مش بيفعّلها على الكمبيوتر. ظبّطها على كل جهاز بتشتغل منه. [إعداد الإشعارات](/ar/settings/notifications) ## لما يتثبّت [#لما-يتثبّت] * في **الإعدادات ← تثبيت التطبيق** هتلاقي «متثبّت على الجهاز ده». * اللوحة بتفتح في شاشة كاملة من غير شريط المتصفح، والشريط اللي تحت بيبقى زي أي تطبيق. * لإلغاء التثبيت: امسح الأيقونة زي أي تطبيق عادي. ## الخطوة الجاية [#الخطوة-الجاية] # تجهيز الوكالة (4 خطوات) URL: https://docs.flyby.world/ar/getting-started/onboarding > بيانات الوكالة، الوكيل الذكي، الباقة والتجربة المجانية، ودعوة الفريق. بعد التسجيل بتعدي على 4 خطوات قصيرة قبل ما تدخل لوحة التحكم. كل حاجة بتختارها هنا تقدر تعدّلها بعدين من الإعدادات أو من صفحة **الوكيل الذكي**. المالك مش هيقدر يفتح لوحة التحكم غير بعد الخطوة الرابعة. لو قفلت الصفحة في النص، هترجع لنفس الخطوة اللي وقفت عندها أول ما تدخل تاني. ### 1. أنشئ وكالتك [#1-أنشئ-وكالتك] * **اسم الوكالة**: الاسم اللي العملاء يعرفوك بيه، مثلًا «النيل للسياحة». * **رقم واتساب الوكالة** (إجباري): الرقم اللي العملاء بيتواصلوا عليه. اكتبه بكود الدولة، زي ‎+20 10 0000 0000. * **الدولة**: مصر، السعودية، الإمارات، الكويت، قطر، البحرين، عُمان أو الأردن. عملة الأسعار بتتحدد منها تلقائيًا (جنيه للمصري، ريال للسعودي، درهم للإماراتي…). * **لهجة الوكيل الذكي**: مصري، خليجي، شامي، فصحى، أو **حسب العميل** لو عملاءك من بلاد مختلفة. اضغط **إنشاء الوكالة**. ### 2. اتعرّف على وكيلك الذكي [#2-اتعرّف-على-وكيلك-الذكي] * **اسم الوكيل**: الاسم اللي العملاء هيشوفوه في الشات، زي «سارة» أو «مساعد النيل». حرفين على الأقل. * **أسلوب الكلام**: **ودود** أو **رسمي** أو **فاخر**. تحت الاختيارات هتلاقي معاينة «إزاي هيرحّب بالعميل» بتتغير مع كل اختيار. اضغط **كمّل**. التفاصيل الأكتر (رسالة الترحيب، التعليمات، بيانات التأهيل) هتظبطها بعدين من [صفحة الوكيل الذكي](/ar/ai-agent/persona). ### 3. اختار باقتك [#3-اختار-باقتك] * اختار **شهري** أو **سنوي** (السنوي فيه **شهرين ببلاش**). * اختار الباقة: **البداية** أو **النمو** (الأكثر طلبًا) أو **المحترف**. تحت كل باقة هتلاقي عدد محادثات الذكاء الاصطناعي والمستخدمين والقنوات. * اضغط **ابدأ التجربة المجانية 14 يوم**. التجربة بتبدأ فورًا: 14 يوم و50 محادثة ذكاء اصطناعي بمميزات باقة النمو، **من غير كارت**. الباقة اللي اخترتها بتتسجّل كطلب، وفريقنا هيكلمك يفعّلها قبل ما التجربة تخلص. [مقارنة الباقات](/ar/billing) · [تفاصيل التجربة](/ar/billing/trial) ### 4. ادعي فريقك (اختياري) [#4-ادعي-فريقك-اختياري] اكتب **الإيميل** لكل زميل واختار **الصلاحية**: * **مدير**: يعمل كل حاجة ماعدا إنه يشيل المالك أو ينزّل صلاحيته. * **مشرف عملاء**: يشوف العملاء المؤهلين وجهات الاتصال بس. اضغط **ضيف واحد كمان** لأكتر من شخص، وبعدين **ابعت الدعوات وكمّل**. أو اضغط **تخطّى دلوقتي** وادعيهم بعدين من صفحة **الفريق**. بعد **ابعت الدعوات وكمّل** هتظهرلك «ابعت لزمايلك لينكات الدعوة»: لينك لكل زميل وجنبه زرارين **انسخ اللينك** و**ابعت على واتساب**. ابعتهم، وبعدين اضغط **ادخل على لوحة التحكم**. فلايباي مش بيبعت إيميلات دعوة، فابعت اللينكات لزمايلك من الشاشة دي على طول. لو فاتك حد، هتلاقي اللينكات بعدين في **الفريق** ← **دعوات مستنية القبول**. لازم زميلك يسجّل بنفس الإيميل عشان يقبل الدعوة، واللينك صالح 14 يوم. [تفاصيل الدعوات](/ar/team/invites) التجربة المجانية فيها 5 مستخدمين (إنت منهم)، وبعدها كل باقة ليها عددها: البداية 2، النمو 5، المحترف 15. الدعوات اللي لسه متقبلتش بتتحسب منهم. لو وصلت للحد هتظهرلك رسالة «وصلت لعدد المستخدمين المتاح في التجربة». ## بعد التجهيز [#بعد-التجهيز] أول ما تخلّص الخطوة الرابعة (أو تضغط **ادخل على لوحة التحكم**) هتدخل على **نظرة عامة**. اللي جاي: # إنشاء الحساب وتسجيل الدخول URL: https://docs.flyby.world/ar/getting-started/sign-up > افتح حسابك بالإيميل أو بجوجل، أكّد بريدك، ورجّع كلمة السر لو نسيتها. فتح الحساب بياخد دقيقة. تقدر تسجّل بإيميل وكلمة سر، أو بضغطة واحدة من حساب جوجل. ## التسجيل [#التسجيل] 1. افتح [flyby.world/ar/signup](https://flyby.world/ar/signup). 2. اضغط **كمّل بجوجل** واختار حسابك. 3. هتدخل على طول على خطوات تجهيز الوكالة. مش محتاج تأكيد إيميل، لأن جوجل أكّده خلاص. على الكمبيوتر ممكن يظهرلك اقتراح جوجل بالحساب المفتوح في المتصفح أول ما تفتح الصفحة، اضغط عليه وخلاص. 1. افتح [flyby.world/ar/signup](https://flyby.world/ar/signup). 2. اكتب **الاسم بالكامل** و**البريد الإلكتروني** و**كلمة المرور** (8 حروف على الأقل). 3. اضغط **إنشاء حساب**. هتظهرلك رسالة «أرسلنا لك رابط تأكيد على بريدك الإلكتروني». 4. افتح الإيميل واضغط لينك التأكيد. اللينك بيفتح على flyby.world ويوديك على خطوات تجهيز الوكالة. دوّر في الـ Spam أو «العروض الترويجية». ولو حاولت تدخل قبل ما تأكّد، هتظهرلك رسالة «يجب تأكيد بريدك الإلكتروني أولاً». لو اللينك قديم أو اتستخدم قبل كده، سجّل دخول عادي أو اطلب لينك جديد من «نسيت كلمة المرور؟». ## حساب واحد = وكالة واحدة [#حساب-واحد--وكالة-واحدة] كل حساب مربوط بوكالة واحدة بس. اللي بيعمل الحساب ويجهّز الوكالة بيبقى **المالك**. زمايلك مش محتاجين يعملوا وكالة: إنت بتبعتلهم دعوة وهما يدخلوا على وكالتك بالصلاحية اللي تختارها. افتح اللينك، وسجّل دخول أو اعمل حساب **بنفس الإيميل اللي الدعوة اتبعتت عليه**، وبعدين اضغط **قبول الدعوة**. مش هتعدي على خطوات التجهيز، هتدخل على لوحة التحكم على طول. [تفاصيل الدعوات](/ar/team/invites) ## تسجيل الدخول [#تسجيل-الدخول] افتح [flyby.world/ar/login](https://flyby.world/ar/login) واختار **كمّل بجوجل** أو اكتب الإيميل وكلمة السر واضغط **تسجيل الدخول**. لو عملت حسابك بجوجل، ادخل بجوجل برضه. ## نسيت كلمة السر [#نسيت-كلمة-السر] ### اطلب لينك جديد [#اطلب-لينك-جديد] من صفحة الدخول اضغط **نسيت كلمة المرور؟**، اكتب إيميلك واضغط **إرسال الرابط**. ### افتح الإيميل [#افتح-الإيميل] لو الإيميل مسجّل عندنا هيوصلك لينك خلال دقايق. اللينك بيفتح على flyby.world. ### اختار كلمة سر جديدة [#اختار-كلمة-سر-جديدة] اكتب **كلمة المرور الجديدة** (8 حروف على الأقل) واضغط **تحديث كلمة المرور**، وهتدخل على لوحة التحكم. تقدر كمان تغيّر كلمة السر وإنت داخل من **حسابي** (من قايمة البروفايل تحت في القايمة الجانبية) ← **تغيير كلمة المرور**. ## الخطوة الجاية [#الخطوة-الجاية] # أسئلة شائعة URL: https://docs.flyby.world/ar/help/faq > إجابات سريعة عن الأسعار، التجربة المجانية، رسوم Meta، اللهجات، الخصوصية، الإلغاء وأخطاء الوكيل. أكتر الأسئلة اللي شركات السياحة بتسألها قبل وبعد ما تبدأ مع فلايباي. ملقيتش سؤالك؟ ابعتلنا على [support@flyby.world](mailto:support@flyby.world). ## الأسعار والاشتراك [#الأسعار-والاشتراك] | الباقة | مصر (شهريًا) | باقي الدول (شهريًا) | محادثات ذكاء اصطناعي | المستخدمين | | ----------- | ------------ | ------------------- | -------------------- | ---------- | | **البداية** | 1,990 جنيه | ‎$69 | 150 | 2 | | **النمو** | 4,490 جنيه | ‎$169 | 500 | 5 | | **المحترف** | 7,990 جنيه | ‎$299 | 1,200 | 15 | الاشتراك السنوي = **شهرين ببلاش**. الشركات في مصر بتدفع بالجنيه، وباقي الدول بالدولار. [مقارنة الباقات بالتفصيل](/ar/billing) 14 يوم، فيهم 50 محادثة ذكاء اصطناعي وكل مميزات باقة النمو (كل القنوات والمالية)، **من غير كارت**. بتبدأ أول ما تخلّص خطوة اختيار الباقة في التجهيز. [تفاصيل التجربة](/ar/billing/trial) الوكيل الذكي بيقف عن الرد، والمحادثات الجديدة بتروح لفريقك في **محتاج موظف**. بياناتك كلها (البرامج، العملاء، المحادثات) بتفضل زي ما هي. أول ما باقتك تتفعّل الوكيل بيرجع يرد. لسه مفيش دفع أونلاين. بتختار الباقة أو الإضافة من **الإعدادات ← الباقة والاشتراك**، والطلب بيوصل فريقنا، وبنكلمك نأكد الدفع ونفعّلها (عادةً خلال يوم عمل). [الباقات](/ar/billing) محادثة عميل واحدة الوكيل رد فيها، وبتتحسب مرة واحدة كل 24 ساعة مهما كان عدد الرسايل. العداد بيتصفّر أول كل شهر (بتوقيت القاهرة)، واللي مستخدمتوش مش بيترحّل. بيوصلك تنبيه عند 80%، وعند 100% الوكيل بيقف والمحادثات الجديدة بتروح لفريقك. [التفاصيل](/ar/billing/ai-conversations) اطلب **+100 محادثة** للشهر ده من **الإعدادات ← الباقة والاشتراك** (البداية 900 جنيه / ‎$19، النمو 750 / ‎$15، المحترف 600 / ‎$12)، أو رقّي باقتك. الإضافات متاحة بعد ما تبقى على باقة مدفوعة، فلو لسه في التجربة اختار باقة الأول. [الإضافات](/ar/billing/add-ons) أيوه، ممكن. رسوم رسايل واتساب (لو فيه) بتتدفع لـ Meta مباشرةً على حساب شركتك، مش لفلايباي. الردود على العميل جوه نافذة الـ 24 ساعة من آخر رسالة ليه عادةً مجانية من Meta. راجع أسعار Meta الحالية لبلدك. أيوه. خدمة **إعداد Meta** بـ 1,500 جنيه / ‎$49 مرة واحدة لباقة البداية والنمو، ومجانية في باقة المحترف. اطلبها من **الإعدادات ← الباقة والاشتراك**. [الإضافات](/ar/billing/add-ons) أيوه، من **الإعدادات ← الباقة والاشتراك** اضغط **غيّر باقتك**، أو ضيف مستخدم إضافي بـ 250 جنيه / ‎$9 في الشهر. الطلب بيوصل فريقنا ويتفعّل بعد تأكيد الدفع. ابعتلنا على [support@flyby.world](mailto:support@flyby.world) قبل ميعاد التجديد ومش هنجدد. ولو عايز تمسح الوكالة وكل بياناتها نهائيًا، المالك يقدر يعمل ده من **الإعدادات ← منطقة الخطر ← حذف الوكالة** (مفيش رجوع فيها). شوف [سياسة الاسترداد](https://flyby.world/ar/refund). ## الوكيل الذكي [#الوكيل-الذكي] مصري، خليجي، شامي، وفصحى، وبيفهم الفرانكو. لو اخترت **حسب العميل** بيرد بنفس لهجة العميل، وبالإنجليزي لو العميل كتب إنجليزي. [شخصية الوكيل](/ar/ai-agent/persona) الوكيل مبيألّفش: كل سعر وميعاد بيقوله جاي من الكتالوج بتاعك، ولو المعلومة مش موجودة بيقول إن مستشار هيأكد. فأغلب الأخطاء سببها معلومة قديمة أو ناقصة في البرامج أو الأسئلة الشائعة. لو لقيت رد غلط: 1. استلم المحادثة من **استلام المحادثة** وصحّح للعميل بنفسك. 2. صحّح المعلومة في البرنامج أو الأسئلة الشائعة، أو ضيف نقطة في التعليمات. 3. [جرّب الوكيل](/ar/ai-agent/test-agent) تاني. ننصحك تراجع المحادثات بانتظام، خصوصًا في الأسابيع الأولى. لا. الوكيل بيبيع ويأهّل ويسلّم العميل لفريقك. تأكيد الحجز والدفع دايمًا مع فريقك، وتقدر تسجلهم في [المالية](/ar/finance) (باقة النمو والمحترف). لا. الوكيل بيشوف إن العميل بعت «رسالة صوتية» أو «صورة» بس، من غير محتواها. لو الصورة معاها كلام مكتوب بيقراه. فريقك يقدر يشوف الرسالة في المحادثة ويرد. مفيش جدول تشغيل تلقائي لسه. تقدر تشغّله وتوقفه بإيدك من زرار **الوكيل بيرد على العملاء**. وفي العادي الوكيل عارف [مواعيد عمل](/ar/settings/working-hours) فريقك، وبرا المواعيد بيقول للعميل إن الفريق هيتابع معاه في مواعيد العمل. لا. Meta بتسمح بالرد الحر بس خلال 24 ساعة من آخر رسالة من العميل. بعدها واتساب محتاج رسايل قوالب معتمدة، وفلايباي مش بيبعت قوالب لسه. [نافذة الـ 24 ساعة](/ar/conversations/messaging-window) ## الحساب والفريق والبيانات [#الحساب-والفريق-والبيانات] بيانات كل وكالة منفصلة تمامًا عن باقي الوكالات، وجوه وكالتك كل واحد بيشوف اللي صلاحيته تسمح بيه بس. توكنات Meta والمفاتيح السرية بتتحفظ متشفّرة ومش بتظهر تاني بعد الحفظ. اقرا [سياسة الخصوصية](https://flyby.world/ar/privacy) و[سياسة رسائل Meta](https://flyby.world/ar/meta-policy). لا، كل حساب ليه وكالة واحدة. لو عندك فروع، كلها تبقى في نفس الوكالة، وباقة المحترف بتسمحلك تعرض الفروع في [صفحتك العامة](/ar/public-page/offers-and-branches). لوكالة تانية منفصلة اعمل حساب بإيميل تاني. البداية 2 مستخدمين، النمو 5، المحترف 15، وتقدر تزوّد. في 3 أدوار: **المالك**، **مدير** (كل حاجة ماعدا إنه يشيل المالك)، و**مشرف عملاء** (العملاء المؤهلين وجهات الاتصال بس). [الأدوار والصلاحيات](/ar/team) أيوه، من المتصفح أو كتطبيق تثبّته على الشاشة الرئيسية من غير ستور. على الآيفون لازم تثبّته عشان الإشعارات تشتغل. [ثبّت التطبيق](/ar/getting-started/install-app) # حل المشاكل URL: https://docs.flyby.world/ar/help/troubleshooting > أشهر المشاكل وحلولها، من الوكيل اللي مش بيرد لحد الإشعارات اللي مش بتوصل والدخول بجوجل. قبل ما تكلمنا، دوّر على المشكلة هنا: أغلب المشاكل ليها سبب معروف وبتتحل في دقيقة. لو جربت الحلول ولسه المشكلة موجودة، ابعتلنا على [support@flyby.world](mailto:support@flyby.world) ومعاك اسم الوكالة ووصف للي حصل. ## الوكيل الذكي [#الوكيل-الذكي] راجع بالترتيب: 1. **الزرار شغال؟** افتح **الوكيل الذكي** وبص على **الوكيل بيرد على العملاء**. لازم يكون **شغال**. 2. **في شريط أحمر فوق لوحة التحكم؟** لو التجربة خلصت أو محادثات الشهر خلصت، الوكيل بيقف والمحادثات بتروح لفريقك. شوف [الباقة والاشتراك](/ar/billing). 3. **في رسالة إن إدارة المنصة وقفت الوكيل أو الحساب؟** دي محتاجة تكلمنا على [support@flyby.world](mailto:support@flyby.world). 4. **القناة نفسها شغالة؟** لو الرسايل مش بتظهر في **المحادثات** أصلًا، المشكلة في ربط القناة مش في الوكيل. شوف «واتساب مش بيستقبل رسايل» تحت. غالبًا المحادثة اتحولت لفريقك: * الوكيل حوّلها لوحده (العميل طلب موظف، شكوى، سؤال ملوش إجابة، أو قاعدة من قواعد التحويل). المحادثة هتلاقيها في **محتاج موظف**. * أو حد من فريقك استلمها أو رد فيها، فحالتها بقت **مع الفريق**. عشان الوكيل يرجع يرد، افتح المحادثة واضغط **إرجاع للوكيل الذكي**. [استلام المحادثة](/ar/conversations/handoff) حصل خطأ فني مؤقت وقت الرد، والمحادثة اتحولت لفريقك عشان العميل ميستناش. رد على العميل بنفسك، أو اضغط **إرجاع للوكيل الذكي** عشان يرد على الرسالة الجاية. لو اتكرر كتير كلمنا. * اتأكد إن حالة البرنامج **شغّال** (المسودة والمتوقف الوكيل مش شايفهم). * راجع الأسعار حسب نوع الغرفة، وضيف أسعار الأطفال والرضّع. * اكتب الوجهة بالعربي والإنجليزي في البرنامج. * حدّث مواعيد السفر، المواعيد اللي عدّت أو المقفولة مش بتتعرض. [مصادر معلومات الوكيل](/ar/ai-agent/knowledge-base) بص على **نسبة التحويل لموظف** في **أداء الوكيل**، وافتح المحادثات اللي اتحولت. غالبًا الأسباب: * أسئلة متكررة ملهاش إجابة في [الأسئلة الشائعة](/ar/catalog/faqs). * قواعد تحويل واسعة زيادة في [التعليمات](/ar/ai-agent/instructions). * برامج ناقصة معلومات (أسعار أطفال، مواعيد). لينك الشات العام متقفل. افتح **الإعدادات ← القنوات والربط** وشغّل **رابط الشات العام**. [شات الموقع](/ar/channels/website-chat) ## محادثات الذكاء الاصطناعي والباقة [#محادثات-الذكاء-الاصطناعي-والباقة] استخدمت كل محادثات باقتك الشهر ده، فالوكيل وقف والمحادثات الجديدة بتروح لفريقك. المحادثات اللي الوكيل كان رد فيها خلال آخر 24 ساعة بيكمّل فيها عادي. الحل: * اطلب **+100 محادثة** للشهر ده، أو رقّي باقتك من **الإعدادات ← الباقة والاشتراك**. * أو استنى أول الشهر، العداد بيتصفّر (بتوقيت القاهرة). [إزاي المحادثات بتتحسب](/ar/billing/ai-conversations) مفيش دفع أونلاين لسه، فالطلب بيستنى فريقنا يكلمك ويأكد الدفع. هتلاقيه في **الإعدادات ← الباقة والاشتراك** تحت «مستني التفعيل». عادةً بنتواصل خلال يوم عمل، ولو اتأخر ابعتلنا. المالك لازم يخلّص الأربع خطوات قبل ما يدخل لوحة التحكم. كمّل من الخطوة اللي وقفت عندها، وخطوة دعوة الفريق تقدر تتخطاها بـ **تخطّى دلوقتي**. [تجهيز الوكالة](/ar/getting-started/onboarding) ## القنوات [#القنوات] افتح **الإعدادات ← القنوات والربط ← واتساب بيزنس** وبص على الحالة: * **مستني أول رسالة**: الربط تمام بس لسه مفيش رسالة وصلت. ابعت رسالة من موبايل تاني للرقم. * **محتاج مراجعة** أو مفيش رسايل خالص؟ راجع: 1. الزرار بتاع القناة شغال. 2. في تطبيق Meta: **WhatsApp ← Configuration**، الـ **Callback URL** والـ **Verify token** هما نفس اللي في فلايباي، ومشترك في **messages**. 3. التطبيق في وضع **Live** مش Development. 4. التوكن معمول بصلاحية **Never**، وليه الأذونات المطلوبة، وما اتلغاش. 5. الـ **Phone number ID** والـ **WhatsApp Business Account ID** صح. 6. اضغط **حفظ واختبار** بعد أي تعديل. [ربط واتساب خطوة بخطوة](/ar/channels/whatsapp) · ومحتاج حد يربطهولك؟ اطلب خدمة إعداد Meta من [الإضافات](/ar/billing/add-ons). لو آخر رسالة من العميل عدّى عليها أكتر من 24 ساعة، Meta مش بتسمح برد حر. العميل لازم يبعت رسالة جديدة الأول. [نافذة الـ 24 ساعة](/ar/conversations/messaging-window) لو جوه الـ 24 ساعة، راجع إن التوكن لسه شغال وإن حالة القناة مش **محتاج مراجعة**. القناتين دول متاحين في باقة **النمو** و**المحترف** (وفي التجربة المجانية). لو إنت على باقة البداية هتلاقيهم مقفولين برسالة «متاحة من باقة النمو وأعلى». [ماسنجر](/ar/channels/messenger) · [إنستجرام](/ar/channels/instagram) ## الإشعارات [#الإشعارات] 1. **فعّلتها على الجهاز ده؟** الإشعارات لكل جهاز لوحده. افتح **الإعدادات ← الإشعارات** على الموبايل والكمبيوتر وفعّل **إشعارات المتصفح** على كل واحد. 2. **آيفون؟** لازم تثبّت فلايباي على الشاشة الرئيسية الأول، وبعدين تفعّل الإشعارات من جوه التطبيق المتثبّت. [ثبّت التطبيق](/ar/getting-started/install-app) 3. **ظهرت رسالة إن الإشعارات مقفولة؟** إنت رفضتها قبل كده. اضغط علامة القفل جنب العنوان في المتصفح، خلّي الإشعارات «سماح»، وجرّب تاني. 4. **وضع عدم الإزعاج أو التركيز** على الموبايل أو الكمبيوتر بيكتم الإشعارات. 5. **إعدادات الجهاز**: اتأكد إن المتصفح (أو تطبيق فلايباي) مسموحله يبعت إشعارات من إعدادات الموبايل. ده طبيعي. إشعارات التحويل لموظف بتروح للمالك والمدير بس، لأن المشرف مبيشوفش المحادثات. المشرف بيوصله إشعار أول ما عميل **يتأهل**. [الأدوار والصلاحيات](/ar/team) فعّل **صوت التنبيه** من **الإعدادات ← الإشعارات**. الصوت بيشتغل وفلايباي مفتوح، ولما يكون مقفول بيبقى صوت إشعارات الجهاز العادي. ## الفريق والدعوات [#الفريق-والدعوات] فلايباي مش بيبعت إيميلات دعوة. افتح **الفريق ← دعوات مستنية القبول**، اضغط **نسخ الرابط** وابعته له على واتساب أو الإيميل. [الدعوات](/ar/team/invites) * **«استخدمت كل المستخدمين المتاحين في باقتك»**: الأعضاء والدعوات المعلّقة بيتحسبوا. الغي الدعوات القديمة، أو ضيف مستخدم، أو رقّي باقتك. * **«صاحب البريد ده عضو في الفريق بالفعل»**: هو موجود خلاص. * **صلاحيتك**: المالك والمدير بس يقدروا يدعوا. * **إيميل مختلف**: لازم يسجّل بنفس الإيميل اللي الدعوة اتبعتت عليه بالظبط. * **«حسابك تابع لوكالة تانية بالفعل»**: كل حساب في وكالة واحدة بس. يسجّل خروج ويقبل بإيميل تاني. * **«الدعوة غير صالحة أو منتهية»**: الرابط صالح 14 يوم، أو اتلغى. اعمل دعوة جديدة. ## الدخول والحساب [#الدخول-والحساب] لو ظهرت «الدخول بجوجل منجحش»: 1. اتأكد إن المتصفح مش قافل النوافذ المنبثقة (Pop-ups) لـ flyby.world، وجرّب تاني. 2. جرّب من متصفح تاني أو نافذة عادية مش خاصة. 3. لو عامل حسابك بإيميل وكلمة سر، ادخل بيهم، أو رجّع كلمة السر من **نسيت كلمة المرور؟**. اقتراح جوجل التلقائي اللي بيظهر فوق الصفحة ممكن ميظهرش لو قفلته قبل كده أو المتصفح مانعه، استخدم زرار **كمّل بجوجل** عادي. * دوّر في الـ Spam و«العروض الترويجية». * استنى دقايق، وبعدين اطلب لينك جديد. * اتأكد إنك كاتب الإيميل صح. لو فتحت لينك وظهرلك إنه «انتهى أو اتستخدم قبل كده»، سجّل دخول عادي أو اطلب لينك جديد من **نسيت كلمة المرور؟**. [إنشاء الحساب](/ar/getting-started/sign-up) القايمة بتتغير حسب دورك. مشرف العملاء مبيشوفش المحادثات ولا الكتالوج ولا المالية ولا الوكيل الذكي. و**المالية** محتاجة باقة النمو أو المحترف. [الأدوار والصلاحيات](/ar/team) # أهلاً بيك في فلايباي URL: https://docs.flyby.world/ar > وكيل سفر ذكي بيرد على عملاءك، يعرض برامجك، ويسلّم فريقك العملاء الجاهزين للحجز. فلايباي موظف مبيعات ذكي لشركتك السياحية، شغال 24 ساعة. بيرد على العملاء على واتساب والماسنجر وإنستجرام وشات الموقع **بلهجتهم**، يرشحلهم برامجك بأسعارها الحقيقية، يجمع بيانات الرحلة، ويسلّم فريقك العميل وهو جاهز للحجز ومعاه ملخص كامل. ## الفكرة في صورة واحدة [#الفكرة-في-صورة-واحدة] **العميل يبعت رسالة ← الوكيل الذكي يرد ويسأل ← العميل يبقى مؤهَّل ← فريقك يستلم ← حجز** ### العميل يبعت رسالة [#العميل-يبعت-رسالة] من واتساب، ماسنجر، إنستجرام، أو لينك الشات بتاع شركتك. كل الرسايل بتتجمع في صفحة **المحادثات**. ### الوكيل الذكي يرد فورًا [#الوكيل-الذكي-يرد-فورًا] يرد بنفس لهجة العميل (مصري، خليجي، شامي، فصحى أو إنجليزي)، ويرشّح من البرامج والخدمات اللي إنت ضايفها بس. مبيألّفش أسعار ولا مواعيد. ### يأهّل العميل [#يأهّل-العميل] وهو بيتكلم بيجمع البيانات اللي إنت محددها: نوع الرحلة، الوجهة، المواعيد، عدد المسافرين، الميزانية، الاسم والموبايل… ويقيّم العميل **ساخن** أو **دافئ** أو **بارد**. ### فريقك يستلم [#فريقك-يستلم] أول ما العميل يتأهل، فريقك بيوصله إشعار، والعميل بيظهر في **العملاء المحتملون** بملخص جاهز. ولو العميل طلب يكلم حد، أو حصل موقف الوكيل مش هيعرف يتصرف فيه، المحادثة بتتحول لفريقك على طول. ### تقفل الحجز [#تقفل-الحجز] فريقك يكمّل مع العميل: عرض سعر، تفاوض، وبعدين حجز ومدفوعات وفاتورة من **المالية** (باقة النمو والمحترف). الوكيل بيبيع ويأهّل ويسلّم. تأكيد الحجز والدفع دايمًا في إيد فريقك. ## ابدأ من هنا [#ابدأ-من-هنا] لو لسه فاتح حساب جديد، امشي على [أول ساعة مع فلايباي](/ar/getting-started): خطوات بسيطة وفي آخرها الوكيل بيرد على عملاءك فعلًا. ## أقسام الشرح [#أقسام-الشرح] ابعتلنا على [support@flyby.world](mailto:support@flyby.world) وهنرد عليك في أقرب وقت. # جهات الاتصال URL: https://docs.flyby.world/ar/leads/contacts > ملف لكل عميل فيه بياناته وتصنيفاته وكل رحلاته ومحادثاته وحجوزاته معاكم. **جهات الاتصال** هي دفتر عملاء الشركة. كل عميل كلّم الوكيل الذكي على أي قناة بيتضاف هنا تلقائي، وتقدر تضيف بنفسك العملاء اللي جم من التليفون أو المكتب. افتح جهات الاتصال **جهة الاتصال** هي الشخص نفسه: اسمه ورقمه وبياناته. **العميل المحتمل** هو فرصة بيع واحدة (رحلة). نفس الشخص ممكن يكون له أكتر من عميل محتمل: عمرة السنة دي وشهر عسل بعدها. ## القائمة [#القائمة] * **البحث**: بالاسم أو التليفون أو الإيميل. * **المصدر**: القناة اللي العميل جه منها (واتساب، موقع الويب، يدوي...). * **التصنيفات**: اعرض العملاء اللي عليهم تصنيف معين، زي VIP. * **تصدير CSV**: بينزّل جهات الاتصال اللي ظاهرة قدامك (بعد الفلاتر) في ملف تفتحه بالإكسل. كل صف فيه التليفون، والمصدر، والتصنيفات، وعدد العملاء المحتملين، و**آخر تواصل**. اضغط على عنوان العمود عشان ترتب بيه. على الموبايل القائمة بتتحول لكروت. القائمة بتعرض أول 500 بس. لو عندك عملاء أكتر، استخدم البحث أو الفلاتر عشان توصل للي عايزه. ## إضافة جهة اتصال [#إضافة-جهة-اتصال] 1. اضغط **جهة اتصال جديدة**. 2. اكتب الاسم (إجباري)، والتليفون والإيميل والمصدر لو متاحين. 3. احفظ، وكمّل باقي البيانات من ملف العميل. لو العميل جاي في رحلة معينة، الأسهل تضيفه من [العملاء المحتملين](/ar/leads#إضافة-عميل-بنفسك) على طول، وجهة الاتصال بتتعمل معاه. ## ملف العميل [#ملف-العميل] اضغط على أي اسم عشان يفتح ملفه. ### فوق [#فوق] الاسم، وإمتى اتضاف، وآخر تواصل معاه، وزرار **واتساب** يفتح محادثة من موبايلك، وزرار الإيميل. وتحتهم أرقام سريعة: **إجمالي العملاء المحتملين**، و**حجوزات ناجحة**، و**إجمالي قيمة الحجوزات** (للمالك والمدير). ### بيانات العميل [#بيانات-العميل] عدّل اللي محتاجه واضغط **حفظ**: | البيانات | ملاحظة | | -------------------------------------------------------- | -------------------------------------------------------------------------------------------- | | الاسم، التليفون، **رقم الواتساب**، الإيميل، **إنستجرام** | الوكيل الذكي بيملا الاسم والتليفون والإيميل لوحده لو العميل قالهم | | **المسؤول** | الموظف المسؤول عن العميل ده | | **المصدر** و**اللهجة** | | | **الجنسية**، **الدولة**، **المدينة** | | | **تاريخ الميلاد** | | | **انتهاء الباسبور** | فلايباي بينبهك لو الباسبور منتهي، أو هينتهي خلال أقل من 6 شهور (أغلب الدول بترفض الدخول بيه) | | **التصنيفات** | اكتب التصنيف واضغط Enter أو فاصلة. مثلًا: VIP، عميل متكرر، عمرة، شركات | | **ملاحظات** | أي معلومة ثابتة عن العميل | اتفقوا على قايمة تصنيفات ثابتة للفريق كله (زي «VIP»، «عميل متكرر»، «شركات»، «حج 2027») بدل ما كل واحد يكتب على مزاجه. بعد كده تقدر تفلتر بيها وتصدّر قايمة لحملة أو عرض خاص. ### التاريخ كله في تبويبات [#التاريخ-كله-في-تبويبات] | التبويب | فيه إيه | | --------------------- | --------------------------------------------------------------------- | | **العملاء المحتملين** | كل رحلات العميل ومراحلها | | **المحادثات** | كل محادثاته على كل القنوات (للمالك والمدير) | | **الحجوزات** | حجوزاته وحالتها وقيمتها (للمالك والمدير) | | **النشاط** | الملاحظات والمكالمات والمهام وتغييرات المراحل على كل عملاءه المحتملين | ## حذف جهة اتصال [#حذف-جهة-اتصال] زرار الحذف في أعلى الملف، للمالك والمدير بس. الحذف بيمسح جهة الاتصال ومعاها **كل العملاء المحتملين والمحادثات والنشاط** بتوعها. الحجوزات والمدفوعات بتفضل موجودة عشان حساباتك ماتتأثرش. الحذف مش بيترجع. لو العميل بس مش مهتم دلوقتي، الأحسن تنقل العميل المحتمل لـ«خسارة» وتسيب جهة الاتصال. ## مين يقدر يعمل إيه؟ [#مين-يقدر-يعمل-إيه] | | المالك والمدير | مشرف العملاء | | ---------------------------------------- | -------------- | ------------ | | يشوف جهات الاتصال | أيوه | أيوه | | يضيف أو يحذف جهة اتصال | أيوه | لأ | | تبويب المحادثات والحجوزات وإجمالي القيمة | أيوه | لأ | | العملاء المحتملين في الملف | كلهم | المؤهلين بس | ## الخطوة الجاية [#الخطوة-الجاية] # العملاء المحتملون ومراحل البيع URL: https://docs.flyby.world/ar/leads > تابع كل عميل من أول رسالة لحد ما يحجز، على لوحة مراحل البيع أو في قائمة. كل عميل بيبان عليه اهتمام بيتحول لـ**عميل محتمل** (Lead). الوكيل الذكي بيعمله لوحده من المحادثة ويملا بيانات الرحلة، وإنت وفريقك بتكمّلوا لحد الحجز. افتح العملاء المحتملين ## مراحل البيع [#مراحل-البيع] كل عميل محتمل بيعدّي على المراحل دي بالترتيب، وفي الآخر يا إما **تم الحجز** يا إما **خسارة**: | المرحلة | معناها | مين بيحطه فيها | | --------------- | ------------------------------------------------------------------ | ----------------------------------------------------------------------- | | **جديد** | عميل لسه متضاف ومحدش اشتغل عليه | إنت، لما تضيف عميل بنفسك | | **قيد التأهيل** | الوكيل بيجمع بيانات الرحلة (الوجهة، المواعيد، العدد، الميزانية...) | الوكيل الذكي، أول ما العميل يبدأ يتكلم في رحلة | | **مؤهل** | البيانات الأساسية اكتملت والعميل مستني حد من الفريق | الوكيل الذكي، وبيبعت إشعار للفريق | | **عرض سعر** | بعتّ للعميل عرض | فريقك | | **تفاوض** | العميل بيفاصل أو بيقارن | فريقك | | **تم الحجز** | العميل حجز | فريقك، أو تلقائي لما [تحوّله لحجز](/ar/leads/lead-details#التحويل-لحجز) | | **خسارة** | العميل مش هيحجز | فريقك، مع سبب الخسارة | الوكيل بيسأل أسئلة التأهيل اللي إنت محددها، ولما يخلص بيكتب ملخص ويقيّم العميل وينقله لـ«مؤهل»، والمحادثة بتروح لـ«محتاج موظف». التفاصيل في [التأهيل والتقييم](/ar/ai-agent/qualification) و[التحويل لموظف](/ar/conversations/handoff). ## التقييم: ساخن ودافئ وبارد [#التقييم-ساخن-ودافئ-وبارد] | التقييم | معناه | | -------- | ------------------------------------------- | | **ساخن** | جاهز يحجز قريب ومعاه ميزانية. كلمه على طول. | | **دافئ** | مهتم بس محتاج متابعة. | | **بارد** | بيتفرج أو بيسأل بس. | الوكيل بيحط التقييم مع سبب قصير، وتقدر تغيره بنفسك من [صفحة العميل](/ar/leads/lead-details). ## لوحة «مراحل البيع» [#لوحة-مراحل-البيع] كل مرحلة عمود، وفوق كل عمود عدد العملاء فيه **ومجموع القيمة المتوقعة** بتاعتهم. كل كارت بيوريك: * اسم العميل، نوع الرحلة، والتقييم * الوجهة، ميعاد السفر، وعدد المسافرين * الميزانية * صورة الموظف المسؤول، وأيقونة المصدر (واتساب، موقع الويب، يدوي...) * آخر تحديث ### نقل عميل لمرحلة تانية [#نقل-عميل-لمرحلة-تانية] * **على الكمبيوتر**: اسحب الكارت وسيبه في العمود الجديد. * **من أي جهاز**: اضغط على زرار (…) في الكارت واختار المرحلة من **انقل إلى**. * **من صفحة العميل**: اضغط على المرحلة في شريط المراحل فوق. لما تنقل عميل لـ**خسارة** هيسألك «ليه العميل ده اتخسر؟». اكتب السبب (مثلًا: السعر عالي، حجز مع شركة تانية، أجّل السفر)، لأنه بيساعدكم تفهموا ليه بتخسروا عملاء وتحسّنوا البيع. كل نقل بيتسجل في [سجل نشاط العميل](/ar/leads/lead-details#سجل-النشاط). الأعمدة بتتحرك بالعرض، اسحب يمين وشمال عشان تشوف باقي المراحل. ولو عايز تشوف كل حاجة تحت بعض، اختار عرض **قائمة**. ## عرض «قائمة» [#عرض-قائمة] جدول فيه العميل، المرحلة، التقييم، نوع الرحلة، الوجهة، ميعاد السفر، القيمة المتوقعة، المسؤول، وآخر تحديث. اضغط على عنوان أي عمود عشان ترتب بيه. على الموبايل الجدول بيتحول لكروت، ومعاه اختيار **ترتيب حسب**. ## الفلاتر والبحث [#الفلاتر-والبحث] * **البحث**: بالاسم أو التليفون أو الوجهة. * **التقييم**: ساخن، دافئ، بارد، أو **من غير تقييم**. * **نوع الرحلة**: عمرة، حج، سياحة خارجية، شهر عسل... * **المسؤول**: **كل الموظفين**، **المسندين ليا**، **مش متسند لحد**، أو موظف معين. * **المصدر**: القناة اللي العميل جه منها. واضغط **مسح الفلاتر** عشان ترجع لكل العملاء. ## إضافة عميل بنفسك [#إضافة-عميل-بنفسك] عميل كلمك تليفون أو جه المكتب؟ ضيفه عشان يدخل في المتابعة: ### اضغط «عميل محتمل جديد» [#اضغط-عميل-محتمل-جديد] ### اختار جهة الاتصال [#اختار-جهة-الاتصال] **جهة اتصال موجودة**: دوّر بالاسم أو رقم التليفون. أو **جهة اتصال جديدة**: اكتب الاسم والتليفون. ### اضغط «إنشاء العميل» [#اضغط-إنشاء-العميل] العميل بيتضاف في مرحلة **جديد**، وبيفتح لك عشان تكمّل [بيانات الرحلة](/ar/leads/lead-details). ## مين يشوف إيه؟ [#مين-يشوف-إيه] | | المالك والمدير | مشرف العملاء | | ----------------------------------------------------- | ----------------------------- | ----------------------------------------------------- | | العملاء اللي بيشوفهم | كلهم | اللي اتأهلوا بس (حتى لو اتنقلوا بعد كده لمرحلة تانية) | | المراحل المتاحة | كل المراحل | من **مؤهل** لحد **تم الحجز** و**خسارة** | | إضافة وحذف عملاء | أيوه | لأ | | تغيير المرحلة والتقييم والمسؤول، وإضافة ملاحظات ومهام | أيوه | أيوه | | التحويل لحجز | أيوه (لو الباقة فيها المالية) | لأ | الرقم الأحمر جنب **العملاء المحتملون** في القائمة الجانبية بيعدّ العملاء اللي في مرحلة **مؤهل**، يعني المستنيين حد يكلمهم. ## الخطوة الجاية [#الخطوة-الجاية] # تفاصيل العميل المحتمل URL: https://docs.flyby.world/ar/leads/lead-details > كل حاجة عن العميل في صفحة واحدة، من بيانات الرحلة والبرامج اللي مهتم بيها لسجل النشاط والتحويل لحجز. اضغط على أي كارت في [مراحل البيع](/ar/leads) وهتفتح صفحة العميل المحتمل. هنا بتتابع العميل خطوة بخطوة: تغيّر المرحلة، تكمّل بيانات الرحلة، تسجّل مكالماتك، وفي الآخر تحوّله لحجز. ## أعلى الصفحة [#أعلى-الصفحة] * **اسم العميل**، وإمتى اتضاف، وإمتى اتأهل (لو اتأهل). * **تحويل لحجز**: للمالك والمدير، في الباقات اللي فيها المالية ([تحت](#التحويل-لحجز)). * **حذف**: للمالك والمدير. بيمسح العميل المحتمل وكل الملاحظات والمهام بتاعته، بس **جهة الاتصال نفسها بتفضل موجودة**. ### مرحلة البيع [#مرحلة-البيع] شريط فيه المراحل بالترتيب. اضغط على أي مرحلة عشان تنقل العميل ليها، والمراحل اللي عدّاها بتظهر بعلامة صح. زرار **خسارة** لوحده على الجنب، ولما تضغطه بيسألك عن سبب الخسارة، والسبب بيفضل ظاهر جنب المرحلة. ### التقييم والمسؤول والمتابعة [#التقييم-والمسؤول-والمتابعة] | الجزء | بيعمل إيه | | --------------------- | ----------------------------------------------------------------------------------- | | **التقييم** | ساخن، دافئ، بارد. وتحته **سبب التقييم** لو حابب تكتب ليه (اختياري). | | **المسؤول عن العميل** | الموظف اللي ماسك العميل ده. بيظهر صورته على الكارت، وبيتفلتر بيه في «المسندين ليا». | | **المتابعة الجاية** | اختار يوم وساعة ترجع فيهم للعميل. لو الميعاد عدّى بيتلوّن أحمر. | **المتابعة الجاية** ميعاد واحد بيظهر في صفحة العميل. لو عايز حاجة تظهر في [صفحة المهام](/ar/leads/tasks) وتتعلّم إنها خلصت، ضيف **مهمة** من سجل النشاط. ## تفاصيل الرحلة [#تفاصيل-الرحلة] الوكيل الذكي بيملا البيانات دي من المحادثة، وتقدر تكمّلها أو تصححها من زرار **تعديل**: * **نوع الرحلة** و**الوجهة** و**مدينة السفر** * **من تاريخ** و**إلى تاريخ**، أو **شهر السفر** لو العميل لسه مش محدد (مثلًا: رمضان، أغسطس)، و**التواريخ مرنة** * **عدد الليالي** * **المسافرين**: كبار، أطفال، رضع * **الميزانية من** و**الميزانية لحد** * **مستوى الفندق** و**نوع الغرفة** * **الجنسية** و**موقف التأشيرة** * **طلبات خاصة** * **القيمة المتوقعة**: قيمة الصفقة المتوقعة، وبتتجمع فوق كل عمود في لوحة المراحل لو العميل قال لك حاجة في التليفون (زي إنه زوّد طفل أو غيّر الميعاد)، عدّلها هنا على طول. كده أي زميل يفتح العميل يلاقي الصورة كاملة، والتحويل لحجز بياخد العدد والتواريخ الصح. ## ملخص الوكيل الذكي [#ملخص-الوكيل-الذكي] ملخص مكتوب بالعربي من الوكيل لما يأهل العميل: العميل عايز إيه، ومستعجل قد إيه، وأي ملاحظة مهمة. اقراه قبل ما تكلم العميل. ## البرامج اللي مهتم بيها [#البرامج-اللي-مهتم-بيها] البرامج اللي العميل سأل عنها أو مهتم بيها. الوكيل بيضيفها لوحده من المحادثة، وكل برنامج بيظهر بسعر «يبدأ من». المالك والمدير يقدروا يضيفوا برنامج من **إضافة برنامج** (البحث في البرامج الشغالة بس) أو يشيلوه. القائمة دي مهمة لأن [التحويل لحجز](#التحويل-لحجز) بيحط البرامج دي في الحجز على طول. تعديل البرامج متاح في كل الباقات. أما [التحويل لحجز](#التحويل-لحجز) فمحتاج باقة فيها المالية (Growth أو Pro). ## سجل النشاط [#سجل-النشاط] كل اللي حصل مع العميل بالترتيب: تغيير المراحل، أحداث الوكيل الذكي (زي إنه أهّل العميل)، ملاحظاتكم، مكالماتكم، والمهام. من فوق السجل تقدر تضيف: | النوع | استخدمه في | | ---------------- | -------------------------------------------------------------------------------------- | | **ملاحظة** | أي معلومة عن العميل: «عايز فندق قريب من الحرم» | | **تسجيل مكالمة** | بعد أي مكالمة: «اتكلمتوا في إيه؟». بتحدّث كمان «آخر تواصل» في ملف العميل | | **مهمة** | حاجة لازم تتعمل في ميعاد: اكتبها واختار **تاريخ التنفيذ** و**الساعة** (التاريخ إجباري) | المهام بتظهر في السجل وفي [صفحة المهام](/ar/leads/tasks)، وتقدر تعلّم عليها إنها خلصت من هنا أو من هناك. والمهمة اللي ميعادها عدّى بيظهر جنبها **متأخرة**. كل واحد يقدر يحذف الملاحظات والمكالمات والمهام اللي كتبها، والمالك والمدير يقدروا يحذفوا أي حاجة منهم. ## على الجنب: جهة الاتصال والمحادثة [#على-الجنب-جهة-الاتصال-والمحادثة] * **جهة الاتصال**: الاسم والتليفون والجنسية والمكان، وزرار **افتح واتساب** يفتح محادثة مع العميل من موبايلك، و**الملف الكامل** يوديك [لجهة الاتصال](/ar/leads/contacts). * **المحادثة**: آخر الرسايل بين العميل والوكيل والفريق، عشان تفهم الكلام وصل لفين. المالك والمدير يقدروا يضغطوا **فتح المحادثة** ويردوا منها. مشرف العملاء بيشوف الرسايل هنا بس مايقدرش يفتح المحادثة. ## التحويل لحجز [#التحويل-لحجز] لما العميل يوافق، حوّله لحجز بضغطة: ### اضغط «تحويل لحجز» [#اضغط-تحويل-لحجز] اتأكد الأول إن **البرامج اللي مهتم بيها** و**تفاصيل الرحلة** (العدد والتواريخ) مظبوطين. ### أكّد [#أكّد] فلايباي بيعمل حجز جديد فيه: * البرامج اللي مهتم بيها كبنود، بسعر «يبدأ من» لكل برنامج، والكمية = الكبار + الأطفال. التكلفة بتيجي لوحدها من سعر الكبار اللي طالع منه سعر «يبدأ من» * تاريخ السفر والعودة وعدد المسافرين من تفاصيل الرحلة والعميل المحتمل بيتنقل لمرحلة **تم الحجز**. ### كمّل الحجز في المالية [#كمّل-الحجز-في-المالية] صفحة الحجز بتفتح على طول. عدّل الأسعار والتكاليف، ضيف خدمات، وسجّل المدفوعات. التفاصيل في [الحجوزات](/ar/finance/bookings). زرار **تحويل لحجز** بيظهر بس في باقات **Growth** و**Pro** (وفترة التجربة)، وللمالك والمدير بس. اعرف الفرق بين الباقات في [الباقات](/ar/billing). ## الخطوة الجاية [#الخطوة-الجاية] # المهام والمتابعات URL: https://docs.flyby.world/ar/leads/tasks > حط متابعة بميعاد لكل عميل، وتابع المتأخر والنهارده والجاي من صفحة واحدة. أغلب الحجوزات بتضيع لأن حد نسي يتابع. المهام بتخلي كل متابعة ليها ميعاد، وبتجمعها لك في صفحة **المهام** عشان تعرف تبدأ يومك بإيه. افتح المهام ## إضافة مهمة [#إضافة-مهمة] فيه طريقتين، والاتنين بيوصلوا لنفس المكان: 1. اضغط **إضافة مهمة**. 2. في **العميل المحتمل** دوّر بالاسم أو الوجهة واختار العميل. 3. في **المهمة** اكتب المطلوب، مثلًا: «كلّم العميل بخصوص التأشيرة». 4. في **الميعاد** اختار اليوم والساعة. 5. اضغط **إضافة مهمة**. 1. افتح [العميل المحتمل](/ar/leads/lead-details). 2. في **سجل النشاط** اختار **مهمة**. 3. اكتب المطلوب، واختار **تاريخ التنفيذ** و**الساعة**. 4. اضغط **إضافة مهمة**. كل مهمة لازم تكون مربوطة بعميل محتمل وليها ميعاد. لو لسه مفيش عملاء محتملين، زرار **إضافة مهمة** بيبقى مقفول. ## صفحة المهام [#صفحة-المهام] المهام متقسمة على أربع تبويبات، وجنب كل واحد العدد: | التبويب | فيه إيه | | ------------ | -------------------------------------------------- | | **متأخرة** | مهام ميعادها عدّى ولسه ماخلصتش. الصفحة بتفتح عليه. | | **النهارده** | مهام ميعادها باقي اليوم | | **الجاية** | مهام ميعادها بعد النهارده | | **خلصت** | آخر المهام اللي اتعلّم عليها إنها خلصت | وعلى الجنب التاني: * **مهامي**: المهام اللي إنت ضفتها. * **كل المهام**: مهام الفريق كله، وجنب كل مهمة صورة اللي ضافها. كل مهمة بيظهر فيها المطلوب، والميعاد (بالأحمر لو متأخرة، ومعاه من إمتى)، واسم العميل المحتمل وجهة الاتصال. اضغط على أي واحد فيهم يفتحه. ## لما المهمة تخلص [#لما-المهمة-تخلص] علّم على المربع اللي جنب المهمة، وهتروح لتبويب **خلصت**. لو علّمت بالغلط، افتح **خلصت** وشيل العلامة وهترجع مكانها. بعد ما تكلم العميل، سجّل المكالمة من **تسجيل مكالمة** في سجل نشاطه، وحط المهمة الجاية على طول. كده العميل عمره ما يقعد من غير متابعة. ## تنبيه المهام المتأخرة [#تنبيه-المهام-المتأخرة] جنب **المهام** في القائمة الجانبية بيظهر رقم أحمر بعدد المهام اللي ميعادها جه أو عدّى ولسه ماخلصتش. على الموبايل بيظهر نقطة حمرا على تبويب **المهام** في الشريط اللي تحت. ## مشرف العملاء [#مشرف-العملاء] مشرف العملاء بيشوف المهام اللي هو ضافها، ومهام العملاء اللي اتأهلوا. وبيقدر يضيف مهام على العملاء المؤهلين بس. ## أمثلة لمهام مفيدة [#أمثلة-لمهام-مفيدة] * «ابعت عرض سعر عمرة رجب، 4 أفراد، غرفة رباعي» ← بكرة 11 الصبح * «اتأكد من موعد تجديد باسبور الأطفال» ← بعد يومين * «اسأل العميل لو حجز ولا لسه» ← بعد أسبوع من إرسال العرض * «كلّمه قبل السفر بأسبوع يأكد المستندات» ← قبل ميعاد السفر ## الخطوة الجاية [#الخطوة-الجاية] # إحصائيات الصفحة URL: https://docs.flyby.world/ar/public-page/analytics > اعرف كام واحد زار صفحتك العامة، جايين منين، فتحوا أنهي برامج، وكام واحد كلمك فعلاً، من غير ما نحفظ أي بيانات شخصية. الإحصائيات بتوريك صفحتك العامة بتشتغل إزاي: الزوار بيوصلولها منين، وبيعملوا إيه فيها، وكام واحد منهم بيتحول لاستفسار. افتحها من زرار **«الإحصائيات»** فوق في «صفحتك العامة». متاحة للـ **مالك** والـ **مدير**. ## بنحسب إيه؟ [#بنحسب-إيه] | الرقم | معناه | | ------------------- | -------------------------------------------- | | **مشاهدات الصفحة** | كل مرة الصفحة الرئيسية اتفتحت | | **زوار فريدين** | عدد الناس، كل زائر بيتحسب مرة واحدة في اليوم | | **مشاهدات البرامج** | فتح صفحة أي برنامج | | **ضغطات الشات** | الضغط على «كلمنا» | | **ضغطات الواتساب** | الضغط على زرار الواتساب | | **ضغطات الاتصال** | الضغط على «اتصل» | وبنسجّل كمان الضغط على عروضك وعلى زرار خريطة الفروع (بيظهروا في ملف التصدير في Pro). ### بنستبعد إيه؟ [#بنستبعد-إيه] * **زياراتك في المعاينة**. * **البوتات ومحركات البحث** ومعاينات اللينكات (زي لما حد يبعت اللينك على واتساب). * **التكرار**: نفس الزائر ونفس الحركة خلال 30 دقيقة بتتحسب مرة واحدة. * أي زيارة والصفحة **مقفولة**. ## الخصوصية [#الخصوصية] الزائر بيتعرّف بكود مشفّر بيتغيّر كل يوم، فبيتحسب مرة في اليوم ومينفعش نتتبعه من يوم ليوم أو بين وكالة والتانية. اللي بيتحفظ: نوع الحركة، البرنامج، مصدر الزيارة، نوع الجهاز (موبايل، كمبيوتر، تابلت)، الدولة، ولغة الصفحة. ومن غير أي اسم أو رقم أو بيانات شخصية. عشان كده الزائر اللي يزورك في يومين مختلفين بيتحسب زائرين. ## اللي بتشوفه حسب باقتك [#اللي-بتشوفه-حسب-باقتك] أرقام **آخر 30 يوم**: * مشاهدات الصفحة * زوار فريدين * ضغطات الشات * ضغطات الواتساب وتحتهم كارت بيوريك اللي هتفتحه لو رقّيت لـ Growth. كل اللي في Starter، وزيادة: * فترات **7 و30 و90 يوم**. * **الزيارات اليومية**: رسم بياني للمشاهدات والزوار كل يوم. * **من الزيارة للاستفسار**: كام زائر فتح برنامج، وكام واحد داس شات أو واتساب أو اتصال، ونسبة كل خطوة من اللي قبلها. * **أكتر البرامج مشاهدة**. * **مصادر الزيارات**: إنستجرام، فيسبوك، جوجل، «مباشر»… * **الأجهزة** و**الدول**. * كروت مشاهدات البرامج وضغطات الاتصال. الفترة التجريبية زي Growth. كل اللي في Growth، وزيادة: * فترة **12 شهر**. * **تصدير CSV** بنوعين: * **ملخص يومي**: التاريخ، المشاهدات، الزوار، مشاهدات البرامج، ضغطات التواصل. * **كل الأحداث**: كل حركة بوقتها ونوعها والبرنامج والمصدر والجهاز والدولة واللغة. ## مصادر الزيارات [#مصادر-الزيارات] المصدر بيتحدد كده: 1. لو اللينك فيه `utm_source` (زي `?utm_source=instagram`)، ده اللي بيظهر. 2. لو لأ، الموقع اللي الزائر جه منه (جوجل، فيسبوك، إنستجرام…). 3. لو مفيش أي معلومة، بيتحسب **«مباشر»**: لينك متكتب، أو شات واتساب، أو تطبيق مش بيقول الزيارة جاية منين. زيارات كتير من واتساب وإنستجرام بتظهر «مباشر» لأن التطبيقات دي مش بتبعت المصدر. حط لينك مختلف لكل مكان: * البايو: `.../p/your-agency?utm_source=instagram` * الإعلانات: `.../p/your-agency?utm_source=facebook_ads` * رسايل الواتساب: `.../p/your-agency?utm_source=whatsapp` ## لو مفيش أرقام [#لو-مفيش-أرقام] * اتأكد إن الصفحة **شغالة** مش مقفولة. * زياراتك من **المعاينة** مش بتتحسب: افتح اللينك العادي من موبايل تاني. * لو لسه ما شاركتش اللينك، هتلاقي «مفيش زيارات لسه». شاركه على الواتساب وإنستجرام وفيسبوك. ## الخطوة الجاية [#الخطوة-الجاية] # الصفحة العامة URL: https://docs.flyby.world/ar/public-page > موقع صغير لوكالتك فيه البرامج والعروض والخدمات والفروع وطرق التواصل، كله في لينك واحد تبعته لأي حد. الصفحة العامة هي «الموقع» الجاهز لوكالتك: بانر باسمك ولونك، برامجك بأسعارها ومواعيدها، العروض، الخدمات، الأسئلة الشائعة، الفروع، وأزرار تواصل بتودي للشات أو الواتساب. من غير ما تكتب سطر كود. لينك صفحتك بيبقى كده، بالعربي والإنجليزي: ```text https://flyby.world/ar/p/your-agency https://flyby.world/en/p/your-agency ``` ## مين يقدر يعدّلها؟ [#مين-يقدر-يعدّلها] الـ **مالك** والـ **مدير** بس. هتلاقيها في القائمة الجانبية باسم «صفحتك العامة». ## شغّل صفحتك في 4 خطوات [#شغّل-صفحتك-في-4-خطوات] ### اختار عنوان الصفحة [#اختار-عنوان-الصفحة] في تبويب **«عام»**، اكتب **«عنوان الصفحة»**: آخر جزء في اللينك، زي `al-ofok-travel`. لو اسم وكالتك بالإنجليزي، زرار **«اقترح»** بيكتبهولك. علامة صح خضرا معناها إن العنوان متاح. القواعد: * من 3 لـ 40 حرف. * حروف إنجليزي صغيرة وأرقام وشرطة (-)، من غير شرطتين ورا بعض، ومش بيبدأ أو يخلص بشرطة. * فيه كلمات محجوزة مينفعش تستخدمها، زي `admin` و `flyby` و `support`. دوس **حفظ**. ### اكتب العنوان الرئيسي والنبذة [#اكتب-العنوان-الرئيسي-والنبذة] * **العنوان الرئيسي** (عربي وإنجليزي): السطر الكبير في أول الصفحة، زي «عمرة ورحلات بأحسن الأسعار». لو سبته فاضي هيظهر اسم وكالتك. * **نبذة قصيرة** (عربي وإنجليزي): سطر أو اتنين عن اللي بيميزك. الخانات الإنجليزي الفاضية بيظهر مكانها النص العربي. ### ضيف صورة غلاف [#ضيف-صورة-غلاف] صورة عريضة ورا العنوان الرئيسي: JPG أو PNG أو WebP، لحد 5 ميجا. من غيرها الصفحة بتستخدم لون البراند بتاعك. ### شغّل الصفحة [#شغّل-الصفحة] فعّل مفتاح **«الصفحة شغالة»** فوق. البادج جنب العنوان هيتغيّر من **مقفولة** لـ **شغالة**، وهيظهر زرار **«افتح الصفحة»**. لو غيّرت عنوان الصفحة بعد ما شاركته، **كل اللينكات القديمة هتبطل تشتغل**: في البايو، والإعلانات، والـ QR كود. اختار عنوان تفضل عليه. ## اللون واللوجو [#اللون-واللوجو] الصفحة بتاخد شكلها من إعدادات موجودة أصلاً: * **اللون الأساسي** = لون الشات من [«الإعدادات ← القنوات والربط»](/ar/channels/website-chat). فلايباي بيظبط لون الكتابة على الأزرار تلقائياً عشان تفضل مقروءة. * **اللوجو** من «الإعدادات ← اللوجو». في كارت **«اللون واللوجو»** هتلاقي زرارين «غيّر اللون» و«غيّر اللوجو» بيودوك على المكان الصح. ## «Powered by Flyby» [#powered-by-flyby] في آخر الصفحة فيه لينك صغير «مدعوم من فلايباي». في باقة **Pro** تقدر تشيله من مفتاح **«اخفي "Powered by Flyby"»** في تبويب «عام». ## المعاينة قبل ما تنشر [#المعاينة-قبل-ما-تنشر] زرار **«معاينة»** فوق بيفتح صفحتك زي ما العملاء هيشوفوها، **حتى لو هي مقفولة**: * المعاينة بتشتغل بس لو إنت مسجّل دخول كعضو في الوكالة. * هيظهرلك شريط فوق بيقول إنها معاينة، وزرار «ارجع للتعديل». * زياراتك في المعاينة **مش بتتحسب** في الإحصائيات. ## العميل بيشوف إيه؟ [#العميل-بيشوف-إيه] * **بانر** فيه اسمك واللوجو والعنوان الرئيسي وأزرار التواصل. ده دايماً أول حاجة. * **الأقسام** اللي شغّلتها بالترتيب اللي اخترته. اقرا [أقسام الصفحة](/ar/public-page/sections). * **صفحة لكل برنامج** فيها الوصف، البرنامج يوم بيوم، بيشمل ومش بيشمل، الفنادق، مواعيد السفر الجاية والأماكن الفاضية، والشروط، وزرار «اسأل عن البرنامج ده». * **أزرار التواصل**: «كلمنا» بيفتح [الشات العام](/ar/channels/website-chat) مع وكيلك الذكي، و«واتساب» بيفتح شات على رقم الواتساب بتاعك ومعاه رسالة جاهزة عن البرنامج أو العرض. على الموبايل الأزرار دي بتفضل ظاهرة تحت الشاشة. * **أيقونات السوشيال ميديا** في قسم التواصل وفي آخر الصفحة. اقرا [لينكات السوشيال](/ar/public-page/social-links). ## شاركها [#شاركها] * انسخ **«لينك صفحتك»** من تبويب «عام» وحطه في البايو وفي إعلاناتك وفي رسالة الترحيب على الواتساب. * لما حد يشارك اللينك على واتساب أو فيسبوك، المعاينة بتطلع بصورة الغلاف (أو اللوجو) واسم وكالتك. * الصفحة وهي شغالة بتظهر في محركات البحث زي جوجل. وهي مقفولة، مبتظهرش لأي حد غير فريقك. ضيف `?utm_source=instagram` في آخر لينك البايو، و `?utm_source=facebook` في الإعلانات، وهتشوف كل مصدر لوحده في [الإحصائيات](/ar/public-page/analytics). ## الخطوة الجاية [#الخطوة-الجاية] # العروض والفروع والأقسام المخصصة URL: https://docs.flyby.world/ar/public-page/offers-and-branches > ضيف عروض لفترة محدودة بشارة وتاريخ انتهاء، واعرض فروعك بالخريطة، واحكي قصة وكالتك في أقسام بتاعتك. التلات تبويبات دول بيخلّوا صفحتك تبان زي موقع وكالة كبيرة: **العروض** بتجيب استفسارات، و**الفروع** بتطمّن العميل إن ليك مكان حقيقي، و**الأقسام المخصصة** بتحكي ليه يختارك. | التبويب | الباقات | | ----------- | -------------------------------- | | العروض | Growth و Pro (والفترة التجريبية) | | أقسام مخصصة | Pro | | الفروع | Pro (من غير حد لعدد الفروع) | لو التبويب مش في باقتك هتلاقي فيه شرح للميزة وزرار «رقّي لباقة …». ## العروض [#العروض] العرض بيظهر في قسم «العروض الحالية» بشارة على الصورة (زي `-15%`) وتاريخ «ساري لحد»، ومعاه زرار **«اسأل عن العرض ده»** اللي بيفتح الشات أو الواتساب برسالة جاهزة فيها اسم العرض. ### افتح «العروض» ودوس «ضيف عرض» [#افتح-العروض-ودوس-ضيف-عرض] من «صفحتك العامة» ← «العروض». ### املأ بيانات العرض [#املأ-بيانات-العرض] | الخانة | تكتب فيها إيه | | ------------------------- | --------------------------------------------------------------------------- | | **العنوان (عربي)** | مطلوب. مثلاً «خصم 15% على عمرة شعبان» | | **العنوان (إنجليزي)** | اختياري. لو فاضي هيظهر العربي | | **النص (عربي / إنجليزي)** | تفاصيل العرض والشروط | | **الشارة** | كلمة قصيرة على العرض، زي «-15%» أو «حجز مبكر». لو فاضية هيظهر «عرض» | | **ساري لحد** | العرض بيختفي لوحده بعد التاريخ ده. سيبه فاضي لو عايزه يفضل ظاهر | | **البرنامج المرتبط** | العميل يقدر يفتح صفحة البرنامج من العرض بزرار «شوف البرنامج» | | **الصورة** | JPG أو PNG أو WebP لحد 5 ميجا. من غيرها بتتستخدم صورة غلاف البرنامج المرتبط | ### دوس «حفظ» [#دوس-حفظ] العرض هيظهر في صفحتك على طول، طالما قسم «العروض» شغال في تبويب [الأقسام](/ar/public-page/sections). حجز مبكر للصيف، عروض رمضان والعمرة، خصم للمجموعات والعائلات، أو باقة شهر عسل. اربط كل عرض ببرنامج عشان العميل يشوف التفاصيل كاملة. العروض اللي تاريخها عدّى بيظهر عليها **«منتهي»** في لوحة التحكم ومبتظهرش للعملاء. تقدر تعدّل التاريخ وترجّعها، أو تمسحها. ## الأقسام المخصصة (Pro) [#الأقسام-المخصصة-pro] بلوكات بتاعتك، كل واحد فيه عنوان ونص وصورة اختيارية. مناسبة لحاجات زي «ليه تسافر معانا»، «تراخيصنا»، «شركاؤنا»، أو «آراء عملائنا». 1. افتح «أقسام مخصصة» ودوس **«ضيف قسم»**. 2. اكتب **العنوان (عربي)** (مطلوب)، والإنجليزي لو حابب، والنص، وارفع صورة لو عايز. 3. دوس **حفظ**. البلوكات بتظهر في الصفحة بنفس ترتيبها في التبويب، في المكان اللي فيه «أقسام مخصصة» في ترتيب الأقسام. ## الفروع (Pro) [#الفروع-pro] كل فرع بيظهر في قسم «فروعنا» بالاسم والمدينة والعنوان والمواعيد، وأزرار **الخريطة** والاتصال والواتساب. ### افتح «الفروع» ودوس «ضيف فرع» [#افتح-الفروع-ودوس-ضيف-فرع] من «صفحتك العامة» ← «الفروع». ### املأ بيانات الفرع [#املأ-بيانات-الفرع] * **اسم الفرع (عربي)**: مطلوب، زي «فرع مدينة نصر». والإنجليزي اختياري. * **المدينة** و**العنوان**. * **التليفون** و**واتساب** الخاصين بالفرع. * **لينك الخريطة**: افتح المكان على جوجل ماب، دوس **مشاركة (Share)** وانسخ اللينك. لازم يبدأ بـ `https://`. * **مواعيد العمل**: اكتبها زي ما العميل هيقراها، مثلاً «من السبت للخميس، من 10 الصبح لـ 10 بالليل». ### دوس «حفظ» [#دوس-حفظ-1] ## إدارة القوائم [#إدارة-القوائم] في العروض والأقسام المخصصة والفروع، كل عنصر في القائمة ليه: * **مفتاح «يظهر في الصفحة»**: تخفي العنصر مؤقتاً من غير ما تمسحه. * **أسهم «لفوق» و«لتحت»**: ترتيبه في الصفحة. * **تعديل** و**مسح**. المسح نهائي وبيطلب تأكيد. ## الخطوة الجاية [#الخطوة-الجاية] # أقسام الصفحة URL: https://docs.flyby.world/ar/public-page/sections > رتّب أقسام صفحتك العامة، شغّل اللي محتاجه واقفل الباقي، واختار البرامج اللي العملاء يشوفوها. صفحتك العامة مقسومة لأقسام: مين إحنا، البرامج، العروض، الخدمات، الأسئلة الشائعة، أقسام مخصصة، الفروع، وتواصل معانا. إنت بتختار إيه يظهر وبأي ترتيب. ## رتّب الأقسام [#رتّب-الأقسام] ### افتح تبويب «الأقسام» [#افتح-تبويب-الأقسام] من «صفحتك العامة» ← «الأقسام». ### شغّل أو اقفل كل قسم [#شغّل-أو-اقفل-كل-قسم] المفتاح جنب كل قسم بيحدد هو يظهر ولا لأ. القسم المقفول بيظهر عليه «مخفي». ### غيّر الترتيب [#غيّر-الترتيب] استخدم أسهم **«لفوق»** و\*\*«لتحت»\*\* جنب كل قسم. ### دوس «حفظ» [#دوس-حفظ] التعديلات مش بتتطبق غير لما تحفظ. «إلغاء التعديلات» بيرجعك لآخر نسخة محفوظة. البانر اللي فوق، اللي فيه اسمك والعنوان الرئيسي وأزرار التواصل، ثابت في أول الصفحة ومينفعش يتحرك. ## كل قسم بيعرض إيه؟ [#كل-قسم-بيعرض-إيه] القسم **مش بيظهر غير لو فيه محتوى**، حتى لو مفتاحه شغال. يعني العروض مثلاً مش هتظهر غير لما تضيف عرض شغال. | القسم | بيعرض إيه | محتواه بييجي منين | | ------------------- | ---------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | | **مين إحنا** | نص «عن الوكالة» | «نبذة عن الوكالة» في [بيانات الوكالة](/ar/settings/agency-profile) | | **البرامج** | كروت البرامج بالصورة والسعر «يبدأ من» | البرامج الشغالة اللي مفعّل عليها «في الصفحة العامة» | | **العروض** | عروض لفترة محدودة بشارة وتاريخ انتهاء | تبويب «العروض» ([العروض والفروع](/ar/public-page/offers-and-branches)) | | **الخدمات** | التأشيرات والطيران والفنادق وباقي خدماتك | [الخدمات](/ar/catalog/services) الشغالة. اللي من غير سعر بيظهر عليها «السعر عند الطلب» | | **الأسئلة الشائعة** | قائمة أسئلة بتفتح وتقفل | [الأسئلة الشائعة](/ar/catalog/faqs) الشغالة | | **أقسام مخصصة** | بلوكات نص حر مع صورة | تبويب «أقسام مخصصة» | | **الفروع** | مكاتبك بالخريطة والمواعيد والتليفون | تبويب «الفروع» | | **تواصل معانا** | التليفون، الواتساب، الإيميل، الموقع، العنوان، مواعيد العمل، أيقونات السوشيال، وأزرار الشات والواتساب | [بيانات الوكالة](/ar/settings/agency-profile) و[مواعيد العمل](/ar/settings/working-hours) | ## الأقسام حسب الباقة [#الأقسام-حسب-الباقة] | القسم | Starter | Growth | Pro | | -------------------------------- | ---------------- | ------------------- | ------------------- | | مين إحنا، البرامج، تواصل معانا | ✓ (لحد 10 برامج) | ✓ (برامج من غير حد) | ✓ (برامج من غير حد) | | العروض، الخدمات، الأسئلة الشائعة | — | ✓ | ✓ | | أقسام مخصصة، الفروع | — | — | ✓ | الفترة التجريبية زي Growth. القسم اللي مش في باقتك بيظهر عليه **«مقفول»** ولينك للترقية، ومش بيظهر للعملاء حتى لو كان شغال قبل كده. ## البرامج في الصفحة [#البرامج-في-الصفحة] تبويب **«البرامج»** بيعرض كل برامجك **الشغالة** ومفتاح جنب كل واحد. * **شغّل المفتاح** عشان البرنامج يظهر، أو **اقفله** عشان يختفي. نفس المفتاح موجود في صفحة البرنامج نفسه باسم **«في الصفحة العامة»**. * **الترتيب**: البرامج **المميزة** الأول، وبعدها الأحدث. عشان تقدّم برنامج، علّمه «مميز» من [البرامج](/ar/catalog/packages). * **المسودات والبرامج المتوقفة** عمرها ما بتظهر في الصفحة، حتى لو المفتاح شغال. في باقة Starter الصفحة بتعرض **10 برامج بحد أقصى**. هتلاقي عداد زي «7 من 10 مستخدمين» فوق القائمة. لو وصلت للحد، اخفي برنامج الأول عشان تظهر غيره، أو رقّي لـ Growth. أي برنامج زيادة بيظهر عليه «مش ظاهر، فوق حد الباقة». ## الخطوة الجاية [#الخطوة-الجاية] # لينكات السوشيال ميديا URL: https://docs.flyby.world/ar/public-page/social-links > ضيف لينكات حساباتك مرة واحدة، وفلايباي هيعرف المنصة لوحده ويعرض أيقونتها على صفحتك العامة. حط لينكات صفحاتك على السوشيال ميديا في بيانات الوكالة، وفلايباي هيعرف كل لينك تبع أنهي منصة من الرابط نفسه، ويعرضه كأيقونة دايرة في صفحتك العامة. ## ضيف لينك [#ضيف-لينك] ### افتح بيانات الوكالة [#افتح-بيانات-الوكالة] «الإعدادات ← بيانات الوكالة»، وانزل لجزء **«السوشيال ميديا»**. ### الصق اللينك [#الصق-اللينك] الصق لينك صفحتك كامل، زي `instagram.com/nile.tours`. مش لازم تكتب `https://`، فلايباي بيضيفه لوحده. الأيقونة جنب الخانة بتتغير على طول للمنصة اللي اتعرفت. ### ضيف لينكات تانية [#ضيف-لينكات-تانية] دوس **«ضيف لينك»** لكل حساب. تقدر تضيف لحد **12 لينك**. ### احفظ [#احفظ] دوس **حفظ** في آخر الصفحة. لو فيه لينك مش صحيح هيظهرلك «فيه لينك مش صحيح. راجعه وجرّب تاني.». اللينكات المكررة والخانات الفاضية بتتشال لوحدها. مين يقدر يعدّلها: الـ **مالك** والـ **مدير**. ## المنصات اللي بنتعرف عليها [#المنصات-اللي-بنتعرف-عليها] | المنصة | اللينكات اللي بتتعرف | | ----------- | ------------------------------------------------------------------------- | | Facebook | `facebook.com` و `fb.com` و `fb.me` و `fb.watch` | | Messenger | `m.me` و `messenger.com` | | Instagram | `instagram.com` و `instagr.am` | | WhatsApp | `wa.me` و `whatsapp.com` | | TikTok | `tiktok.com` | | X (Twitter) | `x.com` و `twitter.com` | | YouTube | `youtube.com` و `youtu.be` | | Snapchat | `snapchat.com` | | LinkedIn | `linkedin.com` و `lnkd.in` | | Telegram | `t.me` و `telegram.me` و `telegram.org` | | Threads | `threads.net` و `threads.com` | | Pinterest | `pinterest.com` و `pin.it` | | Google Maps | `maps.google.com` و `google.com/maps` و `maps.app.goo.gl` و `goo.gl/maps` | | Tripadvisor | `tripadvisor.com` (وأي نطاق دولة) | أي لينك تاني بيظهر بأيقونة **موقع** (كرة أرضية)، فتقدر تحط مثلاً لينك موقعك أو صفحة على Booking. `m.me/yourpage` بيظهر كأيقونة ماسنجر وبيفتح شات مع صفحتك على طول، أما `facebook.com/yourpage` بيفتح الصفحة نفسها. حط الاتنين لو حابب. ## بتظهر فين؟ [#بتظهر-فين] * **قسم «تواصل معانا»** في صفحتك العامة، فوق أزرار الشات والواتساب (لو القسم شغال). * **آخر كل صفحة** (الفوتر)، ومنها صفحات البرامج. الأيقونات بتظهر بنفس ترتيبك في الإعدادات، فحط أهم حساب الأول. رقم الواتساب بتاعك بيظهر لوحده كزرار في الصفحة من «رقم الواتساب» في بيانات الوكالة، فمش لازم تضيف لينك `wa.me` إلا لو عايز أيقونة زيادة. ## الخطوة الجاية [#الخطوة-الجاية] # بيانات الوكالة واللوجو URL: https://docs.flyby.world/ar/settings/agency-profile > بيانات وكالتك اللي بتظهر للعملاء وبيستخدمها الوكيل الذكي في ردوده، ولينكات السوشيال ميديا واللوجو. بيانات الوكالة بتظهر لعملاءك في الصفحة العامة والفواتير، والوكيل الذكي بيرجعلها لما حد يسأل «إنتو مين؟» أو «عنوانكم فين؟». كل ما تكون كاملة، ردود الوكيل بتبقى أدق. **مين يقدر يعدّلها؟** المالك والمدير. افتح بيانات الوكالة ## الخانات [#الخانات] | الخانة | بتُستخدم في إيه | | -------------------------------------------- | ------------------------------------------------------------------------------------------ | | **اسم الوكالة** | إجباري. بيظهر في كل مكان، والوكيل الذكي بيعرّف نفسه بيه | | **الاسم بالإنجليزي** | بيظهر في الواجهة الإنجليزي والفواتير الإنجليزي | | **رقم التليفون** و**رقم الواتساب** | أرقام التواصل اللي بتظهر للعملاء وفي الفاتورة | | **البريد الإلكتروني** و**الموقع الإلكتروني** | بيظهروا في الفاتورة وبيستخدمهم الوكيل لما حد يسأل | | **العنوان** و**المدينة** و**الدولة** | العنوان بيظهر في الفاتورة والوكيل بيقوله للعميل | | **العملة الأساسية** | العملة الافتراضية للبرامج والحجوزات والتقارير | | **المنطقة الزمنية** | بنحسب بيها مواعيد العمل والتقارير | | **نبذة عن الوكالة** | الوكيل الذكي بيقراها ويستخدمها لما العميل يسأل عنكم، وبتظهر في قسم النبذة في الصفحة العامة | | **السوشيال ميديا** | لينكات صفحاتك، وأيقوناتها بتظهر في الصفحة العامة | بعد ما تعدّل اضغط **حفظ التعديلات**. ## اكتب نبذة تساعد الوكيل الذكي [#اكتب-نبذة-تساعد-الوكيل-الذكي] النبذة دي من أهم الخانات. اكتب فيها: * خبرتكم وسنة التأسيس. * تخصصكم (عمرة، سياحة داخلية، سياحة خارجية، رحلات شهر العسل...). * فروعكم وترخيصكم. * أي حاجة بتميزكم عن غيركم. شركة سياحة مرخصة من وزارة السياحة من 2010، متخصصين في برامج العمرة الاقتصادية والفاخرة ورحلات تركيا ودبي، وعندنا فرعين في القاهرة والإسكندرية. النبذة بتعرّف بالوكالة. أما الأسعار والسياسات (الدفع، الإلغاء، الأوراق المطلوبة) فحطها في [الأسئلة الشائعة](/ar/catalog/faqs)، وطريقة الرد في [تعليمات الوكيل](/ar/ai-agent/instructions). ## السوشيال ميديا [#السوشيال-ميديا] اضغط **ضيف لينك** والزق لينك صفحتك (إنستجرام، فيسبوك، تيك توك، يوتيوب، X، سناب شات، لينكدإن، تليجرام، خرائط جوجل…). فلايباي بيعرف المنصة من اللينك لوحده ويعرض أيقونتها في صفحتك العامة. التفاصيل في [لينكات السوشيال ميديا](/ar/public-page/social-links). ## اللوجو [#اللوجو] اللوجو ليه صفحة لوحده: **الإعدادات ← اللوجو**. بيظهر في صفحة الشات والصفحة العامة والفواتير والعروض اللي بتبعتها للعملاء. ### افتح الإعدادات ← اللوجو [#افتح-الإعدادات--اللوجو] افتح اللوجو ### اضغط «رفع لوجو» [#اضغط-رفع-لوجو] أو «تغيير اللوجو» لو فيه لوجو قديم. ### اختار الصورة [#اختار-الصورة] PNG أو JPG أو WEBP، وأقصى حجم 2 ميجا. الأفضل صورة **مربعة بخلفية فاضية (شفافة)**، عشان تبان حلوة في كل الأماكن. تقدر تشيل اللوجو في أي وقت من **حذف اللوجو**. ## الخطوة الجاية [#الخطوة-الجاية] # الإعدادات URL: https://docs.flyby.world/ar/settings > كل صفحات الإعدادات في فلايباي، ومين يشوف أنهي صفحة. من **الإعدادات** بتظبط بيانات وكالتك ومواعيدها وقنواتها وباقتك، وكمان إشعارات الجهاز اللي إنت شغال عليه. افتح الإعدادات ## صفحات الإعدادات [#صفحات-الإعدادات] القايمة متقسمة لجزئين: صفحات **الوكالة** وصفحات **الجهاز ده**. ### صفحات الوكالة (المالك والمدير) [#صفحات-الوكالة-المالك-والمدير] | الصفحة | فيها إيه | | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **بيانات الوكالة** | الاسم وأرقام التواصل والعنوان والعملة والمنطقة الزمنية والنبذة اللي الوكيل الذكي بيستخدمها، ولينكات السوشيال ميديا. [اعرف أكتر](/ar/settings/agency-profile) | | **اللوجو** | لوجو وكالتك اللي بيظهر في صفحة الشات والصفحة العامة والفواتير. [اعرف أكتر](/ar/settings/agency-profile#اللوجو) | | **مواعيد العمل** | أيام وساعات شغل فريقك. [اعرف أكتر](/ar/settings/working-hours) | | **القنوات والربط** | شات الموقع وواتساب وماسنجر وإنستجرام والـ Webhook الصادر. [اعرف أكتر](/ar/channels) | | **الباقة والاشتراك** | باقتك واستهلاك الشهر والإضافات. [اعرف أكتر](/ar/billing) | | **منطقة الخطر** | حذف الوكالة نهائياً (للمالك بس). [تحت](#منطقة-الخطر) | ### صفحات الجهاز ده (كل الأعضاء) [#صفحات-الجهاز-ده-كل-الأعضاء] | الصفحة | فيها إيه | | ----------------- | ------------------------------------------------------------------------------------------------ | | **الإشعارات** | إشعارات المتصفح وصوت التنبيه على الجهاز ده. [اعرف أكتر](/ar/settings/notifications) | | **تثبيت التطبيق** | تثبيت فلايباي على الموبايل أو الكمبيوتر كأنه تطبيق. [اعرف أكتر](/ar/getting-started/install-app) | مشرف العملاء بيشوف صفحات **الجهاز ده** بس. لما يفتح الإعدادات بيروح على **الإشعارات** على طول. ## حسابي [#حسابي] بياناتك الشخصية مش في إعدادات الوكالة. من قايمة الحساب فوق افتح **حسابي** عشان: * تغيّر اسمك ولغة الواجهة. * تغيّر كلمة السر. * تشوف وكالتك ودورك فيها، أو تسيبها. * تسجّل خروج من الجهاز ده. ## منطقة الخطر [#منطقة-الخطر] صفحة **منطقة الخطر** بتظهر **للمالك بس**، وفيها **حذف الوكالة نهائياً**. هيتمسح كل حاجة: المحادثات والعملاء والبرامج والحجوزات والمالية والفريق، وكل الأعضاء هيفقدوا الدخول. عشان تحذف: 1. افتح **الإعدادات ← منطقة الخطر**. 2. اضغط **حذف الوكالة**. 3. اكتب اسم الوكالة بالظبط للتأكيد. 4. اضغط **حذف نهائي**. لو عايز تسيب الوكالة لحد تاني بدل ما تحذفها، استخدم [نقل الملكية](/ar/team/invites#نقل-الملكية-المالك-بس). ## الخطوة الجاية [#الخطوة-الجاية] # الإشعارات URL: https://docs.flyby.world/ar/settings/notifications > خلي فلايباي ينبهك على الموبايل والكمبيوتر لما محادثة تحتاجك أو عميل يتأهل، حتى وهو مقفول. فلايباي بينبهك بالحاجات المهمة: محادثة محتاجة حد من الفريق، عميل جاهز للحجز، أو محادثات الذكاء الاصطناعي قربت تخلص. الإشعارات بتظهر في الجرس جوه البرنامج، وتقدر كمان تخليها توصلك كإشعارات على الجهاز. كل واحد في الفريق بتوصله الإشعارات (الجرس وإشعارات المتصفح) **بلغته هو**: اللغة اللي مختارها في **حسابي**، والمستخدم الجديد بتوصله باللغة اللي سجّل بيها. كل جهاز ليه إعداداته. فعّل الإشعارات على **كل** موبايل وكمبيوتر بتستخدمه. وكل عضو في الفريق بيظبط إشعاراته بنفسه، حتى مشرف العملاء. افتح الإشعارات ## الإعدادات [#الإعدادات] | الإعداد | بيعمل إيه | الافتراضي | | ------------------- | ------------------------------------------------------------------------------------------------------------- | --------- | | **إشعارات المتصفح** | إشعار على الجهاز بالمحادثات اللي محتاجاك والعملاء المؤهلين والتنبيهات، **حتى لو فلايباي في الخلفية أو مقفول** | مقفول | | **صوت التنبيه** | نغمة قصيرة لما يوصل إشعار جديد وفلايباي مفتوح | مفتوح | ## تفعيل إشعارات المتصفح [#تفعيل-إشعارات-المتصفح] ### افتح الإعدادات ← الإشعارات [#افتح-الإعدادات--الإشعارات] على الجهاز اللي عايز توصلك عليه الإشعارات. ### فعّل «إشعارات المتصفح» [#فعّل-إشعارات-المتصفح] ### اضغط «حفظ» [#اضغط-حفظ] المتصفح هيسألك تسمح بالإشعارات ولا لأ. اختار **السماح** (Allow). على الآيفون الإشعارات بتشتغل **بس بعد ما تثبّت التطبيق** على الشاشة الرئيسية: 1. افتح فلايباي من Safari، واضغط زرار المشاركة وبعدين **إضافة إلى الشاشة الرئيسية**. 2. افتح فلايباي من الأيقونة الجديدة. 3. روح **الإعدادات ← الإشعارات** وفعّل الإشعارات من هناك. لو ظهرلك «المتصفح ده مش بيدعم الإشعارات»، يبقى إنت فاتح من المتصفح مش من التطبيق. شوف [تثبيت التطبيق](/ar/getting-started/install-app). بتشتغل من Chrome على طول. ولو ثبّت التطبيق (قائمة ⋮ ← **تثبيت التطبيق**) هتبقى التجربة أحسن. بتشتغل في Chrome وEdge وBrave وFirefox وSafari. الإشعارات بتوصلك حتى لو التاب مقفول، طول ما المتصفح شغال. ## الإشعارات مقفولة من المتصفح [#الإشعارات-مقفولة-من-المتصفح] لو ظهرلك «الإشعارات مقفولة لفلايباي»، يبقى إنت (أو حد) اخترت **منع** قبل كده: 1. اضغط **علامة القفل** جنب عنوان الموقع في المتصفح. 2. خلي **الإشعارات** على **السماح**. 3. اعمل refresh للصفحة، وفعّل «إشعارات المتصفح» واضغط **حفظ** تاني. * اتأكد إن إشعارات المتصفح نفسه مسموح بيها من إعدادات الموبايل أو الكمبيوتر (ووضع «عدم الإزعاج» مقفول). * على الآيفون: لازم تفتح من التطبيق المتثبّت، مش من Safari. * لو ظهرلك «مقدرناش نفعّل الإشعارات على الجهاز ده»، جرّب تاني بعد refresh. فعّل الإشعارات على كل جهاز لوحده. الإعداد على الكمبيوتر مش بيأثر على الموبايل. ## إيه اللي بيبعت إشعار [#إيه-اللي-بيبعت-إشعار] | الإشعار | امتى | بيوصل لمين | | --------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ---------------------------- | | **محادثة محتاج موظف** | الوكيل الذكي سلّم المحادثة لفريقك («محتاج موظف»): العميل طلب يكلم حد، أو قاعدة تسليم اتطبقت | المالك والمدير | | **تعذّر على الوكيل الذكي الرد** | حصلت مشكلة والمحادثة محتاجة رد من الفريق | المالك والمدير | | **عميل مؤهل** | الوكيل خلّص تأهيل عميل، ومعاه تقييمه (ساخن، دافئ، بارد) | المالك والمدير ومشرف العملاء | | **استخدمت 80% من محادثات الذكاء الاصطناعي** | مرة واحدة في الشهر | المالك والمدير | | **خلصت محادثات الذكاء الاصطناعي** أو **انتهت الفترة التجريبية** | الوكيل الذكي اتوقف | المالك والمدير | لما تدوس على الإشعار، بيفتحلك المحادثة أو العميل أو صفحة الباقة على طول. ## الخطوة الجاية [#الخطوة-الجاية] # مواعيد العمل URL: https://docs.flyby.world/ar/settings/working-hours > حدد أيام وساعات شغل فريقك، عشان الوكيل الذكي يعرّف العملاء امتى حد هيتواصل معاهم. الوكيل الذكي بيرد **24 ساعة طول الأسبوع**. مواعيد العمل مش بتوقفه، لكنها بتعرّفه فريقك موجود امتى، فيقول للعميل الكلام الصح. **مين يقدر يعدّلها؟** المالك والمدير. افتح مواعيد العمل ## ظبّط المواعيد [#ظبّط-المواعيد] ### اختار أيام العمل [#اختار-أيام-العمل] دوس على الأيام اللي فريقك بيشتغل فيها (الأحد لحد السبت). ### حدد الساعات [#حدد-الساعات] اختار **من** و**إلى**. نفس الساعات بتطبق على كل الأيام اللي اخترتها. ### احفظ [#احفظ] اضغط **حفظ التعديلات**. المواعيد بتتحسب بـ**المنطقة الزمنية** اللي في [بيانات الوكالة](/ar/settings/agency-profile)، ومكتوب تحت الساعات «المواعيد بتوقيت …». لو المنطقة الزمنية غلط، المواعيد هتتحسب غلط. * لازم وقت النهاية يكون بعد وقت البداية، يعني مينفعش وردية تعدّي نص الليل. * الإعداد الافتراضي للوكالة الجديدة: السبت لحد الخميس، من 10 الصبح لـ 8 بالليل. ## المواعيد بتُستخدم في إيه [#المواعيد-بتُستخدم-في-إيه] | المكان | اللي بيحصل | | ----------------- | ---------------------------------------------------------------------------------------------------------------------- | | **الوكيل الذكي** | بيعرف فريقك متاح دلوقتي ولا لأ. لو برا المواعيد، بيكمّل مع العميل عادي وبيعرّفه إن الفريق هيتواصل معاه في مواعيد العمل | | **أسئلة العملاء** | لو عميل سأل «بتفتحوا امتى؟» الوكيل بيرد بالمواعيد دي | | **الصفحة العامة** | المواعيد بتظهر في قسم التواصل | لو مختارتش ولا يوم، هيظهرلك «مفيش ولا يوم عمل متحدد»، والوكيل الذكي مش هيعرف يقول للعميل فريقك متاح امتى. ## الخطوة الجاية [#الخطوة-الجاية] # الأدوار والصلاحيات URL: https://docs.flyby.world/ar/team > مين يقدر يعمل إيه في فلايباي، المالك والمدير ومشرف العملاء. كل عضو في الفريق ليه دور واحد بيحدد هو يشوف إيه ويقدر يعمل إيه. فيه ٣ أدوار: **المالك** و**مدير** و**مشرف عملاء**. ## الأدوار باختصار [#الأدوار-باختصار] ## جدول الصلاحيات [#جدول-الصلاحيات] | الصلاحية | المالك | مدير | مشرف عملاء | | -------------------------------------------------------------------- | :----: | :--: | :--------: | | المحادثات: الرد، استلام المحادثة من الوكيل الذكي، الملاحظات والتحويل | ✓ | ✓ | — | | كل العملاء المحتملين (حتى اللي لسه متأهلوش) | ✓ | ✓ | — | | العملاء المؤهلين ومهامهم | ✓ | ✓ | ✓ | | تحويل عميل محتمل لحجز أو حذفه | ✓ | ✓ | — | | عرض جهات الاتصال | ✓ | ✓ | ✓ | | إضافة وحذف جهات الاتصال | ✓ | ✓ | — | | الكتالوج: البرامج والخدمات والأسئلة الشائعة | ✓ | ✓ | — | | الحسابات: الحجوزات والمدفوعات والمصروفات والفواتير | ✓ | ✓ | — | | إعدادات الوكيل الذكي | ✓ | ✓ | — | | الصفحة العامة وإحصائياتها | ✓ | ✓ | — | | الفريق: دعوة أعضاء وتغيير أدوارهم وإزالتهم | ✓ | ✓ | — | | إعدادات الوكالة: البيانات والمواعيد والقنوات والباقة والاشتراك | ✓ | ✓ | — | | إشعاراته وتثبيت التطبيق على جهازه | ✓ | ✓ | ✓ | | إزالة المالك أو تغيير دوره | — | — | — | | نقل الملكية | ✓ | — | — | | حذف الوكالة (منطقة الخطر) | ✓ | — | — | العميل المؤهل هو اللي الوكيل الذكي (أو فريقك) خلّص أسئلة التأهيل معاه ووصل لمرحلة «مؤهل». مشرف العملاء بيشوف العملاء دول حتى لو اتنقلوا بعد كده لعرض سعر أو تفاوض أو حجز أو خسارة. اعرف أكتر عن [التأهيل](/ar/ai-agent/qualification). ## امتى تستخدم كل دور؟ [#امتى-تستخدم-كل-دور] * **مدير**: لشريكك أو مدير المبيعات أو أي حد محتاج يظبط البرامج والحسابات والإعدادات. * **مشرف عملاء**: لموظفين المبيعات اللي شغلهم يكلموا العملاء الجاهزين ويقفلوا الحجز. مش هيشوفوا المحادثات ولا الأرقام المالية. المدير صلاحياته كاملة تقريباً، ومنها الحسابات وربط القنوات والباقة. اديه بس للناس اللي بتثق فيهم. ## الخطوة الجاية [#الخطوة-الجاية] # دعوة الفريق وإدارته URL: https://docs.flyby.world/ar/team/invites > ادعُ زمايلك برابط خاص، غيّر أدوارهم أو شيلهم، وانقل الملكية لو احتجت. من صفحة **الفريق** بتدعو زمايلك وتحدد دور كل واحد. الدعوة عبارة عن **رابط خاص** إنت بتبعته بنفسك، والشخص بيقبله بنفس الإيميل اللي دعيته بيه. **مين يقدر؟** المالك والمدير. مشرف العملاء مالوش دخول على صفحة الفريق. افتح الفريق ## دعوة عضو جديد [#دعوة-عضو-جديد] ### اضغط «دعوة عضو» [#اضغط-دعوة-عضو] من صفحة **الفريق**. ### اكتب الإيميل واختار الدور [#اكتب-الإيميل-واختار-الدور] **مدير** (صلاحيات كاملة) أو **مشرف عملاء** (العملاء المؤهلين بس). شوف [الأدوار والصلاحيات](/ar/team). ### اضغط «إنشاء رابط الدعوة» [#اضغط-إنشاء-رابط-الدعوة] هيظهرلك «رابط الدعوة جاهز». ### ابعت الرابط [#ابعت-الرابط] انسخه وابعته بنفسك، أو اضغط **ابعته على واتساب** وهيتفتح واتساب برسالة جاهزة فيها الرابط. فلايباي مش بيبعت الدعوة بالإيميل. لازم إنت تبعت الرابط للشخص على واتساب أو الإيميل. * الرابط صالح لمدة **14 يوم**. * لو دعيت نفس الإيميل تاني، الرابط الجديد بيلغي القديم. * الدعوات اللي لسه متقبلتش بتظهر في **دعوات مستنية القبول**، ومنها تقدر **نسخ الرابط** تاني أو **إلغاء الدعوة**. * لو دعيت زمايلك وإنت بتجهّز الوكالة، فلايباي بيعرضلك لينكاتهم على طول بزرارين **انسخ اللينك** و**ابعت على واتساب**، وبتلاقيها هنا كمان. [تجهيز الوكالة](/ar/getting-started/onboarding) ## عدد المستخدمين في كل باقة [#عدد-المستخدمين-في-كل-باقة] | الباقة | المستخدمين | | ---------------- | ---------- | | التجربة المجانية | 5 | | البداية | 2 | | النمو | 5 | | المحترف | 15 | العدد ده بيشمل **كل الأعضاء النشطين (ومعاهم المالك) + الدعوات اللي لسه متقبلتش**. لو خلّصت العدد هتظهرلك رسالة «استخدمت كل المستخدمين المتاحين في باقتك». عشان تدعي ناس أكتر: * ضيف **مستخدم إضافي** بـ 250 جنيه / 9 دولار في الشهر لكل مستخدم. [الإضافات](/ar/billing/add-ons) * أو رقّي باقتك من **الإعدادات ← الباقة والاشتراك**. [الباقات](/ar/billing) الدعوة المعلّقة بتاخد مكان مستخدم. لو حد مش هيقبل، ألغي دعوته عشان المكان يرجع. ## قبول الدعوة (للشخص المدعو) [#قبول-الدعوة-للشخص-المدعو] 1. افتح الرابط اللي وصلك. 2. لو مش مسجّل دخول: اضغط **تسجيل الدخول** أو **إنشاء حساب** بـ**نفس الإيميل** اللي الدعوة متبعتة ليه (تقدر كمان تكمّل بجوجل لو نفس الإيميل). 3. اضغط **قبول الدعوة**، وهتدخل على لوحة تحكم الوكالة على طول. إنت داخل بحساب غير الإيميل المدعو. اضغط «سجّل خروج وادخل بالحساب الصح» وادخل بالإيميل اللي الدعوة متبعتة ليه. كل حساب ينفع يكون في وكالة واحدة بس. سجّل خروج واقبل الدعوة بإيميل مختلف، أو سيب الوكالة التانية الأول. ممكن تكون اتلغت أو اتقبلت قبل كده أو عدّى عليها 14 يوم. اطلب من الوكالة رابط جديد. ## تغيير دور عضو [#تغيير-دور-عضو] في قايمة **الأعضاء**، اختار الدور الجديد من القايمة جنب اسم العضو (**مدير** أو **مشرف عملاء**). التغيير بيطبق فوراً. * مينفعش تغيّر دورك إنت. * محدش يقدر يغيّر دور **المالك**. ## إزالة عضو [#إزالة-عضو] اضغط أيقونة الحذف جنب العضو وأكّد. هيفقد الدخول على الوكالة فوراً، وتقدر تدعوه تاني بعدين. المالك مينفعش يتشال. ## نقل الملكية (المالك بس) [#نقل-الملكية-المالك-بس] لو عايز تسلّم الوكالة لحد تاني: ### رقّي الشخص لمدير [#رقّي-الشخص-لمدير] الملكية تتنقل لمدير بس. ### افتح كارت «نقل الملكية» [#افتح-كارت-نقل-الملكية] في صفحة **الفريق** (بيظهر للمالك بس). ### اختار المدير واضغط «نقل الملكية» [#اختار-المدير-واضغط-نقل-الملكية] وأكّد. المدير ده هيبقى المالك الجديد، وإنت هتتحوّل لمدير. مش هتقدر ترجّعها إلا لو هو نقلها لك تاني. ## مغادرة الوكالة [#مغادرة-الوكالة] * **المدير**: اضغط **مغادرة الوكالة** جنب اسمك في صفحة **الفريق**، أو من **حسابي ← وكالاتي**. * **مشرف العملاء**: من **حسابي ← وكالاتي** (من قايمة الحساب فوق). * **المالك**: مينفعش يسيب الوكالة. انقل الملكية الأول. بعد ما تسيب هتفقد الدخول على كل بيانات الوكالة، ومحتاج دعوة جديدة عشان ترجع. ## الخطوة الجاية [#الخطوة-الجاية]