Connectors / Service / Revo 4me

4me helps Managed Service Providers to boost their service management business by delivering agile service that will help gain and retain customers. (updated: 1663687341928)

Revo 4me

Revo and 4me will help you take back control of your service management system by removing the pain of switching tools, reducing consultancy hours, and enabling you to deploy and integrate at the speed you need.

Overview

Revo 4me provides Managed Service Providers with the ability to boost their service management business by delivering agile service that will help gain and retain customers.

API Information

The Base URL used for the Revo 4me connector is https://graphql.{domain}, where the 'domain' property is taken from your input when authenticating. More information can be found on their main API documentation site.

Authentication

Within the builder, click on the Revo 4me connector to display the connector properties panel. Select the 'Auth' tab and click on the 'New authentication' button.

add-auth

In the Tray.io authentication pop-up modal, name the authentication in a way that will quickly identify it within a potentially large list. For example, whether it is a QA or Production auth, etc.

Consider who/ how many people will need access to this authentication when choosing where to create this authentication ('Personal' or 'Organisational').

The second page asks you which authentication method you would like to use, either 'OAuth 2 with client credentials' or 'Token based'.

Revo 4me authentication method

For the 'OAuth 2' method, you will be asked for your 'Domain', 'Account name', 'Client ID', and 'Client secret' credentials.

Revo 4me oauth inputs

You will need to register your OAuth application in the 'Applications' console of the 'My Profile' section. A registered OAuth application is assigned a unique client ID and Client Secret. The client secret should not be shared.

Revo4me Oauth App

For 'Token' based authentication, you will be asked for your 'Domain', 'Account name', and 'Personal access token' credentials.

Revo 4me token auth input

To get these details, head to the Revo 4me dashboard. Click on 'My Profile' and then 'Personal Access Tokens'. Click the '+' icon to add a new token.

Revo 4me add PAT

Fill in the details, adding any scopes you may need.

Revo 4me create PAT

Once you have added these fields to your Tray.io authentication pop-up window, click the 'Create authentication' button. 

Your connector authentication setup should now be complete.

Available Operations

The examples below show one or two of the available connector operations in use.

Please see the Full Operations Reference at the end of this page for details on all available operations for this connector.

Using the Raw HTTP Request ('Universal Operation')

As of version 1.0, you can effectively create your own operations.

This is a powerful feature that you can use when there is an endpoint in Revo 4me that is not used by any of our operations.

To use this, you will first of all need to research the endpoint in the [Revo 4me - https://developer.4me.com/graphql/#authentication] API documentation to find the exact format that 4me will be expecting the endpoint to be passed in.

For example, if you wanted to query the API for a list of people with a certain email address, you would use the Revo 4me API docs to find the relevant query information here.

Note that all GraphQL requests are a `POST` request, and don't require a URL endpoint to be provided. You will need to provide the GraphQL query as raw JSON.

Based on the information provided in the API documentation, you need to configure the following attributes on your Tray platform:

  • Method: POST

  • URL:  

    • Endpoint / Full URL: ' '

  • Body Type:

    • raw:

1
{"query": "query($emails: [String]!){people(first: 1, filter: {primaryEmail: {values: $emails}}) {nodes { id name primaryEmail }}}","variables": { "emails": ["connectors+4me@tray.io"] }}

Revo 4me raw HTTP

Once the API call is executed successfully, you should get the following results:

Revo 4me raw HTTP result

BEST PRACTICES: Whenever you do decide to create your own workflow, be sure to check out some of our key articles such as:

All Operations

Latest version:

1.0

Raw HTTP request (advanced)

Perform a raw HTTP request with some pre-configuration and processing by the connector, such as authentication.