> ## 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.
# La red de referidos
> Que tus clientes te traigan clientes: tu agente anota cada recomendación por WhatsApp, tú fijas las recompensas por nivel y llevas los pagos.
Un cliente contento conoce a otros como él. **La red de referidos convierte
esas recomendaciones en ventas que puedes medir y premiar.** Tu agente anota a
quién te recomienda cada cliente por WhatsApp. Tú decides cuánto gana cada
persona cuando el recomendado deja su adelanto. Y en esta pantalla llevas la
cuenta de lo que debes y de lo que ya pagaste.
**Dónde está.** En el menú de la izquierda, dentro de **Ventas**, elige tu
agente en el selector (el círculo con su foto o su inicial y su nombre).
Después, bajo el separador **COMERCIO**, pulsa **Red de referidos**, justo
debajo de **Catálogo**. (Directo: `optimind.darkfunnels.ai/red-referidos`.) La
ve cualquier persona de tu equipo con acceso a la app **Ventas**.
**No es lo mismo que «Referidos» de Administración → Plataforma.** Ese otro
programa es el de DarkFunnels: lo que ganas en créditos cuando otro negocio se
suscribe con tu código. Lo cuenta
[Créditos y recarga](/primeros-pasos/creditos-y-recarga#invita-a-otros-negocios-y-gana-creditos).
Esta guía es del programa de **tu** negocio, para **tus** clientes.
## Cómo funciona, de punta a punta
1. **Tu cliente te recomienda a alguien.** En el chat le pasa a tu agente el
contacto de un conocido: como tarjeta de contacto de WhatsApp o escribiendo
el número.
2. **Tu agente lo registra.** Desde ese momento, ese conocido es un
**referido** de tu cliente.
3. **El referido llega.** O tu cliente le reenvía una presentación con tu
número y él te escribe, o tu WhatsApp le escribe primero. Eso lo eliges tú.
4. **El referido compra y deja su adelanto.** Tú lo marcas en esta pantalla.
5. **La red gana.** Gana quien lo recomendó y, si les pusiste monto, también
quienes están más arriba en su red, hasta 5 niveles. Cada uno puede recibir
un WhatsApp con la noticia.
6. **Tú pagas por PayPal y lo registras aquí.** Si la persona tiene
conversación con tu agente y el aviso **Cuando le pagas** está encendido
(viene así de fábrica), recibe otro WhatsApp que le confirma el pago.
**Un ejemplo.** En la tienda «Moda Sol», el nivel 1 gana 30 PEN y el nivel 2
gana 10 PEN. Lucía le recomendó a Carla, y después Carla le recomendó a Rosa.
Cuando Rosa deja su adelanto, **Carla gana 30 PEN** (ella recomendó a Rosa: es
el nivel 1) y **Lucía gana 10 PEN** (ella recomendó a Carla: es el nivel 2).
### Las palabras de esta pantalla
| Palabra | Qué significa |
| - | - |
| **Referido** | La persona que te recomendaron. |
| **Referidor** | Tu cliente que te recomendó a alguien. |
| **Adelanto** | El primer pago del referido. Es lo que hace ganar a la red, y lo marcas tú. |
| **Recompensa** | Lo que gana cada persona de la red por ese adelanto. El panel también la llama **premio**. |
| **Nivel** | En las recompensas, **N1** es quien recomendó al referido y cobra el nivel 1; **N2**, quien recomendó a ese N1; y así hasta **N5**. Ojo: la columna **nivel** de la pestaña Referidos mide otra cosa, a qué altura de la red está el referido (ver [Referidos](#referidos)). |
| **Origen** | Alguien que recomienda sin haber llegado recomendado. Es la punta de una rama de la red. |
## Pon en marcha tu programa
Abre la pestaña **Programa** y baja hasta **Recompensas por nivel**. Elige
la moneda, pulsa **Agregar nivel** y escribe el monto de cada nivel.
**Sin niveles, el programa no genera recompensas**, y los pedidos
automáticos de la pestaña Avisos no salen.
→ [Programa](#programa)
En **¿Quién escribe primero?**, deja **El cliente lo presenta** (viene así
de fábrica y es lo recomendado) o cambia a **El agente le escribe
primero**. La diferencia la ves en
[Lo que hace tu agente en WhatsApp](#lo-que-hace-tu-agente-en-whatsapp).
Tu agente pide referidos en el capítulo donde tu manual se lo indique. En
ese capítulo, cuéntale al cliente del programa y añade la herramienta
**Registrar un referido** desde el menú `@` → **Herramientas**. En el texto
del manual se ve como **«Registrar Referido Tool»**.
→ [Registrar un referido](/guias/herramientas#registrar-un-referido)
De vuelta en **Programa**, en **¿Dónde pide referidos tu agente?**, elige
ese capítulo en **Capítulo donde pide referidos**. Con él se cuentan los
pedidos de referidos y, si lo enciendes en Avisos, de ahí parte el
recordatorio **«Si tu cliente no te pasa ningún contacto»**.
El botón está arriba, en la fila de las pestañas. **Nada de Programa se
guarda hasta que lo pulses.**
En la pestaña **Avisos** decides qué manda el programa por su cuenta. Los
pedidos al confirmar el pago y en la post-venta, y el recordatorio **«Si tu
cliente no te pasa ningún contacto»**, vienen apagados: si los quieres,
enciéndelos ahí.
→ [Avisos](#avisos)
## Lo que hace tu agente en WhatsApp
### Cuando tu cliente le pasa un contacto
El agente registra **a cada persona por separado**. Necesita su nombre y su
WhatsApp **con código de país**. Si el número llega sin código de país, el
agente no lo completa por su cuenta: se lo pide a tu cliente. Si tu cliente
cuenta algo de esa persona (a qué se dedica, dónde vive), queda guardado.
En la ficha del referido quedan **Referido por**, con el nombre de quien lo
recomendó, y **Contexto del referido**, si tu cliente contó algo de él.
Lo que pasa después depende de lo que elegiste en **¿Quién escribe primero?**:
* En el mismo chat, el agente le manda a tu cliente **un mensaje aparte con
tu presentación**, tal cual la escribiste en Programa (o la de fábrica).
* La presentación lleva **el número de WhatsApp de tu agente en texto**.
WhatsApp lo convierte solo en un toque que abre el chat contigo.
* Si elegiste una foto, un video o un PDF, va **en ese mismo mensaje**, con
la presentación como pie. Así tu cliente reenvía una sola cosa.
* El agente le pide a tu cliente que se la reenvíe a su conocido y le da
las gracias.
* **El referido te escribe él.** El agente lo reconoce por su número,
escriba lo que escriba, y lo atiende desde el capítulo que elegiste en
Programa.
* Cuando el referido te escribe por primera vez, el agente le agradece la
recomendación a tu cliente por su chat, de día (aviso **«Cuando su
conocido escribe»**).
* Si el referido no escribe, a los 3 días (de fábrica) el agente le pregunta
una vez a tu cliente si pudo reenviarle tu presentación (aviso **«Si su
conocido no escribe»**).
**Tu número no le escribe primero al referido.** Por eso es lo recomendado.
* Tu WhatsApp le manda al referido **un solo mensaje**: una apertura de una
o dos líneas que redacta la IA (el saludo según la hora, quién eres, de
parte de quién viene y el contexto, si lo hay), después tu texto y, si
quieres, una foto, un video o un PDF.
* Sale **de día**: entre las 8:00 y las 20:00 en la zona horaria del agente,
y fuera de su horario de no molestar. Si tu cliente pasa el contacto de
noche, el mensaje sale por la mañana.
* Hay un **tope de referidos por día** (3 de fábrica, hasta 20). Cuando el
día se llena, los siguientes salen el siguiente día con cupo, desde las 8,
y el agente le dice a tu cliente que le escribirán mañana (o en cuántos
días), no que ya le escribieron.
* Si el referido te escribe antes de que salga ese mensaje, el mensaje ya no
sale.
* **Después no hay seguimiento al referido.** El capítulo que elegiste corre
cuando conteste. Y cuando contesta, a tu cliente le llega el
agradecimiento (aviso **«Cuando su conocido escribe»**), igual que en el
otro modo.
**Cada uno de esos mensajes le llega a alguien que no te tiene guardado.**
WhatsApp castiga escribirle primero a desconocidos, no responder. Con un
número recién vinculado, empieza con un tope bajo.
### Las reglas que el agente ya conoce
* **No cuenta quien ya le escribió a este agente.** Si ese número ya conversó
con este embudo, el agente se lo dice a tu cliente con amabilidad y no
registra nada.
* **Si el mismo cliente vuelve a pasarte a alguien que ya te recomendó**, esa
persona sigue contando para él. Si aún no te escribe, el agente le indica que
reenvíe el mensaje que le pasó cuando lo registró.
* **Gana el primero.** Si otro cliente ya había recomendado ese número, el
nuevo registro no cuenta. La excepción: si en Programa fijaste **«Un referido
vale (días)»** y ese plazo pasó sin adelanto, la recomendación pasa al nuevo
cliente.
* **Nadie se recomienda a sí mismo.** El agente no registra el número del propio
cliente.
* **Sin un WhatsApp conectado no se registra a nadie.** El agente le dice a tu
cliente que tomó nota, sin prometerle que le escribirán.
Al registrar un referido, el agente tiene orden de **no hablar de premios**. De
dinero hablan los pedidos y los mensajes de la pestaña [Avisos](#avisos), que
tú enciendes y redactas.
### Cuando tu cliente dice que no
Si tu cliente dice que no con claridad («no conozco a nadie», «no, gracias»)
después de un pedido de referidos que se contó, **el agente lo anota solo**. Un
pedido se cuenta cuando tu cliente entra al capítulo que elegiste en **¿Dónde
pide referidos tu agente?**, o cuando le llega un pedido o el recordatorio de
[Avisos](#avisos). Desde ese momento ya no le llegan los pedidos automáticos, y
se cancela el recordatorio que tuviera pendiente.
Si el agente le pidió desde un capítulo que no elegiste en Programa y antes no
hubo ningún pedido contado, ese «no» no queda anotado: los pedidos automáticos
pueden salir igual más adelante. Un «lo pienso» o «te lo paso luego» no cuenta
como un no.
### Cuando tu cliente pregunta cómo van sus referidos
Si tu cliente pregunta «¿cómo van mis referidos?» o «¿ya me pagaron?», el agente
**consulta su estado real** y le responde con sus palabras: a quién recomendó,
si ya te escribió o dejó su adelanto, cuánto ganó, cuánto se le pagó y cuánto
falta. Tiene orden de nombrar solo a las personas que tu cliente recomendó (de
su red da solo cifras) y de no prometer fechas de pago.
### Lo que recibe quien llega recomendado
Si en Programa escribiste algo en **¿Qué recibe quien llega recomendado?**:
* En el modo **El cliente lo presenta**, la presentación que reenvía tu cliente
lleva al final la frase **«Por ir de mi parte tienes…»** con ese beneficio.
Si tu texto no incluye `{{numero}}`, tu número va después, en su propia
línea.
* En los dos modos, el beneficio queda guardado en la ficha del referido, como
**Beneficio por venir recomendado**. Se guarda el de ese día: si después lo
cambias, lo prometido no cambia.
El agente tiene orden de decírselo al referido, de respetarlo al cotizar y de no
contarle lo que gana quien lo recomendó.
### Los clientes embajadores
Si en Programa fijaste **Embajador desde**, el cliente que llega a esa cantidad
de recomendados con adelanto pasa a ser **embajador**:
* Su ficha recibe la etiqueta **«Embajador»** y el dato **Embajador del
programa de referidos**.
* El agente tiene orden de atenderlo con prioridad y especial calidez.
* Cuando escribe, tu equipo recibe un WhatsApp que empieza con *«⭐ Te escribe
un embajador de tu programa de referidos»*. Va a los números de **Informar de
las ventas**, en
[Configuración](/guias/configuracion-del-agente#informar-de-las-ventas).
Se decide al marcar un adelanto: si un cliente ya pasaba esa cantidad antes de
que la fijaras, pasa a embajador con su siguiente recomendado con adelanto. Con
el **Bono por cantidad** pasa lo mismo.
Ese aviso al equipo sale como mucho una vez cada 6 horas por chat, entre las
7:00 y las 22:00 en la hora del agente, y no desde tu chat de prueba. Solo les
llega a los números de la lista que le escribieron a la línea de tu agente en
los últimos 30 días.
## La pantalla, pestaña por pestaña
Arriba, el título **«Red de referidos»** y siete pestañas: **Resumen ·
Referidos · Pagos · Red · Referidores · Programa · Avisos**.
**Todo es por agente.** Lo que ves y lo que configuras es del agente elegido en
el selector. Si cambias de agente, cambia la red entera. Sin agente elegido, la
pantalla dice **«Selecciona un agente»**.
**Las cinco primeras pestañas se actualizan solas cada 10 segundos** mientras
tienes la pestaña del navegador a la vista. A la derecha de las pestañas lo
dice: *«En vivo · actualizado hace 8 s»* (en los primeros segundos, *«En vivo ·
actualizado ahora»*). El botón **Actualizar** relee al
momento. **Programa** y **Avisos** no se actualizan solas: son formularios, y
así no te borran lo que estás escribiendo.
### Resumen
El programa de un vistazo.
| Cifra | Qué cuenta |
| - | - |
| **Referidos** | Los referidos registrados. Debajo, cuántos esperan respuesta. |
| **Respondieron** | Los que ya te escribieron y aún no dejan adelanto. |
| **Adelantos** | Los referidos con adelanto. Debajo, cuántos ya están pagados. |
| **Conversión** | De referido a adelanto, en porcentaje. |
| **Por pagar** | Lo que debes en recompensas, y lo que ya pagaste. Si la pulsas, te lleva a **Pagos**. |
Debajo vienen cuatro bloques:
* **Dónde está cada referido.** Una barra con cinco tramos: **Invitados, aún
sin escribir** · **Esperando respuesta** · **Respondieron** · **Adelanto, por
pagar** · **Pagados**.
* **Embudo del programa.** Mide el programa desde que empezó. Arriba, tres
datos: **Pedidos de referidos** (cuántas veces tu agente pidió y qué respondió
el cliente: si dio contactos, si dijo que no, si respondió sin pasar contactos
o si no respondió), **Referidos por cliente** y **Del adelanto al pago** (lo
que tardas en pagar, en mediana). En el medio, una gráfica con cuatro barras:
**Contactos**, **Escribieron**, **Adelanto** y **Pagado**. Entre barra y barra
dice qué porcentaje pasa y cuántos se quedan, y marca **el paso más flojo**.
Abajo, la tabla **Por semana**, con las últimas 8 semanas.
* **Recompensas.** Por moneda: lo que está por pagar, lo pagado y lo generado.
**Ver pagos** te lleva a Pagos.
* **Quién más recomienda.** Tus 5 mejores referidores. **Ver ranking** te lleva
a Referidores.
**Un pedido de referidos se cuenta cuando tu cliente entra al capítulo donde tu
agente los pide**, y también cuando sale un pedido automático de Avisos (al
confirmar el pago, en la post-venta o con el recordatorio). Si no eliges ese
capítulo en Programa, los pedidos que tu agente haga desde el manual no se
cuentan.
Si todavía no hay referidos ni pedidos de referidos contados, el Resumen dice
**«Aún no hay referidos»** y te ofrece **Configurar recompensas**, que te lleva
a Programa.
### Referidos
La lista de tus referidos, con su estado y lo que puedes hacer con cada uno.
Arriba tienes el buscador **«Buscar nombre o teléfono…»**, los filtros
**Todos · Invitados · Contactados · Respondieron · Con adelanto · Pagados** y el
botón **Exportar CSV**.
Las columnas son **referido**, **referido por**, **nivel**, **fecha**,
**estado** y **recompensas**:
* Pulsa el **nombre del referido** para abrir su panel lateral.
* Pulsa el **nombre de quien lo recomendó** para ver solo sus referidos. Arriba
aparece el filtro **«Referidos de…»**, con una **x** para quitarlo.
* **Nivel** dice a qué altura de la red está el referido: **N1** si lo recomendó
un origen, **N2** si lo recomendó alguien de N1, **N3** si lo recomendó
alguien de N2, y así (puede pasar de N5). **No es el nivel de las
recompensas**: en el ejemplo de «Moda Sol», Rosa sale como **N2**, y su
adelanto le paga el nivel 1 a Carla y el nivel 2 a Lucía.
* **Recompensas** muestra lo que gana cada nivel por su adelanto. Antes de
marcarlo dice *«Al marcar el adelanto»*.
#### Los estados de un referido
| Estado | Qué significa |
| - | - |
| **Invitado** | Tu cliente lo presentó y todavía no te escribe. |
| **Contactado** | Se registró con **El agente le escribe primero** y todavía no responde. El primer mensaje ya salió o espera su hora: de noche, en el horario de no molestar o por el tope del día. |
| **Respondió** | Ya te escribió. |
| **Adelanto recibido** | Marcaste su adelanto: sus recompensas están por pagar. Al pasar el ratón, dice quién lo marcó. |
| **Pagado** | Pagaste todas sus recompensas. Pasa a este estado solo, al registrar el último pago. |
| **Pasó a otro cliente** | Venció su plazo sin adelanto y lo recomendó otro cliente. Queda como historia: su adelanto se marca en la fila del nuevo cliente. |
| **Devolvió el adelanto** | Marcaste que le devolviste el adelanto. Sus premios sin pagar se anularon. |
#### Los botones de cada fila
| Botón | Cuándo aparece | Qué hace |
| - | - | - |
| **Abrir chat** | Si el referido tiene chat. Se crea al registrarlo, así que suele estar desde el principio, vacío hasta que haya un mensaje | Abre su chat en Conversaciones. |
| **Vincular chat** | Mientras el referido no te ha escrito | Para cuando te escribió desde otro número. Ver más abajo. |
| **Marcar adelanto** | En **Contactado** y **Respondió** | Registra su adelanto y crea las recompensas de la red. |
| **Pagar N1** (o **Pagar N2**, **Pagar bono**…) | Si hay una recompensa por pagar | Abre el pago de la de menor nivel. |
| **Devolvió el adelanto** | En **Adelanto recibido** y **Pagado** | Anula sus premios sin pagar. |
#### Marcar el adelanto
**Marcar el adelanto lo haces tú.** Aprobar su pago en Pedidos no lo marca
solo.
La misma celda te pregunta **«¿Adelanto recibido?»**. Pulsa **Sí, marcar**,
o **No** si te equivocaste.
El panel revisa si en Pedidos hay un pago confirmado de ese referido: un
pedido suyo con un pago registrado a mano o un comprobante aprobado. Si no
lo hay, la celda dice **«Sin pago confirmado en Pedidos»**.
* Si el adelanto entró por fuera (por ejemplo, en efectivo), pulsa
**Marcar igual: entró por fuera**. Queda anotado, y al pasar el ratón por
su estado se lee.
* Si no, pulsa **No** y registra primero el pago en
[Pedidos](/guias/pedidos-y-metricas#registrar-un-pago).
Al marcarlo, se crean las recompensas de toda la cadena, solo en los niveles
con monto mayor que 0. Si el aviso **«Cuando su referido da el adelanto»**
está encendido, a cada persona que gana se le manda un WhatsApp por la línea
de tu agente. El aviso que aparece en pantalla te cuenta qué pasó: a quién
se le avisó, si ese aviso está apagado, si algún WhatsApp no salió o si
alguien no tiene conversación abierta. **A quien no le llegó, escríbele tú
desde su chat.**
Si con ese adelanto tu cliente llega al bono o a embajador, también se crea su
bono o se le nombra embajador, y la frase va en el mismo WhatsApp.
#### «Vincular chat»: el referido te escribió desde otro número
A veces tu cliente te pasa un número y su conocido te escribe desde otro.
Entonces entra como un desconocido y su fila sigue en **Invitado** o
**Contactado**.
Se abre **«¿Desde qué chat escribió…?»** con el nombre del referido.
La lista trae **solo a quienes te escribieron por primera vez después de la
recomendación**, con su primer mensaje. Así no se puede vincular a un
cliente que ya tenías para cobrar un premio. Puedes buscar por nombre o
número.
Queda como referido de quien lo recomendó. Su ficha recibe **Referido
por** y, si tu cliente contó algo de él, **Contexto del referido**. A tu
cliente le llega el agradecimiento (si ese aviso está encendido) y ya no se
le pregunta si pudo reenviar tu presentación. En el modo en frío, además,
se cancela el mensaje al número de la tarjeta si aún no había salido.
Lo que no cambia: su chat sigue en el capítulo en que estaba, y su ficha no
recibe el **Beneficio por venir recomendado**. Si le prometiste uno,
díselo tú.
#### «Devolvió el adelanto»
Si le devuelves el adelanto a un referido, pulsa **Devolvió el adelanto** y
confirma con **Sí, anular premios**. Se anulan los premios **sin pagar** de ese
adelanto en toda la cadena, y el bono de tu cliente si con eso queda por debajo
de la meta. **Lo ya pagado no cambia, y no se envía ningún WhatsApp**: si te
preguntan, explícales tú. Si el referido vuelve a pagar, márcalo otra vez.
#### Exportar CSV
**Exportar CSV** descarga los referidos que cumplen los filtros que tienes
puestos, no solo los que ves en pantalla, hasta 5000 filas. El archivo se llama
`referidos-` más la fecha en hora UTC (en Perú, desde las 19:00 sale la del día
siguiente). Trae el referido, quién lo recomendó, sus
teléfonos, el nivel, el estado, las fechas, quién marcó el adelanto, las
recompensas y la nota.
### Pagos
El libro de recompensas: a quién le debes, cuánto y por qué.
Arriba, los filtros **Por pagar · Pagados · Todos** (se abre en **Por pagar**) y
el buscador **«Buscar nombre, correo o referencia…»**. Las columnas son
**beneficiario**, **por el adelanto de** (con su nivel: N1, N2… o Bono),
**monto**, **correo paypal**, **estado**, **generada**, **pago** (la referencia,
la fecha y quién pagó) y **comprobante**. Al pie, el total de lo que ves, sin lo
anulado.
| Estado | Qué significa |
| - | - |
| **Por pagar** | Lo debes. Si fijaste un plazo, al pasar el ratón dice hasta cuándo lo prometiste. |
| **En espera** | Todavía no se libera (lo decide **Espera antes de pagar**, en Programa). Si el adelanto se devuelve antes, se anula. |
| **Atrasado** | Pasó el plazo que prometiste en **Plazo para pagar**. |
| **Retenido** | Retenido para revisión: el mismo correo de PayPal o el mismo nombre completo (nombre y apellido) aparece dos veces en la misma cadena de recomendaciones. Puede ser la misma persona cobrando dos veces. |
| **Pagado** | Ya registraste su pago. |
| **Anulado** | Se devolvió el adelanto que lo generó (o, si es un bono, tu cliente quedó por debajo de la meta). No se paga. Lo ves en **Todos**. |
#### Pagar una recompensa
**El panel no envía el dinero.** Pagas tú en PayPal y después lo registras aquí.
Envía el monto desde tu cuenta de PayPal y guarda el ID de la transacción.
Se abre **«Pagar recompensa»**, con el monto, el nivel, a quién y por el
adelanto de quién.
* **Correo de PayPal** (obligatorio): el correo al que enviaste el pago. Si
la persona lo dejó en su ficha, viene puesto: confírmalo igual.
* **Referencia de PayPal** (obligatoria): pega el ID de la transacción.
* **Comprobante** (opcional): una captura o PDF del pago, en JPG, PNG, WEBP
o PDF, de hasta 10 MB.
Debajo de los campos, una frase te dice si la persona tiene conversación
con tu agente. Si la tiene y el aviso **Cuando le pagas** está encendido,
recibe un WhatsApp que confirma el pago, con el comprobante si lo
adjuntaste. Con ese aviso apagado no le llega nada, aunque la frase diga que
sí: el aviso que aparece al registrar el pago te lo confirma.
Dos casos piden un paso más:
* **Retenido:** el diálogo te explica con quién coincide. Revisa la cadena y,
si está bien, marca **Revisé la cadena: pagar igual**.
* **En espera:** el diálogo dice hasta cuándo. Para pagarlo ya, marca **Pagar
antes de tiempo**. Ojo: si después devuelven el adelanto, ese dinero ya no
se recupera.
Al registrar el pago, la recompensa pasa a **Pagado** con su referencia, la
fecha y quién pagó. Cuando están pagadas todas las recompensas de un referido,
su fila en Referidos pasa sola a **Pagado**.
### Red
El árbol de quién recomendó a quién: **quien recomendó arriba y su referido
debajo**. Arriba dice cuántas personas y cuántas recomendaciones hay, con la
leyenda de colores: **Origen**, **Invitado**, **Contactado**, **Respondió**,
**Adelanto recibido** y **Pagado**.
Cada tarjeta muestra el nombre, el teléfono, el estado, lo **Ganado** y lo
**Pagado**, y cuántos referidos tiene. Acércate y aléjate con los botones de
abajo a la derecha. La red muestra hasta 2000 personas: si la tuya es más
grande, te avisa, y en la pestaña Referidos puedes buscar a cualquiera.
**Pulsa una tarjeta y se abre el panel de esa persona**, el mismo que se abre
desde los nombres de las otras pestañas:
* **Abrir chat** y **Ver sus referidos en la tabla**.
* Tres cifras: **Refirió**, **Por cobrar** y **Cobrado**.
* **La recomendó**: quién la trajo, si llegó recomendada.
* **Sus recompensas**: cada una con su estado y un botón **Pagar** si está por
pagar.
* **Refirió a**: a quién recomendó y en qué estado está cada uno.
### Referidores
El ranking de **los 10 que más mueven tu programa**: primero por adelantos,
luego por referidos. Columnas: **referidor**, **referidos**, **adelantos**,
**conversión**, **ganado**, **pagado**, **por pagar** y **correo paypal**. Los
embajadores llevan el sello **Embajador** junto a su nombre.
Cada fila tiene **Abrir chat** y **Ver referidos**, que te lleva a la pestaña
Referidos filtrada por esa persona.
### Programa
Aquí configuras el programa. Arriba, un dibujo te muestra **el camino del
referido**, paso a paso, según lo que elijas. Junto al formulario, un teléfono
te enseña cómo le llega el mensaje al referido, con datos de muestra.
Las secciones van en este orden.
#### ¿Dónde pide referidos tu agente?
* **Capítulo donde pide referidos.** El capítulo de tu manual donde el agente
le cuenta del programa a tu cliente y le pide un contacto. Cada cliente que
entra ahí cuenta como un pedido, y de ahí parte el recordatorio **«Si tu
cliente no te pasa ningún contacto»**. Sin capítulo elegido, esos pedidos no
se cuentan y el recordatorio no sale.
* **¿A quién buscas?** Describe el cliente que quieres que te recomienden, por
ejemplo «alguien que tenga una tienda de ropa en tu zona». En los pedidos
automáticos, el agente pregunta por ese perfil en vez de un genérico
«¿conoces a alguien?». Hasta 200 caracteres, sin variables. Vacío, pregunta
en general.
#### ¿Quién escribe primero?
Dos tarjetas: **El cliente lo presenta** (con el sello **Recomendado**) y **El
agente le escribe primero**. Lo que hace cada una lo cuenta
[Lo que hace tu agente en WhatsApp](#lo-que-hace-tu-agente-en-whatsapp).
Si eliges **El agente le escribe primero**, aparece **¿A cuántos referidos puede
escribirles primero cada día?**: de 1 a 20, 3 de fábrica. Solo cuentan los
primeros mensajes que inicia tu número; las respuestas no.
#### El mensaje al referido
Esta sección cambia de nombre según el modo.
Es la del modo **El cliente lo presenta**.
* **Presentación que tu cliente reenvía.** Escríbela en la voz de tu
cliente, porque es él quien la manda. Hasta 500 caracteres. Puedes
nombrar `{{nombre}}` (el referido), `{{referido_por}}` (tu cliente) y
`{{numero}}` (el WhatsApp de tu agente, en texto). Si quitas `{{numero}}`,
se añade al final. Vacía, sale la de fábrica, que ves en gris:
> «`{{nombre}}`, te paso el contacto de `{{agente}}`, de `{{empresa}}`.
> Justo me estaban contando lo que hacen y me acordé de ti, te paso su
> número para que le escribas por WhatsApp `{{numero}}`, un abrazo!»
En la de fábrica, el agente rellena `{{agente}}` con el nombre con el que
se presenta y `{{empresa}}` con el **Nombre de tu negocio**.
* **Foto, video o PDF.** **Sin adjunto**, o **Una foto, un video o un PDF de
la librería**. Aparecen las fotos, los videos y los PDF ligados a este
agente en la [Librería](/guias/libreria).
Tu número va en texto y no como enlace: un enlace en un mensaje reenviado
se lee como spam.
Es la del modo **El agente le escribe primero**. El mensaje tiene tres
piezas:
* **Apertura.** La escribe la IA en cada envío: una o dos líneas, sin
enlaces, precios ni premios. No se edita.
* **Tu texto.** Sale tal cual, después de la apertura. Hasta 700
caracteres. Puedes nombrar `{{nombre}}`, `{{referido_por}}` y
`{{contexto}}` (lo que contaron del referido). Vacío, sale el de fábrica.
El panel te avisa, sin impedirte guardar, si tu texto empieza saludando,
si lleva un enlace o si lleva un precio.
* **Foto, video o PDF.** **Sin adjunto** viene marcado como
**Recomendado**: un archivo en el primer mensaje a un desconocido es lo
que más se reporta.
Con el campo vacío, **Usar el texto de fábrica** lo copia para que lo retoques.
Si escribes una variable que no está en la lista, el panel te dice cuál es y no
te deja guardar hasta que la corrijas.
**Ojo con la presentación de fábrica.** Lleva `{{agente}}` y `{{empresa}}`, que
se rellenan cuando dejas el campo vacío pero que el panel no admite en un texto
tuyo. Si la copias con **Usar el texto de fábrica**, cámbialos por el nombre con
el que se presenta tu agente y el de tu negocio, escritos tal cual, o el panel
no te deja guardar.
#### Nombre de tu negocio y capítulo de entrada
* **Nombre de tu negocio.** Cómo se llama tu negocio en lo que recibe el
referido. Rellena `{{empresa}}` en la presentación de fábrica y firma la apertura del
mensaje en frío. Hasta 80 caracteres, sin variables ni saltos de línea.
Vacío, se usa el nombre del embudo.
* **El capítulo de entrada.** Se llama **¿En qué capítulo empiezan los
referidos?** (modo presentación) o **¿En qué capítulo sigue el referido
cuando conteste?** (modo en frío). Si no eliges ninguno, es el primer
capítulo de tu manual, con el sello **Por defecto**. En el modo presentación,
ese capítulo debe saludar a quien llega presentado. En el modo en frío corre
como continuación, porque el agente ya se presentó.
Si borraste del manual el capítulo elegido, el panel te avisa: mientras no
elijas otro, los referidos entran por el primero.
#### Recompensas por nivel
* **Moneda de las recompensas.** PEN, USD, COP, MXN, CLP, ARS, BOB o EUR. Es la
del aviso que recibe cada persona. Cambiarla no cambia las recompensas ya
generadas.
* **Recompensa por nivel.** Una escalera que empieza en *«El referido da su
adelanto»*. Pulsa **Agregar nivel** para sumar uno, hasta 5. Se quitan desde
el último, con la papelera. El monto admite hasta 2 decimales, y **0** vale:
ese nivel no cobra. Debajo, una frase te da el ejemplo con tus montos.
**Los montos nuevos valen para los adelantos que marques después de guardar.**
Lo ya generado no cambia.
#### Los ajustes opcionales
Todos se pueden dejar vacíos.
| Campo | Qué hace | Valores |
| - | - | - |
| **Bono por cantidad** | Un premio extra, una sola vez, para el cliente que llegue a cierta cantidad de recomendados con adelanto. Lo gana quien los recomendó (nivel 1) y se paga desde Pagos como **Bono**. Cuando le falta uno, su aviso se lo dice. | **Con cuántos recomendados con adelanto**: de 2 a 50. **De cuánto es el bono**: mayor que 0. Los dos o ninguno. |
| **Tope por venta** | Suma lo que reparte una venta (todos los niveles y el bono) y te avisa si pasa ese porcentaje de tu adelanto más chico. Solo avisa: no cambia ningún premio ni te impide guardar. | **Tu adelanto más chico**: mayor que 0. **Máximo a repartir por venta (%)**: de 1 a 100. Los dos o ninguno. |
| **Un referido vale (días)** | Cuántos días le cuenta un referido a quien lo recomendó mientras no deja su adelanto. Pasado el plazo, si otro cliente lo recomienda, pasa a ese y su fila vieja queda como **«Pasó a otro cliente»**. Si nadie más lo recomienda, el primero lo conserva aunque compre tarde. Quien ya te escribió no cambia de dueño. | De 7 a 365. Vacío: no vence. |
| **Espera antes de pagar (días)** | Cuántos días espera cada premio desde el adelanto antes de poder pagarse. Si en ese tiempo le devuelves el adelanto, marcas **Devolvió el adelanto** y los premios se anulan sin haber pagado nada. | De 1 a 90. Vacío: sin espera. |
| **Plazo para pagar (horas)** | En cuánto tiempo te comprometes a pagar desde el adelanto (con espera, desde que el premio se libera). El aviso del adelanto lo promete, por ejemplo *«Te enviamos el pago en las próximas 72 horas»*, y Pagos marca **Atrasado** lo que se pase. Cambiarlo no mueve lo ya prometido. | De 1 a 720. Vacío: sin plazo. |
| **Embajador desde (recomendados con adelanto)** | Quien llegue a esa cantidad pasa a embajador. Ver [Los clientes embajadores](#los-clientes-embajadores). | De 2 a 50. Vacío: sin embajadores. |
| **¿Qué recibe quien llega recomendado?** | Un beneficio para el referido, por ejemplo «10 % de descuento en tu primera compra». Ver [Lo que recibe quien llega recomendado](#lo-que-recibe-quien-llega-recomendado). | Hasta 200 caracteres, sin variables. Vacío: no recibe nada. |
#### Guardar
**Guardar cambios** y **Descartar** están arriba, en la fila de las pestañas.
**Descartar** aparece cuando tocaste algo y vuelve a lo último que guardaste. Al
lado, el estado: **Sin cambios pendientes**, **Cambios sin guardar**,
**Guardando…** o **Guardado**. Al guardar sale el aviso *«Programa guardado»*.
Si **Guardar cambios** está gris aunque cambiaste algo, hay un campo con error:
lo dice en rojo junto al campo, y al pasar el ratón por el botón te dice cuál
revisar.
### Avisos
**Lo que el programa envía solo, sin que nadie lo pida.** Cada aviso tiene su
interruptor (**Encendido** o **Apagado**), su plazo cuando lo tiene, su texto y,
debajo, la regla que lo cancela.
| Aviso | De fábrica | Cuándo sale | Cuándo no sale |
| - | - | - | - |
| **Pedidos → Cuando confirmas su pago** | Apagado | 10 minutos después de que el pago que apruebas o registras en Pedidos cubre el adelanto del pedido (o lo completa), de día. El agente le agradece la compra y le pide un contacto. | Si ya te recomendó a alguien o si dijo que no. Sale una sola vez por cliente. |
| **Pedidos → En la post-venta** | Apagado | 7, 15, 30, 45, 60 o 90 días después de la venta (30 de fábrica), de día. Le pregunta cómo le fue y, solo si le fue bien, le pide un contacto. | Si ya te recomendó a alguien, si dijo que no o si se le pidieron referidos en los últimos 7 días. Encenderlo no escribe a clientes de ventas viejas. |
| **Recordatorios → Si tu cliente no te pasa ningún contacto** | Apagado | 24 horas, o 2, 3, 7, 14, 30, 60 o 90 días después de que tu cliente entra al capítulo donde tu agente pide referidos (30 días de fábrica). | Si antes te pasa un contacto, si dice que no o si ya te recomendó a alguien. Uno por cliente de este embudo. |
| **Recordatorios → Si su conocido no escribe** | Encendido | 1, 2, 3, 5, 7 o 14 días después de que tu cliente te pasa el contacto (3 de fábrica). Le pregunta si pudo reenviar tu presentación. | Si su conocido ya te escribió. Solo funciona con **El cliente lo presenta**. |
| **Mensajes → Cuando su conocido escribe** | Encendido | Con el primer mensaje del referido, de día. El agente le agradece la recomendación a tu cliente. | Si ya salió una vez por ese referido. |
| **Mensajes → Cuando su referido da el adelanto** | Encendido | Cuando marcas el adelanto (en Referidos o en la ficha del cliente): uno por cada persona de la red que gana. | A quien no tiene conversación con tu agente. |
| **Mensajes → Cuando le pagas** | Encendido | Cuando registras el pago (en Pagos, en Referidos, en el panel de la persona o en la ficha del cliente). Si adjuntaste el comprobante, va en una segunda burbuja. | A quien no tiene conversación con tu agente. |
Los recordatorios salen **de 8:00 a 20:00 en la zona horaria del embudo**.
**Los dos pedidos y el recordatorio necesitan una recompensa de nivel 1 mayor
que 0.** Si en Programa no la hay, no salen; en los dos pedidos, el panel te lo
avisa junto al interruptor. Además, **el recordatorio necesita el capítulo
donde tu agente pide referidos**: si lo enciendes sin él, el panel no te deja
guardar y te ofrece **Elegirlo en Programa**.
#### Instrucción o mensaje literal
Los textos son de dos tipos, y la pantalla lo dice en cada uno:
* **Instrucciones para el agente**: los pedidos, los recordatorios y **Cuando
su conocido escribe**. El agente las dice con sus palabras.
* **Mensajes tal cual**: **Cuando su referido da el adelanto** y **Cuando le
pagas**. Salen tal cual los escribes, en una burbuja. Si falta el nombre o el
correo de la persona, la frase se arregla sola, y al aviso del adelanto se le
suman al final las frases del bono y del embajador cuando tocan. Debajo de
cada uno, **«Así le llega (con datos de ejemplo)»** te muestra el resultado.
Cada texto admite hasta 500 caracteres. **Vacío, se usa el de fábrica**, que ves
en gris. Si escribes una variable que no está en su lista, el panel te dice cuál
es y no te deja guardar hasta que la corrijas.
| Texto | Variables que puedes nombrar |
| - | - |
| Los dos pedidos y el recordatorio | `{{premio}}`: lo que gana por cada referido con adelanto (el nivel 1). |
| **Si su conocido no escribe** y **Cuando su conocido escribe** | `{{referido}}`: el nombre de su conocido. |
| **Cuando su referido da el adelanto**, para quien lo recomendó | `{{nombre}}`, `{{referido}}`, `{{monto}}` y `{{plazo}}` (cuándo le pagas; sin plazo, «pronto»). |
| **Cuando su referido da el adelanto**, para el resto de la red | Las mismas, más `{{como_llego}}`: cómo llegó ese referido a su red. |
| **Si con ese adelanto gana el bono** y **Si le falta 1 para el bono** | `{{cantidad}}` y `{{bono}}`. |
| **Si con ese adelanto pasa a embajador** | `{{cantidad}}`. |
| **Cuando le pagas** | `{{nombre}}`, `{{monto}}`, `{{motivo}}`, `{{correo}}` y `{{referido}}`. |
El de fábrica del adelanto, para quien recomendó, dice así:
> «¡Buenas noticias, `{{nombre}}`! `{{referido}}` ya realizó su adelanto. Ganaste
> `{{monto}}` por recomendarnos 🎉 Te avisaremos cuando te enviemos el pago.»
Si fijaste un **Plazo para pagar**, el final cambia por *«Te enviamos el pago*
`{{plazo}}` *y te avisamos.»* Las frases del bono y del embajador se añaden al
final de ese mismo mensaje, solo para quien recomendó y solo si tienes bono o
embajadores en Programa.
Se guarda igual que Programa, con **Guardar cambios** arriba. Al guardar sale el
aviso *«Avisos guardados»*.
## Desde la ficha del cliente
En **Clientes**, y en la ficha que se abre junto a cada chat de
**Conversaciones**, la ficha tiene una sección **Referidos** si ese cliente
recomendó a alguien o llegó recomendado. Si no, la sección no aparece.
Muestra **Refirió a** o **Referido por**, el estado, la fecha y las recompensas
por nivel, cada una con **Pagar** si está por pagar. Desde ahí también puedes
marcar el adelanto con **Marcar adelanto recibido** y confirmar con **Sí,
adelanto recibido**: la confirmación te dice quién recibirá el WhatsApp.
**Vincular chat** y **Devolvió el adelanto** están solo en la pestaña
[Referidos](#referidos).
## Si algo no funciona
| Lo que ves | Casi siempre es | Cómo se arregla |
| - | - | - |
| La pantalla dice **«Selecciona un agente»** | No hay agente elegido | Elige uno en el selector, dentro de **Ventas** |
| **La red sale vacía** aunque tienes referidos | Tienes elegido otro agente: el programa es por agente | Elige en el selector el agente correcto |
| El agente **no pide referidos** | Ningún capítulo de tu manual se lo indica y los pedidos de Avisos están apagados | Escribe el pedido en el manual con **Registrar un referido**, o enciende los pedidos en **Avisos** |
| El agente **no registró el contacto** | El WhatsApp de tu agente está desconectado | Revisa la conexión en **Personalizar** |
| El agente dijo que **ese número no cuenta** | Ya conversó con este embudo, otro cliente lo recomendó antes o es el número del propio cliente | Son [las reglas](#las-reglas-que-el-agente-ya-conoce): no es un fallo |
| El agente **pidió el código de país** | El número llegó sin él | Que tu cliente comparta la tarjeta de contacto o el número completo |
| **No salen los pedidos automáticos** | Interruptor apagado o sin recompensa de nivel 1 | Enciéndelos en **Avisos** y pon el nivel 1 en **Programa** |
| **No sale el recordatorio** | Está apagado, falta el capítulo donde pide referidos, ese capítulo ya no está en el manual o no hay recompensa de nivel 1 | Enciéndelo en **Avisos**; elige el capítulo y el nivel 1 en **Programa**, y guarda |
| El referido sigue en **Invitado** aunque te escribió | Te escribió desde otro número | **Vincular chat** en su fila |
| **No veo «Marcar adelanto»** | El referido está en **Invitado** (aún no te escribe), ya tiene el adelanto marcado o pasó a otro cliente | Si te escribió desde otro número, vincúlalo primero. Si pagó sin escribirte, márcalo desde la sección **Referidos** de la ficha de quien lo recomendó. Si pasó a otro cliente, márcalo en la fila del nuevo |
| **«Sin pago confirmado en Pedidos»** | No hay pago registrado ni comprobante aprobado de ese referido | Registra el pago en Pedidos, o **Marcar igual: entró por fuera** |
| *«…no tiene conversación abierta, así que no se envió aviso»* | Esa persona no tiene chat con tu agente | Avísale tú por otro medio |
| *«…un aviso por WhatsApp no salió»* | El envío falló | Escríbele tú desde su chat |
| *«Este agente no tiene recompensas configuradas…»* | No hay niveles en Programa, o los niveles que tocan a esa cadena están en 0 | Pon montos mayores que 0 en **Programa**: valen para los adelantos que marques después |
| Una recompensa en **Retenido** | El mismo correo de PayPal o el mismo nombre aparece dos veces en la cadena | Revisa la cadena y, si está bien, **Revisé la cadena: pagar igual** |
| **Guardar cambios** está gris | Un campo tiene un error | Busca el texto en rojo; el botón te dice qué revisar al pasar el ratón |
| *«Ese archivo ya no está en tu librería…»* | Borraste el adjunto o lo desligaste del agente | Elige otro archivo o **Sin adjunto**, y guarda |
## Preguntas frecuentes
No. Pagas tú por PayPal, fuera del panel, y aquí registras el pago con su
referencia y, si quieres, el comprobante. El registro pide el correo y la
referencia de PayPal.
Sí. Programa, Avisos y la red entera son por agente: cada uno con sus
recompensas, sus mensajes y sus referidos.
Nada. Los montos nuevos valen para los adelantos que marques después de
guardar. Las recompensas ya generadas conservan su monto y su moneda.
Si pusiste un beneficio en **¿Qué recibe quien llega recomendado?**, el
agente se lo dice al referido y tiene orden de no contarle lo que gana quien
lo recomendó. Sin beneficio no hay esa orden expresa: por si acaso, no
pongas los montos del programa en el capítulo por el que entran los
referidos.
El primero. Si en Programa fijaste **Un referido vale (días)** y pasó ese
plazo sin adelanto, gana el segundo, y la fila del primero queda como
**Pasó a otro cliente**. Si la persona ya te había escrito, no cambia de
dueño.
Lo ya pagado no cambia. **Devolvió el adelanto** solo anula los premios que
seguían sin pagar. Para tener margen, usa **Espera antes de pagar**: los
premios esperan esos días antes de poder pagarse.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.