# Alertas, webhooks, Copilot y API del Investigador

Source: https://help.didit.me/es/investigations/investigator-alerts-and-integrations
Updated: 2026-10-23

Recibe aviso cuando un lote está listo, publica alertas del Investigador en Slack o Teams, recibe sus eventos por webhook y envíale elementos por API.

En **Investigador → Configuración → Alertas de Slack y Teams**, pega la URL del
webhook entrante de un canal de Slack o Microsoft Teams y pulsa **Enviar
prueba**. Suscribe tus endpoints de webhook a los eventos `investigator` en
**Webhooks**. Pide a Didit Copilot que abra o acepte un informe: siempre te pide
tu aprobación antes de decidir nada.

> **Note:** Estas funciones se activan una a una y puede que aún no estén activadas para tu
> aplicación. Puedes añadir un canal de Slack o Teams antes de que se activen las
> alertas: no se publica nada hasta que lo estén.

## Notificaciones de lote listo

Cuando hay 5 o más recomendaciones de confianza alta esperando a ser aceptadas, el Investigador avisa a tu equipo por correo electrónico y en la consola, como máximo una vez cada 4 horas, con un enlace que abre la cola en ese lote. El aviso va a las personas que aparecen en **A quién se avisa**, en el paso **Revisar y activar** de la configuración. Esa lista es de solo lectura en la consola: de forma predeterminada se avisa a todos los miembros de tu organización, y solo se avisa a miembros. Las preferencias de notificación y las horas de silencio de cada persona se aplican como siempre.

## Alertas de Slack y Teams

Añade un canal por aplicación: pega la URL del webhook entrante del canal, pulsa **Añadir canal** y después **Enviar prueba** para comprobar que llega el mensaje. La URL debe ser un enlace https de un canal de Slack o Microsoft Teams. Se guarda cifrada y no se vuelve a mostrar; pulsa **Eliminar** para dejar de publicar.

El canal recibe un mensaje cuando:

| Alerta | Cuándo |
|---|---|
| **Lote listo para aceptar** | Hay 5 o más recomendaciones de confianza alta esperando, como máximo cada 4 horas |
| **Caída de consistencia** | Una cola repitió su recomendación en menos del 90 % de las ejecuciones |
| **Deriva** | Una cola tuvo deriva y se bajó su nivel |

Las alertas solo llevan recuentos y enlaces, nunca datos de una persona.

## Eventos de webhook

Tus endpoints de webhook pueden recibir los eventos del Investigador, firmados y reintentados como cualquier otro webhook de Didit. Suscríbete a ellos en **Webhooks**:

| Evento | Se envía cuando |
|---|---|
| `investigator.report.ready` | Se redactó un informe |
| `investigator.decision.automated` | El Investigador decidió un elemento por su cuenta |
| `investigator.decision.overridden` | Una persona realizó una acción distinta de la del informe, o anuló una decisión automatizada |
| `investigator.question.raised` | El Investigador hizo una pregunta a tu equipo sobre su política |
| `investigator.automation.paused` | Se pausó la automatización, por una persona o al alcanzar el límite de gasto mensual |
| `investigator.rfi.answered` | La persona respondió a una solicitud de información |
| `investigator.rfi.overdue` | Una solicitud de información superó su plazo sin respuesta |
| `investigator.decision.contested` | La persona impugnó una decisión |
| `investigator.drift.detected` | Una cola tuvo deriva y bajó un nivel |
| `investigator.sla.breached` | Un informe esperó más allá del nivel de servicio de su cola |
| `investigator.qa.failed` | Una decisión que tomó una persona no superó el control de calidad |
| `investigator.external.report.ready` | El informe sobre un elemento enviado desde fuera de Didit está listo |

Los eventos solo llevan identificadores, la cola, la recomendación, la acción y la procedencia, nunca el nombre de una persona, el motivo de un revisor ni una justificación. Los eventos de estado de verificaciones y de verificaciones de empresas también indican quién decidió, en `decided_by`: `investigator` cuando decidió por su cuenta, `human` cuando lo hizo una persona. Los payloads están en la [documentación para desarrolladores](https://docs.didit.me). Consulta también [los conceptos básicos de los webhooks](https://help.didit.me/es/integration/webhooks-basics).

## Didit Copilot

Didit Copilot puede manejar el Investigador por ti: listar la cola, abrir un informe y explicarlo, responder a una pregunta, iniciar una prueba retrospectiva o leer el rendimiento. Cuando le pides que acepte, anule o acepte en lote, muestra una tarjeta de aprobación con la acción exacta, y no se decide nada hasta que la apruebas. Las decisiones tomadas así se marcan como **vía Copilot** en **Actividad**. También puede añadir una nota a un elemento y, cuando lo apruebas en una tarjeta igual, pedir al Investigador que vuelva a revisar el elemento. También llega a las demás pestañas: pausar la automatización, la autonomía, la configuración, la política y el SOP, y las comprobaciones que inicia, cada una en una tarjeta igual. Consulta [usar Didit Copilot en el Investigador](https://help.didit.me/es/didit-copilot/copilot-in-the-investigator).

## MCP

El servidor MCP de Didit da a tu propio asistente de IA las mismas herramientas del Investigador: la cola, los informes, las preguntas, las pruebas retrospectivas, el panel de control, el rendimiento y la actividad, además de añadir una nota a un elemento y pedir una nueva revisión. Aceptar, anular y aceptar en lote están marcadas como destructivas y se niegan a ejecutarse hasta que tu asistente confirma que aprobaste esa acción exacta. Las decisiones tomadas así se marcan como **vía MCP** en **Actividad**. Las herramientas actúan en tu nombre, con los permisos de tu rol: decidir un elemento requiere acceso de escritura sobre él.

## Enviar elementos de fuera de Didit

Si parte de tu revisión se hace fuera de Didit, por ejemplo verificaciones de otro proveedor o alertas de tu propia monitorización de transacciones, puedes enviar esos elementos al Investigador por API. Revisa cada uno según tus reglas de verificación o de transacciones y redacta un informe que lees por API o recibes como webhook `investigator.external.report.ready`. Didit nunca decide estos elementos y nunca se facturan. La documentación para desarrolladores explica el formato.

En la consola, pon el filtro **Origen** de la cola en **Externo (API)** para verlos en **Elementos externos**. Cada elemento muestra si es un elemento de **Identidad** o de **Transacción**, su estado (**En cola**, **En revisión**, **Revisado** o **Fallido**) o, una vez revisado, su recomendación, lo que marcó el otro sistema y lo que dice tu política con las reglas que aplicó. Su informe es solo una recomendación, nunca una decisión. **Cómo enviar elementos por API** abre la documentación para desarrolladores.

## API

Todo lo que hay en las páginas del Investigador también está disponible a través de la API del Investigador, con una clave de API que tenga acceso a decisiones (para leer y decidir elementos) o a aplicaciones (para cambiar la configuración). Consulta la [documentación para desarrolladores](https://docs.didit.me).