Panel de Claix
Conectar Slack a Claix para los avisos de Guard
Claix Guard puede enviar cada veredicto a un canal de Slack, o a un endpoint HTTPS público y libre que ya tengas. Esta guía es el camino de Slack: un clic, eliges un canal y envías un mensaje de prueba. No creas una app de Slack y no pegas ningún token.
Slack no usa la cuenta de Google con la que entraste en Claix. El inicio de sesión de Claix solo indica a qué cuenta de Claix se engancha el canal. La pantalla de Slack es donde eliges el workspace y el canal.
1. Antes de empezar
Necesitas:
- Una cuenta de Claix. Solo el propietario del workspace puede conectar Slack.
- Un workspace de Slack en el que puedas instalar una app y elegir un canal.
- Para Aprobar y Rechazar, dos URLs HTTPS públicas que controles: una al aprobar y otra al rechazar. Pueden ser un Webhook de n8n, Make, Zapier, una función serverless o tu propia API.
En el panel, abre Guard, luego Traces, y abre Configurar Endpoints de Aviso.
2. Un endpoint libre, sin Slack
Puedes no usar Slack. En el mismo cuadro, pon un veredicto en Endpoint y pega una URL HTTPS pública. Claix hace un POST con el resultado de la comprobación, incluido el SQL propuesto y el veredicto.
- Permitido, denegado y pendiente de aprobación pueden usar un endpoint.
- Un aviso de pendiente de aprobación enviado a un endpoint no lleva botones. Usa Slack cuando una persona deba pulsar Aprobar o Rechazar en un canal.
- Cada veredicto tiene un destino. Puedes mezclarlos: deja Permitido en el endpoint que ya usas y envía pendiente de aprobación a Slack.
- Un endpoint vacío no envía aviso de ese veredicto. Los avisos que ya tenías siguen hasta que cambies ese destino.
La URL tiene que ser HTTPS pública, sin usuario ni contraseña.
3. Add to Slack
- En el cuadro de avisos, pulsa Add to Slack.
- Slack abre su pantalla de permisos. Elige el workspace, luego el canal que debe recibir los avisos, y acepta.
- Claix te devuelve a Guard Traces. El cuadro muestra Conectado a #canal.
- Pulsa Enviar mensaje de prueba. En ese canal debe aparecer el texto "Claix Guard is connected to this channel."
El canal que pudiste elegir al instalar la app de Claix en Slack no es esta conexión. Los avisos van al canal que eliges en esta pantalla.
Cambiar canal abre la misma pantalla de Slack. Desconectar quita la conexión de esta cuenta de Claix. Si el cuadro dice que la conexión está rota, pulsa Reconnect Slack y vuelve a elegir el canal.
4. Elige un destino para cada veredicto
A la izquierda del cuadro, cada veredicto es Endpoint o Slack. Guarda después de elegir.
| Veredicto | Endpoint | Slack |
|---|---|---|
| Permitido | POST del resultado, con el SQL. | Un mensaje normal. Sin botones. |
| Denegado | POST del resultado, con el SQL. | Un mensaje normal. Sin botones. |
| Pendiente de aprobación | POST del resultado. Sin botones. | Un mensaje con Aprobar y Rechazar. También indicas los dos endpoints a los que llaman esos botones. |
Pendiente de aprobación en Slack sigue necesitando las dos URLs: Endpoint al aprobar y Endpoint al rechazar. Conecta Slack antes de elegir Slack en un veredicto.
6. Ejemplo: un reembolso en n8n
- Tu flujo llama a POST /check-sql y recibe pendiente de aprobación. No ejecutes la sentencia todavía.
- Claix publica la petición en el canal. Quien debe decidir lee el SQL y pulsa Aprobar.
- Claix llama a tu URL de aprobar. En n8n es un trigger Webhook, luego un nodo de Postgres que ejecuta la misma sentencia, y un paso que avisa al cliente.
- Rechazar llama a la otra URL, que le dice al agente que el cambio se ha declinado.
Make, Zapier, una función serverless y tu propia API usan la misma forma: una URL que reciba un POST HTTPS.
7. Buenas prácticas
- Elige un canal que solo vean las personas adecuadas. Los mensajes pueden incluir el SQL propuesto.
- Haz que el endpoint de aprobar haga todo el trabajo, incluida la ejecución, para que el botón siempre termine en un resultado.
- Reserva denegado para lo que nadie debería poder hacer. Usa pendiente de aprobación para un caso que una persona pueda juzgar.
- Envía el mensaje de prueba y luego prueba un pendiente de aprobación real antes de fiarte del canal.
- Si casi todas las peticiones se aprueban, la regla es probablemente demasiado estricta. Si casi todas se rechazan, debería ser denegado.