Webhooks
Webhooks let you notify external systems when something happens in Trackelio. When a configured event occurs, Trackelio sends an HTTP POST request to your specified URL with details about the event. Use webhooks to connect Trackelio with tools like Slack, Discord, Zapier, or your own backend services.
Supported events
Section titled “Supported events”The following events can trigger webhook deliveries:
| Event | Description |
|---|---|
post.created | A new feedback post is created |
post.status_changed | A post’s status is updated |
post.assigned | A post is assigned to a team member |
comment.created | A new comment is added to a post |
nps.submitted | A user submits an NPS response |
csat.submitted | A user submits a CSAT rating |
conversation.completed | A messenger conversation is completed |
Endpoint configuration
Section titled “Endpoint configuration”Each webhook endpoint has the following settings:
- URL — The HTTP endpoint that will receive the POST requests.
- Events — An array of event types this endpoint should receive. You can subscribe to one or more events per endpoint.
- Secret — A secret key used to sign payloads with HMAC-SHA256. Use this to verify that incoming requests genuinely came from Trackelio.
- Active toggle — Enable or disable the endpoint without deleting it. Useful for temporarily pausing deliveries during maintenance.
Payload signing
Section titled “Payload signing”Every webhook delivery is signed using HMAC-SHA256 with the secret you configure for the endpoint. The signature is included in the request headers so your receiving service can verify authenticity. Always validate the signature before processing a webhook payload to prevent unauthorized requests.
Delivery tracking
Section titled “Delivery tracking”Trackelio tracks the result of every webhook delivery, including:
- Status code — The HTTP status code returned by your endpoint.
- Response body — The body of the response from your endpoint.
- Failure count — A running count of consecutive failures for each endpoint.
Use the delivery log to diagnose issues with your integration. If an endpoint is consistently failing, check the status codes and response bodies for error details.
Common integrations
Section titled “Common integrations”Here are some typical ways to use webhooks:
- Slack — Post a message to a channel when new feedback is submitted or a post changes status.
- Discord — Send notifications to a Discord channel for team visibility.
- Zapier — Connect Trackelio to thousands of apps through Zapier’s webhook trigger.
- Custom systems — Forward events to your own API for custom workflows, such as updating a CRM, triggering CI/CD pipelines, or syncing data with internal tools.