Integrations

​

Overview

1. Fragment’s direct integration with existing tools: Hubspot, Zendesk, Intercom, ComplyAdvantage…
   We have an existing integration with those tools, and can mirror the data from there with your API key.
2. Custom integration with your in-house tools
   If you have a custom back-office, you can create a user for Fragment (ex: acme@checkfragment.com) and we will take care of mirroring your task backlog on Fragment.
3. Direct integration through our API: we grant you access to Fragment’s API.
4. Direct integration using Zapier, n8n, Make or similar tools: a Zapier workflow can be configured to push tasks to the Fragment API.

​

Option 1: direct integration with public tools (Hubspot example)

1. Connect Zapier to HubSpot
2. Create a workflow on HubSpot that sends a trigger on Zapier
3. Configure your Zapier to send tasks to Fragment (see above)

1. Create Private app
   1. Go to settings > Integrations > Private Apps
   2. Click on “create a private App”, pick the name Fragment
   3. Configure the following scopes
   d. Share the access token with us e. We activate the sync on our side. It will poll your HubSpot to get all recent changes every minute.

​

Option 2: Custom integration with your in-house tools

1. Create a user for Fragment with the right permissions (read the backlog).
2. Every X minute (configurable, 5min by default), we refresh your backlog to fetch the open tasks.
3. We close tasks not in the backlog anymore, and create new ones.
4. Operators go through Fragment to complete tasks on their custom back-office.

​

Option 3: Direct integration through our API

1. Locate the part of your case management system (Backend? Automation platform like Zapier?) that creates the tasks
2. Format the data into a JSON that respects the Task Data Model. You usually need to specify the due date of the task (due_at), and some fields to get started (including the url).
3. Make a PATCH request to the tasks/ endpoint

import requests

# 1. Retrieve task information
task = {
    "status": "TODO",
    "due_at": "2024-07-12T12:29:16.891000+00:00",
    "fields": {
        "title": "Claim ABC"
        "url": "https://google.com",
        "partner": "VIP customer XYZ",
        "integration": "API",
    }
}

# 2. Make PATCH request (UPSERT)
response = requests.patch(
    f"https://api.onfragment.com/api/v1/tasks/",
    headers={"Authorization": f"Bearer {YOUR_API_KEY}"},
    json=task,
)
if not response.status_code == 200:
    raise Exception("Fragment API issue")

​

Option 4: direct integration through no-code tools

​

Zapier

1. The first option is to use the Custom Request Webhook via Zapier.
2. The second option is to use the Code Action from Zapier (available in Python and JavaScript flavors).

1. Create new Zap
2. Add a Google Sheet Trigger on New or Updated Row.

1. Add a Code Step. Configure the input data and make an HTTP API request.
   • See code
     Copy

     task = {
         "fields": {
             "title": input_data["title"],
             "url": input_data["url"],
             "category": input_data["category"],
             "name": input_data["name"],
             "priority": input_data["priority"],
             "external_id": input_data["id"],
         }
     }
     resp = requests.put(
         f"https://api.onfragment.com/api/v1/tasks/",
         headers={"Authorization": f"Bearer {YOUR_API_KEY}"},
         json=task,
     )
     if not resp.status_code == 200:
         raise Exception(resp)
     return resp.json()
     

2. Navigate to the Fragment dashboard, you should now see the tasks !

​

Make

1. Create a Search Rows Google Sheets trigger
2. Add a JSON action to format the flat data into a proper JSON. This action enables you to define a schema for your data and is thus robust. In our case, let’s adopt a simple data structure that fits the Task Data Model

1. Add an HTTP action node. Make sure to
   • Select the PATCH method
   • Enter the header x-api-key for authentication
   • Fill the request content by selecting the output of the JSON step
2. Navigate to the Fragment dashboard, you should now see the tasks

​

n8n

1. Create a Google Sheet Trigger on rowAdded
2. Transform the data with a Code block (example below)
   • See Code (Javascript)
     Copy

     // Loop over input items and add a new field called 'myNewField' to the JSON of each one
     for (const item of $input.all()) {
       const new_item = {
         fields: {
             title: item.json.title,
             url: item.json.url,
             category: item.json.category,
             priority: item.json.priority,
             name: item.json.name,
             external_id: item.json.id,
         }
       };
       item.json = new_item;
     }
     
     return $input.all();
     

   • See Screenshot
3. Add an HTTP node Make sure to
   • Select method PATCH
   • Include the header x-api-key
   • Retrieve the body from the previous step (already formatted) with {{ $json }}

1. Navigate to the Fragment dashboard, you should now see the tasks