Documentation
Complete guide to setting up website monitoring with PingZen. API documentation, code examples, and best practices.
Alert Configuration
PingZen supports multiple alert channels. Configure one or more channels for redundancy.
Telegram
The fastest way to receive notifications (1-2 seconds).
- 1.Open Telegram and find the bot @pingzen_bot
- 2.Send /start command to get your Chat ID
- 3.Copy the Chat ID (numeric identifier)
- 4.In PingZen go to Alerts → Create Alert
- 5.Select Telegram channel and paste the Chat ID
For group notifications, add the bot to a group and use the group Chat ID (starts with -100).
Slack
Integration via Incoming Webhooks for team collaboration.
- 1.In Slack go to Settings → Apps → Incoming Webhooks
- 2.Click 'Add New Webhook to Workspace'
- 3.Select a channel for notifications
- 4.Copy the Webhook URL (https://hooks.slack.com/...)
- 5.In PingZen create an alert and paste the URL
Create a dedicated #alerts channel for monitoring notifications.
Discord
Webhook integration for Discord servers.
- 1.In Discord open Server Settings → Integrations → Webhooks
- 2.Click 'New Webhook' and select a channel
- 3.Copy the Webhook URL
- 4.In PingZen create a Discord alert
- 5.Paste the Webhook URL
Name the webhook 'PingZen Alerts' for easy identification.
Microsoft Teams
Integration via Incoming Webhook for enterprise teams.
- 1.In Teams select channel → More options → Connectors
- 2.Find 'Incoming Webhook' and click Configure
- 3.Name the webhook and copy the URL
- 4.In PingZen create an MS Teams alert
- 5.Paste the Webhook URL
Mattermost
Slack-compatible webhooks for self-hosted teams.
- 1.In Mattermost: Main Menu → Integrations → Incoming Webhooks
- 2.Click Add Incoming Webhook
- 3.Select a channel and copy the Webhook URL
- 4.In PingZen use the Mattermost type
Webhook
Send JSON data to your HTTP endpoint for custom integrations.
- 1.Create an HTTP endpoint on your server to receive POST requests
- 2.In PingZen create a Webhook alert
- 3.Enter your endpoint URL
- 4.Optionally add authentication headers
JSON Payload Format
{
"event": "monitor_down",
"monitor": {
"id": 123,
"name": "My Website",
"url": "https://example.com",
"status": "down"
},
"timestamp": "2025-01-15T10:30:00Z",
"error_message": "Connection timeout"
}Alert Triggers
Choose which events should send notifications:
Service Down (DOWN)
Sent when a monitor transitions to DOWN status after confirmation (default: 3 consecutive failures).
Recovery (RECOVERED)
Sent when a monitor recovers after being down.
Degradation (DEGRADED)
Sent when response time threshold is exceeded or partial errors occur.
SSL Expiring
Sent N days before SSL certificate expiration.
Cooldown Period
Minimum time between repeated alerts for the same issue. Prevents notification spam during unstable connections.
Recommended: 5-15 minutes for production environments.
Alerts API
Manage alerts programmatically via REST API.
List Alerts
Create Alert
Update Alert
Delete Alert
Test Alert
Common Questions
What protocols can I monitor?
PingZen supports 19 protocols: HTTP/HTTPS, WebSocket (WS/WSS), TCP, UDP, ICMP Ping, gRPC, DNS, WHOIS, SSL certificates, Email (SMTP/IMAP/POP3), FTP/FTPS, DNSBL, and SafeBrowsing. You can monitor websites, APIs, servers, databases, and any network service.
How fast can I get alerts?
Telegram alerts are delivered within 1-2 seconds of detection. Slack and Discord notifications arrive almost instantly. You can configure multiple alert channels for redundancy.
Can I organize monitors by project?
Yes! PingZen supports workspaces, which let you organize monitors by project, environment, or team. Each workspace can have its own alert configurations and team members.
Is there an API for automation?
Absolutely. PingZen provides a full REST API with OpenAPI documentation. You can create, update, and delete monitors programmatically.
How do status pages work?
Status pages are public, branded pages showing your services' uptime. You can use a custom domain (status.yourdomain.com), display real-time status, and allow customers to subscribe for updates.
What happens if I reach my monitor limit?
We'll notify you when approaching your limit. You can pause some monitors or contact us for increased capacity. We never stop monitoring without warning, ensuring your critical services stay protected.
Ready to stop missing downtime?
Join thousands of teams who trust PingZen. Setup takes 30 seconds.