Webhooks de plugins
Entrega eventos externos a un plugin activo en tu organización, y qué comprueba el endpoint antes de que el plugin los vea.
Un plugin que declara la capacidad de webhook recibe eventos externos en:
POST https://intelligence-api.veyra.so/api/plugins/{pluginId}/webhooks/{endpointKey}endpointKey nombra uno de los endpoints que el plugin declara en su manifiesto. La página de ajustes del plugin muestra sus direcciones.
Qué comprueba Veyra primero
| Comprobación | Si falla |
|---|---|
| El plugin existe. | 404 |
| El plugin está listo (activo e iniciado). | 400 con su estado actual |
| El plugin declara la capacidad de webhook y este endpoint. | 400 o 404 |
Después, el plugin verifica la solicitud a su manera (por ejemplo, con una firma del servicio que la envía) y decide qué hacer con ella. Su documentación describe la carga que espera.
Autenticación
Cómo se autentica un webhook de plugin depende del plugin. Prefiere los plugins que verifican una firma del remitente; la dirección del endpoint por sí sola no debe tratarse como un secreto.
Consulta Plugins en la referencia de la API.