Webhook Integration

Send article data to any custom endpoint for flexible integration.

Overview

The webhook integration allows you to send article data to any custom HTTP endpoint. This is perfect for custom CMS integrations, automation workflows, or connecting to platforms not natively supported.

Use Cases

Custom CMS platforms
Headless CMS integrations
Automation workflows (Make, n8n, etc.)
Content syndication
Custom content pipelines
Internal content management systems

Setup Instructions

Step 1: Configure Webhook URL

Go to Integrations in Sight AI
Click Webhook
Enter your webhook endpoint URL
Select the HTTP method (POST is default)
Add any custom headers if needed
Click "Save"

Step 2: Test the Connection

Click "Send Test"
Verify your endpoint receives the test payload
Check the response status

Payload Format

When an article is synced, Sight AI sends a JSON payload to your endpoint:

{
  "event": "article.published",
  "timestamp": "2024-01-15T10:30:00Z",
  "article": {
    "id": "article_abc123",
    "title": "Article Title",
    "slug": "article-title",
    "content": "<p>Full HTML content...</p>",
    "excerpt": "Article summary...",
    "featured_image": {
      "url": "https://...",
      "alt": "Image description"
    },
    "images": [
      {
        "url": "https://...",
        "alt": "Image description"
      }
    ],
    "meta": {
      "title": "SEO Title",
      "description": "Meta description"
    },
    "keyword": "target keyword",
    "type": "explainer",
    "word_count": 2500,
    "created_at": "2024-01-15T10:30:00Z"
  },
  "site": {
    "id": "site_xyz789",
    "name": "Your Site Name",
    "url": "https://yoursite.com"
  }
}

Configuration Options

HTTP Method

Choose the HTTP method for your webhook:

POST – Most common, sends data in request body
PUT – For update-style operations

Custom Headers

Add custom headers for authentication or identification:

Authorization – API key or bearer token
X-API-Key – Custom API key header
Content-Type – Defaults to application/json

Webhook Secret

For security, Sight AI includes a signature header:

X-Sight-Signature: sha256=abc123...

Use this to verify webhooks are from Sight AI.

Event Types

Event	Description
`article.published`	Article was synced/published
`article.updated`	Article was updated and re-synced
`test`	Test webhook from Sight AI

Response Handling

Your endpoint should respond with:

200-299 – Success, delivery confirmed
4xx – Client error, will not retry
5xx – Server error, Sight AI will retry

Respond within 30 seconds to avoid timeout.

Retry Policy

Failed webhooks (5xx responses or timeouts) are retried:

First retry: 1 minute after failure
Second retry: 5 minutes after first retry
Third retry: 15 minutes after second retry
Maximum 3 retries before marking as failed

Delivery Logs

View webhook delivery history:

Go to Integrations → Webhook
Click "View Logs"
See recent deliveries with status and response

Example Integrations

Zapier (via Webhooks by Zapier)

Create a new Zap with "Webhooks by Zapier" trigger
Select "Catch Hook"
Copy the webhook URL
Paste into Sight AI webhook configuration
Set up your Zap actions

Make (formerly Integromat)

Create a new scenario with Webhook module
Select "Custom webhook"
Copy the webhook URL
Configure in Sight AI
Add your Make actions

Troubleshooting

Webhook Not Received

Verify the endpoint URL is correct and accessible
Check for firewall or IP restrictions
Ensure your server is running and responding
Review delivery logs for error details

Authentication Failed

Verify custom headers are configured correctly
Check API key or token validity
Ensure header names match what your endpoint expects

Disconnecting

To disable the webhook:

Go to Integrations → Webhook
Click "Disable" or delete the webhook URL
Save changes