Este documento describe como se puede agregar acciones al Agente de IA, como por ejemplo:
  • Apagar un agente de IA.
  • Asignar una fase al contacto.
  • Asignar una etiqueta al contacto.
  • Asignar una segmentación al contacto.
  • Asignar un agente humano al contacto.
Campos del la Acción
CampoDescripción
referenceDescripción detallada del contenido de la intencion. Se utiliza para poder darle información al agente y sepa la inención del usuario, como por ejemplo: “Quiero hablar con un agente humano”.
tagsSon referencias para poder entender mas la información dentro de la acción, si bien es cierto, con la Referencia existe mas posibilidades, con los tags complementa esta funcionalidad.
enabledBooleano que indica si la acción está activada (true) o no (false).
responseMessageMensaje que el agente debe de responder al usuario.
responseIABooleano que indica si después de ejecutar las acciones, el agente debe continuar con el flujo de IA (true) o usar solo el responseMessage (false).
responseJsonBooleano que indica si el agente debe de responder con un JSON estructurado (true) o un mensaje de texto plano (false).
actionListado de acciones que se pueden ejecutar el Agente de IA.
✅ El agente de IA ejecutará las acciones en orden, esto quiere decir que si puso dos asignaciones, el agente de IA asignará la primera asignación y luego la segunda asignación. Por lo que prevalecerá la última acción ejecutada.

Tipos de Respuesta

Las acciones del agente tienen dos configuraciones importantes que determinan cómo responde después de ejecutar las acciones:

ResponseIA

Controla si el agente debe continuar con el flujo de IA después de ejecutar las acciones.
ValorComportamiento
trueEjecuta las acciones + responde con IA (más inteligente)
falseEjecuta las acciones + responde solo con responseMessage (fijo)
Ejemplo con responseIA = true:
👤 Usuario: "Quiero información sobre precios"
🤖 Bot: [Ejecuta acciones: AsignarTag "comercial"] 
🤖 Bot: "¡Hola! Me complace ayudarte con información sobre nuestros precios. Tenemos varios planes disponibles..."
Ejemplo con responseIA = false:
👤 Usuario: "Quiero información sobre precios"  
🤖 Bot: [Ejecuta acciones: AsignarTag "comercial"]
🤖 Bot: "Gracias por tu consulta, un ejecutivo te contactará pronto."

ResponseJSON

Controla el formato de la respuesta de la acción (solo cuando responseIA = false).
ValorFormato de Respuesta
falseTexto plano
trueJSON estructurado
Ejemplo con responseJSON = false:
{
  "success": true,
  "answer": "Gracias por tu consulta, un ejecutivo te contactará pronto."
}
Ejemplo con responseJSON = true:
{
  "success": true,
  "answer": {
    "message": "Gracias por tu consulta, un ejecutivo te contactará pronto.",
    "actionsExecuted": [
      {
        "type": "action.tag",
        "value": "comercial"
      },
      {
        "type": "action.stage", 
        "value": "prospecto"
      }
    ]
  }
}
📝 Importante: El campo responseJSON solo afecta cuando responseIA = false. Si responseIA = true, la respuesta siempre será texto plano generado por la IA.

Casos de Uso Comunes

1. Acción con Respuesta Inteligente

{
  "intent": "solicitar_informacion",
  "reference": "El usuario solicita información sobre productos o servicios",
  "tags": ["informacion", "productos"],
  "enabled": true,
  "responseMessage": "",
  "responseIA": true,
  "responseJson": false,
  "action": [
    {
      "type": "AsignarTag",
      "value": "lead_caliente"
    }
  ]
}
Resultado: Ejecuta la acción + la IA responde inteligentemente según el contexto.

2. Acción con Respuesta Fija

{
  "intent": "contactar_soporte",
  "reference": "El usuario quiere contactar con soporte técnico",
  "tags": ["soporte", "ayuda"],
  "enabled": true,
  "responseMessage": "He registrado tu solicitud de soporte. Un técnico se comunicará contigo en breve.",
  "responseIA": false,
  "responseJson": false,
  "action": [
    {
      "type": "AsignarTag", 
      "value": "soporte"
    },
    {
      "type": "AsignarFase",
      "value": "ticket_abierto"
    }
  ]
}
Resultado: Ejecuta las acciones + respuesta fija predefinida.

3. Acción para API/Webhook (JSON)

{
  "intent": "registrar_lead",
  "reference": "Registro automático de lead en sistema externo",
  "tags": ["lead", "crm"],
  "enabled": true,
  "responseMessage": "Registro completado exitosamente",
  "responseIA": false,
  "responseJson": true,
  "action": [
    {
      "type": "AsignarTag",
      "value": "lead_registrado"
    }
  ]
}
Resultado: Ejecuta las acciones + respuesta JSON estructurada (ideal para integraciones).

Asignación de Agentes.

El agente de IA puede asignar un agente humano al contacto, esto se podrá visualizar en la vista de contactos, en el campo de Agente Asignado.

Asignación de Etiquetas.

El agente de IA puede asignar una etiqueta al contacto, esto se podrá visualizar en la vista de contactos, en el campo de Etiquetas.

Asignación de Fases.

El agente de IA puede asignar una fase al contacto, esto se podrá visualizar en la vista de contactos, en el campo de Fase.

Asignación de Segmentación.

El agente de IA puede asignar una segmentación al contacto, esto se podrá visualizar en la vista de contactos, en el campo de Segmentación.

Apagar el Agente de IA.

El Agente de IA puede apagarse con la acción de Shutdown, esto se podrá visualizar en la vista de contactos, en el campo de Agente Activo.
⚠️ importante saber que esta opción si se apaga ya no contestará el agente hasta que se vuelva a encender de forma manual.