> ## Documentation Index
> Fetch the complete documentation index at: https://docs.duckie.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Pylon

> Connect Pylon to manage customer issues with Duckie

Connect Pylon to let Duckie respond to customer issues in your Pylon workspace.

## Capabilities

| Capability             | Supported              |
| ---------------------- | ---------------------- |
| **Knowledge Source**   | ✗                      |
| **Deployment Trigger** | ✓ Respond to issues    |
| **Tool Actions**       | ✓ Reply, update status |

## Setup

Pylon uses an API key + webhook setup.

### Step 1: Get Your API Key

1. Go to Pylon settings
2. Navigate to API section
3. Create or copy your API key

### Step 2: Connect in Duckie

1. Go to **Settings → Connections** in Duckie
2. Find **Pylon** and click **Connect**
3. Enter your **API Key**
4. Click **Connect**

### Step 3: Configure Webhook

After connecting, you'll see a webhook URL. Configure it in Pylon:

1. Copy the webhook URL from Duckie
2. Go to **Pylon Settings → Webhooks** ([https://app.usepylon.com/settings/webhooks](https://app.usepylon.com/settings/webhooks))
3. Add a new webhook with the Duckie URL
4. Create a trigger with action **Select Webhook**
5. Configure the JSON payload:

```json theme={null}
{
  "id": "{{ issue.id }}",
  "message_id": "{{ issue.last_message.id }}"
}
```

6. Save and test the webhook

## Using as a Deployment Trigger

1. Go to **Deploy**
2. Click **Create Deployment**
3. Select your agent
4. Choose **Pylon** as the trigger
5. Configure which events trigger responses

## Available Tools

| Tool                  | Description               |
| --------------------- | ------------------------- |
| `pylon_reply`         | Send a reply to the issue |
| `pylon_update_status` | Change issue status       |
| `pylon_get_issue`     | Get issue details         |

## Troubleshooting

### "Webhook not receiving events"

* Verify the webhook URL is correct in Pylon
* Check that the JSON payload format matches exactly
* Test the webhook from Pylon's settings

### "API authentication failed"

* Verify the API key is still valid
* Regenerate the key if needed