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.

Veyra Docs TeamActualizado el 1 min de lecturaVersión 2 · Historial

Un plugin que declara la capacidad de webhook recibe eventos externos en:

HTTP
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.

EntrantesPluginsWebhooks