Trello

Integration of Trello with Callgoose SQIBS

Overview

This document provides a detailed guide to integrating Trello with Callgoose SQIBS for Event-Driven Automation and Task-based Auto Remediation. The integration enables automatic creation of incidents or requests in Callgoose SQIBS when a new card is created in a specified Trello board or list. Callgoose SQIBS then triggers the appropriate automation workflows to process or resolve the issue described in the card.

Prerequisites

• Trello Account: Admin access to the board with ability to create webhooks or use automation tools.
• Callgoose SQIBS Account: Permissions to set up API filters and automation workflows.
• Callgoose API Token and Endpoint: Required for receiving webhook events.

1. Obtain API Token and Endpoint Details in Callgoose SQIBS

1.1 Generate API Token:

• Refer to: How to Create API Token in Callgoose SQIBS

1.2 Find API Endpoint:

• Refer to: Callgoose SQIBS API Endpoint Documentation

2. Set Up Trello Webhook to Trigger Callgoose SQIBS

2.1 Generate Trello API Key and Token

1. Go to https://trello.com/app-key and log in
2. Copy your API Key
3. Generate a Token from the same page (click the link to generate one for your user)

2.2 Create Webhook Using Trello API

• Endpoint:

POST https://api.trello.com/1/webhooks/

• Query Parameters:

key=<your_api_key>&token=<your_token>

• Body:

{
  "description": "Callgoose SQIBS Webhook",
  "callbackURL": "https://<your_callgoose_instance>/sqibs/integration_endpoint",
  "idModel": "<id_of_board_or_list>"
}

Use Trello API to find the idModel of the board or list you want to monitor

3. Configure Callgoose SQIBS to Handle Trello Events

3.1 Create API Filters

1. Log in to Callgoose SQIBS
2. Navigate to API Filters
3. Create a new filter to process card creation events from Trello

Example:

• Payload JSON Key: action.type
• Key Value Contains: ["createCard"]
• Map Incident With: action.data.card.id
• Incident Title From: action.data.card.name
• Incident Description From: action.data.card.desc

3.2 Sample Trello Webhook Payload

{
  "action": {
    "type": "createCard",
    "data": {
      "card": {
        "id": "60afc234d5",
        "name": "Restart web server on production",
        "desc": "Automation needed to restart nginx on prod-node-01"
      }
    }
  }
}

4. Link Automation Workflow in Callgoose SQIBS

1. Configure the automation runner to respond to the new incident
2. Use supported automation tools (Shell, Python, Ansible, PowerShell, etc.) to remediate the request described in the Trello card
3. Automation should update the incident status upon completion

5. Testing and Validation

1. Create a test card on the monitored Trello board or list
2. Confirm the webhook is received by Callgoose SQIBS
3. Check that an incident/request is created in SQIBS with appropriate title and description
4. Verify automation execution and final resolution status

6. Troubleshooting

• Check Trello’s developer dashboard for webhook delivery status
• Use Callgoose SQIBS API log to inspect received payloads
• Ensure JSON keys used in filters match actual payload structure
• Validate API Key and Token used for webhook creation

7. References

• Trello Developer API Reference
• Callgoose SQIBS API Token Documentation
• Callgoose SQIBS API Endpoint Documentation
• API Filter Instructions and FAQ
• How to Send API