> ## Documentation Index > Fetch the complete documentation index at: https://docs.darkfunnels.ai/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > DarkFunnels is a WhatsApp AI sales-agent platform used mainly in Peru and Latin America. The product interface and most of this documentation are in Spanish; the /en tree is the English mirror. > A business connects the WhatsApp number it already uses by scanning a QR code from the dashboard, the same linked-device mechanism as WhatsApp Web. It does not go through the Meta Cloud API (WhatsApp Business Platform), so there is no application to get approved and no message templates to submit. DarkFunnels is not a Meta product and is not affiliated with Meta. > DarkFunnels also publishes a remote MCP server at https://mcp.darkfunnels.ai/mcp so an assistant such as Claude, ChatGPT or Codex can operate the workspace on the owner's behalf. The tool reference is at /referencia/tools and the connection parameters at /referencia/url-de-conexion. > The dashboard is https://optimind.darkfunnels.ai, the marketing site is https://darkfunnels.ai and the page written for AI agents is https://darkfunnels.ai/agents. # WhatsApp AI agent credits and top-ups > WhatsApp AI agent credits and usage explained: what spends balance, how long it lasts, exactly what happens when you hit zero, and how to top up from the dashboard. Credits are **dollars**: US\$ 1 of credit = US\$ 1. There are no points, no packs with odd equivalences, and no monthly expiry on the balance you bought. The dashboard interface is in Spanish, so buttons and menus are named here in Spanish with the English meaning in parentheses. ## Where the first ones come from Your trial brings **US\$10 in credit and 15 days with up to 5 active agents** — plus **US\$25** if you signed up with a referral code. They are credited **when you connect your WhatsApp**, not when you sign up, and the 15-day clock starts at that very instant. Before that your balance says US\$ 0 and it is not a fault. It is covered by [Connect your WhatsApp](/en/getting-started/connect-whatsapp). Welcome credits are granted **once per account**, for life. Disconnecting and reconnecting the channel neither duplicates them nor takes them away. ## What consumes balance What consumes it is **the AI's work**, and it is measured for real: there is no flat rate per message and no rounding in your favour or in ours. * **Each turn your agent answers** — what it reads from the thread and what it writes. A long conversation costs more than a "how much is it?" answered in one line. * **The audio it transcribes**, per second of audio. * **The photos it interprets** when a customer sends an image. * **The documents it reads** when assembling your product's context. * **Funnel generation and playbook proposals**, every time you ask for them. What does **not** consume: having the WhatsApp session connected, or using the dashboard. The spending is generated by the AI when it works, not by the fact of being signed up. ## How much each conversation costs you The unit that really matters is not the token, it is the conversation. That is why the credits card in **Saldo y facturación** ("Balance and billing") translates it with your own data: *"This month, each conversation cost you \~US\$ 0.15"*, followed by how many conversations your agents started this month and how much they consumed between them all. It is an **average for the current month**, not a rate: it comes from dividing what your agents consumed by the conversations they started, and it is the same number you see on Home as **Costo por conversación** ("Cost per conversation"). While there are no conversations in the month, the card tells you so instead of inventing a figure. If the average looks high to you, it is nearly always long conversations or lots of audio: the playbook decides how much your agent talks, and a script that closes in fewer steps also costs less. ## How long it lasts you It depends on how many conversations you have and how long they are, so any number we put here would be a lie for somebody. The dashboard tells you with your data: in **Saldo y facturación** ("Balance and billing"), the credits card projects *"At your consumption rate, the balance lasts \~N days"* using your real consumption for the month. It is the one figure worth trusting. ## What happens when you reach zero When you run out of balance **your agents stop answering new turns**. The conversations are not deleted and the number stays connected: it is simply that nobody answers until you top up. **What is lost: the turn that was not answered.** The messages people write to you while you have no balance **are saved and you see them in the inbox**, but they do not sit in a queue: on topping up, your agent **does not answer the backlog**. It picks up with the next message that customer writes. If nobody writes again, nobody gets a reply — which is why it is better to top up beforehand, and to review by hand what came in in the meantime. The cut-off does not wait for exactly US\$ 0: your agent goes quiet when the balance drops below **US\$ 0.10**, so you can see a remainder on screen and have it silent all the same. That is why the dashboard distinguishes three notices, and each one tells the truth about its number: | Notice | What happened | | ----------------------------------------------- | --------------------------------------------------------------------------- | | **Saldo insuficiente** ("Insufficient balance") | You have something left, but less than a turn costs. | | **Saldo agotado** ("Balance exhausted") | You reached zero. | | **Saldo en deuda** ("Balance in debt") | The balance went negative. Your next top-up deducts the debt automatically. | The **Saldo** ("Balance") chip in the top bar turns amber when little is left and red when the agent no longer answers: it is the notice you will see first, without going into any screen. ## How to top up In the side menu, block **Administración → Dinero** ("Administration → Money"). Or press the **Saldo** ("Balance") chip in the top bar, which leads to the same place. The pack picker opens: **US\$ 5, 10, 25, 50 or 100**. Choose and confirm. Everything is paid **in dollars, by card**. The charge goes through the payment gateway; your card is stored for the next top-ups, which are charged instantly without typing it again. The balance is credited straight away and you will see it in the history as a **Recarga** ("Top-up") movement with its reference. Top up **before** you hit zero. While the balance is exhausted your agent does not answer, and a sale that was not answered in time costs quite a bit more than US\$ 10. If the payment does not go through or the packs do not load, the dashboard itself offers **Contactar al equipo** ("Contact the team") over WhatsApp and we apply it by hand. ## Trial, subscription and balance are three different things It is worth not mixing them up: * **The trial** is 15 days with up to 5 active agents. When it ends, your agents stop answering new turns even if you have balance to spare. * **The subscription** is what gives you back the active agents when the trial ends. * **The balance** is the AI's fuel. It is spent with use and topped up whenever you like, whether you are on trial or on a subscription. The balance you bought **does not expire** when the trial ends: it is still there when you subscribe.