Resumen
El flujo de la acción Crear te ayuda a convertir plantillas preconstruidas en acciones totalmente configuradas que tus agentes pueden usar. Puedes seleccionar una plantilla, definir su propósito, conectar las cuentas necesarias y configurar los ajustes, todo ello en un flujo guiado. Una vez creada, la acción aparece en Mis acciones y puede adjuntarse a los agentes.
Instrucciones
Cómo crear una acción
Sigue estos pasos para crear una nueva acción a partir de una plantilla:
1. Inicia sesión en tu cuenta de Astra
Inicia sesión en tu cuenta de Astra
2. Abre la biblioteca de acciones
Ve a la Biblioteca de acciones
Explora las plantillas usando:
Todas
Recientes
Por tipo
Haz clic en una plantilla para iniciar el flujo de creación
3. Autorizar (si es necesario)
Algunas acciones (por ejemplo, CRM como Hubspot u Hojas de cálculo de Google o APIs) requieren autorización de la cuenta
Si es necesario, aparecerá una ventana emergente
Sigue los pasos que aparecen en pantalla para autorizar tu cuenta
Una vez completado, continuarás con el siguiente paso.
4. Define los detalles de la acción (página de intención)
En la página de intención, rellena los datos obligatorios:
Nombre: Un nombre claro para la acción
Objeto: Describe lo que debe hacer la acción
Campos adicionales (dependiendo de la plantilla)
Consejo: Sé específico y descriptivo. Una intención bien definida ayuda al agente a utilizar la acción con mayor precisión.
Después de rellenar los detalles:
Haz clic en Confirmar para continuar
Serás redirigido a la página de configuración
Haz clic en Editar el objeto de la acción en cualquier momento para volver atrás y realizar cambios
5. Configurar la acción
Completa todos los ajustes necesarios en función de la plantilla seleccionada
Esto puede incluir entradas de API, contenido de mensajes o asignaciones de campos
6. Guarda la acción
Haz clic en Guardar como borrador para guardar el progreso sin que la acción esté disponible
Haz clic en Guardar acción para publicarla como una acción activa
Estados de la acción:
Borrador:
Guardado pero no disponible para los agentes
Útil para pruebas o configuración incompleta
Activo:
Totalmente configurado y disponible para su uso
Se puede adjuntar a los agentes
Después de crear una acción
La acción aparecerá en Mis acciones en la Biblioteca de acciones
Para usarla, adjunta la acción a un agente
Crear acciones desde la página del agente
También puedes crear acciones al configurar un agente:
Inicia sesión en tu cuenta de Astra
Ve a la página de Agentes, selecciona cualquier agente (o crea uno nuevo) y ve a Crear mi agente
Haz clic en Añadir acción
La Biblioteca de acciones se abrirá en una ventana emergente
Selecciona una plantilla y sigue los mismos pasos para crear la acción
Cómo actualizar una acción
Actualizar acción te permite modificar el nombre, el objeto, el estado, la cuenta conectada o cualquier ajuste específico de la plantilla de una acción existente.
Solo puedes editar las acciones que hayas creado o que existan dentro de tu espacio de trabajo.
El flujo de actualización utiliza las mismas páginas de intención y configuración que el flujo de creación; la única diferencia es que empiezas desde una acción existente en lugar de una plantilla.
Para editar cualquier acción, sigue estos pasos:
Inicia sesión en tu cuenta de Astra
Ve a la Biblioteca de acciones
Abre la pestaña Mis acciones
Elige la acción que quieres actualizar:
Haz clic directamente en la tarjeta de acción, o
Haz clic en los tres puntos (⋮) y selecciona Editar
Actualiza los campos obligatorios:
Página de intención: Edita el nombre, la intención u otros detalles generales
Página de configuración: Actualiza los ajustes específicos de la plantilla
Si es necesario, haz clic en Editar el objeto de la acción para volver a la página de objeto
Haz clic en Guardar después de realizar los cambios
Después de actualizar una acción
Cualquier cambio se aplica inmediatamente
Si la acción ya está adjunta a agentes activos, se utilizará automáticamente la versión actualizada
Nota: Ten cuidado al actualizar las acciones que están en uso, ya que los cambios pueden afectar directamente al comportamiento del agente en vivo.
Cómo eliminar una acción
Eliminar acción te permite eliminar permanentemente una acción que ya no necesitas.
Una vez eliminada, la acción se elimina de Mis acciones y ya no estará disponible para su uso en agentes o integraciones.
La eliminación de una acción no afecta a ninguna cuenta conectada que se haya configurado dentro de ella.
Para eliminar una acción, sigue estos pasos:
Ve a la Biblioteca de acciones
Abre la pestaña Mis acciones
Busca la acción que quieres eliminar
Haz clic en los tres puntos (⋮) en la tarjeta de acción
Selecciona Eliminar
Importante
Si la acción está siendo utilizada actualmente por algún agente (en modo de prueba o publicado), no puedes eliminarla
Primero debes eliminar la acción de todos los agentes asociados antes de eliminarla
Si la acción no está en uso, puedes proceder con la eliminación
Después de eliminar una acción
La acción se elimina permanentemente de Mis acciones
Ya no estará disponible para adjuntarla a ningún agente
Cómo funcionan la autenticación y las cuentas
Algunas acciones (como Búsqueda en la web o Formularios personalizados) se pueden utilizar sin necesidad de autenticación.
Para la mayoría de las plataformas de terceros (como Slack, Google Sheets y HubSpot), Astra utiliza OAuth 2.0 (Autorización abierta) para una autenticación segura.
Cuando creas una acción que requiere autenticación, aparece una ventana emergente que te pide que conectes tu cuenta
Haz clic en Conectar tu cuenta (por ejemplo, espacio de trabajo de Slack o cuenta de HubSpot).
Se abrirá una nueva pestaña del navegador
Sigue los pasos específicos de la plataforma para completar la autenticación
Cada plataforma puede tener un flujo ligeramente diferente, y existen guías detalladas disponibles cuando sea necesario
Administrar las cuentas conectadas
En la página de configuración de la acción, si se requiere autenticación, verás una opción de selección de cuenta donde puedes:
Cambiar cuentas
Añadir una nueva cuenta
Desconectar una cuenta existente
Añadir una nueva cuenta
Haz clic en Añadir cuenta
Completa el mismo flujo de autenticación que antes para conectar otra cuenta
Desconectar una cuenta
Haz clic en Desconectar para eliminar una cuenta conectada
Se aplicará una comprobación de seguridad:
Si la cuenta sigue siendo utilizada por alguna acción activa (no eliminada), no puedes desconectarla
Primero debes actualizar esas acciones para que utilicen una cuenta diferente o eliminar las acciones
Si la cuenta no es utilizada por ninguna acción activa, se puede desconectar de forma segura
Otros métodos de autenticación
Algunas acciones (como Wati o las acciones de la API REST) utilizan métodos que no son OAuth para la autenticación
En estos casos, sigue las instrucciones que aparecen en pantalla para completar la configuración
Hay guías específicas de la plataforma disponibles para obtener instrucciones detalladas
Conclusión
Las acciones son los bloques de construcción que permiten a tus agentes de Astra realizar tareas reales más allá de las conversaciones. Al crear, actualizar y gestionar las acciones de forma eficaz, puedes automatizar los flujos de trabajo, integrarte con herramientas externas y mejorar la forma en que tus agentes responden a las necesidades de los clientes.
A medida que escales, mantén tus acciones bien definidas, revísalas y actualízalas periódicamente y asegúrate de que las conexiones se gestionan correctamente. Esto ayuda a mantener la precisión, evitar interrupciones y obtener el máximo valor de tu configuración de automatización.