Skip to main content

Tools Integrations Guide

Connect Ampliserv with your existing tools to streamline incident management and notifications.

🔌 Available Integrations​

Communication Tools​

Issue Tracking​

  • Jira Integration - Automatically create Jira tickets for incidents
  • GitHub Issues (Coming Soon) - Create GitHub issues for incidents

CI/CD​

  • GitHub Actions (Coming Soon) - Link to deployments and automation

🎯 Integration Benefits​

BenefitDescription
Automated AlertsGet notified instantly when incidents occur
Ticket CreationAutomatically create Jira tickets for critical issues
Team CollaborationKeep everyone informed through their preferred channels
Centralized ManagementManage all notifications from one dashboard

🚀 Getting Started​

Step 1: Access Integrations​

  1. Login to your Ampliserv dashboard
  2. Navigate to Integrations in the sidebar
  3. View all available integrations

Integrations Dashboard
Figure 1: Integrations dashboard showing available tools

Step 2: Configure an Integration​

  1. Click "Configure" on any integration card
  2. Fill in the required credentials
  3. Click "Save Configuration"
  4. Verify the connection status

Step 3: Test & Verify​

  1. Trigger a test incident
  2. Check if notifications are delivered
  3. Verify ticket creation (for Jira)
  4. Adjust settings as needed

🔧 Prerequisites​

Before configuring any integration:

  • ✅ Ampliserv account set up and active
  • ✅ Administrator access to the target tool
  • ✅ API credentials/keys from the target tool
  • ✅ Network access between Ampliserv and the tool

⚙️ Common Configuration Fields​

Most integrations require:

  • API Keys/Tokens - For authentication
  • URLs/Endpoints - Where to send data
  • Project/Channel IDs - Specific destination
  • User Permissions - Access rights needed

🔄 Integration Status​

Each integration shows one of three statuses:

🟢 Connected​

  • Configuration saved
  • Connection verified
  • Ready to receive data

🟡 Configured​

  • Configuration saved
  • Connection issues detected
  • Check credentials and network

⚪ Not Configured​

  • No configuration saved
  • Click "Configure" to set up

📊 Integration Dashboard​

View all integrations at a glance:

  • Status indicators for each tool
  • Connection counts (X of Y connected)
  • Quick configuration buttons
  • Test connection options

🔍 Testing Your Integrations​

Method 1: Manual Test​

  1. Navigate to the integration
  2. Click "Test Connection" (if available)
  3. Check for success/error messages

Method 2: Trigger Test Incident​

  1. Create a test incident in Ampliserv
  2. Monitor all connected tools
  3. Verify notifications/tickets created

❓ Troubleshooting​

Common Issues​

Issue: "Authentication failed"
Solution: Regenerate API keys and update configuration

Issue: "Connection timeout"
Solution: Check network/firewall settings, verify URLs

Issue: "No notifications received"
Solution: Verify notification settings, check spam folders

Issue: "Permissions denied"
Solution: Ensure user has proper access rights in target tool

Debug Steps​

  1. Verify credentials - Are they still valid?
  2. Check network - Can Ampliserv reach the tool?
  3. Review logs - Any error messages?
  4. Test manually - Can you access the tool directly?
  5. Contact support - If issues persist

🛠️ Managing Multiple Integrations​

Best Practices​

  1. Start Simple - Configure one integration at a time
  2. Test Thoroughly - Verify each works before adding more
  3. Document Settings - Keep records of configurations
  4. Regular Reviews - Check integration status weekly
  5. Update Credentials - Rotate API keys periodically

Organization Tips​

  • Group by team/department
  • Use descriptive names for configurations
  • Set up separate channels for different incident types
  • Establish notification hierarchies

🔄 Updating Integrations​

When you need to update an integration:

  1. Click "Update" on the integration card
  2. Modify the necessary fields
  3. Save the configuration
  4. Test the updated connection

Note: Some fields (like passwords) remain empty for security. You only need to re-enter them if changing.

🗑️ Removing Integrations​

To disconnect an integration:

  1. Open the integration configuration
  2. Clear all required fields
  3. Save the configuration
  4. Status will change to "Not Configured"

Warning: Removing an integration stops all notifications/ticket creation for that tool.

📈 Monitoring Integration Health​

Monitor your integrations through:

  • Status badges on integration cards
  • Dashboard summary (connected count)
  • Incident logs (check for failed notifications)
  • Regular testing (schedule weekly tests)

🔜 Coming Soon​

Planned Integrations​

  • Slack - Full Slack integration with channel management
  • PagerDuty - Escalation policies and on-call schedules
  • Datadog - Metrics and monitoring integration
  • Custom Webhooks - Send data to any HTTP endpoint
  • ServiceNow - IT service management integration

Feature Updates​

  • Bulk configuration - Set up multiple integrations at once
  • Integration templates - Pre-configured setups for common tools
  • Advanced routing - Conditional notifications based on incident severity
  • Analytics dashboard - Track integration performance and usage

🆘 Support Resources​

Need help with integrations?

  • Documentation: This guide and integration-specific pages
  • Email Support: integrations@ampliserv.com
  • Troubleshooting Guide: Common Issues
  • Community Forum: Coming soon
  • Live Chat: Available in the dashboard

Next Steps​

Ready to connect your first tool? Choose from:

  1. Email Integration - For team notifications
  2. Jira Integration - For ticket management
  3. Teams Integration - For team collaboration

Integration questions? Email integrations@ampliserv.com with your organization name and tool details.