Crear acciones personalizadas (API, Shopify, pagos)
Conecta a Shieldy con tus sistemas: llamadas a una API, consulta de pedidos de Shopify y enlaces de pago.
- Plan Pro o Enterprise (el plan Starter solo incluye el agente de datos).
- Usuario con rol administrador.
- Créditos de IA disponibles en tu plan.
- Para Shopify: el dominio de tu tienda y un token de acceso de la API de administración con permiso de lectura de pedidos.
Las acciones personalizadas amplían lo que Shieldy puede hacer. Puedes crear hasta 8.
Agregar una acción
- Entra a Shield Agent en el menú izquierdo, abre la pestaña Agentes y haz clic en la tarjeta Agente de clientes.
- Haz clic en Entrenamiento → Acciones.
- En Mis acciones, haz clic en Agregar acción.
- Escribe un nombre corto sin espacios (por ejemplo
consultar_pedido). - Elige el tipo de acción (ver abajo).
- En la descripción escribe cuándo debe usarla. Ejemplo: «cuando el cliente pregunta por el estado de su pedido».
- Completa los campos del tipo elegido y haz clic en Guardar.
Tipo: API personalizada
| Campo | Qué poner |
|---|---|
| URL | La dirección completa de tu servicio, con https://. No se permiten direcciones internas. |
| Método | POST envía los datos que el agente reúna como JSON. GET consulta la dirección. |
| Token Bearer | Opcional. Se envía en la cabecera Authorization. |
El agente recibe la respuesta de tu servicio (hasta 800 caracteres) y la usa para contestar al cliente. Si tu servicio falla, el agente avisa que pasará la conversación a un asesor.
Tipo: Shopify, buscar pedido
- En Tienda, escribe el dominio, por ejemplo
mitienda.myshopify.com. - En Token de acceso, pega el token de la API de administración.
El agente pide al cliente el número de pedido y consulta su estado de pago, envío y total.
Tipo: Enlace de pago
En URL escribe la plantilla de tu enlace usando {amount} para el monto y {name} para el nombre del cliente. Ejemplo: https://pago.com/cobrar?monto={amount}&cliente={name}. El agente completa los valores y comparte el enlace.
Seguridad de los tokens
- Los tokens se guardan en el servidor y no se vuelven a mostrar en pantalla: verás «guardado».
- Si dejas el campo vacío al guardar, se conserva el token anterior. Para cambiarlo, escribe el nuevo.
- Usa tokens con los permisos mínimos necesarios.
Probar la acción
En el probador, el agente indica cuándo usaría una acción, pero no la ejecuta de verdad. Para comprobarla, activa el agente y haz una prueba real desde otro número.
¿Te resultó útil este artículo?
¡Gracias por tu opinión! Si necesitas más ayuda escríbenos a soporte@redshield.security.
