Ping

Channels

Channels are the core concept in Ping. Each channel has its own webhook URL and groups related notifications together.


What is a Channel?

A channel is a notification endpoint. Each channel has:

  • Name - A descriptive label (e.g., "Deploy Alerts")
  • Icon - An SF Symbol for visual identification
  • Color - A color for the channel badge
  • Webhook URL - A unique URL for sending notifications
  • Messages - A history of all notifications sent to this channel

Think of channels like chat groups - each one collects related notifications together.

Creating Channels

  1. Open the Channels tab
  2. Tap the + button
  3. Fill in the details:
    • Name: Something descriptive
    • Icon: Choose from available SF Symbols
    • Color: Pick a color for visual identification
  4. Tap Create

Your new channel appears with a unique webhook URL.

Suggested Channels:

  • Deploy Alerts - CI/CD notifications
  • Server Monitoring - Infrastructure alerts
  • n8n Workflows - Automation updates
  • Cron Jobs - Scheduled task completion
  • Error Logs - Application errors

Managing Channels

Viewing Channel Details

Tap any channel to see:

  • Message history (newest first)
  • Webhook URL
  • Channel settings

Editing a Channel

  1. Tap the channel
  2. Tap the settings icon
  3. Modify name, icon, or color
  4. Tap Save

Deleting a Channel

  1. Swipe left on the channel in the list
  2. Tap Delete

Warning: Deleting a channel also deletes all its messages. This cannot be undone.

Webhook URLs

Your webhook URL looks like this:

https://ping-api-production.up.railway.app/v1/send/YOUR_TOKEN

The token at the end is your authentication. Keep this URL private - anyone with access can send you notifications.

Copying the URL

  1. Tap the channel
  2. Tap the webhook URL to copy it
  3. Paste it in your integration

Regenerating Tokens

If your webhook URL is compromised:

  1. Tap the channel
  2. Tap Settings
  3. Tap Regenerate Token
  4. Confirm the action

Your old URL stops working immediately. Update any integrations with the new URL.