> For the complete documentation index, see [llms.txt](https://docs.dapta.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dapta.ai/dapta-docs-es/agentes-de-texto/acciones-del-agente.md).

# Acciones del Agente

Conecta tu agente de texto a una API externa o transfiere la conversación a una persona o a un equipo de tu espacio de trabajo, y define el mensaje que recibe el cliente en ese momento.

{% hint style="info" %}
**¿Quieres que el agente agende reuniones?** Es una acción propia, **Agendar citas (Dapta Calendars)**. Mira [Agendar citas con dCal](https://docs.dapta.ai/dapta-docs-es/agentes-de-texto/agendar-citas-con-dapta-calendars.md).
{% endhint %}

#### **Añadir Acciones**

Para añadir una nueva Acción, dentro de "Configuración" desplázate a la sección “Acciones del agente” y haz click en **Agregar Nueva Acción**.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2FOm6NzwXYKNAuGyc2e1JS%2FCaptura%20de%20pantalla%202026-01-08%20a%20las%205.06.36%E2%80%AFp.%E2%80%AFm..png?alt=media&amp;token=7f290f3b-1d89-4081-90a0-432867195bf5" alt="" width="223"><figcaption></figcaption></figure>

\
Elige el tipo de acción en la lista que se abre. Esta página explica estos dos:

* **Acción Personalizada:** Integrar con otro webhook/endpoint. Su formulario se titula **Acción API**.
* **Transferir a un humano:** Pasar la conversación a una persona de tu espacio de trabajo.

**Transferir agente** es otra acción: pasa la conversación a otro agente de IA, no a una persona.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2FQhN0RtUGoaSOKR9IV9gO%2FCaptura%20de%20pantalla%202026-01-08%20a%20las%205.11.50%E2%80%AFp.%E2%80%AFm..png?alt=media&amp;token=ca8a9fb6-a912-4172-b0eb-51c030e31eb3" alt="" width="375"><figcaption></figcaption></figure>

Te vamos a explicar una por una:

#### 1. Tipo API:

Este tipo de acción permite conectar con otras herramientas por medio de API

* **Nombre:** Dale un nombre a tu “Acción”
* **HTTP de la API:** Elige el método, puedes revisar los métodos HTTP [AQUI](https://blog.postman.com/what-are-http-methods/)
* **URL de la API:** Pega aqui la URL, esta URL ayuda a conectar el API con el recurso que está solicitando
* **Instrucciones Importantes:** Describe las instrucciones que debe hacer esta acción, siendo muy claro, especifico, con escenarios y ejemplos de las acciones que realizará el agente.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2FexLbzMXaIAErt388nlsP%2FCaptura%20de%20pantalla%202026-01-08%20a%20las%205.26.53%E2%80%AFp.%E2%80%AFm..png?alt=media&amp;token=55620315-5fc8-4717-822e-765854212f9b" alt="" width="375"><figcaption></figcaption></figure>

* **Parámetros** (Opcional)\
  Dapta brinda la opción de añadir parámetros a tu Acción, para añadir un parámetro sólo debes hacer click en “+ Add Parameter”, colocar nombre de parámetro y las instrucciones respectivas del parámetro.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2FAZRW0dvebxWMUH8kJtZM%2FCaptura%20de%20pantalla%202026-01-08%20a%20las%205.36.26%E2%80%AFp.%E2%80%AFm..png?alt=media&amp;token=e6151972-5682-403a-a278-a1f9532940f0" alt="" width="375"><figcaption></figcaption></figure>

\
para eliminar el parámetro presiona el ícono de trash “🗑️” a la derecha de cada parámetro añadido

* Para terminar de añadir la Acción, haz click en el botón: “Create Action"

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2FUSAQaIb9fxjfSNAzjP1u%2FCaptura%20de%20pantalla%202026-01-08%20a%20las%205.40.46%E2%80%AFp.%E2%80%AFm..png?alt=media&amp;token=5f1ac528-c58b-436a-ac20-d05f83547bcc" alt="" width="127"><figcaption></figcaption></figure>

#### **2. Tipo Transferir a un humano**

Esta acción pasa la conversación a una persona de tu espacio de trabajo, según las instrucciones que le des al agente. En cuanto el agente la transfiere, la IA deja de responder y la persona continúa la conversación en la [Bandeja de entrada](https://docs.dapta.ai/dapta-docs-es/agentes-de-texto/operar-conversaciones.md).

* **Nombre de la Acción:** Dale un nombre a tu “Acción”. Por defecto el nombre es request\_human\_agent
* **Instrucciones Importantes:** Describe cuándo la IA debe pasar la conversación a una persona. Sé muy claro y específico, con escenarios y ejemplos.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2FadoxIH711hYTp41AsUaP%2FCaptura%20de%20pantalla%202026-01-08%20a%20las%205.42.49%E2%80%AFp.%E2%80%AFm..png?alt=media&amp;token=d4b1eb40-2682-4a7d-bb23-5a99abb765cb" alt="" width="375"><figcaption></figcaption></figure>

* **Transferir A:** Elige **Miembro** para enviar cada transferencia a una persona que elijas, o **Equipo** para enviarla a un equipo de transferencia.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2FRFtamX0Bf0813jkIHHMS%2FCaptura%20de%20pantalla%202026-01-08%20a%20las%205.47.08%E2%80%AFp.%E2%80%AFm..png?alt=media&amp;token=352a6e71-f997-479f-b6c5-f893689e8e70" alt="" width="375"><figcaption></figcaption></figure>

Con **Equipo**, elige un equipo en **Equipos de Transferencia** o crea uno. Cuando eliges un equipo, **Estrategia de Asignación** define quién recibe cada conversación: **Fija** asigna a cada miembro del equipo en el mismo orden, sin importar cuántos chats tenga, y **Balanceada** asigna a quien tenga menos chats activos en el equipo.

Para crear un equipo, haz clic en **Crear nuevo equipo**.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2F758i3Q5wE6IcU0apIeOM%2FCaptura%20de%20pantalla%202026-01-08%20a%20las%205.56.41%E2%80%AFp.%E2%80%AFm..png?alt=media&amp;token=0f18b140-5a5b-4429-806c-4c73583e6f31" alt="" width="116"><figcaption></figcaption></figure>

En **Nuevo equipo de transferencia**, escribe el **Nombre del equipo**.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2Fg0mLBs2OyzFIvHOZKP5p%2FCaptura%20de%20pantalla%202026-01-08%20a%20las%205.54.38%E2%80%AFp.%E2%80%AFm.%201.png?alt=media&amp;token=41f0e8b7-3f49-4a3a-9438-2660e65e7f24" alt="" width="302"><figcaption></figcaption></figure>

Luego, en **Miembros del Equipo**, busca a los miembros de tu espacio de trabajo y selecciona cada uno para agregarlo.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2FAhx9595QYZ0as38bQXVZ%2FCaptura%20de%20pantalla%202026-01-08%20a%20las%206.01.35%E2%80%AFp.%E2%80%AFm..png?alt=media&amp;token=4a779e8b-0515-4298-8e0c-86b170f4678f" alt="" width="375"><figcaption></figcaption></figure>

Podrás ver los miembros en medida que vayas añadiendo

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2F4ki9gylbYbLe8LS8UwVe%2FCaptura%20de%20pantalla%202026-01-08%20a%20las%206.04.37%E2%80%AFp.%E2%80%AFm..png?alt=media&amp;token=042d1d67-6c5a-47f6-b9c9-983328ef3633" alt="" width="375"><figcaption></figcaption></figure>

Haz clic en **Crear equipo**.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2FlwOymifGThP9kxh0pj3m%2Fimage.png?alt=media&amp;token=8739633f-f97d-4a2d-b6bc-4c14cdfc1fa6" alt=""><figcaption></figcaption></figure>

**Mensaje al cliente en la transferencia**

Elige qué recibe el cliente cuando la conversación pasa a una persona. Lo que recibe en ese momento sale de este ajuste, no de tu prompt.

| Opción              | Qué recibe el cliente                                                                                       |
| ------------------- | ----------------------------------------------------------------------------------------------------------- |
| **Silencioso**      | Ningún mensaje.                                                                                             |
| **Mensaje fijo**    | Exactamente el texto que escribas en **Mensaje de transferencia**. El campo es obligatorio con esta opción. |
| **Generado por IA** | Un aviso breve de una o dos frases que escribe la IA, según si se asignó un asesor.                         |

**Mensaje de no disponibilidad:** se envía cuando no se pudo asignar a ningún asesor, por ejemplo si nadie del equipo está en línea. La IA deja de responder de todos modos y la conversación queda a la espera de una persona en la pestaña **Unassigned** de la Bandeja de entrada.

{% hint style="warning" %}
Las acciones de transferencia creadas antes de que existiera este ajuste están en **Silencioso**: el cliente no recibe ningún mensaje en la transferencia hasta que abras la acción y elijas **Mensaje fijo** o **Generado por IA**.
{% endhint %}

Haz clic en **Crear Acción** para terminar. La acción que acabas de crear aparece en la sección **Acciones del agente**.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.dapta.ai/dapta-docs-es/agentes-de-texto/acciones-del-agente.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
