Webhook Input
Webhook Input is a simple component that lets you receive data from a webhook. You can paste a JSON payload into the Data field to test how the component will parse it and pass it to the rest of your workflow.
¿Cómo funciona?
When you drop this component into your flow, it waits for a webhook request. The JSON you paste (or that arrives from an external source) is parsed by the component. If the text is valid JSON, it is converted into a Data object that can be used by other components. If the text is not valid JSON, the component stores the raw text under a payload
key and shows an error message so you can correct it.
The component does not call any external APIs; all processing happens locally inside the dashboard.
Entradas
Campos de Entrada
- Data: Use this field to quickly test the webhook component by providing a JSON payload.
This is the only input for the component.
Salidas
- Data: The output is a Data object that contains the parsed JSON. If the input was not valid JSON, the output will be
{ "payload": "<raw text>" }
. This output can be connected to other components that expect a Data object.
Ejemplo de Uso
- Drag the Webhook Input component onto the canvas.
- In the Data field, paste the following JSON:
{"user": "alice","action": "login","timestamp": "2025-10-07T12:34:56Z"}
- Connect the Data output to a Print component (or any other component that accepts Data).
- Run the flow. The Print component will display the parsed JSON, showing that the webhook data has been received and processed correctly.
Componentes Relacionados
- Webhook Output – Sends data from the flow to an external URL.
- JSON Parser – Parses raw JSON strings into structured data.
- Print – Displays data for debugging purposes.
Consejos y Mejores Prácticas
- Keep the JSON payload small to avoid performance issues.
- Use the Data field only for testing; in production, the component will receive data from an actual webhook trigger.
- Validate the structure of your JSON before sending it to the component to reduce errors.
- If you need to handle large payloads, consider streaming the data or using a dedicated storage component.
Consideraciones de Seguridad
- The component parses JSON locally, so it does not expose your data to external services.
- Avoid including sensitive information (like passwords or API keys) directly in the JSON payload.
- If the webhook is exposed to the internet, ensure that your Nappai instance is protected by proper authentication and HTTPS.