> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dialtu.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurar el aviso

> Avisa por WhatsApp a la persona a la que se asigna una conversación cuando un agente de IA la traspasa a un asesor

Cuando un agente de IA le pasa una conversación a una persona con una herramienta de **Traspaso**, Dialtu puede enviarle a esa persona un mensaje de WhatsApp: quién es el cliente, por qué se traspasó, un detalle corto y un enlace para abrir la conversación.

Se configura en la propia herramienta de traspaso, en la sección **Notificación por WhatsApp** — *"Avisa por WhatsApp a la persona a la que se asigna la conversación."* Viene **desactivada por defecto**. La herramienta de traspaso está en la biblioteca de herramientas de cada canal — ver [Herramientas de WhatsApp](/es/whatsapp-agents/tools#tipos-disponibles-en-whatsapp) y [Herramientas de SMS](/es/sms-agents/tools#traspaso).

## Antes de empezar

<Check>
  **Una herramienta de traspaso con Grupo de Asignación.** El aviso va a quien quedó asignada la conversación. Con el grupo vacío nadie queda asignado y no se envía nada.
</Check>

<Check>
  **Una línea de WhatsApp conectada**, incluso para conversaciones de SMS y Messenger. El aviso siempre viaja por WhatsApp.
</Check>

<Check>
  **Un número de WhatsApp para cada persona del grupo** — en su perfil de usuario o definido en esta herramienta. Ver [Números de WhatsApp para notificaciones](/es/handoff-notices/notification-phones).
</Check>

<Check>
  **Permiso de escritura de WhatsApp** para crear la plantilla predeterminada. Sin él verás *"Pídele a un administrador que la cree"*. Ver el estado de la plantilla requiere lectura de WhatsApp.
</Check>

## Pasos

<Steps>
  <Step title="Abre la herramienta de traspaso" icon="user">
    En la biblioteca de herramientas del canal, abre la herramienta de traspaso (o crea una) y configura su **Grupo de Asignación**.
  </Step>

  <Step title="Activa el aviso" icon="toggle-on">
    Activa **Notificación por WhatsApp**.

    En SMS verás además: *"Solo funciona con agentes SMS Lumina: el aviso se envía cuando un agente Lumina pasa la conversación a una persona. Los agentes Aurora pueden usar esta herramienta, pero no envían el aviso."*
  </Step>

  <Step title="Elige la línea de envío" icon="phone">
    **Línea de envío** — la línea de WhatsApp desde la que sale el aviso.

    * **WhatsApp:** opcional. Por defecto es *Misma línea de la conversación (predeterminado)* — la línea a la que escribió el cliente.
    * **SMS y Messenger:** obligatoria — *"El aviso siempre se envía por WhatsApp. Elige la línea de WhatsApp desde la que sale."* Viene prellenada cuando el espacio de trabajo tiene una sola línea de WhatsApp.

    <Frame caption="SMS: la línea de envío es obligatoria">
      <img src="https://mintcdn.com/dialtu-0be120d3/peod1gnin3ofAGnE/images/es/avisos-de-traspaso/aviso-sms.png?fit=max&auto=format&n=peod1gnin3ofAGnE&q=85&s=559de85a1fb1b0139be4004f04026a66" alt="Herramienta de traspaso para SMS con Notificación por WhatsApp activada, el aviso Solo funciona con agentes SMS Lumina, la explicación de que el aviso se envía por WhatsApp, la Línea de envío obligatoria con un número de WhatsApp de la cuenta Rueda Firme y la Plantilla predeterminada aprobada en español e inglés." width="2880" height="1800" data-path="images/es/avisos-de-traspaso/aviso-sms.png" />
    </Frame>
  </Step>

  <Step title="Elige la plantilla" icon="file-lines">
    **Plantilla predeterminada** o **Usar mi plantilla**. Ver [Plantillas](#plantillas) más abajo.

    <Frame caption="La plantilla predeterminada, su estado por cuenta y la vista previa">
      <img src="https://mintcdn.com/dialtu-0be120d3/peod1gnin3ofAGnE/images/es/avisos-de-traspaso/aviso-plantilla-predeterminada.png?fit=max&auto=format&n=peod1gnin3ofAGnE&q=85&s=563d9f51ff3856c3bc0f6377ac06f66e" alt="Herramienta de traspaso de WhatsApp con Notificación por WhatsApp activada, la explicación de quién recibe el aviso, Línea de envío en Misma línea de la conversación (predeterminado), Plantilla en Plantilla predeterminada con la cuenta Rueda Firme aprobada en español e inglés, y la Vista previa del aviso con marcadores para el cliente, el motivo, el detalle y el enlace a la conversación." width="2880" height="1800" data-path="images/es/avisos-de-traspaso/aviso-plantilla-predeterminada.png" />
    </Frame>
  </Step>

  <Step title="Elige el contenido" icon="pen">
    **Libre** o **Campos** — lo que el agente escribe en la parte *Detalle* del aviso. Ver [Contenido](#contenido).
  </Step>

  <Step title="Revisa el número de cada persona" icon="address-book">
    En el grupo de asignación, cada persona muestra el número al que se le avisará: *"Usa el teléfono del perfil: +57…"*, o *"Sin teléfono en el perfil: si no pones un número aquí, esta persona no recibirá el aviso."* Escribe un número en **WhatsApp para notificaciones** para reemplazar el del perfil solo en esta herramienta.
  </Step>

  <Step title="Guarda" icon="floppy-disk">
    El resumen de la herramienta muestra **Activa · plantilla predeterminada**, **Activa · plantilla propia** o **Desactivada**.
  </Step>
</Steps>

## Referencia

| Control | Opciones | Predeterminado | Qué hace |
| - | - | - | - |
| **Notificación por WhatsApp** | Activada / Desactivada | **Desactivada** | Envía el aviso en cada traspaso que haga esta herramienta |
| **Línea de envío** | *Misma línea de la conversación* o una línea de WhatsApp conectada | WhatsApp: la línea de la conversación. SMS / Messenger: ninguna — obligatoria (prellenada si hay una sola línea) | La línea de WhatsApp desde la que sale el aviso. La plantilla debe estar aprobada en la cuenta de esa línea |
| **Plantilla** | **Plantilla predeterminada** / **Usar mi plantilla** | **Plantilla predeterminada** | Qué plantilla aprobada por Meta se envía |
| **Contenido** | **Libre** / **Campos** | **Libre** | Lo que el agente escribe como detalle |
| Libre → indicaciones | Texto, opcional, hasta 1.000 caracteres | Vacío | Instrucciones extra para el resumen, p. ej. *"Incluye el producto que preguntó y su presupuesto"* |
| Campos | Hasta **10**. Cada uno: **Nombre del campo**, **Clave** (`a-z`, `0-9`, `_`, máx. 40), **Instrucciones para el agente** opcionales | — | El agente llena cada uno a partir de la conversación |
| **WhatsApp para notificaciones** (por persona del grupo) | Un número con indicativo de país | Vacío — usa el número del perfil | Reemplaza el número del perfil de la persona en esta herramienta |
| **Resumen de traspaso con IA** | Activado / Desactivado | **Desactivado** en herramientas nuevas; las existentes siguen **Activado** | Deja un resumen interno con IA en el chat. Es independiente del aviso y **usa créditos** por resumen |

<Note>
  **Resumen de traspaso con IA** está en la herramienta de traspaso de todos los canales, con o sin aviso: *"Cuando la IA transfiera la conversación a un humano, dejará un resumen interno generado por IA de la conversación en el chat."*
</Note>

## Plantillas

### Plantilla predeterminada

La plantilla predeterminada es una plantilla de Dialtu llamada `conversation_handoff_notice`, categoría UTILITY, en español y en inglés. Su texto:

<Tabs>
  <Tab title="Español">
    ```text theme={null}
    🔔 Te transfirieron una conversación.
    Cliente: {{1}} · Teléfono: {{2}}
    Motivo: {{3}}
    Detalle: {{4}}
    Ábrela aquí: {{5}}
    Responde desde la plataforma; este número no recibe respuestas.
    ```
  </Tab>

  <Tab title="Inglés">
    ```text theme={null}
    🔔 A conversation was transferred to you.
    Customer: {{1}} · Phone: {{2}}
    Reason: {{3}}
    Detail: {{4}}
    Open it here: {{5}}
    Reply from the platform; this number does not receive replies.
    ```
  </Tab>
</Tabs>

`{{1}}` nombre del cliente (su teléfono si no tiene nombre) · `{{2}}` teléfono del cliente · `{{3}}` por qué el agente hizo el traspaso · `{{4}}` el detalle · `{{5}}` el enlace a la conversación.

* **Créala una vez por cuenta de WhatsApp Business.** Sirve para las herramientas de traspaso de todos los canales que envíen desde una línea de esa cuenta. La sección lista cada cuenta con una píldora de estado por idioma y el botón **Crear plantilla**. Meta la revisa: *"Plantilla enviada a Meta para revisión. La aprobación suele tardar de unos minutos a unas horas."*
* **El idioma sigue al agente.** Un agente en inglés envía la versión en inglés; cualquier otro idioma envía la versión en español. Si esa versión no está aprobada, se usa cualquier versión aprobada.

| Píldora de estado | Significado |
| - | - |
| **Aprobada** | Lista. Los avisos se envían |
| **Pendiente de revisión de Meta** | Esperando a Meta. Los avisos se omiten hasta que se apruebe |
| **Rechazada por Meta** | Se muestra con el motivo de Meta: *"Meta la rechazó: …"*. Los avisos se omiten |
| **Sin registrar** | Aún no se ha creado en esa cuenta — pulsa **Crear plantilla** |

### Usar mi plantilla

Elige una de tus plantillas. Debe estar **aprobada**, ser de categoría **UTILITY**, usar **variables posicionales** (`{{1}}`, `{{2}}`…) y no tener encabezado multimedia ni variables en enlaces. Debe pertenecer a la cuenta de WhatsApp de la línea de envío.

Luego, en **Llena las variables**, asigna cada variable a una de estas fuentes:

| Fuente | Qué envía |
| - | - |
| **Nombre del cliente** | El nombre del cliente, o su teléfono |
| **Teléfono del cliente** | El número del cliente |
| **Nombre de la persona asignada** | La persona a la que se asignó la conversación |
| **Motivo de la transferencia** | Por qué la IA hizo el traspaso |
| **Detalle escrito por el agente** | El texto libre, o todos los campos en una línea |
| **Enlace a la conversación** | El enlace a la conversación |
| **Nombre del agente de IA** | El agente que hizo el traspaso |
| **Campo: …** | Uno de tus campos (con **Contenido → Campos**) |
| **Texto fijo** | Un texto que escribes y se envía tal cual |

<Frame caption="Tu propia plantilla, con cada variable asignada">
  <img src="https://mintcdn.com/dialtu-0be120d3/peod1gnin3ofAGnE/images/es/avisos-de-traspaso/aviso-plantilla-propia.png?fit=max&auto=format&n=peod1gnin3ofAGnE&q=85&s=37171a424a4fad525dae10e1b643f093" alt="Sección de notificación de la herramienta de traspaso con Plantilla en Usar mi plantilla, la plantilla aviso_asesor (es_ES, Rueda Firme) seleccionada con su texto, y Llena las variables asignando {{1}} a Nombre de la persona asignada, {{2}} a Nombre del cliente, {{3}} a Teléfono del cliente, {{4}} a Motivo de la transferencia y {{5}} a Enlace a la conversación." width="2880" height="1800" data-path="images/es/avisos-de-traspaso/aviso-plantilla-propia.png" />
</Frame>

## Contenido

| Opción | Qué escribe el agente |
| - | - |
| **Libre** | *"El agente escribe un resumen corto para la persona asignada: por qué transfirió y los datos clave recopilados."* |
| **Campos** | *"El agente llena cada campo a partir de la conversación."* Se envían juntos como el detalle, y cada uno puede llenar una variable de tu propia plantilla |

El detalle se escribe para la persona que toma la conversación, en el idioma de la conversación. Nunca se le envía al cliente.

<Note>
  Los valores vacíos se envían como **—**, porque Meta rechaza parámetros vacíos. Meta también limita el mensaje completo a 1.024 caracteres, así que un detalle largo se recorta.
</Note>

## Quién lo recibe

La persona a la que se **asigna la conversación después del traspaso** — elegida por el grupo de asignación y la estrategia de la herramienta. Su número se elige en este orden:

1. El número de **WhatsApp para notificaciones** definido para ella en esta herramienta.
2. Si no hay, el número de **WhatsApp para notificaciones** de su perfil de usuario.
3. Si tampoco hay, no se le avisa a nadie y la nota dice por qué.

Un aviso por traspaso. Una persona asignada inactiva cuenta como si no hubiera nadie asignado.

## El enlace

El enlace abre la conversación en tu panel, en tu propio dominio si tienes uno. Cuando la conversación no tiene cliente — puede pasar en Messenger — el enlace se reemplaza por **—**.

## Las notas en Conversaciones

Cada traspaso con el aviso activado deja una nota en la conversación **del cliente**:

| Nota | Significado |
| - | - |
| *Aviso por WhatsApp enviado a Ana (+57•••••4567)* | Meta aceptó el mensaje. No significa que se haya entregado ni leído |
| *No se envió el aviso por WhatsApp a la persona asignada: motivo* | Se omitió antes de enviarlo. Ver los motivos abajo |
| *Falló el aviso por WhatsApp a Ana: error* | Meta rechazó el envío |

| Motivo en la nota | Solución |
| - | - |
| *nadie quedó asignado* | El grupo está vacío, o la persona elegida está inactiva |
| *la persona asignada no tiene número de WhatsApp para notificaciones* | Agrégale uno en su perfil o en esta herramienta |
| *no hay una línea de WhatsApp disponible para enviarlo* | Elige una **Línea de envío**, o vuelve a conectar la que estaba guardada |
| *la plantilla no está aprobada por Meta en esta línea* | Crea o corrige la plantilla en la cuenta de la línea de envío y espera a que esté **Aprobada** |
| *el número de la persona asignada se dio de baja de los mensajes* | Ese número pidió no recibir más mensajes. Usa otro número |

## Lo que debes saber

<Warning>
  **Las respuestas se ignoran.** El aviso es solo una alerta. Lo que la persona conteste no se lee, nunca crea un cliente y nunca activa la IA. Al cliente se le responde desde la plataforma.
</Warning>

<Note>
  **Se respetan las bajas.** Si el número de la persona se dio de baja de los mensajes de esa línea, el aviso se omite.
</Note>

## Siguiente paso

<Card title="Números de WhatsApp para notificaciones" icon="address-book" href="/es/handoff-notices/notification-phones">
  Define el número de cada persona una sola vez, en su perfil.
</Card>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.