Integrations & Ecosystem

Integration Overview 🔗

Donobu is designed to work seamlessly with your existing development and testing ecosystem. Choose from our comprehensive integration guides to connect Donobu with your preferred tools and platforms.

Available Integration Guides

CI/CD Pipeline Integrations

Automate your testing workflows across platforms:

• GitHub Actions - Complete workflow examples and matrix testing
• Jenkins - Pipeline integration with shared libraries
• GitLab CI - Multi-environment testing configurations
• Azure DevOps - Pipeline YAML and task integration
• CircleCI - Executor setup and workflow configuration

Quick Integration Examples

Basic API Integration

// Simple flow creation
const response = await fetch('http://localhost:31000/api/flows', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    name: 'User Login Test',
    targetWebsite: 'https://app.example.com',
    overallObjective: 'Test user login functionality',
    maxToolCalls: 10
  })
});

const flow = await response.json();
console.log('Flow created:', flow.id);

Webhook Notification

// Basic webhook handler
app.post('/donobu-webhook', (req, res) => {
  const { id } = req.body;
  console.log(`Flow ${id} completed`);
  res.status(200).send('OK');
});

Test Framework Integration

// Jest integration example
test('should complete checkout flow', async () => {
  const flowId = await createDonobuFlow({
    name: 'Checkout Test',
    objective: 'Complete product checkout'
  });
  
  const result = await waitForFlowCompletion(flowId);
  expect(result.state).toBe('SUCCESS');
});

Integration Best Practices

1. Environment Management

• Use environment-specific configurations
• Secure API key storage
• Proper credential rotation

2. Error Handling

• Implement comprehensive retry logic
• Capture detailed debugging information
• Set appropriate timeouts

3. Monitoring & Observability

• Track key performance metrics
• Set up alerting for failures
• Maintain execution logs

4. Security Considerations

• Never expose credentials in logs
• Use secure webhook verification
• Implement proper access controls

5. Performance Optimization

• Run flows in parallel when possible
• Use headless mode for CI/CD
• Implement efficient resource cleanup

Custom Integration Support

Need help with a custom integration? Our flexible API and webhook system support:

• Enterprise Tools - Connect with your internal systems
• Custom Workflows - Build tailored automation pipelines
• Third-party Services - Integrate with any REST API
• Database Storage - Store results in your preferred database
• Notification Systems - Send alerts through any communication platform

Getting Started

1. Choose Your Integration - Select from the detailed guides above
2. Follow Setup Instructions - Each guide includes step-by-step setup
3. Test Your Configuration - Verify everything works with sample flows
4. Scale Your Implementation - Expand to cover your full testing needs

Each integration guide includes practical examples, configuration templates, and troubleshooting tips to help you get up and running quickly.