Creating Your First Data Parser

A data parser is a defined by a data parser application that relays alerts and related data from external services to Transposit.

In Transposit, users can view the output of a data parser and can choose to take action, for example, by creating an activity, such as an incident, task, request or job.

A data parser is invoked by a request to a webhook URL that Transposit provides.

Note: Before creating a new data parser, be aware that Transposit comes with a wide range of webhooks built-in, as described in Creating Your First Webhook.

Follow the steps below to create your first data parser in Python.

  1. Fork sample application. Go to this sample application and click "Fork this app" at the top of the page. Make sure to change the owner to the name of your team, not your personal account.
  2. Deploy. In your application in the Transposit Developer Platform, go to Deploy > Mission Control, change the type to “Data parser” and save. You should use the latest tag for ease of development.
  3. Create a webhook. Go back to Transposit and add a webhook by going to Settings > Webhooks. Click the Add webhook button and select "Custom". Your data parser’s identifier is in the format of maintainer/service_name:tag. If you are following this tutorial, your data parser identifier will be your_organization_name/application_name:latest. Note that if you're adding a Slack channel, the channel must already exist. Click Add.
  4. Call the webhook. You'll notice that an endpoint URL was created for you. Type curl [endpoint_url] in a terminal or go to the URL via your web browser to mimic an external service calling your webhook. You should see an alert in the Activity feed and/or specified Slack channel.