Pylon Integration

Connect Pylon to automatically investigate new customer support tickets and post findings back as internal notes. When a new ticket is created in Pylon, Autoheal can automatically start an investigation and share results with your support team.

Capabilities

Once connected, the AI agent can:

Capability	Description
Auto-Investigate Tickets	Automatically start investigations when new tickets arrive
Post Internal Notes	Write investigation findings back to tickets as internal notes
Read Ticket Data	Access ticket details, requester info, and account context
Webhook Triggers	Receive real-time notifications when tickets are created

Prerequisites

• A Pylon account with API access
• An API key for posting internal notes
• Access to Pylon webhook and trigger settings

Setup

1

Add Integration in Autoheal

1. Go to Integrations in Autoheal
2. Click Pylon
3. Enter a name (e.g., "Production Pylon")

2

Configure the Webhook

1. Go to Settings → Webhooks in Pylon
2. Create a new webhook named "Autoheal" using the webhook URL shown in Autoheal
3. Copy the Signing Secret generated by Pylon
4. Paste the signing secret into the Webhook Signing Secret field in Autoheal

3

Create a Trigger

1. Go to Settings → Triggers in Pylon
2. Create a new trigger
3. Set it to run when a new ticket is created
4. Remove the if block condition (so it fires for all tickets)
5. In the then block, choose Send webhook and select the "Autoheal" webhook
6. Paste the payload template (provided in Autoheal) into the content field
7. Save the trigger

4

Create an API Key

1. Go to Settings → API tokens in Pylon
2. Create an API key named "Autoheal"
3. Paste the API key into the API Key field in Autoheal

5

Test and Save

Click Save, then create a test ticket in Pylon to verify the integration works.

Configuration Fields

Field	Required	Description
API Key	Yes	Pylon API key for posting internal notes to tickets
Webhook Signing Secret	Yes	Secret from Pylon for verifying webhook payloads

Webhook Payload

When configuring the trigger in Pylon, use this payload template:

{
  "issue_id": "{{ issue.id }}",
  "issue_number": "{{ issue.number }}",
  "title": "{{ issue.title }}",
  "body": "{{ issue.body }}",
  "status": "{{ issue.status }}",
  "requester_email": "{{ issue.requester.email }}",
  "account_name": "{{ issue.account.name }}",
  "tags": "{{ issue.tags }}"
}

How It Works

1. A customer creates a new ticket in Pylon
2. The Pylon trigger fires and sends a webhook to Autoheal
3. Autoheal automatically starts an investigation using the ticket context
4. An internal note is posted to the ticket with a link to the investigation
5. The AI agent analyzes relevant logs, metrics, and documentation
6. Investigation findings help your support team resolve the issue faster

tip

You can customize which tickets trigger investigations by adding conditions to the Pylon trigger (e.g., only high-priority tickets, or tickets with specific tags).

Example Queries

Once connected, you can ask the AI agent questions like:

Show me the latest Pylon tickets

What tickets were created for the Acme Corp account this week?

Investigate the issue described in Pylon ticket #456

Troubleshooting

Webhook Not Firing

• Verify the webhook URL in Pylon matches the URL shown in Autoheal
• Check that the trigger is enabled and configured correctly
• Ensure the trigger has no conditions that filter out your test ticket
• Verify the payload template is correctly pasted

Internal Notes Not Posting

• Verify the API key is correct and has not been revoked
• Check that the API key has permission to post internal notes
• Ensure the ticket ID is valid and the ticket exists

Signature Verification Failed

• Verify the webhook signing secret matches between Pylon and Autoheal
• Ensure the secret was copied correctly without extra whitespace
• Re-generate the signing secret in Pylon if needed