​

Quick Start

​

Step 1: Create a New Workflow

1. Open MachinaOs at http://localhost:3000
2. Click File > New Workflow or press Ctrl+N
3. You’ll see an empty canvas with a component palette on the left

​

Step 2: Add a Webhook Trigger

1. In the component palette, expand Utilities
2. Drag Webhook Trigger onto the canvas
3. Click the node to select it, then click the gear icon to configure:

Path: hello
Method: POST

​

Step 3: Add an AI Chat Model

1. Expand AI Models in the palette
2. Drag OpenAI Chat Model onto the canvas
3. Position it to the right of the Webhook Trigger
4. Connect them by dragging from the Webhook’s output handle to the AI model’s input handle

​

Configure the AI Model

Model: gpt-4o-mini
Temperature: 0.7

​

Step 4: Set the Prompt

You are a friendly assistant. The user sent: {{webhookTrigger.body}}

Respond with a helpful greeting.

​

Step 5: Add a Webhook Response

1. Drag Webhook Response from Utilities
2. Connect the AI model’s output to the Webhook Response input
3. Configure it:

Status Code: 200
Body: {{openaiChatModel.response}}
Content Type: application/json

​

Step 6: Deploy and Test

1. Click the Deploy button (purple) in the toolbar
2. Your workflow is now listening for webhooks

​

Test with curl

curl -X POST http://localhost:3010/webhook/hello \
  -H "Content-Type: application/json" \
  -d '{"message": "Hello from curl!"}'

​

Your First Workflow

[Webhook Trigger] --> [OpenAI Chat] --> [Webhook Response]

​

What’s Next?